| name | infra-workflow |
|---|
| description | Terraform/Docker Composeによるインフラ構築のワークフロー、ベストプラクティス、Well-Architected Framework対応を定義 |
|---|
インフラワークフロー
本ドキュメントは、Terraform/Docker Composeによるインフラ構築のワークフローを定義します。
1. インフラワークフロー概要
flowchart TB
subgraph INFRA["インフラワークフロー"]
direction TB
%% インフラ設計
subgraph DESIGN["インフラ設計フェーズ"]
D1["インフラ要件確認"]
D2["インフラ設計書作成<br/>@infra-reviewer"]
D3{"設計レビュー<br/>9点以上"}
D1 --> D2 --> D3
D3 -->|"不合格"| D2
end
%% Terraform
subgraph TF["Terraform実装フェーズ"]
TF1["Terraformコード実装"]
TF2["terraform plan"]
TF3{"Plan成功?"}
TF4["セキュリティチェック<br/>@security-reviewer"]
TF5{"レビュー<br/>9点以上"}
TF1 --> TF2 --> TF3
TF3 -->|"失敗"| TF1
TF3 -->|"成功"| TF4 --> TF5
TF5 -->|"不合格"| TF1
end
%% Docker Compose
subgraph DC["Docker Compose実装フェーズ"]
DC1["Docker Compose作成"]
DC2["docker-compose up"]
DC3{"起動成功?"}
DC4{"レビュー<br/>9点以上"}
DC1 --> DC2 --> DC3
DC3 -->|"失敗"| DC1
DC3 -->|"成功"| DC4
DC4 -->|"不合格"| DC1
end
%% フロー接続
D3 -->|"合格"| TF
D3 -->|"合格"| DC
TF5 -->|"合格"| TF_OUT[["terraform apply<br/>待機"]]
DC4 -->|"合格"| DC_OUT[["ローカル環境<br/>準備完了"]]
end
2. Terraformワークフロー
2.1 フェーズ
| # |
フェーズ |
内容 |
完了条件 |
| 1 |
要件確認 |
インフラ要件の確認 |
要件が明確 |
| 2 |
設計 |
インフラ設計書作成 |
レビュー9点以上 |
| 3 |
実装 |
Terraformコード実装 |
terraform plan 成功 |
| 4 |
セキュリティレビュー |
セキュリティチェック |
レビュー9点以上 |
| 5 |
適用 |
terraform apply（手動） |
人間の承認後 |
2.2 Terraform ベストプラクティス
ディレクトリ構成
infrastructure/
├── terraform/
│ ├── environments/
│ │ ├── dev/
│ │ │ ├── main.tf
│ │ │ ├── variables.tf
│ │ │ ├── outputs.tf
│ │ │ └── terraform.tfvars
│ │ ├── staging/
│ │ └── production/
│ │
│ └── modules/
│ ├── networking/
│ │ ├── main.tf
│ │ ├── variables.tf
│ │ └── outputs.tf
│ ├── compute/
│ ├── database/
│ └── security/
│
└── docs/
└── インフラ設計書.md
命名規則
| リソース |
命名規則 |
例 |
| リソース名 |
{project}-{env}-{resource} |
myapp-prod-vpc |
| モジュール名 |
機能を表す単語 |
networking, compute |
| 変数名 |
snake_case |
instance_type |
必須設定
# provider バージョン固定
terraform {
required_version = ">= 1.0.0"
required_providers {
aws = {
source = "hashicorp/aws"
version = "~> 5.0"
}
}
}
# 全変数にdescription必須
variable "instance_type" {
type = string
description = "EC2インスタンスタイプ"
default = "t3.micro"
}
# 重要なoutputにはdescription必須
output "vpc_id" {
description = "作成されたVPCのID"
value = aws_vpc.main.id
}
2.3 セキュリティチェック項目
| カテゴリ |
チェック項目 |
| ネットワーク |
セキュリティグループが最小権限か |
| IAM |
IAMポリシーが最小権限か |
| 暗号化 |
RDS、S3、EBSが暗号化されているか |
| ログ |
CloudTrail、VPCフローログが有効か |
| 公開設定 |
S3バケットがパブリックでないか |
| シークレット |
Secrets Managerが使用されているか |
3. Docker Composeワークフロー
3.1 フェーズ
| # |
フェーズ |
内容 |
完了条件 |
| 1 |
要件確認 |
ローカル環境要件の確認 |
要件が明確 |
| 2 |
実装 |
Docker Compose作成 |
docker-compose up 成功 |
| 3 |
レビュー |
設定レビュー |
レビュー9点以上 |
| 4 |
ドキュメント化 |
セットアップ手順の記載 |
README更新 |
3.2 Docker Compose ベストプラクティス
ディレクトリ構成
docker/
├── docker-compose.yml # 本番用
├── docker-compose.dev.yml # 開発用（上書き）
├── docker-compose.test.yml # テスト用
├── .env.example # 環境変数テンプレート
└── services/
├── backend/
│ └── Dockerfile
├── frontend/
│ └── Dockerfile
└── nginx/
└── nginx.conf
必須設定
version: '3.8'
services:
backend:
build:
context: ./services/backend
dockerfile: Dockerfile
env_file:
- .env
networks:
- app-network
healthcheck:
test: ["CMD", "curl", "-f", "http://localhost:8080/health"]
interval: 30s
timeout: 10s
retries: 3
depends_on:
db:
condition: service_healthy
db:
image: postgres:15-alpine
volumes:
- db-data:/var/lib/postgresql/data
environment:
POSTGRES_USER: ${DB_USER}
POSTGRES_PASSWORD: ${DB_PASSWORD}
POSTGRES_DB: ${DB_NAME}
healthcheck:
test: ["CMD-SHELL", "pg_isready -U ${DB_USER}"]
interval: 10s
timeout: 5s
retries: 5
networks:
app-network:
driver: bridge
volumes:
db-data:
3.3 開発環境用オーバーライド
# docker-compose.dev.yml
version: '3.8'
services:
backend:
volumes:
- ./backend:/app # ホットリロード用
- /app/node_modules # node_modules除外
environment:
- DEBUG=true
ports:
- "3000:3000"
- "9229:9229" # デバッグポート
frontend:
volumes:
- ./frontend:/app
- /app/node_modules
ports:
- "5173:5173"
3.4 チェック項目
| カテゴリ |
チェック項目 |
| バージョン |
version: '3.8' 以上か |
| ネットワーク |
適切なネットワーク分離がされているか |
| ボリューム |
データ永続化が適切に設定されているか |
| 環境変数 |
.env ファイルから参照しているか |
| ヘルスチェック |
healthcheckが設定されているか |
| 依存関係 |
depends_onで適切な依存関係が設定されているか |
| セキュリティ |
機密情報がハードコードされていないか |
4. Well-Architected Framework対応
4.1 5つの柱
| 柱 |
確認項目 |
| セキュリティ |
暗号化、最小権限、ネットワーク分離、監査ログ |
| 信頼性 |
Multi-AZ、Auto Scaling、バックアップ、DR |
| パフォーマンス効率 |
適切なインスタンスサイズ、キャッシュ、CDN |
| コスト最適化 |
不要リソース削除、Reserved/Spot活用 |
| 運用上の優秀性 |
IaC、CloudWatch、タグ付け、自動化 |
4.2 各柱のチェックリスト
セキュリティ
信頼性
パフォーマンス効率
コスト最適化
運用上の優秀性
5. 環境変数管理
5.1 Terraformからの環境変数出力
# outputs.tf
output "backend_env_vars" {
description = "バックエンド用環境変数（非機密）"
value = {
DATABASE_HOST = aws_db_instance.main.address
REDIS_HOST = aws_elasticache_cluster.main.cache_nodes[0].address
S3_BUCKET = aws_s3_bucket.main.id
}
}
output "backend_secrets_arn" {
description = "Secrets Manager ARN"
value = aws_secretsmanager_secret.backend.arn
}
5.2 機密情報の管理
| 環境 |
管理方法 |
| ローカル |
.env ファイル（.gitignore） |
| AWS |
Secrets Manager |
| CI/CD |
GitHub Secrets / GitLab CI Variables |
変更履歴
| 日付 |
バージョン |
変更内容 |
| 2026-01-02 |
1.0.0 |
初版作成（ai-frameworkからの取り込み） |
