AWS アーキテクチャ作図入門/aws-architecture-diagram-101

Update:

2025/8/24 更新 / AWS Summit Japan 2025 ― Community Stageで発表
2024/5/10 更新 / JAWS-UG山形 / re:boot 勉強会で発表
2023/10/8 更新 / JAWS-UG広島21回目＠酒まつりで披露できなかった幻のスライド)
2023/8/12 開催「JAWS-UG静岡 AWS勉強会 202308」における、ソラコム松下(@ma2shita)からの発表資料

Transcript

1. AWS アーキテクチャー作図入門 2025年 Summer Ver. 株式会社ソラコム テクノロジー・エバンジェリスト 松下 享平 (Max / @ma2shita)
2. 株式会社ソラコム テクノロジー・エバンジェリスト 松下 享平 (まつした こうへい) "Max" • 静岡県民 新幹線通勤族 • 講演や執筆を中心に活動、登壇数700以上/累計 • 好きな言葉「論よりコード」 • X(旧Twitter): @ma2shita • 好きな AWS サービス: • AWS IoT Core • AWS IoT Events • AWS CLI • 肌ラボ使ってます WiJG?, Public domain, via Wikimedia Commons NEW!!
3. #AWSSummit
4. AWS アーキテクチャ図の作り方って、 どうやって学びましたか？
5. 作図の基本 正しい使い方で、正しく伝える
6. 一見良さそうに見えるが…？
7. Dark 背景用を 使っていない 改行位置が 正しくない 初出で略称表記 作成時の アイコンが最新でない 枠線(特に色)が 統一されていない こんなにも改善点がある “AWS Cloud” 表記が無い 作成時の 正式名でない
8. 修正後 ※ アイコンは作図当時。2025年6月現在で Amazon API Gateway や Amazon RDS が異なる色へアップデートされている。
9. 最新のアーキテクチャアイコンを使う https://aws.amazon.com/architecture/icons/
10. pptx の中に作図ガイドラインがある(英語)
11. サービス名は2行まで、改行位置に注意 Amazon Simple Queue Service Amazon Simple Queue Service Amazon Simple Queue Service AWS service names must fit on no more than two lines. AWS or Amazon should always be accompanied by the service name. Lines should never break mid-word. ― Slide 15 in AWS Architecture Icon Deck 訳 by DeepL) AWSのサービス名は2行以内に収め なければならない。AWSまたはAmazonは常に サービス名を伴っていなければならない。行は途 中で改行してはならない。 pptx 内の名称表記もこのルールに沿っている 原則は１行、困難な場合にのみ２行とするのが好ましい Amazon Simple Queue Service
12. 名称変更への対応【ガイドラインにはない】 旧 2024年5月現在 時期とリンク AWS Chatbot AWS Q Developer ※ Feb. 19, 2025 Amazon CodeWhisperer Amazon Q Developer ※ Apr. 30, 2024 Amazon Kinesis Data Firehose Amazon Data Firehose Feb. 9, 2024 Amazon Kinesis Data Analytics Amazon Managed Service for Apache Flink Sep. 1st , 2023 AWS Single Sign-On (AWS SSO) AWS IAM Identity Center Jul. 26, 2022 Amazon Elasticsearch Service Amazon OpenSearch Service Sep. 10, 2021 Amazon Managed Apache Cassandra Service Amazon Keyspaces (for Apache Cassandra) Apr. 23, 2020 Amazon CloudWatch Events Amazon EventBridge ※ Jul. 11, 2019 毎年改名が発生、都度確認を忘れずに 《思い込みや慣れはミスの元》 • ※は新サービス内に取り込まれたケース • すべては網羅していません
13. 名称は Amazon Q に聞くこともできる Can I still use the •• name ?
14. 正しい使い方で、正しく伝える ✓ 読み手の負担が減る ✓ 資料と「あなた」の信頼度が上がる 《“俺流” は避けよう》
15. では、どうやって学ぶのか？
16. AWS アーキテクチャ作図を学ぶステップ 1. 最新の AWS アーキテクチャアイコンを入手 2. Examples をお手本に、作図してみる それ以降のステップは？
17. 【最重要】 1. 最新の AWS アーキテクチャアイコンを入手 背景が Light/Dark 向け双方ある • 両方ダウンロードしておく (“General Icons” 以外の違いは見いだせないが) • Note: pptx 内のアイコンは SVG • PNG は “アセットパッケージ” から入手 だいたい四半期毎の更新 • オススメは作図直前にチェック • pptx内「What’s New?」も読んでおこう https://aws.amazon.com/architecture/icons/
18. 2. pptx 内の “Examples” をお手本に作図 同じものをゼロから作ってみる • アイコンの探し方、アイコン同士のつなぎ方、テキストラベルの書き方の 実務がわかる • 作図の経験をしてから Guidelines を読むと、より理解できる・覚えられる
19. アーキテクチャ作図チェックリスト アイコンセット  アイコンは最新か？  背景色に合わせたアイコンを使っているか？ サービス名  名称や機能名は最新か？  初出時に略称を使っていないか？  2行以内に収まっているか？改行位置は適切か？ 作図  枠線や矢印の色使い、太さが統一できているか？  “AWS Cloud” の表記がされているか？ Summer, 2025
20. 今後のステップは？ https://aws.amazon.com/jp/builders-flash/202204/way-to-draw-architecture/ 沿うべきこと、自分流でよいものを見極める
21. 今後のステップは？ 自らのアーキテクチャを作図 • 作成済みの図と Guidelines を見比べる • Guidelines もアップデートされることがある 固有名詞の正式表記は正確に Amazon Complete Font Setの適用で、さらに見やすい図へ https://www.aboutamazon.jp/about-us/leadership-principles リーダーシップ・プリンシプル (Leadership Principles) の 1 節 少ない手間で 作図をしよう あなたの力は、他に使うべき！
22. 生成 AI 活用のヒント • アーキテクチャ図を描画 • アーキテクチャ図のチェック チェックの方が、多くの人に役立ちそう (これからのヒーローへのバトンパス)
23. 皆さんのアウトプットを支援 https://speakerdeck.com/ma2shita/lets-lt-aws-summit-japan-2024 https://speakerdeck.com/ma2shita/aws-architecture-diagram-101
24. 機会があれば、 作図ワークショップをやりたいですね
25. 正しく使って、伝わる作図を！ イケてる
26. IoT の「つなぐ」を簡単に You Create. We Connect.