チュートリアル：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. ほとんどの場合、IntelliJ IDEA は Terraform のインストールパスを検出します。 IDE がバージョンや実行可能ファイルのパスを検出しない場合は、 検出とテスト をクリックしてください。

   Terraform がコンピューターにインストールされていない場合は、 インストール をクリックしてください。

   

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

1. IntelliJ IDEA を起動してください。

   新しいプロジェクトを開始するには、次のいずれかを実行します。

   • 'ようこそ' 画面で 新規プロジェクト をクリックします。

   • メインメニューから ファイル | 新規 | プロジェクト を選択します。

   • メインウィンドウのヘッダーにあるプロジェクトウィジェットをクリックし、 新規プロジェクト を選択します。

     

2. 左側のリストから 空のプロジェクト を選択します。

3. 名前 フィールドにプロジェクトの名前を入力します。

4. ロケーション フィールドに、プロジェクトの場所へのパスを入力または選択します。

5. Git リポジトリの作成 オプションを選択して、新しいプロジェクトをバージョン管理下に置きます。

   後でいつでもそれを行うことができます。

6. 作成 をクリックします。

   

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

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

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

   

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

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

1. main.tf ファイルで、 provider ブロックの入力を開始してください：

   provider ""

2. コード補完 (Ctrl+Space) を呼び出し、 aws を 補完候補リストから選択してください：

   provider "aws" { }

   この操作を行うと、IntelliJ IDEA はファイル先頭に terraform ブロックも自動挿入します。 このブロックは 必要なプロバイダーとそのバージョンを構成用に定義しています。

   これらのステップ実行中後、構成は次のようになります：

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

3. provider ブロック内でコード補完を使い、 リージョン と profile の引数を追加します。

4. 引数の値を設定してください。例：

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

   リージョン は 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 バケットが除去されたことを確認してください。