こんなアーキテクチャ図はいやだ / Anti-pattern in AWS Architecture Diagrams

2026/04/18 JAWS-UG横浜支部 #100 祝・第100回スペシャル でお話しした内容です。
10個のアーキテクチャ図を書く時に気をつけるポイントをお話ししました。

Transcript

1. 山﨑 奈緒美 2026/4/18 JAWS-UG横浜支部 こんなアーキテクチャ図はいやだ BEYOND THE TIME: 半年後の自分へ贈る10のメッセージ こんなアーキテクチャ図はいやだ BEYOND THE TIME: 半年後の自分へ贈る10のメッセージ
2. ご挨拶と自己紹介 AWS SAMURAI 2015 JAWS-UGアーキテクチャ専門支部 JAWS-UG情シス支部 JAWS FESTA 2024 in 広島 副実行委員長 E-JAWSコミッティ 生活協同組合コープさっぽろ デジタル推進本部 IT統括部 山﨑 奈緒美 大阪出身。 就職で上京し、ソフトハウスでインフラエンジニア 地図情報システム開発会社でひとり情シス 旅行会社の情シス部門でクラウド担当 2020年9月に東京から札幌へ移住し10月よりコープさっぽろへJOIN。 AWSのことならなんでも担当。 @nao_spon I ♡ Route53 IAM Organizations 夏はロードバイク、冬はスノボしてます。仲間募集中！
3. みなさん、 アーキテクチャ図を書いていますか？
4. みなさん、適切な アーキテクチャ図を書いていますか？
5. 不適切なアーキテクチャ図が与える影響 認識齟齬と誤解 実装ミスの誘発 生産性の低下 技術的負債の蓄積 チーム間で同じ図を見ても異なる解釈が生まれ、 設計意図が正確に伝わらない 設計意図の伝達失敗により、 開発段階で想定外の問題が発生し手戻りが増加する 不明瞭な図はレビュー時間を増大させ、 本質的な議論よりも図の解釈に時間を費やす 保守性の悪い図は更新されず、 実態と乖離したドキュメントが技術的負債となる
6. 半年後の自分のために ドキュメントを書く 結果的にみんなのためになるよ！！
7. 前提条件 • アイコンの利用規約を守るのは大前提です ◦ 縦横幅の比率変更、アイコンの色変更はNGです ◦ 他にも細かいところはありますが利用規約を読みましょう • 自社内の設計資料として作成する場合のお話です ◦ 顧客向け提案資料、社外向け資料、イベント登壇資料など シチュエーションによってはマッチしない可能性は大いにあります • AWSアーキテクチャに限らないお話です ◦ 他クラウドでも、オンプレでも共通する話題だと思います
8. 10 Tips of AWS Anti-pattern in Architecture Diagrams
9. 1: 君の名は。
10. 1: 君の名は。 アイコンだけで「誰（役割）」かわからない。あなたの「名前（Role）」は？ AWS Cloud Virtual private cloud (VPC) Private subnet Public subnet
11. 2: 境界線上のアリア
12. 2: 境界線上のアリア 境界（VPC / Subnet）がないから守備範囲が不明。「境界線」を引こう。 AWS Cloud WEBサーバー APサーバー DBサーバー バッチコンテナ 画像保存 画像リサイズ ALB
13. 3: スパイダーマン アクロス・ザ・ネットワーク
14. 3: スパイダーマン：アクロス・ザ・ネットワーク 線が絡まって、データの行き先が追えない。「線の交差」を避けよう。 ECS Task 出荷指示 Worker Worker Worker Worker Worker Worker 位置検索 位置指示 配送先検索 パレット指示 出庫指示 複雑になる場合は分割するのも手
15. 4: Fly Me to the Moon 月はどっちに出ている
16. 4: Fly Me to the Moon / 月はどっちに出ている 矢印の向きがバラバラで、起点が不明。「向き」を右か下へ揃えよう。 API Gateway 商品検索 Lambda 商品発注 Lambda Lambda Authorizer Aurora セッション管理 DynamoDB 商品画像 S3 売価情報 S3 お客様 社員
17. 5: ウォーリーをさがせ！
18. 5: ウォーリーをさがせ！ 情報過多で、見るべき場所が埋もれている。場合によっては分割しよう。
19. 6: 2001年宇宙の旅
20. 6: 2001年宇宙の旅 外部結合先が「モノリス」で謎。「I/Fとプロトコル」を明記しよう。 AWS Cloud Virtual private cloud (VPC) Private subnet Public subnet 上位システム NLB 注文処理ECS 注文データ Aurora
21. 7: おくりびと
22. 7: おくりびと ファイルを「送る（PUT）」のか「取りに行く（GET）」のか。それが問題だ 矢印には必ず メソッド（ PUT / GET / Sync）を書き添えよう APIGateway Lambda ALB ECR データ保存S3 他システム バッチサーバー SecurityGroupやIAMの権限設定にも影響するよ！
23. 8: ユーザーを探して三千里
24. 8: ユーザーを探して三千里 誰が使うのか（アクター）がいなくて迷子。「起点（ユーザー）」を置こう。 AWS Cloud Virtual private cloud (VPC) Private subnet Public subnet ALB 注文処理ECS 注文データ Aurora
25. 9: メメント
26. 9: メメント 10分後にわからなくなる処理順序 Amazon Cognito Lambda Authorizer Lambda AWS WAF APIGateway 順序性のある通信の場合は矢印に番号とどのような処理かを添えよう
27. 10: Not Invented Here 自前主義
28. 10: Not Invented Here : 自前主義 その独立宣言、本当に必要？車輪の再発明をしてない？ Amazon Cognito Lambda Authorizer Lambda AWS WAF データ連携用S3 共通認証基盤 Amazon Cognito 共通データ保存 S3 Bucket 僕たちの存在を 忘れてないかい？ APIGateway
29. まとめ 半年後の自分でも理解できる図を書こう 10のチェックポイント 意識すべきこと 可読性（名前・境界・交差） 誰が見ても一瞬で構造がわかるか？ 密度（向き・拡大） 情報の流れと解像度は適切か？ 文脈（外部・ユーザー） システムの外側にある『物語』を描いているか？ 秩序（時系列・共通化） 独自ルールで迷宮を作っていないか？
30. 半年後の自分のために ドキュメントを書く 結果的にみんなのためになるよ！！