こんなアーキテクチャ図は嫌だ BEYOND THE TIME: 半年後の自分へ贈る15のメッセージ / 15 of Anti-pattern in AWS Architecture Diagrams

2026/9/5 JAWS SONIC 2026でお話しした内容です。
15個のアーキテクチャ図を書く時に気をつけるポイントをお話ししました。

Transcript

1. #jawsug #jawssonic2026 こんなアーキテクチャ図は嫌だ BEYOND THE TIME: 半年後の自分へ贈る10のメッセージ JAWS-UGアーキテクチャ専門支部 山﨑 奈緒美
2. ご挨拶と自己紹介 AWS SAMURAI 2015 JAWS-UGアーキテクチャ専門支部 JAWS-UG情シス支部 JAWS FESTA 2024 in 広島 副実行委員長 E-JAWSコミッティ 大阪出身。 就職で上京し、ソフトハウスでインフラエンジニア 地図情報システム開発会社でひとり情シス 旅行会社の情シス部門でクラウド担当 2020年9月に東京から札幌へ移住し10月よりコープさっぽろへJOIN。 AWSのことならなんでも担当。 I♡ Route53 生活協同組合コープさっぽろ デジタル推進本部 IT統括部 山﨑 奈緒美 IAM Organizations 夏はロードバイク、冬はスノボしてます。仲間募集中！ @nao_spon
3. みなさん、 アーキテクチャ図を書いていますか？
4. みなさん、適切な アーキテクチャ図を書いていますか？
5. 不適切なアーキテクチャ図が与える影響 認識齟齬と誤解 チーム間で同じ図を見ても異なる解釈が生まれ、 設計意図が正確に伝わらない 実装ミスの誘発 設計意図の伝達失敗により、 開発段階で想定外の問題が発生し手戻りが増加する 生産性の低下 不明瞭な図はレビュー時間を増大させ、 本質的な議論よりも図の解釈に時間を費やす 技術的負債の蓄積 保守性の悪い図は更新されず、 実態と乖離したドキュメントが技術的負債となる
6. アーキテクチャ図を描くときの極意 読み手に考えさせない 解読させない 「パッと見でわかるように」を心がける
7. アーキテクチャ図を描くときの極意 半年後の自分のために ドキュメントを書く 結果的にみんなのためになるよ！！
8. 前提条件 • アイコンの利用規約を守るのは大前提です ◦ 縦横幅の比率変更、アイコンの色変更はNGです ◦ 他にも細かいところはありますが利用規約を読みましょう • 自社内の設計資料として作成する場合のお話です ◦ 顧客向け提案資料、社外向け資料、イベント登壇資料など シチュエーションによってはマッチしない可能性は大いにあります • AWSアーキテクチャに限らないお話です ◦ 他クラウドでも、オンプレでも共通する話題だと思います
9. 10 Tips of AWS Anti-pattern in Architecture Diagrams
10. 10 Tips of AWS Anti-pattern in Architecture Diagrams
11. 15 Tips of AWS Anti-pattern in Architecture Diagrams
12. #jawsug #jawssonic2026
13. 1: 君の名は。
14. 1: 君の名は。 アイコンだけで「誰（役割）」かわからない。あなたの「名前（Role）」は？ AWS Cloud Virtual private cloud (VPC) Public subnet Private subnet
15. 2: 境界線上のアリア
16. 2: 境界線上のアリア 境界（VPC / Subnet）がないから守備範囲が不明。「境界線」を引こう。 AWS Cloud ALB WEBサーバー APサーバー DBサーバー 画像リサイズ 画像保存 バッチコンテナ
17. 3: スパイダーマン アクロス・ザ・ネットワーク
18. 3: スパイダーマン：アクロス・ザ・ネットワーク 線が絡まって、データの行き先が追えない。「線の交差」を避けよう。 ECS Task 出荷指示 位置検索 位置指示 配送先検索 パレット指示 出庫指示 Worker Worker Worker Worker Worker Worker 複雑になる場合は分割するのも手
19. 4: Fly Me to the Moon 月はどっちに出ている
20. 4: Fly Me to the Moon / 月はどっちに出ている 矢印の向きがバラバラで、起点が不明。「向き」を右か下へ揃えよう。 社員 お客様 API Gateway 商品検索 Lambda 商品画像 S3 商品発注 Lambda Lambda Authorizer Aurora 売価情報 S3 セッション管理 DynamoDB
21. 5: ウォーリーをさがせ！
22. 5: ウォーリーをさがせ！ 情報過多で、見るべき場所が埋もれている。場合によっては分割しよう。
23. 6: 2001年宇宙の旅
24. 6: 2001年宇宙の旅 外部結合先が「モノリス」で謎。「I/Fとプロトコル」を明記しよう。 AWS Cloud Virtual private cloud (VPC) Public subnet 上位システム NLB Private subnet 注文処理ECS 注文データ Aurora
25. 7: おくりびと
26. 7: おくりびと ファイルを「送る（PUT）」のか「取りに行く（GET）」のか。それが問題だ 矢印には必ず メソッド（ PUT / GET / Sync）を書き添えよう APIGateway Lambda データ保存S3 ALB 他システム バッチサーバー ECR SecurityGroupやIAMの権限設定にも影響するよ！
27. 8: ユーザーを探して三千里
28. 8: ユーザーを探して三千里 誰が使うのか（アクター）がいなくて迷子。「起点（ユーザー）」を置こう。 AWS Cloud Virtual private cloud (VPC) Public subnet ALB Private subnet 注文処理ECS 注文データ Aurora
29. 9: メメント
30. 9: メメント 10分後にわからなくなる処理順序 Amazon Cognito Lambda Authorizer AWS WAF APIGateway Lambda 順序性のある通信の場合は矢印に番号とどのような処理かを添えよう
31. 10: Not Invented Here 自前主義
32. 10: Not Invented Here : 自前主義 その独立宣言、本当に必要？車輪の再発明をしてない？ 共通認証基盤 Amazon Cognito Amazon Cognito 僕たちの存在を 忘れてないかい？ AWS WAF 共通データ保存 S3 Bucket APIGateway Lambda Authorizer Lambda データ連携用 S3
33. 11: AIハヤトにおまかせ！
34. 11: AIハヤトにおまかせ！ 生成AIに作らせるのはいいけど、ちゃんと確認した？ AWS Cloud ap-northeast-1(東京リージョン) Virtual private cloud (VPC) Public subnet Private subnet Amazon WorkChrono 打刻コアエンジン バッチ実行 最適化ジョブ HTTPS Cloud Front CDN ALB 負荷分散 HTTP ECS Fargate 勤怠API Aurora MySQL AWS Braket 残業シフト計算 PC/スマホ 計算結果取り込み 図を作るのはAI、説明責任を負うのはあなた
35. 12: シン・勤怠管理システム
36. 12: シン・勤怠管理システム どれが本当の最新？ 勤怠管理システム(2005) → 新勤怠管理システム(2012) → 次世代勤怠管理システム(2018) → シン・勤怠管理システム(イマココ) → ？？？(2030) 「アーキテクチャ図」ではないけれど、システム名の命名も大事です。
37. 13: 翔んでLambda
38. 13: 翔んでLambda Lambdaアイコンにはそこらへんの草でも食わせておけ！ ※画像はイメージです AWS Cloud キャンペーン 登録 キャンペーン 検索 ポイント登録 ポイント計算 キャンペーン 重複確認 キャンペーン ステータス更新 ポイント付与 ポイント 有効期限確認 アイコンの利用規約を守るのは大前提です 機能や役割をビジュアルで表現したい場合は枠で囲んだり、説明書きで表現しよう ※画像はイメージです。あくまでもアンチパターンのご紹介のためのものです
39. 14: ちいかわ 〜アーキ図のひけつ〜
40. 14: ちいかわ 〜アーキ図のひけつ〜 なんか小さくて読めないやつ（フォントサイズ2pt） AWS Cloud Virtual private cloud (VPC) Public subnet ALB Private subnet WEBサーバー バッチサーバー データベース Aurora MySQL 手元で読ませるなら最低12pt(日本語なら14pt)。投影するなら18pt以上推奨 アイテムが多く全体を表示すると広大になる場合は抽象化＆分割しよう →参考 5: ウォーリーをさがせ！パターン
41. 15: 君の名は2 〜前前前ページ〜
42. 15: 君の名は2 〜前前前ページ〜 前作は名前がなかった。今作は、ページをめくるたび名前が変わる。 ——お前、誰だ？ Yoyaku Kanri System アーキテクチャ図 Yoyaku Kanri System 詳細設計書 サーバー構成 ・ 予約管理サーバ ・ データベースサーバー ・ バッチサーバー YKS-ONE DBサーバ ソフトウェア構成 予約管理サーバ ・ Apache 2.4 ・ Tomcat 11 Yoyaku Kanri System 運用マニュアル マスタデータ手動取り込み手順 YKシステムコントローラにアクセ スし、管理者ユーザーでログイン します。 メニューで「管理者モード」をク リックします。 図を分割した場合や、各種設計書等の文書での名前表記を統一しよう
43. まとめ 半年後の自分でも理解できる図を書こう 10のチェックポイント 意識すべきこと 可読性（名前・境界・交差） 誰が見ても一瞬で構造がわかるか？ 密度（向き・拡大・サイズ） 情報の流れと解像度は適切か？ 文脈（外部・ユーザー） システムの外側にある『物語』を描いているか？ 秩序（時系列・共通化） 独自ルールで迷宮を作っていないか？ 作法（アイコン利用規約） 公式アイコンの色変更・アスペクト比を勝手に変えていないか？ 責任(AI・検証) AIが描いた図を確認したか？あなたの言葉で説明できるか?
44. アーキテクチャ図を描くときの極意 読み手に考えさせない 解読させない 「パッと見でわかるように」を心がける
45. アーキテクチャ図を描くときの極意 半年後の自分のために ドキュメントを書く 結果的にみんなのためになるよ！！
46. 余談： 私がアーキテクチャ図レビュー時に見ているポイント • システム概要 ◦ システム名 ◦ どのようなことをするシステムか ◦ 利用者は誰なのか ◦ インターネットからのアクセスがあるか ◦ 他システム連携はあるか ◦ リソース作成、保守運用は誰が行うか ※人によっては違う観点で見ているかもしれません
47. 余談： 私がアーキテクチャ図レビュー時に見ているポイント • システム構成はどのようになっているか ◦ 内部で規定しているAWS利用ガイドラインに沿っているか ◦ ベストプラクティスに則っているか ◦ 記載されているAWSサービスの選定根拠 ◦ システムの規模感に対して過剰 or 過小ではないか ◦ コスト感が見合っているか ◦ 共通で用意してあるものを使っているか ※人によっては違う観点で見ているかもしれません
48. #jawsug #jawssonic2026