Configure um pipeline de CI/CD usando a AWS e o CodePipeline AWS CDK

Instale ferramentas no Linux ou no macOS.

Se você estiver usando macOS ou Linux, poderá instalar as ferramentas executando o seguinte comando no terminal de sua preferência ou usando o Homebrew para Linux.

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

Instale ferramentas usando o AWS Cloud9.

Se você estiver usando o AWS Cloud9, instale as ferramentas executando o comando a seguir.

gem install cfn-nag

Observação: o AWS Cloud9 deve ter o Node.js e o npm instalados. Para verificar a instalação ou a versão, execute o comando a seguir.

node -v
npm -v

Configure a AWS CLI.

Para configurar a AWS CLI, use as instruções para seu sistema operacional:

Faça download ou clonagem do código.

Para obter o código usado por esse padrão, siga um destes procedimentos:

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

Remova o diretório .git do repositório clonado.

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

Posteriormente, você usará um CodeCommit repositório AWS recém-criado como origem remota.

Conecte-se à conta da AWS.

Você pode se conectar usando um token de segurança temporário ou autenticação de zona de pouso. Para confirmar que você está usando a conta e a região da AWS corretas, execute os comandos a seguir.

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

Faça o bootstrap do ambiente.

Para fazer o bootstrap de um ambiente AWS CDK, execute os seguintes comandos:

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

Depois de inicializar o ambiente com sucesso, a saída a seguir deve ser exibida.

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

Para obter mais informações sobre o bootstrapping do AWS CDK, consulte a documentação do AWS CDK.

Sintetize um modelo.

Para sintetizar um aplicativo do AWS CDK, use o comando cdk synth.

npm run cdk synth

Você verá a saída a seguir.

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

Implante a CodePipeline pilha.

Agora que você inicializou e sintetizou o CloudFormation modelo, você pode implantá-lo. A implantação criará o CodePipeline pipeline e um CodeCommit repositório, que serão a fonte e o gatilho do pipeline.

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

Depois de executar o comando, você deverá ver uma implantação bem-sucedida das informações de CodePipeline pilha e saída. CodePipeline.RepositoryNameFornece o nome do CodeCommit repositório na conta da AWS.

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

Configure o CodeCommit repositório e a ramificação remotos.

Depois de uma implantação bem-sucedida, CodePipeline iniciará a primeira execução do pipeline, que você pode encontrar no CodePipeline console da AWS. Como o AWS CDK e CodeCommit não iniciam uma ramificação padrão, essa execução inicial do pipeline falhará e retornará a seguinte mensagem de erro.

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

Para corrigir esse erro, configure uma origem remota como SampleRepository e crie a ramificação main necessária.

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

Confirme uma alteração para ativar o pipeline.

Depois de uma implantação inicial bem-sucedida, você deve ter um pipeline de CI/CD completo com uma ramificação main para SampleRepository como ramificação de origem. Assim que você confirmar as alterações na ramificação main, o pipeline iniciará e executará a seguinte sequência de ações:

Execute o processo de desenvolvimento usando um Makefile.

Você pode executar todo o pipeline localmente usando o comandomake ou pode executar uma etapa individual (por exemplo, make linting).

Para testar o uso de make, execute as seguintes ações:

Exclua os recursos do aplicativo AWS CDK.

Para limpar seu aplicativo AWS CDK, execute o comando a seguir.

cdk destroy --all

Esteja ciente de que os buckets do Amazon Simple Storage Service (Amazon S3) criados durante a inicialização não são excluídos automaticamente. Eles precisam de uma política de retenção que permita a exclusão, ou você precisa excluí-los manualmente na sua conta da AWS.