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 un fichier accessible au public URL généré pour votre CodeBuild projet. Cela permet à quiconque 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.
Rubriques
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). Pour inclure des badges de construction dans votre AWS CodeBuild projet, vous devez spécifier
badgeEnabled
avec une valeur detrue
.
Pour créer un projet de construction avec les badges de construction activés (console)
Ouvrez la AWS CodeBuild console sur https://console.aws.amazon.com/codesuite/codebuild/home
. -
Si une page CodeBuild d'informations s'affiche, choisissez Create build project. Sinon, dans le volet de navigation, développez Build, choisissez Build projects, puis Create build project.
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.
-
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, dans Repository, choisissez 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.
-
-
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 Type d'environnement ARM, choisissez LinuxGPU, Linux ou Windows. Si vous choisissez Autre registre, pour Registre externe URL, entrez le nom et le tag de l'image Docker dans Docker Hub, en utilisant le format.
Si vous choisissez Amazon ECR, utilisez le ECRréférentiel Amazon et ECRl'image Amazon pour choisir l'image Docker dans votre AWS compte.docker repository
/docker image name
-
Pour utiliser une image Docker privée, choisissez Image personnalisée. Pour Type d'environnement ARM, choisissez LinuxGPU, Linux ou Windows. Pour le registre d'images, choisissez Autre registre, puis entrez les informations ARN 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 dans le Guide de l'utilisateur AWS Secrets Manager .
-
-
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 Rôle 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.
-
-
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 plus d’informations, consultez le Référence des spécifications de génération.
-
-
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 le nom de votre projet pour le ZIP fichier ou le dossier de sortie de construction, laissez le champ Nom vide. 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 ZIP fichier, incluez l'extension zip.
-
Pour Nom du compartiment, choisissez le nom du compartiment de sortie.
-
Si vous avez choisi Insérer des commandes de génération plus tôt dans cette procédure, pour les fichiers de sortie, entrez les emplacements des fichiers de la version que vous souhaitez placer dans le ZIP fichier ou le dossier de sortie de construction. 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 defiles
dans Syntaxe d'un fichier buildspec.
-
-
-
Développez Additional configuration (Configuration supplémentaire) et choisissez les options appropriées.
-
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.