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 les plateformes x86\$164 et ARM. Vous pouvez également vous abonner pour recevoir des notifications lorsque de nouvelles versions de l'agent sont publiées. ## Conditions préalables Avant de commencer, vous devez effectuer les opérations suivantes : + Installez Git sur votre machine locale. + Installez et configurez [Docker](https://www.docker.com/) 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\$164-standard](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 ``` 1. Accédez au répertoire des images. Pour cet exemple, utilisez l'`aws/codebuild/standard:5.0`image : ``` $ cd aws-codebuild-docker-images/ubuntu/standard/5.0 ``` 1. Construisez l'image. Cela peut prendre plusieurs minutes. ``` $ docker build -t aws/codebuild/standard:5.0 . ``` 1. Téléchargez l' CodeBuild agent. Pour télécharger la version x86\$164 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 ``` 1. L' CodeBuild agent est disponible à l'[adresse https://gallery.ecr. aws/codebuild/local-construit](https://gallery.ecr.aws/codebuild/local-builds). La signature SHA (Secure Hash Algorithm) pour la version x86\$164 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. 1. Téléchargez le script [codebuild\$1build.sh](https://github.com/aws/aws-codebuild-docker-images/blob/master/local_builds/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 ``` 1. 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\$164, exécutez la commande suivante : ``` $ ./codebuild_build.sh -i -a ``` Pour exécuter une version ARM, exécutez la commande suivante : ``` $ ./codebuild_build.sh -i -a -l public.ecr.aws/codebuild/local-builds:aarch64 ``` Remplacez ** par le nom de l'image du conteneur, tel que `aws/codebuild/standard:5.0` ou`public.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 `option à la commande de script. ## Recevez des notifications pour les nouvelles versions de CodeBuild l'agent 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/](https://console.aws.amazon.com/sns/v3/home) 1. 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. 1. Dans le panneau de navigation, sélectionnez **Abonnements**. 1. Sélectionnez **Créer un abonnement**. 1. 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 ``` 1. Pour **Protocol (Protocole)**, choisissez **Email (E-mail)** ou **SMS**. 1. 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. 1. Choisissez **Créer un abonnement**. 1. 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/](https://console.aws.amazon.com/sns/v3/home) 1. Dans le panneau de navigation, sélectionnez **Abonnements**. 1. Sélectionnez l'abonnement, puis sous **Actions**, choisissez **Delete subscriptions (Supprimer des abonnements)**. Lorsque vous êtes invité à confirmer, choisissez **Delete**.