1. 개요

본 계획은 하이브리드 클라우드 기반 DR 시스템을 위한 애플리케이션 및 인프라 CI/CD 파이프라인 구축을 목표로 합니다. 웹 소스 코드 변경 시 자동으로 Docker 이미지를 빌드하여 Docker Hub에 푸시하고, ArgoCD가 바라보는 gitops-repo를 업데이트하여 자동 배포를 수행합니다. 또한, AWS EKS 인프라를 원클릭으로 가동할 수 있는 Terraform Apply 자동화 워크플로우를 구성합니다.

2. 세부 구현 계획

A. Websource CI/CD 파이프라인 (애플리케이션 자동 배포)

목표: 애플리케이션 코드가 업데이트되면 자동으로 새 이미지가 생성되고, 온프레미스 및 AWS의 ArgoCD를 통해 무중단 배포되도록 구성.

1. Dockerfile 생성 (Websource/Dockerfile)
   • php:8.0-apache 이미지를 베이스로 사용하고, sam_main_web.php를 /var/www/html/index.php로 복사하여 서비스하도록 구성.
2. GitHub Actions CI 워크플로우 생성 (Websource/.github/workflows/ci.yml)
   • 트리거: main 브랜치에 push 이벤트 발생 시.
   • Docker Build & Push: GitHub Secrets에 저장된 Docker Hub 인증 정보(DOCKER_USERNAME, DOCKER_PASSWORD)를 사용해 로그인 후, [DOCKER_USERNAME]/hybrid-dr-web:[GITHUB_SHA] 형태로 이미지를 푸시.
   • GitOps 레포 업데이트:
     • 팀원의 PAT(PAT_TOKEN Secret)를 사용하여 gitops-repo를 체크아웃.
     • my_web_chart/aws/values.yaml 및 my_web_chart/OnPremise/values.yaml 내부의 phpApp.image 값을 방금 푸시한 새 이미지 태그로 변경 (sed 또는 yq 사용).
     • 변경 사항을 gitops-repo에 Commit 및 Push.
   • ArgoCD 배포: gitops-repo가 업데이트되면 ArgoCD가 이를 감지하고 파드를 재시작하여 자동 적용.

B. Infra_terraform CD 파이프라인 (인프라 원클릭 가동)

목표: 재해 또는 필요 시 AWS EKS를 포함한 클라우드 인프라를 깃허브 액션에서 버튼 한 번으로 전체 프로비저닝할 수 있도록 구성.

1. Terraform Remote Backend 설정 (provider.tf 수정)
   • 이미 생성된 S3 버킷과 DynamoDB 테이블을 사용하여 Terraform 상태(State)를 관리하도록 backend "s3" 블록 추가.
   • 이를 통해 여러 환경에서 동일한 상태를 공유하고 상태 잠금(Locking)을 통해 충돌 방지.
2. GitHub Actions Provisioning 워크플로우 생성 (Infra_terraform/.github/workflows/provision.yml)
   • 트리거: 수동 실행 이벤트(workflow_dispatch)
   • AWS 자격 증명: OIDC Token 방식(aws-actions/configure-aws-credentials) 활용.
   • Terraform 실행:
     • terraform init (Remote Backend 초기화 포함)
     • terraform plan
     • terraform apply -auto-approve 를 차례대로 실행하여 인프라 생성.

3. 요구되는 사전 준비사항 (Secrets)

이 파이프라인이 동작하기 위해 각 GitHub 리포지토리의 Settings -> Secrets and variables -> Actions에 다음 값들이 등록되어야 합니다.

Websource 레포지토리:

• DOCKER_USERNAME: Docker Hub 계정명
• DOCKER_PASSWORD: Docker Hub 비밀번호 또는 Access Token
• PAT_TOKEN: gitops-repo에 접근 및 푸시 권한이 있는 GitHub Personal Access Token

Infra_terraform 레포지토리:

• AWS_DEPLOY_ROLE_ARN: AWS 접근을 위한 IAM Role

4. 검증 방법