大事だけど AWS 構成図では省略してしまうことが多いサービスについて - サーバーワークスエンジニアブログ

コーヒーが好きな木谷映見です。 今回は小ネタです。AWS 構成図を書く際、省略してしまうことが多いサービスについて思いを馳せました。 よくある？構成図 リージョン アベイラビリティゾーン ルートテーブル AWS IAM インスタンスプロファイル Amazon EBS Elastic IP Elastic network interface（ENI） セキュリティグループ セッションマネージャーする時のエンドポイント 最終構成図 終わりに よくある？構成図 よくあると思われる構成図を描いてみました。 AWS になじみがある方から見ると、 「ふむ、パブリックサブネットとプライベートサブネットに 1 台ずつ EC2 インスタンスがあって、プライベートサブネットのインスタンスにはセッションマネージャーでログインするのかな？S3 バケットもあるな」 くらいの想像ができるかもしれません。 リージョン

[remonoil]

見る人が自由に表示・非表示できるのが欲しい。そもそも自動生成してくれよこの図

[kuzumimizuku]

AWSに限らないけど「現場の人間が現場の構成をざっくり共有するための構成図」と「外向きの説明用の構成図」でレイヤーが違う感覚はある。最終形、構成図として正しくても「もうちょいシンプルに……」と言われそう。

[masatomo-m]

マイベストプラクティスはレイヤ分けできるツールで図を描いて、レイヤ情報付きのデータをメンテすること。細かい奴は別レイヤに描く事で表示・非表示切り替えできる。diagrams.netならフリーだし他社間引継ぎもしやすい

[Shin-JPN]

本当はこの辺ちゃんと書かないと構成図になってない。「省略してる部分は判る」も事実だが、それは今見てるから。AWSのサービス提供形態は変更が早く数年で常識も変わるので誤解される余地は減らしておくべき

[emt0]

ユーザーにAWSの資格持ち居れば省略してもいいけどいつまでもいるとも思わないし基本はゴチャゴチャになるけど全部書いてる。ユーザーはシンプルにしたってどうせ分かんないし（暴論）

[getcha]

オンプレと違うのは、始めに「ざっくり」書いていて未考慮の点があっても後でリカバリーが効く事かな。オンプレは間違うと機器調達に関わるから、はじめから細かく書いて考慮漏れがないか検討している事が多い。

[bugcloud]

AWSの構成図書くときにアイコンだけで書く人がけっこういて、まったく覚えていない自分は検索もできずとてもつらい

[yyamano]

全部を一つの図に書くと読みにくいので視点によって図を分けて欲しい。せめてアプリ、ネットワーク、セキュリティ観点くらいに分割しないと関係者全員が読める図にならないと思う。

[tkni2005]

AZがVPCの中にあるのは違和感があるんだけど公式でもどっちのパターンもあるから気にしないようにしてる

[karia]

いい記事。AZがあることが重要な局面ではAZまで書いたりとか用途によって変えるよね。

[tmatsuu]

どの粒度で書くかはいつも悩ましい問題だ。結構横着しちゃう

[nodat]

よく収まった！

[arumaru]

アイコンだけでなくゲートウェイ名やS3とかのサービス名は省略せずに書いておいてほしい

[THAL]

メモ

[mr_mayama]

いいまとめ。設計では詳細に書くけど公開用ライトアップとかでは省略するからね。

[asa_ca3]

手動でメンテしたくない図ナンバーワン。CDKなりで書いて詳しくはコード見てもらうのが良いと思っている。

[yoneyore]

書くと分かりにくいけど、詳細設計図代わりに置きたい気持ちは分かり見が深い。こういった図もうまく書けるようになればいいのやが。

[d6rkaiz]

誰のために残すかが大事だと思うよ

[ngsw]

けっこう哲学的な話題で『なぜ世界は存在しないのか』で説明されていることの、具体的事例とも感じた

[hateshinaiz]

構成図を書く前に何を伝えたいのか、情報はどこにあるのかをはっきりさせる方が先かな。IAMはどこかにリストされてれば良くて、構成図に無くても構わない。

[noho-sibe]

メガジェットしぶしげが出てきそう

[caelum_et_luna]

レイヤーで分けて作るのいいよね。でもあんまり浸透してない感。

[kuborn]

順番に増えていく紹介の仕方が楽しい。

[ton-boo]

AWS初学者としては設計資料にはこれくらい書いてあってほしい。でも説明相手によってもっと簡潔な図のほうが適していることが多々あるのもわかるんで使い分けるしかない

[mixvox-j]

”この人がいないと何もできないのに、省略されてしまうことが多いサービスナンバーワン、IAM です。”

[amatou310]

わかるけどめっちゃビジーな感じになるよね

[honeybe]

冗長。すべて図に入れる必要は無い。別添で資料を作れば良い(そして作られない別添資料…)

[dUxRZiaA]

意図によりますね。理解してもらうためか、正確さ必要なのか

[sekaiiti]

分かるんだけど、書きすぎるとごちゃごちゃで逆に見難くなるのよね。構成図上はシンプルなくらいで良いんじゃないかなてって思う。構成図上は記事内のAZまでで、提案書や設計書上に文字で残すくらいで充分な気もする

[atico]

NAT Gatewayは書かれることが多いけどこの図で省略されてる？もしくはPrivateLinkを使っている？PrivateLinkも重要だけど、書かれないことが多い。

[tsz]

AWS全然わからんので、全部盛りしてくれると助かる

[vesikukka]

インスタンスプロファイルは別の表で管理するかな。