使用 AWS CodePipeline 和 AWS CDK 設定 CI/CD 管道

在 macOS 或 Linux 上安裝工具。

如果您使用的是 MacOS 或 Linux，則可以通過在首選終端機中運行以下命令或使用 Linux 版自製軟件來安裝工具。

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 儲存庫做為遠端來源。

Connect 到 AWS 帳戶。

您可以使用臨時安全令牌或 landing zone 身份驗證進行連接。若要確認您使用的是正確的帳戶和 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 堆疊和輸出資訊。會CodePipeline.RepositoryName為您提供 AWS 帳戶中 CodeCommit 儲存庫的名稱。

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

提交變更以啟動管線。

成功的初始部署之後，您應該擁有一個完整的 CI/CD 管線，並將分main支SampleRepository做為來源分支。一旦您將變更提交至main分支，管線就會啟動並執行下列動作順序：

使用生成文件運行開發過程。

您可以使用make命令在本機執行整個管線，也可以執行個別步驟 (例如make linting)。

若要測試使用make，請執行下列動作：

刪除 AWS CDK 應用程式資源。

若要清理 AWS CDK 應用程式，請執行下列命令。

cdk destroy --all

請注意，在啟動載入期間建立的 Amazon 簡易儲存服務 (Amazon S3) 儲存貯體不會自動刪除。他們需要允許刪除的保留政策，或者您需要在 AWS 帳戶中手動刪除它們。