Richten Sie eine CI/CD-Pipeline mithilfe von AWS CodePipeline und AWS CDK ein

Installieren Sie Tools auf macOS oder Linux.

Wenn Sie macOS oder Linux verwenden, können Sie die Tools installieren, indem Sie den folgenden Befehl in Ihrem bevorzugten Terminal ausführen oder Homebrew für Linux verwenden.

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

Installieren Sie Tools mithilfe von AWS Cloud9.

Wenn Sie AWS Cloud9 verwenden, installieren Sie die Tools, indem Sie den folgenden Befehl ausführen.

gem install cfn-nag

Hinweis: In AWS Cloud9 sollten Node.js und npm installiert sein. Führen Sie den folgenden Befehl aus, um die Installation oder Version zu überprüfen.

node -v
npm -v

Richten Sie die AWS-CLI ein.

Verwenden Sie die Anweisungen für Ihr Betriebssystem, um AWS CLI einzurichten:

Laden Sie den Code herunter oder klonen Sie ihn.

Gehen Sie wie folgt vor, um den Code abzurufen, der von diesem Muster verwendet wird:

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

Entfernen Sie das .git Verzeichnis aus dem geklonten Repository.

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

Später werden Sie ein neu erstelltes CodeCommit AWS-Repository als Remote-Ursprung verwenden.

Connect zum AWS-Konto her.

Sie können eine Verbindung herstellen, indem Sie ein temporäres Sicherheitstoken oder eine Landingzone-Authentifizierung verwenden. Führen Sie die folgenden Befehle aus, um zu bestätigen, dass Sie das richtige Konto und die richtige AWS-Region verwenden.

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

Bootstrapping für die Umwelt.

Führen Sie die folgenden Befehle aus, um eine AWS-CDK-Umgebung zu booten.

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

Nachdem Sie die Umgebung erfolgreich gebootet haben, sollte die folgende Ausgabe angezeigt werden.

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

Weitere Informationen zu AWS CDK-Bootstrapping finden Sie in der AWS CDK-Dokumentation.

Synthetisieren Sie eine Vorlage.

Verwenden Sie den Befehl, um eine AWS CDK-App zu synthetisieren. cdk synth

npm run cdk synth

Die Ausgabe sollte folgendermaßen aussehen.

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

Stellen Sie den CodePipeline Stack bereit.

Nachdem Sie die CloudFormation Vorlage nun gebootet und synthetisiert haben, können Sie sie bereitstellen. Bei der Bereitstellung werden die CodePipeline Pipeline und ein CodeCommit Repository erstellt, das als Quelle und Auslöser der Pipeline dient.

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

Nachdem Sie den Befehl ausgeführt haben, sollten Sie sehen, dass der CodePipeline Stack erfolgreich bereitgestellt und die Informationen ausgegeben wurden. Das CodePipeline.RepositoryName gibt Ihnen den Namen des CodeCommit Repositorys im AWS-Konto.

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

Richten Sie das CodeCommit Remote-Repository und den Branch ein.

Nach einer erfolgreichen Bereitstellung CodePipeline wird der erste Lauf der Pipeline initiiert, den Sie in der CodePipeline AWS-Konsole finden. Da AWS CDK und CodeCommit kein Standard-Branch initiieren, schlägt dieser erste Pipeline-Lauf fehl und gibt die folgende Fehlermeldung zurück.

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

Um diesen Fehler zu beheben, richten Sie einen Remote-Ursprung als SampleRepository ein und erstellen Sie den erforderlichen main Branch.

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

Bestätigen Sie eine Änderung, um die Pipeline zu aktivieren.

Nach einer erfolgreichen ersten Bereitstellung sollten Sie über eine vollständige CI/CD-Pipeline mit einem main Zweig SampleRepository als Quellzweig verfügen. Sobald Sie die Änderungen an der main Verzweigung vorgenommen haben, initiiert die Pipeline die folgende Abfolge von Aktionen und führt sie aus:

Führen Sie den Entwicklungsprozess mithilfe eines Makefiles aus.

Sie können die gesamte Pipeline lokal ausführen, indem Sie den make Befehl verwenden, oder Sie können einen einzelnen Schritt ausführen (z. B.make linting).

Führen Sie die folgenden Aktionen ausmake, um die Verwendung zu testen:

Löschen Sie die AWS-CDK-App-Ressourcen.

Führen Sie den folgenden Befehl aus, um Ihre AWS CDK-App zu bereinigen.

cdk destroy --all

Beachten Sie, dass die Amazon Simple Storage Service (Amazon S3) -Buckets, die beim Bootstrapping erstellt werden, nicht automatisch gelöscht werden. Sie benötigen eine Aufbewahrungsrichtlinie, die das Löschen ermöglicht, oder Sie müssen sie manuell in Ihrem AWS-Konto löschen.