Skip to content
OpenAgentSkill
Browsing is open · Catalog captured 2026-11-21 · Automatic updates and account services are paused.
DevOps & cloud

aws-drawio-diagram

AWS の構成図を draw.io の XML(.drawio)で描く。公式の AWS4 アイコンを使い、タイトルや凡例や番号バッジのような装飾を足さず、どのサービスがどこにあって何とつながっているかだけで読める図にする。AWS 構成図、アーキテクチャ図、インフラ構成図、ネットワーク構成図、VPC の図を描いてほしいとき、draw.io で AWS の図を作りたいとき、既存の構成図を直したいときは必ずこの Skill を使う。Use this whenever the user asks for an AWS architecture diagram, cloud infrastructure diagram, VPC diagram, or a draw.io file of AWS resources, even if they don't say "draw.io". Mermaid、PlantUML、Python の diagrams ライブラリなど、ほかの形式を指定されたときは使わない。Do not use it when the user explicitly asks for Mermaid, PlantUML, or the Python diagrams library.

sagochiko · Static checks on file

Installation

Read the source and dependencies before running a command. Copying does not install or execute anything.

npx skills add sagochiko/aws-drawio-diagram-skill --skill aws-drawio-diagram

About this skill


name: aws-drawio-diagram description: AWS の構成図を draw.io の XML(.drawio)で描く。公式の AWS4 アイコンを使い、タイトルや凡例や番号バッジのような装飾を足さず、どのサービスがどこにあって何とつながっているかだけで読める図にする。AWS 構成図、アーキテクチャ図、インフラ構成図、ネットワーク構成図、VPC の図を描いてほしいとき、draw.io で AWS の図を作りたいとき、既存の構成図を直したいときは必ずこの Skill を使う。Use this whenever the user asks for an AWS architecture diagram, cloud infrastructure diagram, VPC diagram, or a draw.io file of AWS resources, even if they don't say "draw.io". Mermaid、PlantUML、Python の diagrams ライブラリなど、ほかの形式を指定されたときは使わない。Do not use it when the user explicitly asks for Mermaid, PlantUML, or the Python diagrams library.

AWS 構成図を draw.io で描く

この図が目指すもの

見た人が、どのサービスがどのネットワークの境界の中にあり、リクエストやデータがどこからどこへ流れるかを、図だけで追えること。

構成が読めることを優先し、見栄えのための要素は足さない。タイトル、番号付きのバッジ、凡例のような装飾は、情報を増やす一方で図を読みにくくする。アイコンを色付きの枠で囲むと、公式アイコンをそのまま置いた図に見えなくなる。

進め方

  1. 構成を把握する。登場するサービス、置き場所(VPC の内か外か、どのサブネットか)、つながりを書き出す
  2. 配置を決める。下の「配置」の決まりに沿って、枠の入れ子と各アイコンの座標を先に決める
  3. XML を分けて書く。枠、アイコン、線の順に、何回かに分けてファイルへ足していく
  4. draw.io の CLI で PNG に書き出し、自分の目で確かめる
  5. 書いたもの、描かなかったもの、迷ったところを伝える

3 で分けるのは、1回の応答で XML を丸ごと書くと出力の上限に当たって落ちることがあるため。

座標を計算するスクリプトなどの作業用のファイルは、/tmp ではなく出力先と同じディレクトリに置く。消さずに残し、最後の説明でどのファイルを残したかを伝える。/tmp に置くと、同時に動いている別の作業のファイルと名前がぶつかることがある。

座標は自分で決める。draw.io CLI の --layout(自動配置)は使わない。枠の入れ子や上下の位置に意味がある図なので、自動配置で動かされると崩れる。

draw.io の CLI

PNG への書き出しには draw.io desktop の CLI を使う。まず which drawio で PATH にあるかを見る。無ければ references/cli.md の OS ごとの場所を探す。画面の無い Linux や WSL2 での呼び方もそこにある。

書き出しはこう叩く。-e で PNG の中に図の XML を埋め込むので、PNG を draw.io で開けば編集できる。

drawio -x -f png -e -b 10 -o diagram.drawio.png diagram.drawio

書き出す前に python3 -c "import sys, xml.dom.minidom; xml.dom.minidom.parse(sys.argv[1])" diagram.drawio で XML が壊れていないかを確かめる。壊れた XML でも CLI はエラーを出さず、何も描かれていない小さな PNG を作るので、PNG ができたことは成功の証拠にならない。CLI が sandbox_extension_issue_file failed のような警告を出しても、図が描かれていれば問題ない。書き出した画像で、線がラベルの文字に重なっていないか、アイコンが枠からはみ出していないか、アイコンの絵が出ているかを見る。直したら書き出し直す。

CLI が見つからなければ書き出しは飛ばす。そのときは上の検査で XML が壊れていないことだけ確かめ、目で確かめていないことを最後に伝える。

依頼に無いもの

依頼どおりに動かすと必ず要るものは、依頼に書かれていなくても描く。NAT Gateway や外向きの ALB を置く VPC の Internet Gateway が代表で、描かないと、動かない構成の図になる。足したものは最後の説明で伝える。

要るかどうかが構成の選び方で変わるもの(VPC エンドポイント、踏み台のサーバーなど)は足さない。描いていないことを最後の説明で伝える。

配置

利用者は図の上端に置く。リクエストが上から下へ流れる向きにそろえると、入れ子の深さと縦の位置が対応して読みやすい。

枠は外から AWS Cloud、リージョン、VPC、アベイラビリティゾーン、サブネットの順に入れ子にする。

VPC の外で動くものは、グローバルなサービスかリージョンのサービスかで置き場所を分ける。CloudFront、Route 53、CloudFront に付ける WAF、Lambda@Edge、IAM のようなグローバルなサービスは、AWS Cloud の枠の中、リージョンの枠の外に置く。S3、CloudWatch、Cognito、Lambda、DynamoDB、ECR のようなリージョンのサービスは、リージョンの枠の中、VPC の枠の外に置く。リージョンの枠の外に S3 を置くと、どのリージョンのバケットか読めなくなる。どちらか迷うサービスは、作るときにリージョンを選ぶかどうかで決める。

アベイラビリティゾーンは横に並べ、各ゾーンの中はパブリックサブネットを上、プライベートサブネットを下に置く。インターネットに近いものほど上に来るので、リクエストの流れと向きがそろう。

各ゾーンでは、リクエストの本流になるアイコン(ECS や EC2、データベースなど)を縦一列にそろえ、その列をサブネットの横幅の中央に置く。アイコンの x 座標は、サブネットの幅の半分からアイコンの幅の半分を引いた値にする。ALB と NLB はこの列に入れず、下の「よく出るサービスの描き方」のとおり AZ の境目に1つ置く。NAT Gateway のように本流から外れるものは、パブリックサブネットの中で ALB と反対側(AZ の外側寄り)に置く。本流を片側に寄せると、反対側が何も無い区画として残り、どれが主役か分かりにくくなる。

アベイラビリティゾーンは ap-northeast-1a のように正式名称で書く。「AZ A」「ゾーン1」のような略記にすると、どのリージョンの構成かが図から読めなくなる。リージョンの指定がなければ、会話の言語から妥当なものを選ぶ。日本語なら東京(ap-northeast-1)が自然で、枠の名前に「東京リージョン」のように地名を添えてよい。指定が無くて選んだときは、どのリージョンにしたかを最後に伝える。

アイコンは 60x60 にする。間隔はラベルと線のラベルが収まる最小限にとどめ、広げすぎない。図が広がると、記事や画面に載せたとき全体が縮み、アイコンも文字も小さく見える。目安は、同じ行に並ぶアイコンの中心どうしが横 140 前後、同じ列が縦 160 前後。あいだに線のラベルが入るときだけ縦 210 程度まで広げる。ラベルの付いた横向きの線でつなぐアイコンどうしは、ラベルの幅に左右 20 ずつ足した分だけあいだを空ける。fontSize=12 の日本語なら1文字およそ 12 で、「ログ・メトリクス」なら中心どうしを 200 前後にする。枠の内側の余白は 20 から 30 にする。

VPC の外に置くリージョンのサービス(S3、CloudWatch、Cognito など)は、VPC の右に縦一列に並べる。それぞれの高さは、つながる相手の高さに合わせる。S3 なら、VPC の中から読み書きするサービス(ECS など)があればその高さ、CloudFront から配信するだけならリージョンの枠の上端近くにする。CloudFront はリージョンの枠の外にあるので、同じ高さには置けない。CloudWatch はログを送るサービスの高さにする。置く側をそろえると、回ごとに位置が変わらない。VPC から離しすぎず、VPC の枠との間は 60 から 80 にする。VPC の無い構成では、本流の列の右に並べる。書き出した PNG で、枠の中やサービスのあいだに何も無い区画が目立てば、座標を詰めて書き出し直す。

アイコン

AWS 公式の AWS4 アイコンを使う。四角や丸、文字だけの箱で代用しない。

アイコンはサービス単位にそろえる(shape=mxgraph.aws4.resourceIcon;resIcon=mxgraph.aws4.<名前>)。ALB と NLB も Elastic Load Balancing のサービスアイコンで描き、種類はラベル(「Application Load Balancer」「Network Load Balancer」)で書く。ECS のタスク、S3 のバケット、Lambda の関数のようなリソースアイコンも使わず、そのサービスのアイコンにする。サービスごとに粒度を変えると、同じ依頼でも ALB を四角で描く回と丸で描く回に割れ、同じものが別の種類に見える。サービス単位にそろえるのが一番単純で、回ごとに割れにくい。

リソースアイコン(shape=mxgraph.aws4.<名前>)は、NAT Gateway、Internet Gateway、VPC エンドポイント、Site-to-Site VPN の接続、カスタマーゲートウェイ、Transit Gateway のアタッチメントのように、独立したサービスアイコンを持たない部品にだけ使う。

細かすぎるアイコンは使わない。EC2 のインスタンスの種類別(c5_instance など)や、DB のエンジン別(aurora_mysql_instance など)のアイコンは、違いが絵ではほとんど伝わらない。違いはラベルに書く。

NAT Gateway と Internet Gateway は、専用のリソースアイコン(nat_gateway、internet_gateway)で描く。サービス単位にそろえようとして VPC のアイコンに丸めると、何の機器か分からなくなる。Transit Gateway は本体のリソースアイコンが無いので、サービスアイコン(transit_gateway)で描く。

利用者、インターネット、社内データセンター、カスタマーゲートウェイ、モバイル端末、IoT 機器のような AWS の外のものも、汎用のアイコンで描く。文字だけの箱にしない。

使う名前は references/styles.md の表から選ぶ。表に無いものは draw.io の名前を推測することになるが、draw.io の名前は略称が多く(EKS は eks)、サービス名をそのまま小文字にしても当たらないことがある。名前が違うとアイコンの絵が出ず、色の四角だけになるので、書き出した PNG で必ず確かめる。CLI が無くて書き出せないときは確かめようがないので、表に無いサービスに推測した名前を使ったら、そのことを最後に伝える。

アイコンをそのまま置く。色付きの枠で囲んだり、枠に「Compute」「データベース」のような役割名を載せたりしない。

枠、アイコン、線のスタイル文字列とカテゴリの色は references/styles.md にある。

ラベル

ラベルは常にアイコンの下に置く。スタイルの verticalLabelPosition=bottom を書き換えず、線を避けるためにラベルを上や横へ動かさない。線がラベルにかかりそうなときは、ラベルではなく線のほうを「線」の節のやり方で直す。サービス名は英語の正式名称のまま(Amazon CloudFront、Application Load Balancer)にし、それ以外は会話の言語に合わせる。

枠の名前も同じにする。「AWS Cloud」「VPC」はそのまま書き、リージョン、アベイラビリティゾーン、サブネットは会話の言語で書く。日本語なら「東京リージョン(ap-northeast-1)」「パブリックサブネット」「プライベートサブネット」。枠だけ英語にすると、1枚の図の中で言語が混ざる。最後に伝える説明も会話の言語で書く。

要素の理解に要る短い補足は、ラベルの2行目に添えてよい。「Writer」「Reader」、「us-east-1 で発行」のように、図だけでは分からない役割や制約か、依頼に書かれた区別(「内部向け」など)を書く。図から読めることは書かない。CloudFront の後ろにある ALB に「インターネット向け」と添えても、何も足さない。長い説明文にはしない。

線にもラベルを付ける。「HTTPS」「動的リクエスト」「静的ファイル」「読み書き」「レプリケーション」「ログ・メトリクス」のように、何が流れるかを書く。線のラベルがないと、どの線が何の通信か読めない。ラベルは線の value に書き、線とは別の文字として置かない。別に置くと、線を動かしたときにラベルだけ取り残される。

文字の背景は透明にする。線のラベルは何も書かないと白い箱の上に出て、色の付いた枠の上で浮き、下の枠線も隠す。透明にしただけだと線が文字の真ん中を横切るので、references/styles.md の線の

Read the complete source ↗