TerraformによるAWSリソースの作成

実際にTerraformを使ってAWSリソースを作成するハンズオンを行います。

1. ハンズオンの概要

実際にTerraformを使ってAWSリソースを作成するハンズオンを行います。

今回は、シンプルなS3バケットを作成します。

2. Terraformの初期化

2.1 作業フォルダの作成

任意の場所にterraform-basic-handsonフォルダを作成し、Visual Studio Codeの「ファイル」→「フォルダーを開く」から、作成したterraform-basic-handsonフォルダを開きます。

terraform-basic-handson  ← このフォルダを作成

2.2 main.tfの作成

main.tfファイルを作成します。Visual Studio Codeのエクスプローラーでterraform-basic-handsonフォルダを右クリックし、「新しいファイル」を選択してmain.tfという名前で作成してください。

terraform-basic-handson
└── main.tf  ← このファイルを作成

2.3 プロバイダブロックの作成

作成したファイルに以下の内容を記述して保存します。ここでは、AWSを使用するための設定(プロバイダブロック)として、リージョンに東京リージョンを指定しています。

provider "aws" {
  region = "ap-northeast-1" # 東京リージョン
}

2.4 terraform initの実行

以下のコマンドで、Terraform がインストールされていることを確認します。

terraform --version

以下のように Terraform のバージョンが表示されれば、インストールは確認できています。

Terraform v1.9.8
on darwin_arm64

バージョンが表示されない場合は、Terraformのインストール を先に実施してください。

インストールが確認できたら、記述したプロバイダ(今回はAWS)に必要なプラグインをダウンロードするために、初期化コマンドを実行します。

Visual Studio Codeにて、「ターミナル」メニューから「新しいターミナル」を選択すると、下の方にターミナルが表示されます。

ターミナルで作業ディレクトリに移動し、以下を実行してください。

terraform init

以下のメッセージが表示されれば、ここまでは成功です。

Terraform has been successfully initialized!
⚠️ 認証エラーが出る場合
terraform initが成功しても、後続のterraform planやterraform applyで「No valid credential sources found」や「AuthorizationError」が表示される場合があります。
これはAWS CLIの認証設定が完了していないことが原因です。
aws configureコマンドでアクセスキーとシークレットキーを設定するか、AWS CLIの設定が正しく行われているか確認してください。

3. Terraformコードの作成

3.1 リソースブロックの作成

続いて、S3バケットを作成するための定義(リソースブロック)を main.tf に追記します。先ほど記述したプロバイダブロックの下に、以下の内容を追記して保存します。

resource "aws_s3_bucket" "example" {
  bucket = "my-unique-bucket-name-2025-test" # 必ず変更してください
}

bucket の値(バケット名)は、世界中で一意(ユニーク)である必要があります。末尾に日付や自分の名前を入れるなどして、他の人と被らない名前に変更してください。

4. 実行計画

4.1 terraform planの実行

実際にリソースを作成する前に、コードに基づいてどのような変更が行われるかを確認(ドライラン)します。

下記のコマンドを実行してください。

terraform plan

4.2 変更内容の確認

コマンドを実行すると、多くのログが表示されます。以下の2点に注目して確認してください。

出力の途中に、以下のように緑色(環境による)の + 記号が表示されている箇所を探してください。

# aws_s3_bucket.example will be created
+ resource "aws_s3_bucket" "example" {
    + acceleration_status         = (known after apply)
    + acl                         = (known after apply)
    + bucket                      = "my-unique-bucket-name..."
    ...
  }

この + (プラス記号) は、そのリソースが「新規作成」(add)されることを意味しています(逆に - なら削除、~ なら変更を意味します)。

また、出力の最後に以下の行が表示されているか確認してください。

Plan: 1 to add, 0 to change, 0 to destroy.

これは「1つのリソースを追加、0個を変更、0個を削除」する計画であることを示しています。 エラーが出る場合は、コードのスペルミスや、bucket 名がすでに他で使用されていないかなどを確認してください。

⚠️ 「BucketAlreadyExists」エラーが出る場合
S3バケット名は全世界で一意である必要があります。
別の名前(例えば末尾に日付やランダムな文字列を追加)に変更してください。
⚠️ 構文エラーが出る場合
「Error: Unsupported argument」や「Error: Missing required argument」が表示される場合は、コードの構文エラーです。
=の前後にスペースがあるか、波括弧{}が正しく閉じているか、文字列がダブルクォート""で囲まれているかを確認してください。

5. 実行

5.1 terraform applyの実行

計画内容に問題がなければ、実際にAWSへ適用してリソースを作成します。

terraform apply

途中で確認を求められるので、yes と入力してEnterキーを押してください。

「Apply complete!」と表示されれば作成成功です。

⚠️ 「Terraform AWS Provider」エラーが出る場合
AWSの認証情報が設定されていないか、無効です。
aws configureコマンドで認証情報を設定してください。
また、設定したIAMユーザに適切な権限(今回の場合はS3へのアクセス権限)があることを確認してください。
⚠️ 「Still creating...」が長時間続く場合
terraform apply実行後に「Still creating...」が10秒以上出続ける場合は、IAMユーザの権限が不足している可能性があります。Terraformはリソース作成後にAWS APIで結果を確認するため、作成権限だけでなく読み取り権限も必要です。
AWS CLIのインストールで作成したcli-user(AdministratorAccess付き)を使用しているか確認してください。別のIAMユーザを使用している場合は、AdministratorAccessポリシーを付与するか、aws configureでcli-userのアクセスキーに切り替えてください。

5.2 stateファイルの確認

作業ディレクトリ内に terraform.tfstate というファイルが生成されています。 これはTerraformが管理しているリソースの現在の状態(State)を記録した重要なファイルです。中身を見て、作成したバケットの情報(ARNやIDなど)がJSON形式で記録されていることを確認してください。

5.3 作成されたリソースの確認

terraform apply コマンドの実行が完了したら、実際にAWSマネジメントコンソールにアクセスして、S3バケットが正しく作成されているかを確認しましょう。

まず、ブラウザからAWSマネジメントコンソールにログインし、画面上部にある検索バーに「S3」と入力します。検索結果のサービス欄に表示される「S3」を選択して、S3のダッシュボードへ移動してください。

バケットの一覧画面が表示されますので、リストの中に先ほど main.tf ファイルで指定した名前のバケットが存在しているかを探します。指定した名前のバケットが見つかれば、TerraformによるS3バケットの作成は成功です。

6. リソースの削除

ハンズオン終了後は、不要な課金を防ぐために作成したリソースを削除します。Terraformでは、terraform destroy というコマンドを実行すると、Terraformで作成したリソースの削除が行えます。

terraform destroy

terraform apply と同様に確認を求められますので、yes と入力します。 「Destroy complete!」と表示され、AWSコンソール上からバケットが削除されていればハンズオンは完了です。