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コンソール上からバケットが削除されていればハンズオンは完了です。