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

Update:

2023/10/8 内容を更新 (JAWS-UG広島21回目＠酒まつりで披露できなかった幻のスライド)
2023/8/12 開催「JAWS-UG静岡 AWS勉強会 202308」における、ソラコム松下(@ma2shita)からの発表資料。

Transcript

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

   View Slide

2. 株式会社ソラコム
   テクノロジー・エバンジェリスト
   松下 享平 (まつした こうへい)
   "Max"
   • 講演回数 600超/累計
   • JAWS-UG IoT 専門支部
   • AWS ヒーロー (2020年～)
   • 好きな言葉「論より、コード」
   • 好きな AWS サービス
   AWS IoT Core 《今日で8歳!!》
   AWS IoT Events
   Amazon Ember Fonts
   • @ma2shita (お友達になって!)
   WiJG?, Public domain, via Wikimedia Commons
   

   View Slide

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

   View Slide

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

   View Slide

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

   View Slide

6. 修正後
   

   View Slide

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

   View Slide

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

   View Slide

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

   View Slide

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

    View Slide

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

    View Slide

12. アーキテクチャ作図チェックリスト (Oct. 2023)
    アイコンセット
     アイコンセットは最新か？
     背景色に合わせたアイコンを使っているか？
    サービス名
     名称や機能名は最新か？
     初出時に略称を使っていないか？
     1行になっているか？改行せざる得ない時、2 単語目後ろで
    改行をしているか？
    作図
     枠線や矢印の色使いや太さは、統一できているか？
     “AWS Cloud” の表記がされているか？
    

    View Slide

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

    View Slide

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

    View Slide