Configura una pipeline CI/CD utilizzando AWS e CodePipeline AWS CDK

Installa strumenti su macOS o Linux.

Se utilizzi macOS o Linux, puoi installare gli strumenti eseguendo il seguente comando nel tuo terminale preferito o usando Homebrew per Linux.

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

Installa strumenti utilizzando AWS Cloud9.

Se utilizzi AWS Cloud9, installa gli strumenti eseguendo il comando seguente.

gem install cfn-nag

Nota: AWS Cloud9 dovrebbe avere Node.js e npm installati. Per verificare l'installazione o la versione, esegui il comando seguente.

node -v
npm -v

Configura AWS CLI.

Per configurare AWS CLI, usa le istruzioni per il tuo sistema operativo:

Scarica o clona il codice.

Per ottenere il codice utilizzato da questo pattern, effettuate una delle seguenti operazioni:

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

Rimuovi la .git directory dal repository clonato.

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

Successivamente, utilizzerai un CodeCommit repository AWS appena creato come origine remota.

Connect all'account AWS.

Puoi connetterti utilizzando un token di sicurezza temporaneo o l'autenticazione delle landing zone. Per confermare che stai utilizzando l'account e la regione AWS corretti, esegui i seguenti comandi.

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

Avvia l'ambiente.

Per avviare un ambiente AWS CDK, esegui i seguenti comandi.

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

Dopo aver avviato correttamente l'ambiente, dovrebbe essere visualizzato il seguente output.

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

Per ulteriori informazioni sul bootstrap di AWS CDK, consulta la documentazione di AWS CDK.

Sintetizza un modello.

Per sintetizzare un'app AWS CDK, usa il comando. cdk synth

npm run cdk synth

Vedrai il seguente output.

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

Distribuisci lo CodePipeline stack.

Ora che hai avviato e sintetizzato il CloudFormation modello, puoi distribuirlo. La distribuzione creerà la CodePipeline pipeline e un CodeCommit repository, che saranno l'origine e il trigger della pipeline.

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

Dopo aver eseguito il comando, dovresti vedere una corretta distribuzione dello CodePipeline stack e delle informazioni di output. ti CodePipeline.RepositoryName dà il nome del CodeCommit repository nell'account AWS.

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

Configura l' CodeCommit archivio e la filiale remoti.

Dopo una distribuzione di successo, CodePipeline avvierà la prima esecuzione della pipeline, che puoi trovare nella console CodePipeline AWS. Poiché AWS CDK e io CodeCommit non avviamo un ramo predefinito, questa esecuzione iniziale della pipeline fallirà e restituirà il seguente messaggio di errore.

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

Per correggere questo errore, configura un'origine remota come SampleRepository e crea il ramo richiesto. 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

Apporta una modifica per attivare la pipeline.

Dopo una corretta implementazione iniziale, è necessario disporre di una pipeline CI/CD completa con un main ramo SampleRepository come ramo di origine. Non appena apporti modifiche al main ramo, la pipeline avvierà ed eseguirà la seguente sequenza di azioni:

Esegui il processo di sviluppo utilizzando un Makefile.

È possibile eseguire l'intera pipeline localmente utilizzando il make comando oppure eseguire un singolo passaggio (ad esempio,make linting).

Per testare l'utilizzomake, effettuate le seguenti azioni:

Elimina le risorse dell'app AWS CDK.

Per pulire l'app AWS CDK, esegui il comando seguente.

cdk destroy --all

Tieni presente che i bucket Amazon Simple Storage Service (Amazon S3) creati durante il bootstrap non vengono eliminati automaticamente. Hanno bisogno di una policy di conservazione che consenta l'eliminazione, oppure devi eliminarli manualmente nel tuo account AWS.