使用 AWS 和 AW CodePipeline S CDK 设置 CI/CD 管道

在 macOS 或 Linux 上安装工具。

如果您使用的是 macOS 或 Linux，则可以通过在首选终端中运行以下命令或使用 Homebrew for 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 存储库作为远程来源。

连接至 Amazon Web Services account。

您可使用临时安全令牌或登录区身份验证进行连接。要确认您使用的是正确的账户和 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 分支的更改，管线就会启动并运行以下操作序列：

使用 Makefile 运行开发过程。

您可使用 make 命令在本地运行整个管线，也可以运行单个步骤（例如 make linting）。

要使用 make 进行测试，请执行以下操作：

删除 AWS CDK 应用程序资源。

要清理您的 AWS CDK 应用程序，请运行以下命令。

cdk destroy --all

请注意，引导启动期间创建的 Amazon Simple Storage Service (Amazon S3) 存储桶将不会自动删除。它们需要允许删除的保留策略，或者您需要在您的 Amazon Web Services account 中手动删除它们。