リモートバックエンドの準備

Terraformの状態ファイル(tfstate)をリモートで管理するために、S3バケットとDynamoDBテーブルを用意します。リモートバックエンドを使うことで、チームメンバー間での状態の共有、DynamoDBによるロックでの同時実行防止、S3のバージョニングによる状態ファイルの履歴管理が可能になります。

💡 ポイント
リモートバックエンドには、先に存在させておかないと最初の実行ができないという循環の問題があります。tfstateを保存するS3バケット自体をTerraformで作ろうとすると、「tfstateの保存先がまだ存在しないのに、Terraformを実行しなければならない」という矛盾が生じます。この問題を解決するため、S3バケットとDynamoDBテーブルは先にマネジメントコンソールで手動作成し、その後Terraformのimportブロックで管理下に取り込む方法を採用します。
📝 別の管理方法(bootstrap pattern)
本セクションでは、手動で作成したS3・DynamoDBをterraform importで同じstateに取り込む方式を採用していますが、実際には「bootstrap pattern」と呼ばれる別の方式も広く採用されています。これは、バックエンド用リソース(S3 + DynamoDB)専用のrootディレクトリを別途用意し、アプリケーション側のTerraform設定とは別のstateで管理するアプローチです。

import方式が向くケース: 単一環境の小規模構成、構成のシンプルさを優先したい場合
bootstrap patternが向くケース: 複数環境(dev / staging / prod等)を扱う、バックエンドとアプリケーションのライフサイクルを分離したい場合

両方とも実務で採用されている正当な選択肢です。本セクションでは構成のシンプルさを優先してimport方式を採用していますが、ポートフォリオやプロジェクトの規模に応じてbootstrap patternを選んでも構いません。

1. S3バケットの作成

リモートバックエンドでは、tfstateファイルの保存先としてS3バケットが必要です。ここでは、マネジメントコンソールでS3バケットを手動作成します。

AWSマネジメントコンソールでS3のダッシュボードを開き、「バケットを作成」をクリックします。

下記表に従い、設定を行ってください。記載のない項目はデフォルトのままで構いません。

設定項目 値 設定の基準
バケット名 noteapp-tfstate-{自分のAWSアカウントID} アカウントIDを含めてグローバルで一意にする
AWSリージョン アジアパシフィック(東京)ap-northeast-1 他のリソースと同じリージョンに配置
バケットのバージョニング 有効にする tfstateの変更履歴を保持し、誤操作時に復元可能にする

設定後、「バケットを作成」をクリックします。

無事にS3バケットが作成されれば、ここまでの操作は完了です。

📝 バケット名にアカウントIDを含める理由
S3バケット名はグローバルで一意である必要があります。アカウントIDを含めることで、他のAWSアカウントとの名前の衝突を防ぎます。

2. DynamoDBテーブルの作成

S3バケットだけでは、複数人が同時にterraform applyを実行した場合にtfstateが競合する可能性があります。DynamoDBテーブルを用意することで、Terraformが排他ロックを取得し、同時実行による破損を防止できます。

AWSマネジメントコンソールでDynamoDBのダッシュボードを開き、「テーブルの作成」をクリックします。

下記表に従い、設定を行ってください。記載のない項目はデフォルトのままで構いません。

設定項目 値 設定の基準
テーブル名 noteapp-tfstate-lock Terraformのロックテーブルであることがわかる名前
パーティションキー LockID(文字列) Terraformのロック機構が使用するキー名
テーブル設定 設定をカスタマイズ キャパシティモードを変更するため
キャパシティモード オンデマンド ロック用途のためアクセス頻度が低く、オンデマンドが最適

設定後、「テーブルの作成」をクリックします。

DynamoDBテーブルが作成されたら、リモートバックエンドの準備は完了です。この後、Terraformの初期化時にこれらのリソースがバックエンドとして正しく機能することを確認します。