AWSアーキテクチャ図をスマートに描く方法をいろいろ試してみた

JAWS-UG名古屋 × Media-JAWS@中京テレビ

Transcript

1. JAWS-UG中部 LT AWSアーキテクチャ図をスマートに描 く方法をいろいろ試してみた 菊池 修平 @kiku3_2024 2024/6/27 JAWS-UG中部 2024/06/27 1
2. 自己紹介 菊池修平 愛知県在住 仕事：クライアント企業のクラウド活用・技術支援 2024 Japan AWS All Certifications Engineers JAWS-UG中部 2024/06/27 2
3. 皆さん、AWSアーキテクチャ図を描いてますか？ 私は特に指定がなければパワーポイントやdraw.ioを使うことが多い JAWS-UG中部 2024/06/27 3
4. アーキテクチャ図とは 出典：AWS公式 アーキテクチャダイアグラム作成とは アーキテクチャ図は、ソフトウェアシステムコンポーネントの視 覚的表現を作成するプロセスです。ソフトウェアシステムでは、 アーキテクチャという用語は、さまざまな機能、その実装、およ び相互のインタラクションをいいます。 ソフトウェアは本質的に 抽象的であるため、アーキテクチャ図はシステム内におけるさま ざまなデータの動きを視覚的に示します。また、ソフトウェアが 周囲の環境とどのようにインタラクションするかについても明ら かにします。 “ “ JAWS-UG中部 2024/06/27 4
5. アーキテクチャ図の主なユースケース 構成検討 アイデア共有 提案書作成 設計ドキュメント作成 JAWS-UG中部 2024/06/27 5
6. アーキテクチャ図の描き方に唯一の正解はない 何を表現したいか・伝えたいかによって適した表現は違う -> まずは目的を明確にすることが重要 JAWS-UG中部 2024/06/27 6
7. 参考：AWSアーキテクチャ図のガイドライン AWS公式アイコンセットのパワーポイントがあり、そのなかにアーキ テクチャ図作成のガイドラインが載っています JAWS-UG中部 2024/06/27 7
8. アーキテクチャ図作成に使えるツール例 パワーポイント draw.io PlantUML Mermaid Diagrams Eraser AI JAWS-UG中部 2024/06/27 8
9. 各ツールで作図してみる 生成AI（Claude3.5 Sonet）のサポートも得ながら作成してみる サンプルシステムイメージ ユーザーからのリクエストをもとに生成AIで画像生成して、Slackで送 るシステム JAWS-UG中部 2024/06/27 9
10. draw.io 手軽に作図できる AWS Cloud AWS Lambda Amazon S3 Amazon Cognito Amazon API Gateway Amazon Bedrock Amazon DynamoDB Slack User us-east-1 Authenticate API Request Trigger Store Metadata Store Image アイコンも豊富にあり、割と新しい ちなみにdraw.ioのVScode拡張機能のアイコンは少し古い JAWS-UG中部 2024/06/27 10
11. PlantUML UML図作成用のテキストベースツール アイコンは割と新しい レイアウトが思ったように配置できなかった JAWS-UG中部 2024/06/27 11
12. Mermaid テキストベースの作図ツール AWSアイコンセットがないので、それっぽく見せるためには似たよ うな色と形で工夫が必要 参考：テキストから図が生成できるMermaidでAWS構成図をつくる JAWS-UG中部 2024/06/27 12
13. Diagrams Pythonのコードで図を生成 AWSアイコンセットが古い(2022年)ので、Bedrockがなかった JAWS-UG中部 2024/06/27 13
14. Eraser AI 生成AIを使って自然言語（プロンプト）での作図もできるツール 図をCode化することも可能 JAWS-UG中部 2024/06/27 14
15. 各ツールで作ってみた所感 Eraser AIは自然言語で指示できて画像がすぐ生成されるので、かな り楽だった チームで議論しながらアーキテクチャを考えるときに良いと思う PlantUMLとDiagramsは生成AIとやりとりすることで、割と早く使 える図ができた 生成AIが提示してくるアイコンURLは間違ってることが多かった 生成されたコードを実行したり視覚化する手間がある Mermaidは私が不慣れなこともあり一番苦戦した JAWS-UG中部 2024/06/27 15
16. まとめ アーキテクチャ図で何を伝えたいか目的を明確化したうえで、その 目的にあった表現を選択する 生成AIと協業することを意識してツールを選択する アーキテクチャを考えるのは楽しい JAWS-UG中部 2024/06/27 16
17. 発表は以上です ありがとうございました JAWS-UG中部 2024/06/27 17