drawio-aws

Files (1)

• SKILL.md

SKILL.md (first lines)

# draw.io AWS Architecture Diagram Skill

draw.io スキルのラッパー。AWS アーキテクチャ図を作成する際の AWS 4 シェイプライブラリの使い方と注意点をまとめたもの。

基本的な draw.io の操作（XML 構造、エクスポート、CLI）は `/drawio` スキルに従う。このスキルは AWS 固有の知識を補完する。

## AWS 4 アイコンのスタイル

直接シェイプ（`shape=mxgraph.aws4.*`）を使用する。`fillColor` は必須 — 指定しないと CLI エクスポート時にアイコンが透過になる。

### ベーステンプレート

```xml
<mxCell id="example" parent="1"
  style="outlineConnect=0;fontColor=#232F3E;gradientColor=none;fillColor=#XXXXXX;strokeColor=none;dashed=0;verticalLabelPosition=bottom;verticalAlign=top;align=center;html=1;fontSize=11;fontStyle=0;aspect=fixed;pointerEvents=1;shape=mxgraph.aws4.SHAPE_NAME;labelBackgroundColor=#FFFFFF;"
  value="Label" vertex="1">
  <mxGeometry height="60" width="60" x="0" y="0" as="geometry" />
</mxCell>
```

### カテゴリ別 fillColor

| カテゴリ | fillColor | 主なシェイプ（直接シェイプ名） |
| --- | --- | --- |
| Compute | `#ED7100` | `lambda_function` |
| Database | `#C925D1` | `dynamodb`, `dynamodb_stream`, `rds`, `aurora` |
| Storage | `#3F8624` | `s3`, `s3_glacier`, `efs` |
| App Integration | `#E7157B` | `sns`, `queue`（SQS）, `eventbridge`, `step_functions` |
| Internet of Things | `#7AA116` | `iot_core`, `iot_greengrass` |
| Management | `#E7157B` | `parameter_store`, `cloudwatch`, `cloudformation` (App Integration と同色は draw.io AWS4 ライブラリの仕様) |
| Networking | `#8C4FFF` | `vpc`, `elb`, `route53`, `cloudfront`, `api_gateway` |
| Security | `#DD344C` | `iam`, `cognito`, `kms`, `waf` |
| General | `#232F3E` | `endpoint`, `client`, `user` |

### 直接シェイプ名の罠

`shape=mxgraph.aws4.X` の `X` は AWS サービス名そのままとは限らない。シェイプ名が間違っていると塗り潰された矩形のみ描画され、アイコンは出ない。検証済みの動作可否は以下。

| サービス | 動作する直接シェイプ名 | 動作しない名前 |
| --- | --- | --- |
| SQS | `queue` | `simple_queue_service`, `sqs` |
| SNS | `sns` | - |
| EventBridge | `eventbridge` | `amazon_eventbridge` |
| Lambda | `lambda_function` | - |
| DynamoDB | `dynamodb` | - |
| IoT Core | `iot_core` | - |

新しいサービスを追加した際は必ず CLI で SVG エクスポートし、アイコンが描画されているか確認する。

`resourceIcon` ラッパー（`shape=mxgraph.aws4.resourceIcon;resIcon=mxgraph.aws4.X`）を使う代替手段もあるが、矩形背景 + 白アイコンの見た目になるため、直接シェイプとは混在させない。

### グループコンテナのスタイル

グループシェイプでは枠線色に `stroke=` を使用する（通常セルの `strokeColor=` とは異なる。draw.io エディタが生成する仕様）。

**重要**: すべてのコンテナに `container=1;pointerEvents=0;` を付与する。これがないと子要素のドラッグやエッジ接続が正しく動作しない。

```xml
<!-- AWS Cloud -->
<mxCell style="...shape=mxgraph.aws4.group;grIcon=mxgraph.aws4.group_aws_cloud_alt;stroke=#232F3E;fillColor=none;container=1;pointerEvents=0;..." />

<!-- VPC -->
<mxCell style="...shape=mxgraph.aws4.group;grIcon=mxgraph.aws4.group_vpc2;stroke=#8C4FFF;fillColor=none;container=1;pointerEvents=0;..." />

<!-- Availability Zone -->
<mxCell style="...shape=mxgraph.aws4.group;grIcon=mxgraph.aws4.group_availability_zone;stroke=#007CBC;fillColor=none;container=1;pointerEvents=0;..." />

<!-- Corporate Data Center / External -->
<mxCell style="...shape=mxgraph.aws4.group;grIcon=mxgraph.aws4.group_corporate_data_center;stroke=#147EBA;fillColor=none;container=1;pointerEvents=0;..." />

<!-- 論理グループ（破線枠、AWS グループアイコンなし） -->
<mxCell style="rounded=1;whiteSpace=wrap;html=1;fillColor=none;dashed=1;dashPattern=8 4;strokeColor=#666666;verticalAlign=top;align=left;fontSize=14;fontStyle=1;spacingLeft=10;spacingTop=5;strokeWidth=1;container=1;pointerEvents=0;" />
```

## テキストサイズ

| 要素 | fontSize | 用途 |
| --- | --- | --- |
| アイコンラベル | 13 | メインフローおよび補助サービスのラベル |
| 補助アイコンラベル | 12 | DLQ 等の小型アイコン |
| 注釈テキスト | 12 | 補足説明、脚注 |
| セクションラベル | 14 | Data Layer 等のグループラベル（fontStyle=3: bold+italic） |
| コンテナラベル | 14 | AWS Cloud, VPC 等（fontStyle=1: bold） |
| タイトル | 18 | 図全体のタイトル（fontStyle=1: bold） |
| 凡例テキスト | 13 | Legend のテキスト |

ベーステンプレートの `fontSize=11` はデフォルト値。ユーザーから指定がなければ上記を適用する。

## レイアウトガイドライン

- アイコンサイズ: メイン 60x60、補助（DLQ 等）48x48
- ノード間隔: 水平 160px 以上、垂直 120px 以上（ブランチ間 200px 推奨）
- 座標はグリッド 10px 単位に揃える
- メインフロー（左→右）は同じ Y 座標に配置

### コンテナサイズ

コンテナ（AWS Cloud, 論理グループ等）は中身に合わせてタイトに配置する。右や下に大きな余白が残ると「未完成」「ノードを追加し忘れた」印象を与える。

- 最右要素から 20-50px のパディングで右辺を切る
- 最下要素から 20-50px のパディングで下辺を切る
- 凡例は AWS Cloud 外（下部 / 右部）に出すか、コンテナ内の確実に空いている領域に収める

### 多出力ノードの配置

Lambda が複数の宛先に分岐する場合、宛先群の重心 Y に揃えると矢印交差を最小化できる。

- 例: Uplink Lambda が下方の DB 群と右方の SQS に出力する場合 → コンテナ下段に配置すると経路が短く済む
- Bridge 内に Uplink/Downlink を上下に並べる際、対応する x04 の段（DL 行 / UL 行）と Y を合わせる
- 出射ポイントを左 / 右 / 下に分散させ（`exitX/exitY` で制御）、同方向への出射は 30px 以上間隔を空ける

### ラベル配置

デフォルトはアイコン下（`verticalLabelPosition=bottom;verticalAlign=top;align=center`）。
メインフロー矢印と干渉する場合は右側ラベルに切り替える。

```xml
<!-- 右側ラベル（矢印との重なり回避用） -->
labelPosition=right;verticalLabelPosition=middle;verticalAlign=middle;align=left;spacingLeft=10;

From rysk-tanaka/skills, MIT.

More from rysk-tanaka/skills