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

종속 항목 설치

필요한 종속성을 설치하려면 다음 명령을 실행합니다.

# 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

생성된 PRs 및 변경 사항을 검토합니다.

GitHub 워크플로 실행 결과를 모니터링하려면 다음을 수행합니다.

(선택 사항) 정리.

중단되거나 불필요한 PRs 닫습니다.