<p data-line="0" class="code-line">こんにちは！<a href="https://twitter.com/Ryo54388667" target="_blank" rel="nofollow noopener noreferrer">@Ryo54388667</a>です。</p>
<p data-line="2" class="code-line">AWSアーキテクチャ図を正確に作成するための基本的なガイドラインを読んでまとめてみました。</p>
<p data-line="4" class="code-line"><span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__bc68a0e50a5ea" src="https://embed.zenn.studio/card#zenn-embedded__bc68a0e50a5ea" data-content="https%3A%2F%2Ftwitter.com%2FRyo54388667" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://twitter.com/Ryo54388667" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://twitter.com/Ryo54388667</a></p>
<p data-line="6" class="code-line">参考ページ(公式ドキュメント)<br style="display:none">
<span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__cf1a1ee7520a" src="https://embed.zenn.studio/card#zenn-embedded__cf1a1ee7520a" data-content="https%3A%2F%2Faws.amazon.com%2Fjp%2Farchitecture%2Ficons%2F" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://aws.amazon.com/jp/architecture/icons/" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://aws.amazon.com/jp/architecture/icons/</a></p>
<aside class="msg message"><span class="msg-symbol">!</span><div class="msg-content">
<p data-line="10" class="code-line">Release 16-2023.04.28<br>
バージョンです🙏</p>
</div></aside>
<p data-line="14" class="code-line"><strong>(2023/09/25 スライド追記)</strong></p>
<span class="embed-block embed-speakerdeck"><iframe src="https://speakerdeck.com/player/1d87ba8bc34a4eb7a72eb77acf3a8f50" scrolling="no" allowfullscreen allow="encrypted-media" loading="lazy"></iframe></span>
<h2 id="%F0%9F%93%8D-aws%E3%82%A2%E3%83%BC%E3%82%AD%E3%83%86%E3%82%AF%E3%83%81%E3%83%A3%E5%9B%B3-%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6" data-line="18" class="code-line">
<a class="header-anchor-link" href="#%F0%9F%93%8D-aws%E3%82%A2%E3%83%BC%E3%82%AD%E3%83%86%E3%82%AF%E3%83%81%E3%83%A3%E5%9B%B3-%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6" aria-hidden="true"></a> 📍 AWSアーキテクチャ図 について</h2>
<p data-line="20" class="code-line">よくプレゼンテーションやアプリケーションで見かける図のことです。<br>
なかなか、ルールまで確認している人は少ないのではないでしょうか？<br>
僕は雰囲気で書いていたので自戒を込めて書いていきます。。</p>
<p data-line="24" class="code-line">↓ AWSアーキテクチャ図とは、こんな感じのもの<br>
<img src="https://storage.googleapis.com/zenn-user-upload/7db8bd822020-20230918.jpeg" loading="lazy" class="md-img"></p>
<p data-line="27" class="code-line"> <br>
 </p>
<h2 id="%F0%9F%93%8D-%E3%83%AB%E3%83%BC%E3%83%AB%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6" data-line="30" class="code-line">
<a class="header-anchor-link" href="#%F0%9F%93%8D-%E3%83%AB%E3%83%BC%E3%83%AB%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6" aria-hidden="true"></a> 📍 ルールについて</h2>
<h3 id="%E3%82%B0%E3%83%AB%E3%83%BC%E3%83%97%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6%E3%81%AE%E3%83%AB%E3%83%BC%E3%83%AB" data-line="32" class="code-line">
<a class="header-anchor-link" href="#%E3%82%B0%E3%83%AB%E3%83%BC%E3%83%97%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6%E3%81%AE%E3%83%AB%E3%83%BC%E3%83%AB" aria-hidden="true"></a> グループについてのルール</h3>
<ul data-line="33" class="code-line">
<li data-line="33" class="code-line">グループボックスの右下隅を使用してサイズを変更すること。</li>
<li data-line="34" class="code-line">グループ内にさらにグループがある場合、内部のグループには少なくとも0.05のバッファが必要。</li>
</ul>
<p data-line="36" class="code-line">❌ <strong>: NG</strong></p>
<ul data-line="37" class="code-line">
<li data-line="37" class="code-line">承認されていないグループアイコンを利用すること。</li>
<li data-line="38" class="code-line">グループアイコンのサイズを変更すること。</li>
</ul>
<p data-line="40" class="code-line"><img src="https://storage.googleapis.com/zenn-user-upload/4a343c88b665-20230918.jpeg" loading="lazy" class="md-img"></p>
<p data-line="42" class="code-line"> </p>
<p data-line="44" class="code-line">グループについては、僕の場合は、AWS cloud 環境の境界とリージョンとAZくらいしか意識したことないです。<br>
IoTが絡んだり、micro service のアーキテクチャになってくると複雑度が増し、より一層グループを意識することがあるかもですね!</p>
<p data-line="47" class="code-line"> <br>
 </p>
<h3 id="%E3%82%A2%E3%82%A4%E3%82%B3%E3%83%B3%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6%E3%81%AE%E3%83%AB%E3%83%BC%E3%83%AB" data-line="50" class="code-line">
<a class="header-anchor-link" href="#%E3%82%A2%E3%82%A4%E3%82%B3%E3%83%B3%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6%E3%81%AE%E3%83%AB%E3%83%BC%E3%83%AB" aria-hidden="true"></a> アイコンについてのルール</h3>
<ul data-line="51" class="code-line">
<li data-line="51" class="code-line">プレゼンテーションで使用する場合にのみ、スケールアップまたはスケールダウンが許可されている。アイコンの整合性を維持するには、サイズ変更中にShiftキーを押したままにする。</li>
<li data-line="52" class="code-line">アーキテクチャ図の場合は、事前に定義されたサイズのアイコンを使用し、サイズを変更しないこと。</li>
</ul>
<p data-line="54" class="code-line">❌ <strong>: NG</strong></p>
<ul data-line="55" class="code-line">
<li data-line="55" class="code-line">サービスアイコンをトリミングすること。</li>
<li data-line="56" class="code-line">アイコンを反転または回転させること。</li>
<li data-line="57" class="code-line">アイコンの形を変更すること。</li>
</ul>
<p data-line="59" class="code-line"><img src="https://storage.googleapis.com/zenn-user-upload/af8e97df77d1-20230918.jpeg" loading="lazy" class="md-img"></p>
<p data-line="61" class="code-line"> </p>
<blockquote data-line="63" class="code-line">
<p data-line="63" class="code-line">アーキテクチャ図の場合は、事前に定義されたサイズのアイコンを使用し、サイズを変更しないでください。</p>
</blockquote>
<p data-line="65" class="code-line">特に、このルールを破っていた気がします。。反省です。。<br>
<strong>アクセシビリティ等がテストされた上でのサイズ、色なので、 変更してはならん！</strong> ということらしいです。</p>
<p data-line="68" class="code-line">「小さいし、見えづらいから大きくしちゃえっ！！」<br>
これはNGということですね。。</p>
<p data-line="71" class="code-line">テックブログやWeb上にアーキテクチャ図を記載する場合は元のサイズが好ましいということです。</p>
<p data-line="73" class="code-line"> <br>
 </p>
<h3 id="%E7%9F%A2%E5%8D%B0%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6%E3%81%AE%E3%83%AB%E3%83%BC%E3%83%AB" data-line="76" class="code-line">
<a class="header-anchor-link" href="#%E7%9F%A2%E5%8D%B0%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6%E3%81%AE%E3%83%AB%E3%83%BC%E3%83%AB" aria-hidden="true"></a> 矢印についてのルール</h3>
<ul data-line="77" class="code-line">
<li data-line="77" class="code-line">プリセットの矢印を図にコピーして、正しいフォーマットを維持する。編集するには、矢印をクリックし、Shiftキーを押したままにすること。</li>
<li data-line="78" class="code-line">新しく矢印を作成する。プリセット矢印は「Open Arrow」を使用すること。</li>
</ul>
<p data-line="80" class="code-line">❌ <strong>: NG</strong></p>
<ul data-line="81" class="code-line">
<li data-line="81" class="code-line">プリセットまたはデフォルトの矢印以外のものを使用すること</li>
</ul>
<p data-line="83" class="code-line"><img src="https://storage.googleapis.com/zenn-user-upload/0ccb57605811-20230918.jpeg" loading="lazy" class="md-img"></p>
<p data-line="85" class="code-line"> </p>
<p data-line="87" class="code-line">僕なら色を変えそうですが、それもNGっぽいですね！<br>
ちなみに、Open Arrow についてはこの図がわかりやすかったです。<a href="https://www.reddit.com/r/typography/comments/swln0x/rightwards_arrow_glyph_change_for_calibri_in/" target="_blank" rel="nofollow noopener noreferrer">引用URL</a><br>
<img src="https://storage.googleapis.com/zenn-user-upload/8c2652df7dc5-20230918.jpg" loading="lazy" class="md-img"></p>
<p data-line="91" class="code-line"> <br>
 </p>
<h3 id="%E3%82%A2%E3%82%A4%E3%82%B3%E3%83%B3%E3%81%AE%E3%83%A9%E3%83%99%E3%83%AB%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6%E3%81%AE%E3%83%AB%E3%83%BC%E3%83%AB" data-line="94" class="code-line">
<a class="header-anchor-link" href="#%E3%82%A2%E3%82%A4%E3%82%B3%E3%83%B3%E3%81%AE%E3%83%A9%E3%83%99%E3%83%AB%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6%E3%81%AE%E3%83%AB%E3%83%BC%E3%83%AB" aria-hidden="true"></a> アイコンのラベルについてのルール</h3>
<ul data-line="95" class="code-line">
<li data-line="95" class="code-line">AWSのサービス名は2行以下でなければならない。</li>
<li data-line="96" class="code-line">AWSまたはAmazonには常にサービス名を添付する必要がある。</li>
<li data-line="97" class="code-line">行は決して単語の途中で折り返してはいけない。</li>
</ul>
<p data-line="99" class="code-line">❌ <strong>: NG</strong></p>
<ul data-line="100" class="code-line">
<li data-line="100" class="code-line">Elastic BeanstalkのELBやElastic Load Balancingなど、さまざまなサービスの省略形を複製する。</li>
<li data-line="101" class="code-line">「Amazon (改行) サービス名」と表記する。(中央の図)</li>
<li data-line="102" class="code-line">単語の中央で行を変える。(右の図)</li>
</ul>
<p data-line="104" class="code-line"><img src="https://storage.googleapis.com/zenn-user-upload/69a8217c0612-20230918.jpeg" loading="lazy" class="md-img"></p>
<p data-line="106" class="code-line"> </p>
<blockquote data-line="108" class="code-line">
<ul data-line="108" class="code-line">
<li data-line="108" class="code-line">「Amazon (改行) サービス名」と表記する。(中央の図)</li>
<li data-line="109" class="code-line">単語の中央で行を変える。(右の図)</li>
</ul>
</blockquote>
<p data-line="111" class="code-line">これ、やりがちではないでしょうか？<br>
QuickSight でひとくくりで、Quick ( 改行 ) Sight はNGです。<br>
ただ、サービス名がどこからどこまでがひとくくりなのか、僕は判別できないなーと思いました。その都度、ドキュメントを確認ですね。</p>
<p data-line="115" class="code-line"> <br>
 </p>
<h3 id="%E7%95%AA%E5%8F%B7%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6%E3%81%AE%E3%83%AB%E3%83%BC%E3%83%AB" data-line="118" class="code-line">
<a class="header-anchor-link" href="#%E7%95%AA%E5%8F%B7%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6%E3%81%AE%E3%83%AB%E3%83%BC%E3%83%AB" aria-hidden="true"></a> 番号についてのルール</h3>
<ul data-line="119" class="code-line">
<li data-line="119" class="code-line">事前に定義されたサイズ、色で吹き出しを使用しフォーマットすること。</li>
<li data-line="120" class="code-line">左から右、上から下、時計回りなど、できるだけ直線的に番号を並べること。</li>
<li data-line="121" class="code-line">コールアウトの配置はできるだけ一貫すること。</li>
</ul>
<p data-line="124" class="code-line">❌ <strong>: NG</strong></p>
<ul data-line="125" class="code-line">
<li data-line="125" class="code-line">同じ図内でコールアウトサイズを混在させること。</li>
<li data-line="126" class="code-line">コールアウト内の色またはフォントサイズを変更すること。</li>
<li data-line="127" class="code-line">文字やその他の記号を使用すること。</li>
<li data-line="128" class="code-line">コールアウト形状を手動でサイズまたはストレッチすること。</li>
<li data-line="129" class="code-line">新しいコールアウト図形を作成すること。</li>
</ul>
<p data-line="132" class="code-line"><img src="https://storage.googleapis.com/zenn-user-upload/5aa57fdc377d-20230918.jpeg" loading="lazy" class="md-img"></p>
<p data-line="134" class="code-line"> </p>
<p data-line="136" class="code-line">僕はまず、<strong>「callout」</strong> がわかりませんでした。。</p>
<blockquote data-line="137" class="code-line">
<p data-line="137" class="code-line">callout は、イラストや技術図面などの一部に線を引いて、機能などを説明するテキストのこと</p>
</blockquote>
<p data-line="139" class="code-line"><a href="https://note.com/haiji505/n/nb5857bcf8ceb" target="_blank" rel="nofollow noopener noreferrer">こちらの記事</a>がわかりやすかったです。感謝！<br>
矢印や吹き出しで細く説明するようなものをcallout と呼ぶのですね。知らなかったです！</p>
<p data-line="142" class="code-line">いろいろとルールが書かれていますが、<strong>「一貫していること、統一されていること」</strong> が大事ということですね。</p>
<p data-line="145" class="code-line"> <br>
 </p>
<h2 id="%F0%9F%93%8D-%E6%9C%80%E5%BE%8C%E3%81%AB" data-line="148" class="code-line">
<a class="header-anchor-link" href="#%F0%9F%93%8D-%E6%9C%80%E5%BE%8C%E3%81%AB" aria-hidden="true"></a> 📍 最後に</h2>
<p data-line="149" class="code-line">最後に、公式が出している模範的なアーキテクチャ図を載せておきます！</p>
<h3 id="ex.1" data-line="151" class="code-line">
<a class="header-anchor-link" href="#ex.1" aria-hidden="true"></a> ex.1</h3>
<p data-line="152" class="code-line"><img src="https://storage.googleapis.com/zenn-user-upload/3e5dbfb1e96f-20230918.jpeg" loading="lazy" class="md-img"></p>
<p data-line="154" class="code-line"> </p>
<h3 id="ex.2" data-line="156" class="code-line">
<a class="header-anchor-link" href="#ex.2" aria-hidden="true"></a> ex.2</h3>
<p data-line="157" class="code-line"><img src="https://storage.googleapis.com/zenn-user-upload/62711bcdfd38-20230918.jpeg" loading="lazy" class="md-img"></p>
<p data-line="159" class="code-line"> </p>
<p data-line="161" class="code-line">最後まで読んでいただきありがとうございます!<br>
気ままにつぶやいているので、気軽にフォローをお願いします！🥺<br style="display:none">
<span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__697d8c341e177" src="https://embed.zenn.studio/card#zenn-embedded__697d8c341e177" data-content="https%3A%2F%2Ftwitter.com%2FRyo54388667" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://twitter.com/Ryo54388667" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://twitter.com/Ryo54388667</a></p>
<p data-line="165" class="code-line">個人メディアもあります〜<br style="display:none">
<span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__98d1407d6d03" src="https://embed.zenn.studio/card#zenn-embedded__98d1407d6d03" data-content="https%3A%2F%2Fryotablog.jp%2Fblogs%2Fmy-seo-todo-list" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://ryotablog.jp/blogs/my-seo-todo-list" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://ryotablog.jp/blogs/my-seo-todo-list</a></p>


【初心者】AWS アーキテクチャ図を書くときの公式ルールをまとめてみた

📍 AWSアーキテクチャ図 について

アイコンのラベルについてのルール

Discussion