前回までで、管理画面を本番用のコンテナイメージにまとめました。今回から、そのイメージを動かす AWS 側の準備に入ります。最初に作るのは、Terraform(=インフラの構成をコードで書き、その通りに作成・変更するツール)の土台と、すべての部品が乗るネットワーク(VPC)です。
「AWS の画面で手作業で作った環境が、誰がいつ何を変えたのか分からなくなってしまった。コードで管理したいけれど、どこから始めればいいのか…」
結論から言うと、Terraform で最初に決めるのは「state(=何を作ったかの記録)をどこに置き、同時に書き換えられないようにするか」と「ネットワークを public と private に分け、外への出口をどうするか」の2つです。ここを後から変えるのは大変なので、最初の回でまとめて固めます。
(2026年10月29日 追記:記事どおりに再現できるよう、必要なコードと手順を追加しました)
前回(第6回:本番用コンテナイメージを作る)では、nginx と php-fpm の本番用イメージを作りました。今回はそれを動かすための VPC・サブネット・NAT Gateway・セキュリティグループを Terraform で定義します。新しく作るファイルは全文を、すでにあるファイルは変更箇所を差分で載せています。
なお、執筆環境には AWS アカウントを用意していないため、terraform apply(実際の作成)は行っていません。terraform validate による構文と整合性の確認と、AWS に接続しない形での plan(作成予定の一覧)までを確認しています。
Terraform の土台とネットワークで作るもの
今回追加するファイルは次のとおりです(すべて infra/terraform/ 配下)。
| ファイル | 内容 |
|---|---|
versions.tf / .terraform.lock.hcl | Terraform と AWS プロバイダー(=AWS を操作するためのプラグイン)のバージョン固定 |
backend.tf / backend.hcl.example | state の保存先(S3)とロック |
providers.tf | リージョンと、全リソース共通のタグ |
variables.tf / locals.tf / terraform.tfvars.example | 環境ごとに変える値 |
network.tf | VPC、サブネット、インターネットゲートウェイ、NAT Gateway、ルートテーブル |
vpc_endpoints.tf | S3 のゲートウェイ型エンドポイント、インターフェイス型エンドポイント(任意) |
security_groups.tf | ALB・Web タスク・その他のタスク・RDS の通信の許可 |
outputs.tf | 次回以降に使う ID の出力 |
1つのディレクトリに役割ごとのファイルを並べる構成にしました(この規模ならモジュール分割は不要と判断)。検証環境(stg)と本番(prod)は、同じコードに別の変数と別の state を渡して作り分けます。
プロジェクトのフォルダに infra/terraform フォルダを作り、以降のファイルはここに置きます。あわせて、state や環境ごとの値のファイルを Git に入れないよう、第1回の .gitignore に追加します。
mkdir -p infra/terraform
.gitignore に次の変更を加えます(+ が追加、- が削除)。
--- a/.gitignore
+++ b/.gitignore
@@ -35,3 +35,9 @@ yarn-error.log
*.tfstate.*
*.tfvars
!*.tfvars.example
+# backend の環境ごとの値(バケット名など)。例は backend.hcl.example
+backend.hcl
+crash.log
+crash.*.log
+.terraformrc
+terraform.rc
state をS3に置き、use_lockfile でロックする
state とは何か
Terraform は、作ったリソースの ID や設定を state ファイルに記録し、次の実行時に「コードと実際の差分」を計算します。state を担当者のパソコンに置くと、別の人の実行で差分を正しく計算できず、二重作成や削除事故につながるため、S3 などの共有の場所に置きます。
backend の設定:バケット名はコードに書かない
infra/terraform/backend.tf を新しく作ります。
# infra/terraform/backend.tf
# state(Terraform が管理しているリソースの記録)の保存先
#
# バケット名などの環境ごとの値はコードに書かず、init 時に渡す(部分設定)
# terraform init -backend-config=backend.hcl
# backend.hcl の例は backend.hcl.example を参照(backend.hcl 自体は Git に入れない)
terraform {
backend "s3" {
# S3 にロックファイル(<key>.tflock)を作って同時実行を防ぐ。DynamoDB のロック用テーブルは不要
use_lockfile = true
encrypt = true
}
}
infra/terraform/backend.hcl.example を新しく作ります。
# infra/terraform/backend.hcl.example
# terraform init -backend-config=backend.hcl で読み込む(コピーして backend.hcl を作る)
# state 用の S3 バケットは Terraform の外で先に作っておく(バージョニング有効・パブリックアクセスブロック)
bucket = "example-admin-tfstate" # 実際のバケット名に置き換える
key = "admin/stg/terraform.tfstate"
region = "ap-northeast-1"
use_lockfile = true は、Terraform 1.11 で正式な機能になった S3 のネイティブロックです。実行中は state と同じ場所にロック用のファイルを置き、他の人が同時に apply できないようにします。以前は DynamoDB のテーブルをロックに使うのが定番でしたが、1.11 のドキュメントでは DynamoDB によるロックは非推奨とされています。
📰 出典:Terraform v1.11.x Backend Type: s3
バケット名や state のパス(key)は、backend.hcl に書いて terraform init -backend-config=backend.hcl で渡します(部分設定)。環境ごとに key を変えれば、同じコードで stg と prod の state を分けられます。
state 用の S3 バケットそのものは、Terraform の外で先に作ります(state を置く場所を、その state で管理することはできないためです)。AWS CLI(認証情報を aws configure などで設定済みのもの)なら次のような手順です。バージョニングを有効にしておくと、state を誤って壊したときに前の版に戻せます。
aws s3api create-bucket --bucket <バケット名> --region ap-northeast-1 \
--create-bucket-configuration LocationConstraint=ap-northeast-1
aws s3api put-bucket-versioning --bucket <バケット名> --versioning-configuration Status=Enabled
aws s3api put-public-access-block --bucket <バケット名> \
--public-access-block-configuration BlockPublicAcls=true,IgnorePublicAcls=true,BlockPublicPolicy=true,RestrictPublicBuckets=true
state には、リソースの設定値がそのまま記録されます。パスワードなどの秘密情報を Terraform の変数で渡すと state にも残るため、この連載では DB のパスワードを AWS 側で生成・管理させます(第8回)。
バージョン固定と共通タグ
infra/terraform/versions.tf を新しく作ります。
# infra/terraform/versions.tf
# Terraform / AWS プロバイダーのバージョン固定
# - Terraform 1.11 系: S3 backend のネイティブロック(use_lockfile)が GA
# - AWS provider 5 系: 実際に使う版は .terraform.lock.hcl で固定する(terraform init で作成)
terraform {
required_version = "~> 1.11"
required_providers {
aws = {
source = "hashicorp/aws"
version = "~> 5.97"
}
}
}
~> 5.97 は「5.97 以上、6.0 未満」という指定です。実際に使う版は、terraform init で作られる .terraform.lock.hcl に記録され、チーム全員が同じ版を使います。筆者の環境(2025年8月時点)では AWS プロバイダー 5.100.0 が選ばれました。このファイルは Git に含めます。
infra/terraform/providers.tf を新しく作ります。
# infra/terraform/providers.tf
provider "aws" {
region = var.region
# すべてのリソースに共通のタグを付ける(費用の集計・持ち主の確認に使う)
default_tags {
tags = {
Project = var.project
Environment = var.environment
ManagedBy = "terraform"
}
}
}
default_tags を付けておくと、請求画面で環境ごとの費用をタグで集計できます。ManagedBy = "terraform" は、画面から手で変更してはいけないリソースの目印にもなります。
VPC を public と private のサブネットに分ける
ネットワークの全体像
| 場所 | 置くもの | インターネットとの関係 |
|---|---|---|
| public サブネット(2つの AZ) | ALB(ロードバランサー)、NAT Gateway | 直接つながる |
| private サブネット(2つの AZ) | ECS のタスク、RDS | 外から直接は届かない。外向きは NAT Gateway 経由 |
AZ(アベイラビリティゾーン)は、同じリージョン内で物理的に離れたデータセンターの単位です。ALB と RDS はどちらも2つ以上の AZ のサブネットを必要とするため、最初から2つの AZ に作ります。
サブネットの IP アドレス範囲は、VPC の 10.0.0.0/16 を cidrsubnet() 関数で /24 に分けて決めています(public は 10.0.0.0/24・10.0.1.0/24、private は 10.0.10.0/24・10.0.11.0/24)。
NAT Gateway:1台にするか AZ ごとにするか
infra/terraform/network.tf を新しく作ります。全文は次のとおりです(クリックで開きます)。VPC、インターネットゲートウェイ、public / private のサブネット、ルートテーブル、NAT Gateway を作ります。
infra/terraform/network.tf の全文(105行)
# infra/terraform/network.tf
# ネットワーク:VPC、public / private サブネット(2AZ)、インターネットゲートウェイ、NAT Gateway、ルートテーブル
#
# public サブネット:ALB と NAT Gateway を置く(インターネットと直接つながる)
# private サブネット:ECS タスクと RDS を置く(外から直接は届かない。外向きは NAT Gateway 経由)
resource "aws_vpc" "main" {
cidr_block = var.vpc_cidr
enable_dns_support = true
enable_dns_hostnames = true # VPC エンドポイント(プライベート DNS)と RDS のエンドポイント名に必要
tags = { Name = "${local.name_prefix}-vpc" }
}
resource "aws_internet_gateway" "main" {
vpc_id = aws_vpc.main.id
tags = { Name = "${local.name_prefix}-igw" }
}
resource "aws_subnet" "public" {
count = length(var.azs)
vpc_id = aws_vpc.main.id
availability_zone = var.azs[count.index]
cidr_block = local.public_subnet_cidrs[count.index]
# public サブネットでも自動でパブリック IP を付けない(付ける必要があるのは ALB と NAT だけで、どちらも個別に管理される)
map_public_ip_on_launch = false
tags = { Name = "${local.name_prefix}-public-${var.azs[count.index]}" }
}
resource "aws_subnet" "private" {
count = length(var.azs)
vpc_id = aws_vpc.main.id
availability_zone = var.azs[count.index]
cidr_block = local.private_subnet_cidrs[count.index]
tags = { Name = "${local.name_prefix}-private-${var.azs[count.index]}" }
}
# ---------- public のルート:インターネットゲートウェイへ ----------
resource "aws_route_table" "public" {
vpc_id = aws_vpc.main.id
tags = { Name = "${local.name_prefix}-public" }
}
resource "aws_route" "public_internet" {
route_table_id = aws_route_table.public.id
destination_cidr_block = "0.0.0.0/0"
gateway_id = aws_internet_gateway.main.id
}
resource "aws_route_table_association" "public" {
count = length(var.azs)
subnet_id = aws_subnet.public[count.index].id
route_table_id = aws_route_table.public.id
}
# ---------- NAT Gateway:private サブネットから外(ECR・外部 API など)へ出る出口 ----------
resource "aws_eip" "nat" {
count = local.nat_gateway_count
domain = "vpc"
tags = { Name = "${local.name_prefix}-nat-${var.azs[count.index]}" }
}
resource "aws_nat_gateway" "main" {
count = local.nat_gateway_count
allocation_id = aws_eip.nat[count.index].id
subnet_id = aws_subnet.public[count.index].id
tags = { Name = "${local.name_prefix}-nat-${var.azs[count.index]}" }
depends_on = [aws_internet_gateway.main]
}
# ---------- private のルート:AZ ごとにルートテーブルを分け、NAT Gateway へ ----------
resource "aws_route_table" "private" {
count = length(var.azs)
vpc_id = aws_vpc.main.id
tags = { Name = "${local.name_prefix}-private-${var.azs[count.index]}" }
}
resource "aws_route" "private_nat" {
count = length(var.azs)
route_table_id = aws_route_table.private[count.index].id
destination_cidr_block = "0.0.0.0/0"
# NAT が1台なら全 AZ がそれを使う。AZ ごとに置いた場合は同じ AZ の NAT を使う
nat_gateway_id = aws_nat_gateway.main[min(count.index, local.nat_gateway_count - 1)].id
}
resource "aws_route_table_association" "private" {
count = length(var.azs)
subnet_id = aws_subnet.private[count.index].id
route_table_id = aws_route_table.private[count.index].id
}
infra/terraform/network.tf(全文のうち NAT Gateway と private のルート)
resource "aws_eip" "nat" {
count = local.nat_gateway_count
domain = "vpc"
tags = { Name = "${local.name_prefix}-nat-${var.azs[count.index]}" }
}
resource "aws_nat_gateway" "main" {
count = local.nat_gateway_count
allocation_id = aws_eip.nat[count.index].id
subnet_id = aws_subnet.public[count.index].id
tags = { Name = "${local.name_prefix}-nat-${var.azs[count.index]}" }
depends_on = [aws_internet_gateway.main]
}
resource "aws_route" "private_nat" {
count = length(var.azs)
route_table_id = aws_route_table.private[count.index].id
destination_cidr_block = "0.0.0.0/0"
# NAT が1台なら全 AZ がそれを使う。AZ ごとに置いた場合は同じ AZ の NAT を使う
nat_gateway_id = aws_nat_gateway.main[min(count.index, local.nat_gateway_count - 1)].id
}
次の infra/terraform/locals.tf(新規作成)で nat_gateway_count = var.single_nat_gateway ? 1 : length(var.azs) としており、変数1つで台数を切り替えられます。
# infra/terraform/locals.tf
locals {
# リソース名の接頭辞(例:admin-stg)
name_prefix = "${var.project}-${var.environment}"
# サブネットの IP 範囲:/16 を /24 に分け、public は 0〜、private は 10〜 の番号を使う
public_subnet_cidrs = [for i, _ in var.azs : cidrsubnet(var.vpc_cidr, 8, i)]
private_subnet_cidrs = [for i, _ in var.azs : cidrsubnet(var.vpc_cidr, 8, i + 10)]
nat_gateway_count = var.single_nat_gateway ? 1 : length(var.azs)
}
- 1台(
single_nat_gateway = true、既定):費用を抑えられます。その代わり、NAT Gateway のある AZ に障害が起きると、もう一方の AZ のタスクも外に出られなくなります。 - AZ ごと(
false):1つの AZ の障害でも外に出られます。NAT Gateway は台数分の時間課金がかかります。
検証環境は1台、本番は業務の止まってよい時間に応じて判断する、というのが一般的な考え方です。
📰 出典:AWS NAT ゲートウェイ(Amazon VPC ユーザーガイド)
NAT Gateway と VPC エンドポイントを比較する
private サブネットの ECS タスクは、起動時にイメージの取得(ECR)、ログの送信(CloudWatch Logs)、秘密情報の取得(Secrets Manager・SSM Parameter Store)のために AWS のサービスへ接続します。その経路は2通りあります。
| 経路 | 仕組み | 費用の構造 | 向いている場面 |
|---|---|---|---|
| NAT Gateway | インターネット経由で AWS のサービスや外部 API に出る | 台数×時間+通信量 | 外部の API(決済・メールなど)も使う。構成を単純にしたい |
| VPC エンドポイント(インターフェイス型) | VPC 内から AWS のサービスへ直接つなぐ | エンドポイント数×AZ 数×時間+通信量 | 外に出る通信をなくしたい。イメージの取得などの通信量が多い |
| VPC エンドポイント(ゲートウェイ型、S3) | ルートテーブルで S3 への通信を直接つなぐ | 追加料金なし | 常に作っておいてよい |
infra/terraform/vpc_endpoints.tf を新しく作ります。
# infra/terraform/vpc_endpoints.tf
# VPC エンドポイント:private サブネットから AWS のサービスへ、NAT Gateway を通らずに接続する
#
# ゲートウェイ型(S3) : 追加料金なし。ECR のイメージ本体(レイヤー)は S3 から取得されるので常に作る
# インターフェイス型(その他): エンドポイントごと・AZ ごとの時間課金+通信量課金。enable_interface_endpoints で切り替える
resource "aws_vpc_endpoint" "s3" {
vpc_id = aws_vpc.main.id
service_name = "com.amazonaws.${var.region}.s3"
vpc_endpoint_type = "Gateway"
route_table_ids = aws_route_table.private[*].id
tags = { Name = "${local.name_prefix}-s3" }
}
locals {
# ECS on Fargate がイメージ取得・ログ送信・シークレット取得に使うサービスと、キュー(SQS)
interface_endpoint_services = var.enable_interface_endpoints ? toset([
"ecr.api",
"ecr.dkr",
"logs",
"secretsmanager",
"ssm",
"sqs",
]) : toset([])
}
resource "aws_vpc_endpoint" "interface" {
for_each = local.interface_endpoint_services
vpc_id = aws_vpc.main.id
service_name = "com.amazonaws.${var.region}.${each.key}"
vpc_endpoint_type = "Interface"
subnet_ids = aws_subnet.private[*].id
security_group_ids = [aws_security_group.vpc_endpoints.id]
private_dns_enabled = true
tags = { Name = "${local.name_prefix}-${each.key}" }
}
ECR のイメージ本体は S3 から取得されるため、S3 のゲートウェイ型エンドポイントは常に作り、NAT Gateway を通る通信量を減らしています。インターフェイス型は enable_interface_endpoints で切り替えられるようにしました。6つのサービス×2つの AZ 分の時間課金がかかるため、この連載の既定は「NAT Gateway 1台+S3 ゲートウェイ型」です。
📰 出典:Amazon ECR インターフェイス VPC エンドポイント(AWS PrivateLink)
セキュリティグループは「相手のグループ」で許可する
セキュリティグループ(=リソースごとの通信の許可リスト)は、IP アドレスではなく「どのセキュリティグループからの通信か」で許可します。ECS のタスクは起動のたびに IP アドレスが変わるためです。
| グループ | 受け付ける通信 | 出ていく通信 |
|---|---|---|
| alb | インターネットから 80・443 | web へ 8080 |
| web(nginx+php-fpm) | alb から 8080 | 443(AWS の API など)、rds へ 3306 |
| app(worker・scheduler・マイグレーション) | なし | 443、rds へ 3306 |
| rds | web と app から 3306 | なし |
infra/terraform/security_groups.tf を新しく作ります。全文は次のとおりです(クリックで開きます)。
infra/terraform/security_groups.tf の全文(139行)
# infra/terraform/security_groups.tf
# セキュリティグループ(通信の許可リスト)
# 許可の相手は IP アドレスではなく「どのセキュリティグループからか」で指定し、役割ごとに最小限にする
#
# インターネット ──80/443──▶ alb ──8080──▶ web(nginx)
# web / worker / scheduler / migrate(= app) ──3306──▶ rds
# app ──443──▶ vpc_endpoints(インターフェイス型エンドポイントを使う場合)
resource "aws_security_group" "alb" {
name = "${local.name_prefix}-alb"
description = "ALB: HTTP/HTTPS from the internet"
vpc_id = aws_vpc.main.id
tags = { Name = "${local.name_prefix}-alb" }
}
resource "aws_vpc_security_group_ingress_rule" "alb_http" {
security_group_id = aws_security_group.alb.id
description = "HTTP (redirect to HTTPS)"
cidr_ipv4 = "0.0.0.0/0"
ip_protocol = "tcp"
from_port = 80
to_port = 80
}
resource "aws_vpc_security_group_ingress_rule" "alb_https" {
security_group_id = aws_security_group.alb.id
description = "HTTPS"
cidr_ipv4 = "0.0.0.0/0"
ip_protocol = "tcp"
from_port = 443
to_port = 443
}
resource "aws_vpc_security_group_egress_rule" "alb_to_web" {
security_group_id = aws_security_group.alb.id
description = "To web tasks (nginx)"
referenced_security_group_id = aws_security_group.web.id
ip_protocol = "tcp"
from_port = 8080
to_port = 8080
}
# web タスク(nginx+php-fpm):ALB からの 8080 番だけを受け付ける
resource "aws_security_group" "web" {
name = "${local.name_prefix}-web"
description = "ECS web tasks: from ALB only"
vpc_id = aws_vpc.main.id
tags = { Name = "${local.name_prefix}-web" }
}
resource "aws_vpc_security_group_ingress_rule" "web_from_alb" {
security_group_id = aws_security_group.web.id
description = "From ALB"
referenced_security_group_id = aws_security_group.alb.id
ip_protocol = "tcp"
from_port = 8080
to_port = 8080
}
# worker / scheduler / migrate タスク:受け付ける通信はない
resource "aws_security_group" "app" {
name = "${local.name_prefix}-app"
description = "ECS worker/scheduler/migrate tasks: no inbound"
vpc_id = aws_vpc.main.id
tags = { Name = "${local.name_prefix}-app" }
}
# ECS タスクの外向き通信:ECR・外部 API などへの HTTPS と、RDS への 3306
resource "aws_vpc_security_group_egress_rule" "tasks_https" {
for_each = {
web = aws_security_group.web.id
app = aws_security_group.app.id
}
security_group_id = each.value
description = "HTTPS to AWS APIs and external services"
cidr_ipv4 = "0.0.0.0/0"
ip_protocol = "tcp"
from_port = 443
to_port = 443
}
resource "aws_vpc_security_group_egress_rule" "tasks_mysql" {
for_each = {
web = aws_security_group.web.id
app = aws_security_group.app.id
}
security_group_id = each.value
description = "MySQL to RDS"
referenced_security_group_id = aws_security_group.rds.id
ip_protocol = "tcp"
from_port = 3306
to_port = 3306
}
# RDS:ECS タスクからの 3306 番だけを受け付ける(第8回で RDS に割り当てる)
resource "aws_security_group" "rds" {
name = "${local.name_prefix}-rds"
description = "RDS for MySQL: from ECS tasks only"
vpc_id = aws_vpc.main.id
tags = { Name = "${local.name_prefix}-rds" }
}
resource "aws_vpc_security_group_ingress_rule" "rds_from_tasks" {
for_each = {
web = aws_security_group.web.id
app = aws_security_group.app.id
}
security_group_id = aws_security_group.rds.id
description = "MySQL from ECS ${each.key} tasks"
referenced_security_group_id = each.value
ip_protocol = "tcp"
from_port = 3306
to_port = 3306
}
# インターフェイス型 VPC エンドポイント:VPC 内からの 443 番だけ
resource "aws_security_group" "vpc_endpoints" {
name = "${local.name_prefix}-vpce"
description = "Interface VPC endpoints: HTTPS from VPC"
vpc_id = aws_vpc.main.id
tags = { Name = "${local.name_prefix}-vpce" }
}
resource "aws_vpc_security_group_ingress_rule" "vpce_https" {
security_group_id = aws_security_group.vpc_endpoints.id
description = "HTTPS from VPC"
cidr_ipv4 = aws_vpc.main.cidr_block
ip_protocol = "tcp"
from_port = 443
to_port = 443
}
infra/terraform/security_groups.tf(全文のうち web タスクと RDS の部分)
# web タスク(nginx+php-fpm):ALB からの 8080 番だけを受け付ける
resource "aws_security_group" "web" {
name = "${local.name_prefix}-web"
description = "ECS web tasks: from ALB only"
vpc_id = aws_vpc.main.id
tags = { Name = "${local.name_prefix}-web" }
}
resource "aws_vpc_security_group_ingress_rule" "web_from_alb" {
security_group_id = aws_security_group.web.id
description = "From ALB"
referenced_security_group_id = aws_security_group.alb.id
ip_protocol = "tcp"
from_port = 8080
to_port = 8080
}
resource "aws_vpc_security_group_ingress_rule" "rds_from_tasks" {
for_each = {
web = aws_security_group.web.id
app = aws_security_group.app.id
}
security_group_id = aws_security_group.rds.id
description = "MySQL from ECS ${each.key} tasks"
referenced_security_group_id = each.value
ip_protocol = "tcp"
from_port = 3306
to_port = 3306
}
待ち受けを 8080 番にしているのは、第6回で nginx を非 root で動かすようにしたためです。ルールは aws_security_group の中に書かず、aws_vpc_security_group_ingress_rule / egress_rule という1ルール1リソースの書き方にしました。AWS プロバイダーのドキュメントでも、aws_security_group の中にルールを書く方法は避け、こちらを使うことが勧められています。ルールごとに説明やタグを付けられ、追加・削除が他のルールに影響しにくくなります。
📰 出典:Terraform AWS Provider 5.100.0 aws_security_group
変数・出力・変数の例
ここまでのファイルが使う変数(var.〜)と、次回以降に使う出力(output)、変数の値の例を用意します。どれも新しく作るファイルです。terraform.tfvars.example は、コピーして terraform.tfvars(Git に入れない)を作るための見本です。
infra/terraform/variables.tf
# infra/terraform/variables.tf
variable "project" {
description = "プロジェクト名(リソース名の接頭辞)"
type = string
default = "admin"
}
variable "environment" {
description = "環境名(stg / prod など)"
type = string
validation {
condition = contains(["stg", "prod"], var.environment)
error_message = "environment は stg か prod を指定してください。"
}
}
variable "region" {
description = "AWS リージョン"
type = string
default = "ap-northeast-1"
}
variable "vpc_cidr" {
description = "VPC の IP アドレス範囲"
type = string
default = "10.0.0.0/16"
}
variable "azs" {
description = "使うアベイラビリティゾーン(2つ以上)"
type = list(string)
default = ["ap-northeast-1a", "ap-northeast-1c"]
validation {
condition = length(var.azs) >= 2
error_message = "ALB と RDS のため、アベイラビリティゾーンは2つ以上指定してください。"
}
}
variable "single_nat_gateway" {
description = "true: NAT Gateway を1台だけ置く(費用優先)。false: AZ ごとに置く(1つの AZ の障害でも外に出られる)"
type = bool
default = true
}
variable "enable_interface_endpoints" {
description = "ECR・CloudWatch Logs・Secrets Manager・SSM・SQS のインターフェイス型 VPC エンドポイントを作るか"
type = bool
default = false
}
infra/terraform/outputs.tf
# infra/terraform/outputs.tf
output "vpc_id" {
description = "VPC の ID"
value = aws_vpc.main.id
}
output "public_subnet_ids" {
description = "public サブネットの ID(ALB 用)"
value = aws_subnet.public[*].id
}
output "private_subnet_ids" {
description = "private サブネットの ID(ECS タスク・RDS 用)"
value = aws_subnet.private[*].id
}
output "nat_gateway_public_ips" {
description = "NAT Gateway のパブリック IP(外部サービスに接続元 IP を登録する場合に使う)"
value = aws_eip.nat[*].public_ip
}
output "security_group_ids" {
description = "役割ごとのセキュリティグループ ID"
value = {
alb = aws_security_group.alb.id
web = aws_security_group.web.id
app = aws_security_group.app.id
rds = aws_security_group.rds.id
vpc_endpoints = aws_security_group.vpc_endpoints.id
}
}
infra/terraform/terraform.tfvars.example
# infra/terraform/terraform.tfvars.example
# コピーして terraform.tfvars を作る(terraform.tfvars は Git に入れない)
# 秘密情報はここにも書かない(DB パスワードは RDS 管理、APP_KEY などは SSM に Terraform の外で登録する:第8回)
project = "admin"
environment = "stg"
region = "ap-northeast-1"
vpc_cidr = "10.0.0.0/16"
azs = ["ap-northeast-1a", "ap-northeast-1c"]
# 検証環境は NAT Gateway 1台、本番は AZ ごとに置くことを検討する
single_nat_gateway = true
# NAT Gateway の通信量を減らしたい場合や、外に出る経路を絞りたい場合に true
enable_interface_endpoints = false
動作確認の方法
Terraform も Docker のイメージで実行します(infra/terraform で実行)。
docker run --rm -v $PWD:/w -w /w hashicorp/terraform:1.11.4 fmt -check -recursive
docker run --rm -v $PWD:/w -w /w hashicorp/terraform:1.11.4 init -backend=false
docker run --rm -v $PWD:/w -w /w hashicorp/terraform:1.11.4 validate
init -backend=false は、S3 の state に接続せずにプロバイダーだけをダウンロードする指定で、AWS アカウントがなくても構文とリソースの整合性を確認できます。最初の init で .terraform.lock.hcl(使うプロバイダーの版の記録)が自動で作られるので、Git に含めます。筆者の環境では次の結果でした。
fmt -checkは差分なし、validateはSuccess! The configuration is valid..terraform.lock.hclに AWS プロバイダー 5.100.0 が記録された- 確認用に、backend をローカルに差し替え、AWS に接続しない設定(ダミーの認証情報と認証チェックの省略)を一時的に加えて
planを実行したところ、既定の変数でPlan: 35 to add。single_nat_gateway = falseとenable_interface_endpoints = trueにすると NAT Gateway が2台、インターフェイス型エンドポイントが6つ増えてPlan: 43 to addになった。environment = "dev"のように許可していない値は、変数の検証でエラーになった
この plan は AWS に問い合わせていないため、AZ 名が実在するか、アカウントの上限に収まるかなどは確認できていません。読者の AWS アカウントでは、backend.hcl と terraform.tfvars を用意して、terraform init -backend-config=backend.hcl、terraform plan で作成予定を確認してから apply してください。
Docker で動かす Terraform から AWS に接続するときは、AWS CLI の認証情報のフォルダを読み取り専用で渡し、使うプロファイルを指定します(<プロファイル名> は自分の環境の値)。
cp backend.hcl.example backend.hcl # バケット名などを自分の環境の値に書き換える
cp terraform.tfvars.example terraform.tfvars # 同上
docker run --rm -v $PWD:/w -w /w -v $HOME/.aws:/root/.aws:ro -e AWS_PROFILE=<プロファイル名> \
hashicorp/terraform:1.11.4 init -backend-config=backend.hcl
docker run --rm -v $PWD:/w -w /w -v $HOME/.aws:/root/.aws:ro -e AWS_PROFILE=<プロファイル名> \
hashicorp/terraform:1.11.4 plan
つまずきやすい点・セキュリティ上の注意
- state・tfvars を Git に入れない:
.gitignoreに*.tfstate、*.tfvars(例のファイルを除く)、backend.hclを入れています。state にはリソースの詳細な設定が入ります。 - 画面から手で変更しない:Terraform で作ったリソースを AWS の画面で変更すると、次の
planで元に戻す差分が出ます。緊急対応で変更した場合は、必ずコードにも反映します。 - NAT Gateway は作った瞬間から課金される:検証が終わった環境は
terraform destroyで削除するか、使わない時間帯の扱いを決めておきます。 - サブネットの IP 範囲は後から変えにくい:社内ネットワークや他の VPC と接続する予定があれば、重ならない範囲を最初に決めます。
- VPC フローログなどの監査の仕組みは省略:本番では、通信の記録(VPC フローログ)の要否もセキュリティ要件として検討します。
発注者向けメモ:AWS の費用は「常にかかるもの」と「使った分」に分かれる
AWS の月額費用は、大きく2種類に分けて考えると見積もりが読みやすくなります。
- 時間課金で常に発生するもの:NAT Gateway、ALB、RDS、Fargate のタスク、インターフェイス型 VPC エンドポイント。利用者がいない夜間も費用がかかります
- 使った分だけのもの:通信量、ログの量と保存期間、S3 の保存量
今回の NAT Gateway のように、「1台にするか AZ ごとにするか」で費用と障害への強さが変わる部品があります。検証環境と本番で構成を分けるのは一般的ですが、その判断の根拠(どれくらい止まってよいか)は発注者側が決める必要があります。
- インフラをコードで管理しているか:Terraform などのコードが納品物に含まれるか
- state の置き場所と権限:誰の AWS アカウントに、誰が変更できる形で置くか
- 検証環境と本番の違い:どこを省略し、それによってどんなリスクを受け入れるか
開発会社には、次のように確認してみてください。
- 「AWS の構成はコードで管理していますか?そのコードと state は、契約終了後にこちらで引き継げますか?」
- 「検証環境と本番で構成が違う部分はどこですか?それぞれの月額の目安を分けて出せますか?」
- 「1つのアベイラビリティゾーンで障害が起きたとき、システムはどうなりますか?」
- 「画面から手作業で変更した場合、コードとのずれをどうやって防いでいますか?」
まとめと次回予告
第7回では、Terraform の土台とネットワークを定義しました。
- state は S3 に置き、Terraform 1.11 の
use_lockfileでロックする。バケット名は部分設定で渡し、コードに書かない .terraform.lock.hclでプロバイダーの版を固定し、default_tagsで全リソースにタグを付ける- VPC を public と private のサブネット(2つの AZ)に分け、NAT Gateway の台数を変数で切り替える
- S3 はゲートウェイ型エンドポイントを常に作り、インターフェイス型は必要に応じて有効にする
- セキュリティグループは相手のグループで許可し、RDS には ECS のタスクからだけ接続できるようにする
次回は「RDS for MySQL と秘密情報:パスワードをコードに書かない」です。今回作った private サブネットに RDS for MySQL 8.4 を置き、DB のパスワードを AWS に管理させる方法と、APP_KEY などの秘密情報の置き場所を扱います。
この連載の記事一覧
この記事は連載「Laravel+Vue.jsで作る管理画面をECSで動かす」の1回です。連載のほかの回は次のとおりです(連載の一覧ページ)。
- 【Laravel+Vue.jsで作る管理画面をECSで動かす 第1回】全体像と開発環境:Laravel 12+Vue 3 スターターキットを Docker で動かす
- 【Laravel+Vue.jsで作る管理画面をECSで動かす 第2回】顧客マスタの一覧と登録:FormRequest でバリデーションする
- 【Laravel+Vue.jsで作る管理画面をECSで動かす 第3回】ロールと Policy:誰が何をできるかをコードで決める
- 【Laravel+Vue.jsで作る管理画面をECSで動かす 第4回】案件管理と一覧画面の作り込み:検索・並べ替え・ページング
- 【Laravel+Vue.jsで作る管理画面をECSで動かす 第5回】請求と非同期処理:キューとスケジューラをローカルで動かす
- 【Laravel+Vue.jsで作る管理画面をECSで動かす 第6回】本番用コンテナイメージを作る:マルチステージ Dockerfile
- 【Laravel+Vue.jsで作る管理画面をECSで動かす 第7回】Terraform の土台とネットワーク:state 管理と VPC(この記事)
- 【Laravel+Vue.jsで作る管理画面をECSで動かす 第8回】RDS for MySQL と秘密情報:パスワードをコードに書かない
- 【Laravel+Vue.jsで作る管理画面をECSで動かす 第9回】ECR・ECS on Fargate・ALB:管理画面をインターネットに公開する
- 【Laravel+Vue.jsで作る管理画面をECSで動かす 第10回】キューワーカーとスケジューラを ECS で動かす
- 【Laravel+Vue.jsで作る管理画面をECSで動かす 第11回】GitHub Actions で CI/CD:OIDC でキーを持たずにデプロイ
- 【Laravel+Vue.jsで作る管理画面をECSで動かす 第12回】運用編:ログ・監視・スケーリング・切り戻し










コメント
コメント一覧 (1件)
[…] 前回(第7回:Terraform の土台とネットワーク)では、VPC と private サブネット、RDS 用のセキュリティグループを作りました。今回はそこに RDS を置き、秘密情報の置き場所と読み取り権限を定義します。 […]