Exécutez les builds localement avec l' AWS CodeBuild agent - AWS CodeBuild
PrérequisConfigurer l'image de constructionExécutez l' CodeBuild agentRéception de notifications en cas de nouvelle version de l'agent CodeBuild

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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 x86_64 et les plateformes. 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 ECR référentiel CodeBuild public Amazon à l'adresse https://gallery.ecr. aws/codebuild/amazonlinux2-x86_64-standard avec la commande suivante :

    $ docker pull public.ecr.aws/codebuild/amazonlinux2-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 ARM version de l'agent, exécutez la commande suivante :

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

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

    La signature de l'algorithme de hachage sécurisé (SHA) pour la version x86_64 de l'agent est la suivante :

    sha256:ccb19bdd7af94e4dc761e4c58c267e9455c28ec68d938086b4dc1cf8fe6b0940

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

    sha256:7d7b5d35d2ac4e062ae7ba8c662ffed15229a52d09bd0d664a7816c439679192

    Vous pouvez utiliser le SHA pour identifier la version de l'agent. Pour voir la SHA signature de l'agent, exécutez la commande suivante et recherchez ce qui SHA suit 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 un ARM build, 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> avec le nom de l'image du conteneur, tel que aws/codebuild/standard:5.0 oupublic.ecr.aws/codebuild/amazonlinux2-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 SNS notifications Amazon afin d'être averti lorsque de nouvelles versions de l' AWS CodeBuild agent seront publiées.

Pour vous abonner aux notifications des CodeBuild agents

  1. Ouvrez la SNS console Amazon sur https://console.aws.amazon.com/sns/v3/home.

  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 SNS notifications Amazon 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 le sujet ARN, utilisez le nom de ressource Amazon suivant (ARN) : 

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

    2. Dans le champ Protocole, sélectionnez E-mail ou SMS.

    3. Pour Endpoint, choisissez où (e-mail ouSMS) vous souhaitez recevoir les notifications. 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 SNS console Amazon sur https://console.aws.amazon.com/sns/v3/home.

  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.