チュートリアル：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. マーケットプレース タブを開き、 Terraform と HCL プラグインを見つけて、 インストールする をクリックします (プロンプトが表示されたら、IDE を再起動します)。

Terraform 実行パスを指定する

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

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

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

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

   

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

1. PyCharm を起動します。

   新しいプロジェクトを開始するには、次のいずれかを実行してください：

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

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

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

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

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

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

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

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

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

新規 Terraform ファイルを作成する

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

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

   

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

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

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

   provider ""

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

   provider "aws" { }

   この操作をすると、PyCharm はファイルの先頭に 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. 実行 | 実行構成の編集 に進みます。 または、 実行 ウィジェットで をクリックし、ドロップダウンメニューから 実行構成の編集 を選択します。

   

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 バケットが削除されていることを確認してください。