Configuration d'un pipeline CI/CD à l'aide d'AWS et d' CodePipeline AWS CDK

Installez des outils sur macOS ou Linux.

Si vous utilisez macOS ou Linux, vous pouvez installer les outils en exécutant la commande suivante dans votre terminal préféré ou en utilisant Homebrew pour Linux.

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

Installez des outils à l'aide d'AWS Cloud9.

Si vous utilisez AWS Cloud9, installez les outils en exécutant la commande suivante.

gem install cfn-nag

Remarque : Node.js et npm doivent être installés sur AWS Cloud9. Pour vérifier l'installation ou la version, exécutez la commande suivante.

node -v
npm -v

Configurez l'AWS CLI.

Pour configurer l'AWS CLI, suivez les instructions correspondant à votre système d'exploitation :

Téléchargez ou clonez le code.

Pour obtenir le code utilisé par ce modèle, effectuez l'une des opérations suivantes :

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

Supprimez le .git répertoire du référentiel cloné.

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

Plus tard, vous utiliserez un CodeCommit dépôt AWS nouvellement créé comme origine distante.

Connectez-vous au compte AWS.

Vous pouvez vous connecter à l'aide d'un jeton de sécurité temporaire ou d'une authentification par zone d'atterrissage. Pour vérifier que vous utilisez le bon compte et la bonne région AWS, exécutez les commandes suivantes.

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

Démarrez l'environnement.

Pour démarrer un environnement AWS CDK, exécutez les commandes suivantes.

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

Une fois que vous avez réussi à démarrer l'environnement, le résultat suivant doit être affiché.

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

Pour plus d'informations sur le démarrage d'AWS CDK, consultez la documentation du CDK AWS.

Synthétisez un modèle.

Pour synthétiser une application AWS CDK, utilisez la cdk synth commande.

npm run cdk synth

Le résultat suivant doit s'afficher.

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

Déployez la CodePipeline pile.

Maintenant que vous avez amorcé et synthétisé le CloudFormation modèle, vous pouvez le déployer. Le déploiement créera le CodePipeline pipeline et un CodeCommit référentiel, qui seront la source et le déclencheur du pipeline.

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

Après avoir exécuté la commande, vous devriez constater un déploiement réussi de la CodePipeline pile et des informations de sortie. Vous CodePipeline.RepositoryName donne le nom du CodeCommit référentiel dans le compte AWS.

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

Configurez le CodeCommit référentiel et la branche distants.

Une fois le déploiement réussi, CodePipeline lancera la première exécution du pipeline, que vous trouverez dans la CodePipeline console AWS. Comme AWS CDK CodeCommit n'initie pas de branche par défaut, cette exécution initiale du pipeline échouera et renverra le message d'erreur suivant.

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

Pour corriger cette erreur, configurez une origine distante en tant que SampleRepository et créez la main branche requise.

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

Validez une modification pour activer le pipeline.

Après un déploiement initial réussi, vous devriez disposer d'un pipeline CI/CD complet avec une main branche pour SampleRepository en tant que branche source. Dès que vous validez les modifications apportées à la main branche, le pipeline lance et exécute la séquence d'actions suivante :

Lancez le processus de développement à l'aide d'un Makefile.

Vous pouvez exécuter l'ensemble du pipeline localement à l'aide de la make commande, ou vous pouvez exécuter une étape individuelle (par exemple,make linting).

Pour tester l'utilisationmake, effectuez les actions suivantes :

Supprimez les ressources de l'application AWS CDK.

Pour nettoyer votre application AWS CDK, exécutez la commande suivante.

cdk destroy --all

Sachez que les compartiments Amazon Simple Storage Service (Amazon S3) créés lors du démarrage ne sont pas automatiquement supprimés. Ils ont besoin d'une politique de rétention autorisant leur suppression, ou vous devez les supprimer manuellement dans votre compte AWS.