GitHub Actions を使用して Terraform マネージド AWS インフラストラクチャの自動プルリクエストを作成する

リポジトリを設定します。

リポジトリのクローンを作成するには、次のコマンドを実行します。

# Clone the automation tool repository
git clone https://github.com/aws-samples/sample-terraform-pr-automation-utility
cd sample-terraform-pr-automation-utility

# Copy example configuration
cp config.example.yaml config.yaml

依存関係をインストールします。

次のコマンドを実行して、Python の依存関係をインストールし、検証します。

# Install Python dependencies
pip3 install -r requirements.txt

# Verify installation
python3 -c "import github; import hcl2; import yaml; import requests; print('All packages installed successfully')"

GitHub トークンを設定します。

GitHub トークンを設定し、それが機能することを確認するには、次のコマンドを実行します。

# Set GitHub token environment variable
export GITHUB_TOKEN="your_github_token_here"

# Verify token works
curl -H "Authorization: token $GITHUB_TOKEN" https://api.github.com/user

config.yaml ファイルを設定します。

ターゲットリポジトリと必要な変更を定義するには、次のように config.yaml ファイルを編集します。

repositories:
  - owner: "your-org"
    repo: "your-terraform-repo"
    files:
      - path: "variables.tf"
        changes:
          variables:
            - app_version:
                default:
                  update:
                    - from: ["1.0.0"]
                      to: "1.1.0"

settings:
  pr_title_template: "Infrastructure Update - {{timestamp}}"
  slack:
    username: "Terraform Bot"
    icon_emoji: ":terraform:"
    notify_on_success: true
    notify_on_error: true
    notify_batch_summary: true

事前テストを実行します。

本番用リポジトリで実行する前に、必ず設定をテストしてください。次のコマンドを使用します。

# 1. Test configuration syntax
python3 -c "from main import get_config_content; get_config_content()"

# 2. Run in dry-run mode first
DRY_RUN=true python3 main.py

# 3. Test with minimal configuration
# Use a simple config.yaml with just one repository and one change

リポジトリへのアクセスを確認します。

GitHub トークンがリポジトリにアクセスできることを確認するには、次のコマンドを実行します。

# Test GitHub token access
curl -H "Authorization: token $GITHUB_TOKEN" \
  https://api.github.com/repos/owner/repo-name

# Should return repository information, not 404

GitHub Actions UI を使用して自動化ユーティリティを実行します。

GitHub Actions UI を使用して自動化ユーティリティを実行するには、次の手順を実行します。

(代替) コマンドラインから自動化ユーティリティを実行します。

必要に応じて、GitHub Actions UI ではなく、コマンドラインから自動化ユーティリティを実行できます。以下のコマンドを使用します。

# Run actual automation
python3 main.py

作成された PR と変更を確認します。

GitHub ワークフロー実行の結果をモニタリングするには、次を実行します。

(オプション) PR をクリーンアップします。

中止された、もしくは不要な PR を閉じます。