AWS 및 CodePipeline AWS CDK를 사용하여 CI/CD 파이프라인을 설정합니다.

macOS 또는 Linux에 도구를 설치합니다.

MacOS 또는 Linux를 사용하는 경우, 선호하는 터미널에서 다음 명령을 실행하거나 Linux용 Homebrew를 사용하여 도구를 설치할 수 있습니다.

brew install
brew install git-remote-codecommit
brew install ruby brew-gem
brew-gem install cfn-nag

AWS Cloud9를 사용하여 도구를 설치합니다.

AWS Cloud9를 사용하는 경우 다음 명령을 실행하여 도구를 설치합니다.

gem install cfn-nag

참고: AWS Cloud9에는 Node.js 및 npm이 설치되어 있어야 합니다. 설치 또는 버전을 확인하려면 다음 명령을 실행합니다.

node -v
npm -v

AWS CLI를 설정합니다.

AWS CLI를 설정하려면, 운영 체제에 대한 지침을 사용합니다.

코드를 다운로드하거나 복제합니다.

이 패턴에서 사용되는 코드를 가져오려면 다음 중 하나를 수행합니다.

git clone --depth 1 https://github.com/aws-samples/aws-codepipeline-cicd.git

복제된 리포지토리에서 .git 디렉터리를 제거합니다.

cd ./aws-codepipeline-cicd
rm -rf ./.git

나중에 새로 만든 AWS CodeCommit 리포지토리를 원격 오리진으로 사용하게 됩니다.

AWS 계정에 연결합니다.

임시 보안 토큰 또는 랜딩 존 인증을 사용하여 연결할 수 있습니다. 올바른 계정과 AWS 리전을 사용하고 있는지 확인하려면 다음 명령을 실행하십시오.

AWS_REGION="eu-west-1"
ACCOUNT_NUMBER=$(aws sts get-caller-identity --query Account --output text)
echo "${ACCOUNT_NUMBER}"

환경을 부트스트랩합니다.

AWS CDK 환경을 부트스트랩하려면 다음 명령을 실행합니다.

npm install
npm run cdk bootstrap "aws://${ACCOUNT_NUMBER}/${AWS_REGION}"

환경을 성공적으로 부트스트랩한 후에는 다음 출력이 표시되어야 합니다.

⏳  Bootstrapping environment aws://{account}/{region}...
✅  Environment aws://{account}/{region} bootstrapped

AWS CDK 부트스트래핑에 대한 자세한 내용은 AWS CDK 설명서를 참조하세요.

템플릿을 합성합니다.

AWS CDK 앱을 합성하려면 cdk synth 명령을 사용합니다.

npm run cdk synth

다음과 같이 출력되어야 합니다.

Successfully synthesized to <path-to-directory>/aws-codepipeline-cicd/cdk.out
Supply a stack id (CodePipeline, Dev-MainStack) to display its template.

CodePipeline 스택 배포.

이제 CloudFormation 템플릿을 부트스트랩하고 합성했으니 배포할 수 있습니다. 배포를 통해 CodePipeline 파이프라인과 리포지토리가 생성되며, 이 CodeCommit 리포지토리가 파이프라인의 소스이자 트리거가 됩니다.

npm run cdk -- deploy CodePipeline --require-approval never

명령을 실행하면 CodePipeline 스택과 출력 정보가 성공적으로 배포된 것을 확인할 수 있습니다. 는 AWS 계정의 CodeCommit 리포지토리 이름을 CodePipeline.RepositoryName 제공합니다.

CodePipeline: deploying...
CodePipeline: creating CloudFormation changeset...
✅  CodePipeline
Outputs:
CodePipeline.RepositoryName = SampleRepository
Stack ARN:
arn:aws:cloudformation:REGION:ACCOUNT-ID:stack/CodePipeline/STACK-ID

원격 CodeCommit 리포지토리 및 브랜치를 설정합니다.

배포에 CodePipeline 성공하면 AWS CodePipeline 콘솔에서 찾을 수 있는 파이프라인의 첫 번째 실행이 시작됩니다. AWS CDK는 기본 브랜치를 시작하지 CodeCommit 않기 때문에 이 초기 파이프라인 실행은 실패하고 다음 오류 메시지를 반환합니다.

The action failed because no branch named main was found in the selected AWS CodeCommit repository SampleRepository. Make sure you are using the correct branch name, and then try again. Error: null

이 오류를 수정하려면 원격 오리진을 SampleRepository로 설정하고 필요한 main 브랜치를 생성하십시오.

RepoName=$(aws cloudformation describe-stacks --stack-name CodePipeline --query "Stacks[0].Outputs[?OutputKey=='RepositoryName'].OutputValue" --output text)
echo "${RepoName}"
#
git init
git branch -m master main
git remote add origin codecommit://${RepoName}
git add .
git commit -m "Initial commit"
git push -u origin main

파이프라인을 활성화하려면 변경 사항을 커밋하십시오.

초기 배포에 성공하면 SampleRepository의 main 브랜치를 소스 브랜치로 사용하는 완전한 CI/CD 파이프라인을 갖추어야 합니다. main 브랜치에 변경 사항을 커밋하는 즉시 파이프라인은 다음과 같은 일련의 작업을 시작하고 실행합니다.

Makefile을 사용하여 개발 프로세스를 실행합니다.

make 명령을 사용하여 전체 파이프라인을 로컬에서 실행하거나 개별 단계를 실행할 수 있습니다(예: make linting).

make를 사용하여 테스트하려면 다음 작업을 수행합니다.

AWS CDK 앱 리소스를 삭제합니다.

AWS CDK 앱을 정리하려면 다음 명령을 실행합니다.

cdk destroy --all

부트스트래핑 중에 생성된 Amazon Simple Storage Service(Amazon S3) 버킷은 자동으로 삭제되지 않는다는 점을 유의해 주십시오. 삭제를 허용하는 보존 정책이 필요하거나 AWS 계정에서 수동으로 삭제해야 합니다.