チュートリアル：Terraform を使って AWS S3 バケットをデプロイする

AWS 資格情報を設定する

1. システムターミナルで次のコマンドを実行し、名前付きプロファイルを設定します：

   aws configure --profile terraform-user

   名前付きプロファイルを使うことで、同じマシン上で複数の AWS アカウントや構成を管理できます。 ここで指定したプロファイル名は後ほど Terraform 構成で使用されます。

2. プロンプトが表示されたら、次の内容を入力してください：

   • AWS アクセスキー ID：作成した IAM ユーザーのもの。

   • AWS シークレットアクセスキー：作成した IAM ユーザーのもの。

   • デフォルトリージョン名：リソースを作成するリージョン。 例: us-east-1 または eu-central-1。 サポートされているリージョンの詳細については、 公式ドキュメントを参照してください。

   • デフォルト出力フォーマット： Enter を押すとデフォルトフォーマット（JSON）が使用されます。

3. 資格情報が正しく設定されているかは、次のコマンドを実行して確認できます：

   aws sts get-caller-identity --profile terraform-user

   構成が成功すると、コマンドが IAM ユーザーの詳細を返します。

Terraform と HCL プラグインをインストールする

この機能は、インストールして有効にする必要がある Terraform と HCL(英語) プラグインに依存しています。

1. Ctrl+Alt+S を押して設定を開き、 プラグイン を選択します。

2. Marketplace タブを開き、 Terraform と HCL プラグインを見つけて、 インストール​する​ をクリックします (プロンプトが表示されたら、IDE を再起動します)。

Terraform 実行パスを指定する

実行構成を使用して IDE から Terraform コマンドを実行するには、マシンに Terraform がインストールされている必要があります。

1. Ctrl+Alt+S を押して設定を開き、 ツール | Terraform ツール を選択します。

2. ほとんどの場合、PhpStorm は Terraform 実行可能ファイルへのパスを自動的に検出します。 IDE が実行ファイルのバージョンとパスを検出しない場合は、 検出とテスト をクリックしてください。

   マシンに Terraform がインストールされていない場合は、 インストール​する​ をクリックします。

   

3. 必要に応じて、 Terraform 実行可能ファイルのパス フィールドに Terraform へのパスを手動で指定できます。

1. 新規プロジェクト ダイアログから PHP 空プロジェクト を選択します。

2. 新しいプロジェクトに名前を付け、必要に応じて ロケーション フィールドでその場所を変更します。

3. 空のプロジェクトに composer.json ファイルテンプレートを追加する場合は、 「composer.json」を追加 チェックボックスを選択します。

作成 をクリックすると、PhpStorm がプロジェクトスタブを生成し、表示される情報ダイアログで選択した方法に応じて、現在のウィンドウまたは新しいウィンドウで開きます：

新しい Terraform ファイルを作成する

1. プロジェクト ツールウィンドウ（Alt+1 ）で、プロジェクトルートを右クリックし、 新規｜Terraform ファイル を選択します。

2. 新規ファイル ダイアログで、新規ファイル名を main とし、リストから 構成 ファイルテンプレートを選択します。 Enter を押します。

   

   PhpStorm はプロジェクトルートに main.tf ファイルを作成し、エディターで開きます。

AWS プロバイダーを追加する

1. main.tf ファイルで、 provider ブロックの入力を始めます：

   provider ""

2. コード補完（Ctrl+Space ）を実行し、 aws を 補完候補リストから選択します：

   provider "aws" { }

   この操作により、PhpStorm はファイルの先頭に terraform ブロックも挿入します。 このブロックは 必要なプロバイダー やそのバージョンを構成内で定義します。

   これらの手順後、構成は次のようになります：

   terraform { required_providers { aws = { source = "hashicorp/aws" version = "6.36.0" } } } provider "aws" { }

3. provider ブロック内で、コード補完を使って region と profile 引数を追加します。

4. 引数の値を設定します。例：

   provider "aws" { region = "eu-west-1" profile = "terraform-user" }

   region は Terraform がリソースを作成する場所を指定し、 profile は使用する AWS 資格情報を指定します。

S3 バケットリソースを追加する

1. main.tf ファイルで、 resource の入力を始めます。 続いてコード補完（Ctrl+Space ）を使い、 aws_s3_bucket リソースタイプを選択します。 リソースの命名を tutorial_bucket にします。 構成は次のようになります：

   resource "aws_s3_bucket" "tutorial_bucket" {}

2. resource ブロック内で bucket と入力し、コード補完で引数を追加します。 バケット名を一意なものに指定してください。例：

   resource "aws_s3_bucket" "tutorial_bucket" { bucket = "ij-idea-terraform-tutorial-bucket-123" }

プロジェクトを初期化する

terraform init コマンドは Terraform プロジェクトを初期化し、必要なプロバイダーをダウンロードして作業ディレクトリを準備します。 同時に .terraform.lock.hcl ファイルを作成し、プロジェクトで使用した正確なプロバイダーバージョンを記録して、実行や環境間での一貫した動作を保証します。

1. main.tf ファイルで、ガターの Terraform を実行 をクリックします。

2. ドロップダウンリストから Init コマンドを選択します。

実行プランをプレビューする

1. 実行 | 実行構成の編集 に進みます。 または、 Alt+Shift+F10 を押してから 0 を押します。

2. () 新規構成の追加​ をクリックし、 Terraform の入力を開始します。

   

3. リストから Terraform プラン 構成タイプを選択します。

4. 実行/デバッグ構成の命名を行います。たとえば Plan S3 Bucket。

5. プログラム引数 フィールドに -out=tfplan 引数を指定します。

6. 実行 をクリックしてください。

構成を適用する

1. 前のプロシージャと同様に、新しい実行/デバッグ構成を作成します。 リストから Terraform 適用 構成タイプを選択します。

2. 実行/デバッグ構成の命名を行います。たとえば Apply S3 Bucket。

3. プログラム引数 フィールドに tfplan 引数を指定します。

   リソース作成時、Terraform は tfplan ファイルに保存された実行プランを使用します。

4. 実行 をクリックしてください。

5. 構成を適用したら、AWS マネジメントコンソールで S3 バケットが正常に作成されたか確認してください。

S3 バケットを削除する

1. main.tf ファイルで、ガターの Terraform を実行 をクリックします。

2. ドロップダウンリストから Destroy コマンドを選択します。

3. 処理が完了したら、AWS マネジメントコンソールで S3 バケットが削除されたことを確認してください。