AWS CodePipeline, GitHub 저장소 변경점 발생시 S3에 업로드하기

개요

• 이번 글에서는 특정 GitHub 저장소에 위치한 파일에 변경점이 생겼을 때 지정된 S3로 업로드하는 방법을 정리하였다.

사전조건

• AWS CodePipline에 대한 기본적인 이해가 있어야 한다. 본 블로그의 이 글을 참고한다.

배포 시나리오

• GitHub에 위치한 jsonobject/foo-config 저장소에 아래 구조로 ECS의 컨테이너 환경 변수가 관리되고 있다. 이 파일들은 최신 버전이 S3에 업로드되어 ECS의 작업 정의에 연동되어야 한다.

/foo-env-dev
ㄴ foo-backend-dev.env
ㄴ foo-frontend-dev.env
/foo-env-staging
ㄴ foo-backend-staging.env
ㄴ foo-frontend-staging.env
/foo-env-qa
ㄴ foo-backend-qa.env
ㄴ foo-frontend-qa.env
/foo-env-prod
ㄴ foo-backend-prod.env
ㄴ foo-frontend-prod.env

buildspec.yml 작성

• 저장소 루트에 아래와 같이 buildspec.yml 파일을 작성한다.

version: 0.2

phases:
  install:
    runtime-versions:
      java: corretto11
  build:
    commands:
      - echo Syncing environment variables...
      - aws --version
      - aws s3 sync ./foo-env-dev s3://foo-env-dev
      - aws s3 sync ./foo-env-staging s3://foo-env-staging
      - aws s3 sync ./foo-env-qa s3://foo-env-qa
      - aws s3 sync ./foo-env-prod s3://foo-env-prod
  post_build:
    commands:
      - echo Environment variable synchronization is complete.

파이프라인 생성

• 아래와 같이 파이프라인을 생성한다.

AWS CodePipeline 콘솔 접속
→ [파이프라인 생성] 클릭

# 파이프라인 설정
→ 파이프라인 이름: foo-config (입력)
→ 서비스 역할: [새 서비스 역할] 선택
→ 역할 이름: codepipeline-foo-config (입력)
→ [다음] 클릭

# 소스
→ 소스 공급자: [GitHub(버전 2)] 선택
→ 연결: [GitHub에 연결] 클릭
→ 연결 이름: arn:aws:codestar-connections:us-east-1:339071334445:connection/{id} (입력)
→ [GitHub에 연결] 클릭
→ [새 앱 설치] 클릭
→ [연결] 클릭
→ 리포지토리 이름: jsonobject/foo-config (선택)
→ 브랜치 이름: main (선택)
→ 출력 아티팩트 형식: [Codepipeline 기본값] 선택
→ [다음] 클릭

# 빌드
→ 빌드 공급자: [AWS CodeBuild]
→ 리전: [미국 동부 (버지니아 북부)]
→ [프로젝트 생성] 클릭

# 빌드 > 프로젝트 생성 > 프로젝트 구성
→ 프로젝트 이름: foo-config( 입력)

# 빌드 > 프로젝트 생성 > 환경
→ 환경 이미지: [관리형 이미지] 선택
→ 운영 체제: [Amazon Linux 2] 선택
→ 런타임: [Standard] 선택
→ 이미지: [aws/codebuild/amazonlinux2-x86_64-standard:3.0] 선택
→ 이미지 버전: [이 런타임에 항상 최신 이미지 사용] 선택
→ 환경 유형: [Linux] 선택
→ [도커 이미지를 빌드하거나 빌드의 권한을 승력하려면 이 플래그를 활성화합니다.] 선택
→ 서비스 역할: [새 서비스 역할] 선택
→ 역할 이름: codebuild-foo-config (입력)

# 빌드 > 프로젝트 생성 > Buildspec
→ 빌드 사양: [buildspec 파일 사용] 사용
→ buildspec 이름: buildspec.yml (입력)

# 빌드 > 프로젝트 생성
→ [Code Pipeline으로 계속] 클릭

# 빌드
→ [다음] 클릭

# 배포
→ [배포 스테이지 건너뛰기] 클릭

# 검토
→ [파이프라인 생성] 클릭

권한 부여

• 생성한 파이프라인은 S3 파일 업로드 기능을 사용하므로 파이프라인 생성시 함께 생성된 codebuild-foo-config 역할에 AmazonS3FullAccess 정책을 연결해야 파이프라인이 정상 작동한다.