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.
# Créez un échantillon de badges avec CodeBuild
AWS CodeBuild prend désormais en charge l'utilisation de badges de construction, qui fournissent une image intégrée et générée dynamiquement (*badge*) qui affiche l'état de la dernière version d'un projet. Cette image est accessible via une URL accessible au public générée pour votre CodeBuild projet. Cela permet à n'importe qui de consulter le statut d'un CodeBuild projet. Les badges de génération ne contiennent pas d'informations de sécurité. Ils n'ont donc pas besoin d'une authentification.
**Topics**
+ [Créez un projet de construction avec des badges de construction](#sample-build-badges-request-running)
+ [Badges Access AWS CodeBuild Build](access-badges.md)
+ [Publier CodeBuild des badges de construction](publish-badges.md)
+ [CodeBuild statuts des badges](badge-statuses.md)
## Créez un projet de construction avec des badges de construction
Utilisez l'une des procédures suivantes pour créer un projet de génération avec les badges de construction activés. Vous pouvez utiliser AWS CLI ou le AWS Management Console.
**Pour créer un projet de construction avec les badges de construction activés (AWS CLI)**
+ Pour en savoir plus sur la création d'un projet de génération, consultez [Création d'un projet de génération (AWS CLI)](create-project.md#create-project-cli). Pour inclure des badges de construction dans votre AWS CodeBuild projet, vous devez les spécifier *badgeEnabled* avec une valeur de`true`.
**Pour créer un projet de construction avec les badges de construction activés (console)**
1. Ouvrez la AWS CodeBuild console sur [https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home).
1. Si une page CodeBuild d'informations s'affiche, choisissez **Créer un projet de construction**. Sinon, dans le volet de navigation, développez **Build****, choisissez Build projects**, puis **Create build project**.
1. Dans **Nom du projet**, saisissez un nom pour ce projet de génération. Les noms des projets de construction doivent être uniques pour chaque AWS compte. Vous pouvez également inclure une description facultative du projet de construction pour aider les autres utilisateurs à comprendre à quoi sert ce projet.
1. Dans **Source**, pour **Fournisseur de source**, choisissez le type de fournisseur de code source, puis effectuez l'une des actions suivantes :
**Note**
CodeBuild ne prend pas en charge les badges de génération auprès du fournisseur de source Amazon S3. Dans la AWS CodePipeline mesure où Amazon S3 est utilisé pour les transferts d'artefacts, les badges de construction ne sont pas pris en charge pour les projets de génération faisant partie d'un pipeline créé dans CodePipeline.
+ Si vous avez choisi **CodeCommit**, pour **Référentiel**, sélectionnez le nom du référentiel. Sélectionnez **Enable build badge (Activer le badge de génération)** pour rendre le statut de génération de votre projet visible et intégrable.
+ Si vous le souhaitez **GitHub**, suivez les instructions pour vous connecter (ou vous reconnecter) à GitHub. Sur la page GitHub **Autoriser l'application**, pour **Accès à l'organisation**, sélectionnez **Demander l'accès** à côté de chaque référentiel AWS CodeBuild auquel vous souhaitez pouvoir accéder. Après avoir choisi **Authorize application**, de retour dans la console AWS CodeBuild , pour **Repository**, choisissez le nom du référentiel qui contient le code source. Sélectionnez **Enable build badge (Activer le badge de génération)** pour rendre le statut de génération de votre projet visible et intégrable.
+ Si vous avez choisi **Bitbucket**, suivez les instructions pour vous connecter (ou vous reconnecter) à Bitbucket. Dans la page Bitbucket **Confirm access to your account**, pour **Organization access**, choisissez **Grant access**. Après avoir choisi **Autoriser l'accès**, de retour dans la AWS CodeBuild console, pour **Repository**, choisissez le nom du référentiel qui contient le code source. Sélectionnez **Enable build badge (Activer le badge de génération)** pour rendre le statut de génération de votre projet visible et intégrable.
**Important**
Si vous mettez à jour la source de votre projet, cela peut affecter la précision des badges de génération du projet.
1. Dans **Environment (Environnement)** :
Pour **Image d'environnement**, effectuez l'une des actions suivantes :
+ Pour utiliser une image Docker gérée par AWS CodeBuild, choisissez **Image gérée**, puis sélectionnez **Système d'exploitation**, **Runtime (s)**, **Image** et **Version de l'image**. Effectuez votre sélection pour **Type d'environnement** si cette option est disponible.
+ Pour utiliser une autre image Docker, choisissez **Image personnalisée**. Pour le **type d'environnement**, choisissez **ARM**, **Linux****, Linux GPU** ou **Windows**. Si vous choisissez **Other registry (Autre registre)**, pour **External registry URL (URL du registre externe)**, entrez le nom et la balise de l'image Docker dans Docker Hub au format `docker repository/docker image name`. Si vous choisissez **Amazon ECR**, utilisez le **référentiel Amazon ECR** et l'image **Amazon ECR pour choisir l'image** Docker dans votre compte. AWS
+ Pour utiliser une image Docker privée, choisissez **Image personnalisée**. Pour le **type d'environnement**, choisissez **ARM**, **Linux****, Linux GPU** ou **Windows**. Pour **Image registry (Registre de l'image)**, choisissez **Other registry (Autre registre)** et entrez l'ARN des informations d'identification de votre image Docker privée. Les informations d'identification doivent être créées par Secrets Manager. Pour plus d'informations, consultez [Présentation de AWS Secrets Manager](https://docs.aws.amazon.com/secretsmanager/latest/userguide/) dans le *Guide de l'utilisateur AWS Secrets Manager *.
1. Dans **Rôle du service**, sélectionnez l'une des options suivantes :
+ Si vous n'avez pas de rôle CodeBuild de service, choisissez **Nouveau rôle de service**. Dans **Role name**, entrez un nom pour le nouveau rôle.
+ Si vous avez un rôle CodeBuild de service, choisissez **Rôle de service existant**. Dans **Role ARN**, choisissez le rôle de service.
**Note**
Lorsque vous utilisez la console pour créer ou mettre à jour un projet de génération, vous pouvez créer un rôle de CodeBuild service en même temps. Par défaut, le rôle fonctionne avec ce projet de génération uniquement. Si vous utilisez la console pour associer ce rôle de service à un autre projet de génération, le rôle est mis à jour pour fonctionner avec l'autre projet de génération. Un rôle de service peut fonctionner avec 10 projets de génération maximum.
1. Dans **Buildspec, effectuez** l'une des opérations suivantes :
+ Choisissez **Utiliser un fichier buildspec pour utiliser le fichier** buildspec.yml dans le répertoire racine du code source.
+ Choisissez **Insérer des commandes** de génération pour utiliser la console pour insérer des commandes de génération.
Pour de plus amples informations, veuillez consulter [Référence des spécifications de génération](build-spec-ref.md).
1. Dans **Artefacts**, pour **Type**, effectuez l'une des actions suivantes :
+ Si vous ne souhaitez pas créer d'artefacts de sortie de génération, choisissez **Aucun artefact**.
+ Pour stocker le résultat du build dans un compartiment S3, choisissez **Amazon S3**, puis procédez comme suit :
+ Si vous souhaitez utiliser votre nom de projet pour le dossier ou le fichier ZIP de sortie de génération, ne renseignez pas le champ **Nom**. Sinon, entrez le nom. Par défaut, le nom d'un artefact est le nom du projet. Si vous souhaitez utiliser un autre nom, entrez-le dans la zone Nom des artefacts. Si vous souhaitez générer un fichier ZIP, incluez l'extension zip.
+ Pour **Nom du compartiment**, choisissez le nom du compartiment de sortie.
+ Si vous avez sélectionné **Insérer des commandes de génération** précédemment dans cette procédure, pour **Fichiers de sortie**, saisissez les emplacements des fichiers de la génération que vous souhaitez placer dans le dossier ou le fichier ZIP de sortie de génération. Pour plusieurs emplacements, séparez ceux-ci avec une virgule (par exemple, `appspec.yml, target/my-app.jar`). Pour de plus amples informations, consultez la description de `files` dans [Syntaxe d'un fichier buildspec](build-spec-ref.md#build-spec-ref-syntax).
1. Développez **Additional configuration (Configuration supplémentaire)** et choisissez les options appropriées.
1. Choisissez **Créer un projet de génération**. Sur la page **Révision**, choisissez **Démarrer la génération** pour exécuter la génération.
# Badges Access AWS CodeBuild Build
Vous pouvez utiliser AWS CodeBuild la console ou le AWS CLI pour accéder aux badges de build.
+ Dans la CodeBuild console, dans la liste des projets de construction, dans la colonne **Nom**, choisissez le lien correspondant au projet de construction. Sur la *project-name* page **Créer un projet :**, dans **Configuration**, choisissez **Copier l'URL du badge**. Pour de plus amples informations, veuillez consulter [Affichage des détails d'un projet de génération (console)](view-project-details.md#view-project-details-console).
+ Dans le AWS CLI, exécutez la `batch-get-projects` commande. L'URL de badge de génération est incluse dans la section des détails de l'environnement de projet de la sortie. Pour de plus amples informations, veuillez consulter [Affichage des détails d'un projet de génération (AWS CLI)](view-project-details.md#view-project-details-cli).
L'URL de demande de badge de construction est générée avec une branche par défaut commune, mais vous pouvez spécifier n'importe quelle branche de votre référentiel source que vous avez utilisée pour exécuter une compilation. Par exemple :
```
https://codebuild.us-east-1.amazon.com/badges?uuid=...&branch=
```
Vous pouvez également spécifier une balise à partir de votre référentiel source en remplaçant le `branch` paramètre par le `tag` paramètre figurant dans l'URL du badge. Par exemple :
```
https://codebuild.us-east-1.amazon.com/badges?uuid=...&tag=
```
# Publier CodeBuild des badges de construction
Vous pouvez afficher l'état de la dernière version dans un fichier Markdown en utilisant l'URL de votre badge de build dans une image Markdown. Cela est utile pour afficher l'état de la version la plus récente dans le fichier readme.md de votre référentiel source (par exemple, GitHub ou). CodeCommit Par exemple :
```
![]()
```
# CodeBuild statuts des badges
Le badge de CodeBuild construction peut avoir l'un des statuts suivants.
+ **PASSING** : La dernière génération sur la branche indiquée a abouti.
+ **FAILING** : La dernière génération sur la branche indiquée a expiré, a échoué, comprend des erreurs ou a été arrêtée.
+ **IN\$1PROGRESS** : La dernière génération sur la branche indiquée est en cours.
+ **UNKNOWN** : Le projet n'a pas encore exécuté une génération pour la branche indiquée ou n'a exécuté aucune génération. En outre, la fonction de badges de génération a peut-être été désactivée.