メインインフラの準備

リモートバックエンドのコード化が完了したので、次にアプリケーションのインフラを構築するための変数や環境設定をenvironments/test/ディレクトリに定義していきます。

1. コードの記載

environments/test/ディレクトリの各ファイルにコードを記述していきます。ここでは、リポジトリにコミットしたくない値(機密情報・受講生ごとに異なる値)を受け取るための入力変数と、この環境で使う固定値をまとめるローカル変数を定義します。

💡 ポイント
このあと modules/base/variables.tf でも db_password などの変数を定義します。環境側とモジュール側の両方に同じ名前の変数が現れますが、これはTerraformのモジュールの仕組み上、必要な構造です。理由は modules/base/ のコードを記述した後に詳しく解説します。

1.1 variables.tf

environments/test/variables.tfに以下の内容を記述します。ここではリポジトリにコミットしたくない値だけを変数として宣言します。具体的には、機密情報であるdb_passwordと、受講生ごとに異なるdomain_nameの2つです。環境名やVPCのCIDRなど、この環境で使う固定値は後ほどmain.tfのlocalsブロックにまとめて定義します。

variable "db_password" {
  description = "RDSのマスタパスワード"
  type        = string
  sensitive   = true
}

variable "domain_name" {
  description = "カスタムドメイン名(例: example.com)"
  type        = string
}

コードを解説します。

db_password

variable "db_password" {
  description = "RDSのマスタパスワード"
  type        = string
  sensitive   = true
}

RDSのマスタパスワードです。sensitiveは、変数の値をterraform planやterraform applyの出力に表示するかどうかを制御する設定です。trueにすることで、パスワードがターミナルに表示されることを防ぎます。機密情報であるため、実際の値はterraform.tfvarsに記述してリポジトリには含めません。

domain_name

variable "domain_name" {
  description = "カスタムドメイン名(例: example.com)"
  type        = string
}

カスタムドメイン名です。ALBのHTTPS設定(api.<ドメイン名>)とCloudFrontのHTTPS設定(<ドメイン名>)の両方で使用します。受講生ごとに異なるドメインを使用するため、この値もリポジトリには含めずterraform.tfvarsに記述します。

📝 変数 / ローカル変数の使い分け
Terraformで値を扱う場所には、大きく 変数(variables.tf + terraform.tfvars) と ローカル変数(localsブロック) の2種類があります。本セクションでは、「リポジトリにコミットしたくない値(機密情報や受講生ごとに異なる値)」は変数として variables.tf で宣言し、terraform.tfvars で値を指定します。terraform.tfvars は .gitignore でGit管理から除外します。一方、「この環境で使う固定値」(環境名、VPCのCIDR、AZ、DBユーザ名など)は main.tf の locals ブロックで直接定義します。こうすることで、ディレクトリ(environments/test/)とそこで使う値の対応関係が明確になり、リポジトリを見るだけで「この環境がどう構成されているか」が一目でわかるようになります。

1.2 main.tfの更新

environments/test/main.tfに、この環境で使う固定値をまとめたlocalsブロックを追記します。プロバイダ設定の下に以下を追加してください。

locals {
  env                = "test"
  project_name       = "${local.env}-noteapp"
  vpc_cidr           = "10.0.0.0/16"
  availability_zones = ["ap-northeast-1a", "ap-northeast-1c"]
  db_username        = "admin"
  db_name            = "notedb"
}
📝 project_nameについて
localsブロックでproject_nameを${local.env}-noteappと定義しています。envがtestなので、すべてのリソース名がtest-noteapp-vpc、test-noteapp-api-albのように環境名付きの名前になります。これにより、複数の環境が同じAWSアカウント内に共存できます。

コードを解説します。

env / project_name

locals {
  env          = "test"
  project_name = "${local.env}-noteapp"
}

envはこの環境の識別子です。ディレクトリ(environments/test/)がすでに環境を示しているため、localsで固定値としてハードコードします。本番環境を追加する際は、environments/prod/main.tfのlocalsでenv = "prod"と定義します。project_nameはenvをプレフィックスとしたリソース命名規則で、envがtestならtest-noteapp、prodならprod-noteappとなります。

vpc_cidr / availability_zones

locals {
  vpc_cidr           = "10.0.0.0/16"
  availability_zones = ["ap-northeast-1a", "ap-northeast-1c"]
}

VPCのCIDRブロックと、マルチAZ構成で使用するアベイラビリティゾーンのリストです。どちらもこの環境の固定値としてハードコードします。本番環境を追加する場合は、environments/prod/main.tfのlocalsで別の値(例:10.1.0.0/16)を設定することで、環境ごとに異なるCIDRブロックを使用できます。

db_username / db_name

locals {
  db_username = "admin"
  db_name     = "notedb"
}

RDSのマスタユーザ名とデータベース名です。機密情報ではなく、環境によって変える必要もないため、localsで固定値として定義します。

1.3 terraform.tfvars

environments/test/terraform.tfvarsに以下の内容を記述します。このファイルには、variables.tfで宣言した2つの変数(機密情報のdb_passwordと、受講生ごとに異なるdomain_name)の値だけを記述します。

db_password = "YourSecurePassword123!"
domain_name = "example.com"  # ご自身のドメイン名に置き換えてください

書き換えるのはこの2つの値だけです。他の設定値(env、vpc_cidr、availability_zonesなど)はmain.tfのlocalsで固定値として定義しているため、terraform.tfvarsに記述する必要はありません。

本番環境を追加する場合は、environments/prod/main.tfのlocalsでenv = "prod"などを定義し、environments/prod/terraform.tfvarsに本番用のパスワードとドメイン名を記述することで、同じモジュールを別の環境にデプロイできます。

📝 terraform.tfvarsの取り扱い
terraform.tfvarsには機密情報(データベースパスワード)が含まれます。Gitで管理する場合は、リポジトリにコミットしないよう.gitignoreに*.tfvarsを追加してください。
⚠️ 「No value for required variable」エラーが出る場合
terraform plan や terraform apply 実行時に Error: No value for required variable が出る場合、以下のいずれかが原因です。
1. terraform.tfvars の記述漏れ — db_password と domain_name の両方が記述されているか確認してください
2. ファイル名の間違い — terraform.tfvar(sなし)や terraform.tf.vars ではなく、正確に terraform.tfvars である必要があります
3. ファイルの配置場所の間違い — environments/test/ ディレクトリ直下にある必要があります

これで、モジュールを追加するための環境設定が整いました。次のセクションから、base、api、frontendの各モジュールを順番に作成していきます。