AWS アーキテクチャ作図入門 Summer, 2024 Ver. 株式会社ソラコム テクノロジー・エバンジェリスト 松下 享平 (Max / @ma2shita)

株式会社ソラコム テクノロジー・エバンジェリスト 松下 享平 (まつした こうへい) "Max" • 静岡県民 新幹線通勤族 • 講演や執筆を中心に活動、登壇数600以上/累計 • 好きな言葉「論よりコード」 • AWS ヒーロー (2020年受賞) • 好きな AWS サービス AWS IoT Core AWS IoT Events Amazon Ember Fonts • X(旧Twitter): @ma2shita WiJG?, Public domain, via Wikimedia Commons NEW!!

AWS アーキテクチャ図の作り方って、 どうやって学びましたか？

一見良さそうに見えるが…？

Dark 背景用を 使っていない 改行位置が 正しくない 初出で略称表記 作成時の アイコンが最新でない 枠線(特に色)が 統一されていない だいたいミスる点 “AWS Cloud” 表記が無い 作成時の 正式名でない

修正後 矢印の羽根部分も気を付ける必要あり（上記は修正前）

サービス名は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 AWSのサービス名は2行以内に収めなければならな い。AWSまたはAmazonは常にサービス名を伴っ ていなければならない。行は途中で改行してはな らない。 pptx 内の名称表記もこのルールに沿っている 原則は１行、困難な場合にのみ２行とするのが好ましい Amazon Simple Queue Service

名称変更の例 旧 2024年5月現在 時期とリンク 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 1, 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 Amazon Managed Service for Grafana Amazon Managed Grafana ?? 毎年改名が発生、都度確認を忘れずに 《思い込みや慣れはミスの元》 ⚫ ※は新サービス内に取り込まれたケース ⚫ すべては網羅していません

正しい使い方で、正しく伝わる ✓ 見る側の負担が減る ✓ 資料の信頼度が上がる 《“俺流” は避けよう》

どうやって学ぶ？

AWS アーキテクチャ作図を学ぶステップ 1. 最新の AWS アーキテクチャアイコンを入手 2. Examples をお手本に、作図してみる それ以降のステップは？

【最重要】 1. 最新の AWS アーキテクチャアイコンを入手 背景が Light/Dark 向け双方ある • 両方ダウンロードしておく (“General Icons” 以外の違いは見いだせないが) • Note: pptx 内のアイコンは SVG • PNG は “アセットパッケージ” から入手 だいたい四半期毎の更新 • 作図直前にチェック • pptx内「What’s New?」も読んでおこう https://aws.amazon.com/jp/architecture/icons/

2. pptx 内の “Examples” をお手本に作図 同じものをゼロから作ってみる • アイコンの探し方、アイコン同士のつなぎ方、テキストラベルの書き方の 実務がわかる • 作図の経験をしてから Guidelines を読むと、より理解できる・覚えられる

今後のステップは？ 自らのアーキテクチャを作図 • 作成済みの図と Guidelines を見比べる • Guidelines もアップデートされることがある 固有名詞の正式表記は正確に Amazon Ember Fonts を使うと AWS っぽい資料に https://www.aboutamazon.jp/about-us/leadership-principles リーダーシップ・プリンシプル (Leadership Principles) の 1 節 少ない手間で 作図をしよう あなたの力は、他に使うべき！

アーキテクチャ作図チェックリスト アイコンセット  アイコンは最新か？  背景色に合わせたアイコンを使っているか？ サービス名  名称や機能名は最新か？  初出時に略称を使っていないか？  2行以内に収まっているか？改行位置は適切か？ 作図  枠線や矢印の色使いや太さは、統一できているか？  “AWS Cloud” の表記がされているか？ Summer, 2024

正しく使って、伝わる作図を！ イケてる

IoT の「つなぐ」を簡単に You Create. We Connect.