Exécutez les builds localement avec l' AWS CodeBuild agent

Vous pouvez utiliser l' AWS CodeBuild agent pour exécuter CodeBuild des builds sur une machine locale. Des agents sont disponibles pour les plateformes x86_64 et ARM.

Vous pouvez également vous abonner pour recevoir des notifications lorsque de nouvelles versions de l'agent sont publiées.

Prérequis

Avant de commencer, vous devez effectuer les opérations suivantes :

• Installez Git sur votre machine locale.

• Installez et configurez Docker sur votre machine locale.

Configurer l'image de construction

Vous devez uniquement configurer l'image de construction lors de la première exécution de l'agent ou lorsque l'image a changé.

Pour configurer l'image de construction

1. Si vous souhaitez utiliser une image Amazon Linux 2 sélectionnée, vous pouvez l'extraire du référentiel CodeBuild public Amazon ECR à l'adresse https://gallery.ecr. aws/codebuild/amazonlinux-x86_64-standard avec la commande suivante :

   $ docker pull public.ecr.aws/codebuild/amazonlinux-x86_64-standard:4.0

   Sinon, si vous souhaitez utiliser une autre image Linux, effectuez les opérations suivantes :

   1. Clonez le dépôt CodeBuild d'images :

      $ git clone https://github.com/aws/aws-codebuild-docker-images.git

   2. Accédez au répertoire des images. Pour cet exemple, utilisez l'aws/codebuild/standard:5.0image :

      $ cd aws-codebuild-docker-images/ubuntu/standard/5.0

   3. Construisez l'image. Cela peut prendre plusieurs minutes.

      $ docker build -t aws/codebuild/standard:5.0 .

2. Téléchargez l' CodeBuild agent.

   Pour télécharger la version x86_64 de l'agent, exécutez la commande suivante :

   $ docker pull public.ecr.aws/codebuild/local-builds:latest

   Pour télécharger la version ARM de l'agent, exécutez la commande suivante :

   $ docker pull public.ecr.aws/codebuild/local-builds:aarch64

3. L' CodeBuild agent est disponible à l'adresse https://gallery.ecr. aws/codebuild/local-construit.

   La signature SHA (Secure Hash Algorithm) pour la version x86_64 de l'agent est la suivante :

   sha256:ccb19bdd7af94e4dc761e4c58c267e9455c28ec68d938086b4dc1cf8fe6b0940

   La signature SHA pour la version ARM de l'agent est la suivante :

   sha256:7d7b5d35d2ac4e062ae7ba8c662ffed15229a52d09bd0d664a7816c439679192

   Vous pouvez utiliser le SHA pour identifier la version de l'agent. Pour voir la signature SHA de l'agent, exécutez la commande suivante et recherchez le SHA sous RepoDigests :

   $ docker inspect public.ecr.aws/codebuild/local-builds:latest

Exécutez l' CodeBuild agent

Pour exécuter l' CodeBuild agent

1. Accédez au répertoire qui contient la source de votre projet de compilation.

2. Téléchargez le script codebuild_build.sh :

   $ curl -O  https://raw.githubusercontent.com/aws/aws-codebuild-docker-images/master/local_builds/codebuild_build.sh
   $ chmod +x codebuild_build.sh

3. Exécutez le codebuild_build.sh script et spécifiez votre image de conteneur et le répertoire de sortie.

   Pour exécuter une version x86_64, exécutez la commande suivante :

   $ ./codebuild_build.sh -i <container-image> -a <output directory>

   Pour exécuter une version ARM, exécutez la commande suivante :

   $ ./codebuild_build.sh -i <container-image> -a <output directory> -l public.ecr.aws/codebuild/local-builds:aarch64

   Remplacez <container-image> par le nom de l'image du conteneur, tel que aws/codebuild/standard:5.0 oupublic.ecr.aws/codebuild/amazonlinux-x86_64-standard:4.0.

   Le script lance l'image de construction et exécute la construction sur le projet dans le répertoire en cours. Pour spécifier l'emplacement du projet de génération, ajoutez l'-s <build project directory>option à la commande de script.

Réception de notifications en cas de nouvelle version de l'agent CodeBuild

Vous pouvez vous abonner aux notifications Amazon SNS afin d'être averti lorsque de nouvelles versions de l' AWS CodeBuild agent sont publiées.

Pour vous abonner aux notifications des CodeBuild agents

1. Ouvrez la console Amazon SNS à l'adresse v3/home. https://console.aws.amazon.com/sns/

2. Dans la barre de navigation, si ce n'est pas déjà fait, remplacez la AWS région par USA Est (Virginie du Nord). Vous devez sélectionner cette AWS région car les notifications Amazon SNS auxquelles vous vous abonnez sont créées dans cette région.

3. Dans le panneau de navigation, sélectionnez Abonnements.

4. Choisissez Créer un abonnement.

5. Dans Créer un abonnement, procédez comme suit :

   1. Pour ARN de la rubrique, utilisez l’Amazon Resource Name (ARN) suivant :

      arn:aws:sns:us-east-1:850632864840:AWS-CodeBuild-Local-Agent-Updates

   2. Pour Protocol (Protocole), choisissez Email (E-mail) ou SMS.

   3. Pour Endpoint (Point de terminaison), choisissez où recevoir les notifications (e-mail ou SMS). Saisissez une adresse e-mail, une adresse ou un numéro de téléphone, y compris l'indicatif régional.

   4. Choisissez Create subscription (Créer un abonnement).

   5. Choisissez E-mail pour recevoir un e-mail vous demandant de confirmer votre inscription. Suivez les instructions dans l'e-mail pour finaliser votre abonnement.

      Si vous ne souhaitez plus recevoir ces notifications, exécutez la procédure suivante pour annuler votre abonnement.

Pour vous désabonner des notifications des CodeBuild agents

1. Ouvrez la console Amazon SNS à l'adresse v3/home. https://console.aws.amazon.com/sns/

2. Dans le panneau de navigation, sélectionnez Abonnements.

3. Sélectionnez l'abonnement, puis sous Actions, choisissez Delete subscriptions (Supprimer des abonnements). Lorsque vous êtes invité à confirmer, choisissez Delete.