Skip to content

Commit a3a2375

Browse files
authored
Merge pull request #1738 from future-architect/feature
AWS設計ガイドライン
2 parents a6763ed + bec2bc9 commit a3a2375

File tree

6 files changed

+167
-1
lines changed

6 files changed

+167
-1
lines changed

.textlintrc

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -60,7 +60,8 @@
6060
"ヽ(*゚д゚)ノ",
6161
"パソコン通信",
6262
"あるある",
63-
"まあまあ"
63+
"まあまあ",
64+
"Session Manager"
6465
]
6566
}
6667
},
Lines changed: 165 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,165 @@
1+
---
2+
title: "AWS設計ガイドラインを公開しました"
3+
date: 2025/12/12 00:00:00
4+
postid: a
5+
tag:
6+
- AWS
7+
- ガイドライン
8+
category:
9+
- Infrastructure
10+
thumbnail: /images/2025/20251212a/thumbnail.jpg
11+
author: 神崎 林太郎
12+
lede: "フューチャー社内の有志のメンバーでAWS設計ガイドラインを作成しました。この記事では、ガイドライン策定の目的と、その内容を抜粋して紹介します。"
13+
---
14+
<img src="/images/2025/20251212a/top.jpg" alt="" width="1024" height="559">
15+
16+
# はじめに
17+
18+
Technology Innovation Groupの神崎です。
19+
20+
フューチャー社内の有志のメンバーで[AWS設計ガイドライン](https://future-architect.github.io/arch-guidelines/documents/forAWS/aws_guidelines.html)を作成しました。
21+
22+
<a href="https://future-architect.github.io/arch-guidelines/documents/forAWS/aws_guidelines.html">
23+
<img src="/images/2025/20251212a/index.png" alt="" width="488" height="317">
24+
</a>
25+
26+
この記事では、ガイドライン策定の目的と、その内容を抜粋して紹介します。
27+
28+
# ガイドライン策定の目的
29+
30+
詳細はガイドライン冒頭に記載していますが、ベストプラクティスを形式知化していくというのが第一の目的です。第二に、設計のベースラインを提供することで、システム固有で考えるべきところ(すなわち設計作業で重要なところ)に時間が使えるようにして、結果として設計品質を底上げできることを目指しています。
31+
32+
そのため、システムを跨いで再利用可能な部分に特に着目しています。
33+
34+
ちなみに、Geminiにガイドラインの目的を問うたところ次の回答でした。上記の思いやエッセンスは取り込めているのではないかと思います。
35+
36+
> クラウドファーストが標準となり、システム構築においてAWSを採用することは特別なことではなくなりました。しかし、各プロジェクトにおいて以下のような「非機能要件」や「共通コンポーネント」の設計議論が繰り返されている現状があります。
37+
>
38+
> - マルチアカウント環境の境界線(OU設計)はどうあるべきか
39+
> - 監査ログ(CloudTrail等)の集約とコスト最適化のバランス
40+
> - ワークロード(Web API/バッチ)に応じた適切なコンピューティングリソースの選定
41+
>
42+
> これらはシステムごとの差異が本来少ない領域です。ここを毎回ゼロベースで検討することは、いわゆる「車輪の再発明」に他なりません。
43+
> 設計者が本来注力すべきは、そのシステム固有のビジネスロジックやドメイン要件の実現です。
44+
>
45+
> 本ガイドラインは、これら共通化可能な設計領域を **「形式知」** として体系化し、設計品質の均質化と開発生産性の向上を目的として策定されました。
46+
47+
# ガイドラインの内容のご紹介
48+
49+
ガイドラインの主要なポイントを要約して紹介します。
50+
51+
## マルチアカウントを利用した環境分離パターン
52+
53+
アカウントの移譲や引き渡しも意識した環境分離パターンを解説しています。
54+
55+
どのようなリソースについてアカウントを分離すべきか、どのような階層構造でアカウントを作るべきかを整理しています。
56+
57+
**関係するサービス**:
58+
59+
- AWS Organizations
60+
- AWS IAM
61+
- AWS Control Tower
62+
63+
## すべてのアカウントが対応すべきセキュリティ対策
64+
65+
最低限、開発・検証環境であっても講じるべきセキュリティ対策について整理しています。
66+
ガイドラインを機械的に適用するのではなく、インシデントや設定不備の検知に必要な設定や、検知された際の対応手順を記載しています。
67+
68+
**関係するサービス**:
69+
70+
- AWS Security Hub CSPM
71+
- AWS CloudTrail
72+
- Amazon GuardDuty
73+
- Amazon Inspector
74+
- Amazon Macie
75+
76+
## 取り扱う情報の機密性や種別、各種監査基準やセキュリティ基準への対応の仕方
77+
78+
前述のセキュリティ対策に加え、厳密な監査基準やセキュリティ基準へ準拠する必要がある場合の対応方針を解説しています。利用するサービスとしては上の章と共通するところは多いですが、この章独自の要素として、データをどのように取り扱えば各基準に準拠できるかまでを整理しています。
79+
80+
**関係するサービス**:
81+
82+
- AWS Security Hub CSPM
83+
- AWS Config
84+
- AWS CloudTrail
85+
- Amazon GuardDuty
86+
- Amazon Inspector
87+
- Amazon Macie
88+
- AWS Firewall Manager
89+
- AWS IAM Access Analyzer
90+
91+
## コストの最適化
92+
93+
コスト最適化の手段として、どのような観点(ディメンション)で可視化を進めるべきか、推奨事項をまとめています。また、大きくコストを削減するための手段としてリセーラーの活用や、コンピュートとストレージの最適化手段などを解説しています。
94+
95+
**関係するサービス**:
96+
97+
- Savings Plans
98+
- Amazon S3
99+
100+
## 踏み台サーバー
101+
102+
VPC内でのオペレーションを安全に行うためにどのようなサービスを利用すべきかを解説しています。
103+
104+
**関係するサービス**:
105+
106+
- Amazon EC2
107+
- AWS Systems Manager (Session Manager)
108+
- EC2 Instance Connect Endpoint
109+
110+
## アプリ特性に応じたアーキテクチャパターン
111+
112+
Web API、バッチ処理、非同期処理(キュー)など、様々なユースケースごとに、どのようなサービスが利用できるのかを整理しています。また、各方式のメリット・デメリットを比較した上で、処理特性や要件に応じて推奨値について解説しています。
113+
114+
**関係するサービス**:
115+
116+
- Amazon API Gateway
117+
- Amazon CloudFront
118+
- Elastic Load Balancing (ALB / NLB)
119+
- AWS Lambda
120+
121+
## CloudWatch
122+
123+
CloudWatchの特性を踏まえたロググループの推奨利用方法や、各サービスで何を監視すべきなのかの指針をまとめています。
124+
125+
**関係するサービス**:
126+
127+
- Amazon CloudWatch
128+
129+
## CI/CD
130+
131+
AWSリソースを作成するCI/CDパイプラインとしてどのようなサービスが利用できるのかを整理した上で、推奨値を解説しています。併せてCIとCDの分離のパターンについても指針をまとめています。
132+
133+
**関係するサービス**:
134+
135+
- AWS CodePipeline
136+
- AWS CodeBuild
137+
- AWS CodeArtifact
138+
- Amazon ECR
139+
140+
# さいごに
141+
142+
今回紹介した内容はガイドラインの一部です。社内のメンバーはもちろん、社外の方々にも設計のベースラインとしてご活用いただければ幸いです。
143+
144+
またフィードバックやPRについてもお待ちしております。
145+
146+
- GitHub: [future-architect/arch-guidelines](https://github.com/future-architect/arch-guidelines)
147+
- [Future Architecture Guidelines](https://future-architect.github.io/arch-guidelines/)
148+
149+
最後に、本ガイドラインの作成に貢献頂いた有志のみなさんに感謝します。
150+
151+
第一版の完成から本記事の公開まで期間が空いてしまったため、その間のサービスアップデートに追従するためのPRが必要となりました。記事公開と前後しますが、対応するPRを用意しています。他にも、「ここ、もう古くなってるよ」という内容を見つけられましたらぜひPR頂けますと大変ありがたいです。
152+
153+
ちなみに記事執筆に当たって初めてGeminiに案出しや校正をやらせてみたのですが、その過程で自分の過去記事からトンマナを学習させました。あくまでGeminiの視点ですが、自分でも気づいてない評価が見えるので面白いですね。客観的、と言えるぐらいまで生成AIを信用はしていないのですが、確かにあんまり意識はしていないけれど大事にしていることをピックアップされてるなと思いました。もしかしたら占いが当たる、みたいな心理的効果かもしれないのですが…。
154+
155+
まだオールドな人間なので、結構紙とボールペンで自分の思考を整理してから、Geminiと壁打ちしてアイデアを膨らませるみたいな使い方をよくするのですが、Gemini 3になってからトンチンカンなこという回数が実感としても減ったように感じます。
156+
157+
> - **文体:** 基本は「です・ます」調ですが、非常に論理的で硬派なスタイルです。
158+
> - **構成:**
159+
> - **TL;DR**(要約)を冒頭に配置し、結論を急ぐ読者への配慮がある。
160+
> - **「頭の体操編」「実践編」**といったセクション分けで、理論(Why)と実装(How)を明確に分離している。
161+
> - **客観性と論理性:** 「感覚値的にはこうだろう」で終わらせず、Well-Architected Frameworkなどの一次情報を引用し、論理的に正解を導き出そうとする姿勢が強い。
162+
> - **感情表現の抑制:** 絵文字や過度な感嘆符(!)は控えめで、技術的な誠実さを前面に出している。
163+
>
164+
> **結論としての適用トーン:**
165+
> 前回の案よりも「感情的な盛り上げ」を削ぎ落とし、より「ファクトベース」で「論理構成が明確」なスタイルに修正します。
29.1 KB
Loading
24.5 KB
Loading
127 KB
Loading
Binary file not shown.

0 commit comments

Comments
 (0)