Configure una canalización de CI/CD mediante AWS y CodePipeline AWS CDK

Instalar herramientas en macOS o Linux.

Si usa macOS o Linux, puede instalar las herramientas ejecutando el siguiente comando en su terminal preferido o usando Homebrew para Linux.

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

Instale herramientas con AWS Cloud9.

Si usa AWS Cloud9, instale las herramientas ejecutando el siguiente comando.

gem install cfn-nag

Nota: AWS Cloud9 debe tener Node.js y npm instalados. Para comprobar la instalación o la versión, ejecute el siguiente comando.

node -v
npm -v

Configure AWS CLI.

Para configurar la CLI de AWS, consulte las instrucciones del sistema operativo:

Descargue o clone el código.

Para obtener el código que utiliza este patrón, realice una de las siguientes acciones:

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

Elimine el directorio .git del repositorio clonado.

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

Más adelante, utilizará un CodeCommit repositorio de AWS recién creado como origen remoto.

Conéctese a la cuenta de AWS.

Puede conectarse mediante un token de seguridad temporal o una autenticación de zona de aterrizaje. Para confirmar que está utilizando la cuenta y región de AWS correctas, ejecute los siguientes comandos.

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

Inicie el entorno.

Para arrancar un entorno AWS CDK, ejecute los siguientes comandos.

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

Tras arrancar correctamente el entorno, debería aparecer el siguiente resultado.

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

Para más información sobre el proceso de arranque de AWS CDK, consulte la documentación de AWS CDK.

Sintetice una plantilla.

Para sintetizar una aplicación de AWS CDK, ejecute el comando cdk synth.

npm run cdk synth

Debería ver la siguiente salida.

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

Despliega la CodePipeline pila.

Ahora que ha iniciado y sintetizado la CloudFormation plantilla, puede desplegarla. La implementación creará la CodePipeline canalización y un CodeCommit repositorio, que serán la fuente y el desencadenante de la canalización.

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

Tras ejecutar el comando, debería ver una implementación correcta de la CodePipeline pila y la información de salida. CodePipeline.RepositoryNameLe da el nombre del CodeCommit repositorio de la cuenta de 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 el CodeCommit repositorio y la sucursal remotos.

Tras una implementación correcta, CodePipeline iniciará la primera ejecución de la canalización, que puede encontrar en la CodePipeline consola de AWS. Como AWS CDK y CodeCommit no inician una rama predeterminada, esta canalización inicial fallará y devolverá el siguiente mensaje de error.

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 corregir este error, configure un origen remoto como SampleRepository y cree la ramificación main requerida.

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

Realice un cambio para activar el proceso.

Tras la implementación inicial satisfactoria, debería disponer de un proceso de CI/CD completo con una ramificación main con SampleRepository como ramificación de origen. En cuanto realice los cambios en la ramificación main, se iniciará el proceso y se ejecutará la siguiente secuencia de acciones:

Ejecute el proceso de desarrollo mediante Makefile.

Puede ejecutar todo el proceso de forma local mediante el comando make, o bien ejecutar un paso individual (por ejemplo, make linting).

Para probar el uso de make, realice las siguientes acciones:

Elimine los recursos de la aplicación AWS CDK.

Para limpiar su aplicación AWS CDK, ejecute el siguiente comando.

cdk destroy --all

Tenga en cuenta que los buckets de Amazon Simple Storage Service (Amazon S3) creados durante el arranque no se eliminan automáticamente. Necesitará una política de retención que permita su eliminación, o bien tendrá que eliminarlos manualmente en su cuenta de AWS.