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

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

   

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

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

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

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

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

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

     

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

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

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

5. インタープリター フィールドで、プロジェクトで使用する Ruby インタープリターを選択します。

6. 作成 をクリックしてください。

   

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

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

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

   

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

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

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

   provider ""

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

   provider "aws" { }

   この操作を行うと、RubyMine は 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 バケットが削除されたことを確認してください。