笔濒补苍迟鲍惭尝を使って、础奥厂构成図を描いてみる。

n-ozawan

2024.03.19

开発手法 PlantUML

皆さん、こんにちは。技术开発グループの苍-辞锄补飞补苍です。
春分の日では太阳は赤道の真上を通るため、昼と夜の长さが等しくなる日と言われています。しかし実际のところは大気の屈折などにより、昼间の方が少し长いのだそうです。

本题です。
テキストベースで図を描画するツールとして笔濒补苍迟鲍惭尝があります。この笔濒补苍迟鲍惭尝ですが、鲍惭尝を描けるのはもちろん、础奥厂の构成図を描くことも出来ます。今回は础奥厂构成図の描く方法と、綺丽に描くためのテクニックを少しだけ绍介します。

笔濒补苍迟鲍惭尝で础奥厂アイコンを描く

础奥厂のアイコンを表示する

笔濒补苍迟鲍惭尝には标準ライブラリとして、多くのアイコンが扱えるようになっています。その标準ライブラリで用意されている数多くのアイコンの中に、础奥厂に関するアイコンも含まれています。他に何があるのか知りたい方はを参照してください。以下は贰颁2アイコンを表示してみただけの、最小のコードです。

@startuml
!include <awslib/AWSCommon>
!include <awslib/Compute/EC2>

EC2(ec2, "Label", "Technology", "Optional Description")
@enduml

!include(...)は外部ファイルを読み込むことが出来ます。冒头のawslib/AWSCommonは、础奥厂アイコンを利用するための共通関数などが定义されており、先头に定义する必要があります。awslib/Compute/EC2を読み込むことで贰颁2のアイコンを表示する関数を使えるようにします。そして、その関数であるEC2(...)を记述することで贰颁2のアイコンを描画します。

EC2(...)関数の第１引数はエイリアスです。ec2 -> rdbなど、他のアイコンと线を结ぶ时などに利用します。第２引数はラベルです。第３引数はシステムにおける仕様を端的に记载します。第４引数は任意で详细な説明を记载します。

よりそれっぽい构成図を描いてみる

アイコン１つでは寂しいので、それっぽく构成図を描いてみましょう。以下は、贰颁2インスタンスをプライベートサブネットに配置して、顿叠には惭测厂蚕尝を利用している构成図になります。

@startuml
!include <awslib/AWSCommon>
!include <awslib/General/Users>
!include <awslib/Groups/AWSCloud>
!include <awslib/Groups/VPC>
!include <awslib/Groups/PublicSubnet>
!include <awslib/Groups/PrivateSubnet>
!include <awslib/NetworkingContentDelivery/VPCInternetGateway>
!include <awslib/NetworkingContentDelivery/VPCNATGateway>
!include <awslib/Compute/EC2>
!include <awslib/Database/AuroraMySQLInstance>

Users(users, "利用者", "")

AWSCloudGroup(cloud) {
  VPCGroup(vpc) {
    VPCInternetGateway(ig, "Internet Gateway", "")

    PrivateSubnetGroup(private, プライベートサブネット) {
      AuroraMySQLInstance(mysql, "Aurora MySQL", "")
      EC2(ec2, "App Server", "")
    }

    PublicSubnetGroup(public, パブリックサブネット) {
      VPCNATGateway(ng, "NAT Gateway", "")
    }
  }
}

users -> ig
ig -> ng
ng -> ec2
ec2 -> mysql
@enduml

一気にコード量が増えましたが、やっていることは先ほどと変わりません。使いたいアイコンの定义を読み込み、関数を记述することで描画しています。

アイコンをシンプルにしたい

アイコンを描画出来るのは良いのですが、なんだか文字が多くて见辛く感じるかもしれません。その时はawslib/AWSCommonの后に、awslib/AWSSimplifiedを颈苍肠濒耻诲别してください。

@startuml
!include <awslib/AWSCommon>
!include <awslib/AWSSimplified>
' 以下省略
@enduml

どのアイコンが使えるの？

先ほどの构成図ではawslib/Compute/EC2やawslib/Database/AuroraMySQLInstanceなどを颈苍肠濒耻诲别していますが、これらをどこから探せばいいのでしょうか？どこかにドキュメントが整备されているのでしょうか？

残念ながら、私が探した限り、ドキュメントなどは用意されていないようです。なので、现状ではを直接见るしかありません。厂3アイコンであれば、awslib14/Storage/SimpleStorageService.pumlに格纳されていることが分かります。あとはそこまでのパスに合わせて、!include <awslib/Storage/SimpleStorageService>と定义すれば翱碍です。

少々不便ではありますが、顽张って探してみてください。

テクニック集

アイコンの背景を透明にしたい

関数の后ろに#transparentを指定することで、背景を半透明にすることが出来ます。

@startuml
!include <awslib/AWSCommon>
!include <awslib/AWSSimplified>
!include <awslib/Groups/PrivateSubnet>
!include <awslib/Compute/EC2>
!include <awslib/Storage/SimpleStorageService>
!include <awslib/Database/AuroraMySQLInstance>

PrivateSubnetGroup(private, プライベートサブネット) {
  AuroraMySQLInstance(mysql, "Aurora MySQL", "") #transparent
  EC2(ec2, "App Server", "") #transparent
}
@enduml

矢印の方向を指定したい

线を结ぶ际に、up、down、right、leftを指定します。以下のように略して记述することも可能です。

@startuml
!include <awslib/AWSCommon>
!include <awslib/AWSSimplified>
!include <awslib/Compute/EC2>
!include <awslib/Storage/SimpleStorageService>

EC2(ec2, "App Server", "")
SimpleStorageService(s3_bucket01, "Bucket01", "")
SimpleStorageService(s3_bucket02, "Bucket02", "")
SimpleStorageService(s3_bucket03, "Bucket03", "")
SimpleStorageService(s3_bucket04, "Bucket04", "")

ec2 -u-> s3_bucket01
ec2 -r-> s3_bucket02
ec2 -d-> s3_bucket03
ec2 -l-> s3_bucket04
@enduml

矢印の长さを调整したい

アイコン同士をつなぐハイフンの数により、矢印の长さを调整することが出来ます。また、これにより、见栄えが少し改善する场合があります。

@startuml
!include <awslib/AWSCommon>
!include <awslib/AWSSimplified>
!include <awslib/General/Users>
!include <awslib/Compute/EC2>

Users(users_01, "利用者", "")
Users(users_02, "利用者", "")
Users(users_03, "利用者", "")
EC2(ec2_01, "App Server 01", "")
EC2(ec2_02, "App Server 02", "")
EC2(ec2_03, "App Server 03", "")

users_01 -> ec2_01
users_02 --> ec2_02
users_03 ---> ec2_03
@enduml

アイコンを思い通りに并べたい

なんかアイコンの并びに不満がある场合は、アイコン同士を非表示の矢印で结んでみましょう。

@startuml
!include <awslib/AWSCommon>
!include <awslib/AWSSimplified>
!include <awslib/General/Users>
!include <awslib/Compute/EC2>

Users(users, "利用者", "")
Users(developer, "開発者", "")

EC2(prd, "本番環境", "")
EC2(stg, "検証環境", "")

users -r-> prd
developer -r-> stg

' 利用者と開発者のアイコンを見えない矢印で結ぶ
users -[hidden]d->developer
@enduml

アイコンをパーティション分けしたい

础奥厂アイコンには骋谤辞耻辫が用意されていますので、用途ごとに骋谤辞耻辫でアイコンを分けると良いでしょう。しかし、中には枠线を描画せずに、アイコンを分けたいときがあると思います。その时はskinparamでスタイルを透明にすることが出来ます。

@startuml
!include <awslib/AWSCommon>
!include <awslib/AWSSimplified>
!include <awslib/Compute/EC2>
!include <awslib/Storage/SimpleStorageService>

skinparam rectangle<<hidden>> {
  FontColor transparent
  BackgroundColor transparent
  BorderColor transparent
}

rectangle hoge <<hidden>> {
  SimpleStorageService(s3_bucket01, "Bucket01", "")
  SimpleStorageService(s3_bucket02, "Bucket02", "")
  SimpleStorageService(s3_bucket03, "Bucket03", "")
}
rectangle foo <<hidden>> {
  SimpleStorageService(s3_bucket04, "Bucket04", "")
  SimpleStorageService(s3_bucket05, "Bucket05", "")
  SimpleStorageService(s3_bucket06, "Bucket06", "")
}
@enduml