View a markdown version of this page

Modifier les paramètres du projet de création dans AWS CodeBuild - AWS CodeBuild
Modification des paramètres d'un projet de génération (console)Modifier les paramètres d'un projet de build (AWS CLI)Modifier les paramètres d'un projet de build (AWS SDK)

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.

Modifier les paramètres du projet de création dans AWS CodeBuild

Vous pouvez utiliser la AWS CodeBuild console ou AWS CLI les AWS kits SDK pour modifier les paramètres d'un projet de build.

Si vous ajoutez des rapports de test à un projet de génération, assurez-vous que votre rôle IAM dispose des autorisations décrites dansAutorisations relatives aux rapports de test.

Modification des paramètres d'un projet de génération (console)

Pour modifier les paramètres d'un projet de génération, effectuez la procédure suivante :

  1. Ouvrez la AWS CodeBuild console à l'adresse https://console.aws.amazon.com/codesuite/codebuild/home.

  2. Dans le volet de navigation, choisissez Projets de génération.

  3. Effectuez l’une des actions suivantes :

    • Cliquez sur le lien du projet de génération à modifier, puis choisissez Détails de génération.

    • Cliquez sur le bouton en regard du projet de génération à modifier, choisissez View details (Afficher les détails), puis Détails de génération.

Vous pouvez modifier les sections suivantes :

Configuration du projet

Dans la section Configuration du projet, choisissez Modifier. Lorsque vos modifications sont terminées, choisissez Mettre à jour la configuration pour enregistrer la nouvelle configuration.

Vous pouvez modifier les propriétés suivantes.

Description

Entrez une description facultative du projet de création pour aider les autres utilisateurs à comprendre à quoi sert ce projet.

Créer un badge

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. Pour de plus amples informations, veuillez consulter Exemple de badges de génération.

Note

Le badge de compilation ne s'applique pas si votre fournisseur source est Amazon S3.

Activer la limite de création simultanée

Si vous souhaitez limiter le nombre de versions simultanées pour ce projet, effectuez les étapes suivantes :

  1. Sélectionnez Restreindre le nombre de versions simultanées que ce projet peut démarrer.

  2. Dans Limite de génération simultanée, entrez le nombre maximum de versions simultanées autorisées pour ce projet. Cette limite ne peut pas être supérieure à la limite de création simultanée définie pour le compte. Si vous essayez de saisir un nombre supérieur à la limite du compte, un message d'erreur s'affiche.

Les nouvelles générations ne sont démarrées que si le nombre actuel de générations est inférieur ou égal à cette limite. Si le nombre actuel de générations atteint cette limite, les nouvelles générations sont limitées et ne sont pas exécutées.

Permettre l'accès aux bâtiments publics

Pour rendre les résultats de génération de votre projet accessibles au public, y compris aux utilisateurs n'ayant pas accès à un AWS compte, sélectionnez Activer l'accès public à la compilation et confirmez que vous souhaitez rendre les résultats de génération publics. Les propriétés suivantes sont utilisées pour les projets de construction publics :

Rôle du service public des bâtiments

Sélectionnez Nouveau rôle de service si vous souhaitez CodeBuild créer un nouveau rôle de service pour vous, ou Rôle de service existant si vous souhaitez utiliser un rôle de service existant.

Le rôle de service de construction public CodeBuild permet de lire les CloudWatch journaux et de télécharger les artefacts Amazon S3 pour les versions du projet. Cela est nécessaire pour mettre les journaux de construction et les artefacts du projet à la disposition du public.

Rôle de service

Entrez le nom du nouveau rôle de service ou d'un rôle de service existant.

Pour rendre les résultats de construction de votre projet privés, désactivez Activer l'accès public à la construction.

Pour de plus amples informations, veuillez consulter Obtenir des URL de projets de construction publics.

Avertissement

Les points suivants doivent être pris en compte lorsque vous rendez publics les résultats de construction de votre projet :

  • Tous les résultats de construction, les journaux et les artefacts d'un projet, y compris les builds exécutés lorsque le projet était privé, sont accessibles au public.

  • Tous les journaux de construction et les artefacts sont mis à la disposition du public. Les variables d'environnement, le code source et d'autres informations sensibles peuvent avoir été générés dans les journaux de génération et les artefacts. Vous devez faire attention aux informations qui sont affichées dans les journaux de compilation. Voici quelques bonnes pratiques :

    • Ne stockez pas de valeurs sensibles, en particulier les ID de clé AWS d'accès et les clés d'accès secrètes, dans les variables d'environnement. Nous vous recommandons d'utiliser un magasin de paramètres Amazon EC2 Systems Manager ou de AWS Secrets Manager stocker des valeurs sensibles.

    • Suivez cette Meilleures pratiques d'utilisation des webhooks procédure pour limiter les entités qui peuvent déclencher une construction, et ne stockez pas la spécification de construction dans le projet lui-même, afin de vous assurer que vos webhooks sont aussi sécurisés que possible.

  • Un utilisateur malveillant peut utiliser des versions publiques pour distribuer des artefacts malveillants. Nous recommandons aux administrateurs de projet de passer en revue toutes les pull requests pour vérifier qu'il s'agit d'une modification légitime. Nous vous recommandons également de valider tous les artefacts à l'aide de leurs sommes de contrôle pour vous assurer que les bons artefacts sont téléchargés.

Informations supplémentaires

Dans le champ Tags, entrez le nom et la valeur de tous les tags que vous souhaitez que les AWS services d'assistance utilisent. Utilisez Ajouter une ligne pour ajouter une balise. Vous pouvez ajouter jusqu’à 50 balises.

Source

Dans la section Source, choisissez Modifier. Lorsque vos modifications sont terminées, choisissez Mettre à jour la configuration pour enregistrer la nouvelle configuration.

Vous pouvez modifier les propriétés suivantes :

Fournisseur d'origine

Choisissez le type de fournisseur de code source. Utilisez les listes suivantes pour effectuer des sélections adaptées à votre fournisseur source :

Note

CodeBuild ne prend pas en charge Bitbucket Server.

Amazon S3
Compartiment

Choisissez le nom du compartiment d'entrée qui contient le code source.

Clé d'objet S3 ou dossier S3

Entrez le nom du fichier ZIP ou le chemin d'accès au dossier contenant le code source. Entrez une barre oblique (/) pour tout télécharger dans le compartiment S3.

Version source

Entrez l'ID de version de l'objet qui représente la version de votre fichier d'entrée. Pour plus d'informations, consultezExemple de version source avec AWS CodeBuild.

CodeCommit
Référentiel

Choisissez le référentiel que vous souhaitez utiliser.

Type de référence

Choisissez Branch, Git tag ou Commit ID pour spécifier la version de votre code source. Pour de plus amples informations, veuillez consulter Exemple de version source avec AWS CodeBuild.

Note

Nous vous recommandons de choisir des noms de branches Git qui ne ressemblent pas à des identifiants de validation, tels que 811dd1ba1aba14473856cee38308caed7190c0d ou5392f7. Cela vous permet d'éviter les collisions entre Git Checkout et les validations réelles.

Profondeur du clone Git

Choisissez de créer un clone superficiel avec un historique tronqué au nombre de validations spécifié. Si vous souhaitez un clone complet, choisissez Full.

Sous-modules Git

Sélectionnez Use Git submodules (Utiliser les sous-modules Git) si vous souhaitez inclure les sous-modules Git dans votre référentiel.

Bitbucket
Titre

Choisissez Informations d'identification source par défaut ou Informations d'identification source personnalisées et suivez les instructions pour gérer les informations d'identification source par défaut ou personnaliser les informations d'identification source.

Type de connexion

Choisissez OAuth CodeConnections , le mot de passe de l'application ou le jeton d'accès personnel auquel vous connecter. CodeBuild

Connection

Sélectionnez une connexion Bitbucket ou un code secret Secrets Manager pour vous connecter via le type de connexion que vous avez spécifié.

Référentiel

Choisissez Repository dans mon compte Bitbucket ou Public repository et saisissez l'URL du référentiel.

Version source

Entrez une branche, un ID de validation, une étiquette ou une référence et un ID de validation. Pour de plus amples informations, consultez Exemple de version source avec AWS CodeBuild.

Note

Nous vous recommandons de choisir des noms de branches Git qui ne ressemblent pas à des identifiants de validation, tels que 811dd1ba1aba14473856cee38308caed7190c0d ou5392f7. Cela vous permet d'éviter les collisions entre Git Checkout et les validations réelles.

Profondeur du clone Git

Choisissez Git clone depth (Profondeur du clone Git) pour créer un clone superficiel avec un historique tronqué au nombre de validations spécifié. Si vous souhaitez un clone complet, choisissez Full.

Sous-modules Git

Sélectionnez Use Git submodules (Utiliser les sous-modules Git) si vous souhaitez inclure les sous-modules Git dans votre référentiel.

Statut de la génération

Sélectionnez Signaler les états de construction au fournisseur source lorsque vos builds commencent et se terminent si vous souhaitez que l'état du début et de la fin de votre build soit signalé à votre fournisseur source.

Pour pouvoir signaler l'état de construction au fournisseur source, l'utilisateur associé au fournisseur source doit disposer d'un accès en écriture au dépôt. Si l'utilisateur n'a pas accès en écriture, l'état de compilation ne peut pas être mis à jour. Pour de plus amples informations, veuillez consulter Accès au fournisseur source.

Pour le contexte Status, entrez la valeur à utiliser pour le name paramètre dans l'état de validation de Bitbucket. Pour plus d'informations, voir build dans la documentation de l'API Bitbucket.

Pour Target URL, entrez la valeur à utiliser pour le url paramètre dans l'état de validation de Bitbucket. Pour plus d'informations, voir build dans la documentation de l'API Bitbucket.

L'état d'une compilation déclenchée par un webhook est toujours signalé au fournisseur de la source. Pour que l'état d'une compilation démarrée depuis la console ou d'un appel d'API soit signalé au fournisseur source, vous devez sélectionner ce paramètre.

Si les builds de votre projet sont déclenchés par un webhook, vous devez envoyer un nouveau commit au dépôt pour que la modification de ce paramètre soit prise en compte.

Dans Événements webhook de la source principale, sélectionnez Reconstruire chaque fois qu'une modification de code est envoyée à ce référentiel si vous CodeBuild souhaitez créer le code source chaque fois qu'une modification de code est envoyée à ce référentiel. Pour plus d'informations sur les webhooks et les groupes de filtres, consultezÉvénements du webhook Bitbucket.

GitHub
Titre

Choisissez Informations d'identification source par défaut ou Informations d'identification source personnalisées et suivez les instructions pour gérer les informations d'identification source par défaut ou personnaliser les informations d'identification source.

Type de connexion

Choisissez GitHub App, OAuth ou Token d'accès personnel auquel vous connecter. CodeBuild

Connection

Sélectionnez une GitHub connexion ou un code secret du Gestionnaire de secrets pour vous connecter via le type de connexion que vous avez spécifié.

Référentiel

Choisissez Repository in my GitHub account, Public repository ou GitHub Scoped Webhook et saisissez l'URL du référentiel.

Version source

Entrez une branche, un ID de validation, une étiquette ou une référence et un ID de validation. Pour de plus amples informations, consultez Exemple de version source avec AWS CodeBuild.

Note

Nous vous recommandons de choisir des noms de branches Git qui ne ressemblent pas à des identifiants de validation, tels que 811dd1ba1aba14473856cee38308caed7190c0d ou5392f7. Cela vous permet d'éviter les collisions entre Git Checkout et les validations réelles.

Profondeur du clone Git

Choisissez Git clone depth (Profondeur du clone Git) pour créer un clone superficiel avec un historique tronqué au nombre de validations spécifié. Si vous souhaitez un clone complet, choisissez Full.

Sous-modules Git

Sélectionnez Use Git submodules (Utiliser les sous-modules Git) si vous souhaitez inclure les sous-modules Git dans votre référentiel.

Statut de la génération

Sélectionnez Signaler les états de construction au fournisseur source lorsque vos builds commencent et se terminent si vous souhaitez que l'état du début et de la fin de votre build soit signalé à votre fournisseur source.

Pour pouvoir signaler l'état de construction au fournisseur source, l'utilisateur associé au fournisseur source doit disposer d'un accès en écriture au dépôt. Si l'utilisateur n'a pas accès en écriture, l'état de compilation ne peut pas être mis à jour. Pour de plus amples informations, veuillez consulter Accès au fournisseur source.

Pour le contexte du statut, entrez la valeur à utiliser pour le context paramètre dans le statut de GitHub validation. Pour plus d'informations, consultez la section Créer un statut de validation dans le guide du GitHub développeur.

Pour URL cible, entrez la valeur à utiliser pour le target_url paramètre dans le statut de GitHub validation. Pour plus d'informations, consultez la section Créer un statut de validation dans le guide du GitHub développeur.

L'état d'une compilation déclenchée par un webhook est toujours signalé au fournisseur de la source. Pour que l'état d'une compilation démarrée depuis la console ou d'un appel d'API soit signalé au fournisseur source, vous devez sélectionner ce paramètre.

Si les builds de votre projet sont déclenchés par un webhook, vous devez envoyer un nouveau commit au dépôt pour que la modification de ce paramètre soit prise en compte.

Dans Evénements webhook de la source principale, sélectionnez Reconstruire chaque fois qu'une modification de code est envoyée à ce référentiel si vous CodeBuild souhaitez créer le code source chaque fois qu'une modification de code est envoyée à ce référentiel. Pour plus d'informations sur les webhooks et les groupes de filtres, consultezGitHub événements Webhook.

GitHub Enterprise Server
Titre

Choisissez Informations d'identification source par défaut ou Informations d'identification source personnalisées et suivez les instructions pour gérer les informations d'identification source par défaut ou personnaliser les informations d'identification source.

Type de connexion

Choisissez le CodeConnections jeton d'accès personnel auquel vous souhaitez vous connecter CodeBuild.

Connection

Sélectionnez une connexion GitHub Enterprise ou un code secret Secrets Manager pour vous connecter via le type de connexion que vous avez spécifié.

Référentiel

Choisissez Repository dans mon compte GitHub GitHub Enterprise ou Webhook dédié à Enterprise et saisissez l'URL du référentiel.

Version source

Entrez une pull request, une branche, un ID de validation, une balise ou une référence et un ID de validation. Pour de plus amples informations, veuillez consulter Exemple de version source avec AWS CodeBuild.

Note

Nous vous recommandons de choisir des noms de branches Git qui ne ressemblent pas à des identifiants de validation, tels que 811dd1ba1aba14473856cee38308caed7190c0d ou5392f7. Cela vous permet d'éviter les collisions entre Git Checkout et les validations réelles.

Profondeur du clone Git

Choisissez Git clone depth (Profondeur du clone Git) pour créer un clone superficiel avec un historique tronqué au nombre de validations spécifié. Si vous souhaitez un clone complet, choisissez Full.

Sous-modules Git

Sélectionnez Use Git submodules (Utiliser les sous-modules Git) si vous souhaitez inclure les sous-modules Git dans votre référentiel.

Statut de la génération

Sélectionnez Signaler les états de construction au fournisseur source lorsque vos builds commencent et se terminent si vous souhaitez que l'état du début et de la fin de votre build soit signalé à votre fournisseur source.

Pour pouvoir signaler l'état de construction au fournisseur source, l'utilisateur associé au fournisseur source doit disposer d'un accès en écriture au dépôt. Si l'utilisateur n'a pas accès en écriture, l'état de compilation ne peut pas être mis à jour. Pour de plus amples informations, veuillez consulter Accès au fournisseur source.

Pour le contexte du statut, entrez la valeur à utiliser pour le context paramètre dans le statut de GitHub validation. Pour plus d'informations, consultez la section Créer un statut de validation dans le guide du GitHub développeur.

Pour URL cible, entrez la valeur à utiliser pour le target_url paramètre dans le statut de GitHub validation. Pour plus d'informations, consultez la section Créer un statut de validation dans le guide du GitHub développeur.

L'état d'une compilation déclenchée par un webhook est toujours signalé au fournisseur de la source. Pour que l'état d'une compilation démarrée depuis la console ou d'un appel d'API soit signalé au fournisseur source, vous devez sélectionner ce paramètre.

Si les builds de votre projet sont déclenchés par un webhook, vous devez envoyer un nouveau commit au dépôt pour que la modification de ce paramètre soit prise en compte.

SSL non sécurisé

Sélectionnez Activer le SSL non sécurisé pour ignorer les avertissements SSL lors de la connexion à votre référentiel de projets GitHub d'entreprise.

Dans Evénements webhook de la source principale, sélectionnez Reconstruire chaque fois qu'une modification de code est envoyée à ce référentiel si vous CodeBuild souhaitez créer le code source chaque fois qu'une modification de code est envoyée à ce référentiel. Pour plus d'informations sur les webhooks et les groupes de filtres, consultezGitHub événements Webhook.

GitLab
Titre

Choisissez Informations d'identification source par défaut ou Informations d'identification source personnalisées et suivez les instructions pour gérer les informations d'identification source par défaut ou personnaliser les informations d'identification source.

Type de connexion

CodeConnectionsest utilisé pour se connecter GitLab à CodeBuild.

Connection

Sélectionnez la GitLab connexion par laquelle vous souhaitez vous connecter CodeConnections.

Référentiel

Choisissez le référentiel que vous souhaitez utiliser.

Version source

Entrez un ID de pull request, une branche, un ID de validation, une balise ou une référence et un ID de validation. Pour de plus amples informations, veuillez consulter Exemple de version source avec AWS CodeBuild.

Note

Nous vous recommandons de choisir des noms de branches Git qui ne ressemblent pas à des identifiants de validation, tels que 811dd1ba1aba14473856cee38308caed7190c0d ou5392f7. Cela vous permet d'éviter les collisions entre Git Checkout et les validations réelles.

Profondeur du clone Git

Choisissez Git clone depth (Profondeur du clone Git) pour créer un clone superficiel avec un historique tronqué au nombre de validations spécifié. Si vous souhaitez un clone complet, choisissez Full.

Statut de la génération

Sélectionnez Signaler les états de construction au fournisseur source lorsque vos builds commencent et se terminent si vous souhaitez que l'état du début et de la fin de votre build soit signalé à votre fournisseur source.

Pour pouvoir signaler l'état de construction au fournisseur source, l'utilisateur associé au fournisseur source doit disposer d'un accès en écriture au dépôt. Si l'utilisateur n'a pas accès en écriture, l'état de compilation ne peut pas être mis à jour. Pour de plus amples informations, veuillez consulter Accès au fournisseur source.

GitLab Self Managed
Titre

Choisissez Informations d'identification source par défaut ou Informations d'identification source personnalisées et suivez les instructions pour gérer les informations d'identification source par défaut ou personnaliser les informations d'identification source.

Type de connexion

CodeConnectionsest utilisé pour connecter GitLab Self Managed à CodeBuild.

Connection

Sélectionnez une connexion GitLab autogérée par laquelle vous souhaitez vous connecter CodeConnections.

Référentiel

Choisissez le référentiel que vous souhaitez utiliser.

Version source

Entrez un ID de pull request, une branche, un ID de validation, une balise ou une référence et un ID de validation. Pour de plus amples informations, veuillez consulter Exemple de version source avec AWS CodeBuild.

Note

Nous vous recommandons de choisir des noms de branches Git qui ne ressemblent pas à des identifiants de validation, tels que 811dd1ba1aba14473856cee38308caed7190c0d ou5392f7. Cela vous permet d'éviter les collisions entre Git Checkout et les validations réelles.

Profondeur du clone Git

Choisissez Git clone depth (Profondeur du clone Git) pour créer un clone superficiel avec un historique tronqué au nombre de validations spécifié. Si vous souhaitez un clone complet, choisissez Full.

Statut de la génération

Sélectionnez Signaler les états de construction au fournisseur source lorsque vos builds commencent et se terminent si vous souhaitez que l'état du début et de la fin de votre build soit signalé à votre fournisseur source.

Pour pouvoir signaler l'état de construction au fournisseur source, l'utilisateur associé au fournisseur source doit disposer d'un accès en écriture au dépôt. Si l'utilisateur n'a pas accès en écriture, l'état de compilation ne peut pas être mis à jour. Pour de plus amples informations, veuillez consulter Accès au fournisseur source.

Environnement

Dans la section Environnement, choisissez Modifier. Lorsque vos modifications sont terminées, choisissez Mettre à jour la configuration pour enregistrer la nouvelle configuration.

Vous pouvez modifier les propriétés suivantes :

Modèle de provisionnement

Pour modifier le modèle de provisionnement, choisissez Modifier le modèle de provisionnement et effectuez l'une des opérations suivantes :

  • Pour utiliser des flottes à la demande gérées par AWS CodeBuild, choisissez On-demand. Avec des flottes à la demande, CodeBuild fournit des capacités de calcul pour vos constructions. Les machines sont détruites à la fin de la construction. On-demand les flottes sont entièrement gérées et incluent des fonctionnalités de dimensionnement automatique pour gérer les pics de demande.

  • Pour utiliser les flottes à capacité réservée gérées par AWS CodeBuild, choisissez Capacité réservée, puis sélectionnez un nom de flotte. Avec les parcs à capacité réservée, vous configurez un ensemble d'instances dédiées pour votre environnement de build. Ces machines restent inactives, prêtes à traiter les builds ou les tests immédiatement et réduisent les durées de construction. Avec les flottes à capacité réservée, vos machines fonctionnent en permanence et continueront à entraîner des coûts tant qu'elles seront approvisionnées.

Pour plus d'informations, consultez Exécutez des builds sur des flottes à capacité réservée.

Image de l'environnement

Pour modifier l'image de construction, choisissez Remplacer l'image et effectuez l'une des opérations 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, 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 sélectionner l'image Docker dans votre compte. AWS

  • Pour utiliser une image Docker privée, choisissez Image personnalisée. Pour 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 dans le Guide de l'utilisateur AWS Secrets Manager .

Note

CodeBuild remplace le ENTRYPOINT pour les images Docker personnalisées.

Rôle de service

Effectuez l’une des actions 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 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.

Configuration supplémentaire
Expiration

Spécifiez une valeur comprise entre 5 minutes et 36 heures, après quoi la CodeBuild génération s'arrête si elle n'est pas terminée. Si les valeurs de heures et minutes sont laissées vides, la valeur par défaut de 60 minutes est utilisée.

Privilège

Sélectionnez Activer cet indicateur si vous souhaitez créer des images Docker ou si vous souhaitez que vos builds bénéficient de privilèges élevés. uniquement si vous envisagez d'utiliser ce projet de génération pour créer des images Docker. Sinon, toutes les générations associées qui tentent d'interagir avec le démon Docker échouent. Vous devez également démarrer le démon Docker afin que vos générations puissent interagir avec celui-ci. Pour ce faire, vous pouvez initialiser le démon Docker dans la install phase de votre buildspec en exécutant les commandes de construction suivantes. N'exécutez pas ces commandes si vous avez choisi une image d'environnement de génération fournie CodeBuild par le support Docker.

Note

Par défaut, le démon Docker est activé pour les builds non VPC. Si vous souhaitez utiliser des conteneurs Docker pour les builds de VPC, consultez Runtime Privilege et Linux Capabilities sur le site Web de Docker Docs et activez le mode privilégié. De plus, Windows ne prend pas en charge le mode privilégié.

- nohup /usr/local/bin/dockerd --host=unix:///var/run/docker.sock --host=tcp://127.0.0.1:2375 --storage-driver=overlay2 &
- timeout 15 sh -c "until docker info; do echo .; sleep 1; done"
VPC

Si vous souhaitez CodeBuild travailler avec votre VPC :

  • Pour VPC, choisissez l'ID de VPC utilisé. CodeBuild

  • Pour les sous-réseaux VPC, choisissez les sous-réseaux qui incluent des ressources qui utilisent. CodeBuild

  • Pour les groupes de sécurité VPC, choisissez les groupes de sécurité CodeBuild utilisés pour autoriser l'accès aux ressources des VPC.

Pour de plus amples informations, veuillez consulter Utilisation AWS CodeBuild avec Amazon Virtual Private Cloud.

Calcul

Choisissez l'une des options disponibles.

Identifiant du registre

Spécifiez un identifiant de registre lorsque le projet est configuré avec une image de registre non privée.

Note

Ces informations d'identification ne seront utilisées que si les images sont remplacées par celles provenant de registres privés.

Variables d'environnement

Entrez le nom et la valeur, puis choisissez le type de chaque variable d'environnement à utiliser par les builds.

Note

CodeBuild définit automatiquement la variable d'environnement pour votre AWS région. Vous devez définir les variables d'environnement suivantes si vous ne les avez pas ajoutées dans votre fichier buildspec.yml :

  • AWS_ACCOUNT_ID

  • IMAGE_REPO_NAME

  • IMAGE_TAG

La console et AWS CLI les utilisateurs peuvent voir les variables d'environnement. Si la visibilité de vos variables d'environnement ne vous pose pas de problème, définissez les zones Nom et Valeur, puis définissez Type sur Texte brut.

Nous vous recommandons de stocker une variable d'environnement avec une valeur sensible, telle qu'un ID de clé d' AWS accès, une clé d'accès AWS secrète ou un mot de passe en tant que paramètre dans Amazon EC2 Systems Manager Parameter Store ou AWS Secrets Manager.

Si vous utilisez Amazon EC2 Systems Manager Parameter Store, choisissez Parameter dans Type. Dans le champ Nom, entrez un identifiant CodeBuild à référencer. Dans Value, entrez le nom du paramètre tel qu'il est stocké dans le magasin de paramètres Amazon EC2 Systems Manager. Si l'on prend comme exemple un paramètre nommé /CodeBuild/dockerLoginPassword, pour Type, choisissez Parameter (Paramètre). Pour Nom, saisissez LOGIN_PASSWORD. Pour le champ Valeur, saisissez /CodeBuild/dockerLoginPassword.

Important

Si vous utilisez Amazon EC2 Systems Manager Parameter Store, nous vous recommandons de stocker les paramètres avec des noms de paramètres commençant par /CodeBuild/ (par exemple,/CodeBuild/dockerLoginPassword). Vous pouvez utiliser la CodeBuild console pour créer un paramètre dans Amazon EC2 Systems Manager. Choisissez Create parameter (Créer un paramètre), puis suivez les instructions de la boîte de dialogue. (Dans cette boîte de dialogue, pour la clé KMS, vous pouvez spécifier l'ARN d'une AWS KMS clé de votre compte. Amazon EC2 Systems Manager utilise cette clé pour chiffrer la valeur du paramètre pendant le stockage et la déchiffrer lors de la récupération.) Si vous utilisez la CodeBuild console pour créer un paramètre, la console commence le nom du paramètre par « /CodeBuild/ tel qu'il est stocké ». Pour plus d'informations, consultez la section Procédure pas à pas du magasin de paramètres de Systems Manager et de la console de stockage de paramètres de Systems Manager dans le guide de l'utilisateur d'Amazon EC2 Systems Manager.

Si votre projet de génération fait référence à des paramètres stockés dans le magasin de paramètres Amazon EC2 Systems Manager, le rôle de service du projet de génération doit autoriser l'ssm:GetParametersaction. Si vous avez choisi Nouveau rôle de service plus tôt, CodeBuild inclut cette action dans le rôle de service par défaut de votre projet de génération. En revanche, si vous avez choisi précédemment Existing service role (Rôle de service existant), vous devez inclure séparément cette action dans votre rôle de service.

Si votre projet de génération fait référence à des paramètres stockés dans le magasin de paramètres Amazon EC2 Systems Manager avec des noms de paramètres qui ne commencent pas par/CodeBuild/, et que vous avez choisi Nouveau rôle de service, vous devez mettre à jour ce rôle de service pour permettre l'accès aux noms de paramètres qui ne commencent /CodeBuild/ pas par. En effet, ce rôle de service permet uniquement d'accéder aux noms de paramètres qui commencent par /CodeBuild/.

Si vous choisissez Nouveau rôle de service, le rôle de service inclut l'autorisation de déchiffrer tous les paramètres contenus dans l'/CodeBuild/espace de noms du magasin de paramètres Amazon EC2 Systems Manager.

Les variables d'environnement que vous définissez remplacent les variables d'environnement existantes. Par exemple, si l'image Docker contient déjà une variable d'environnement nommée MY_VAR avec la valeur my_value et que vous définissez une variable d'environnement nommée MY_VAR avec la valeur other_value, la valeur my_value est remplacée par other_value. De même, si l'image Docker contient déjà une variable d'environnement nommée PATH avec la valeur /usr/local/sbin:/usr/local/bin et que vous définissez une variable d'environnement nommée PATH avec la valeur $PATH:/usr/share/ant/bin, la valeur /usr/local/sbin:/usr/local/bin est remplacée par la valeur littérale $PATH:/usr/share/ant/bin.

Ne définissez pas de variables d'environnement avec un nom commençant par CODEBUILD_. Ce préfixe est réservé à une utilisation interne .

Si une variable d'environnement avec le même nom est définie dans plusieurs emplacements, la valeur est déterminée comme suit :

  • La valeur de l'appel d'opération de démarrage de génération a une priorité plus élevée.

  • La valeur de la définition de projet de génération vient ensuite dans l'ordre des priorités.

  • La valeur figurant dans la déclaration buildspec a la priorité la plus faible.

Si vous utilisez Secrets Manager, dans Type, choisissez Secrets Manager. Dans le champ Nom, entrez un identifiant CodeBuild à référencer. Pour Value (Valeur), saisissez un reference-key à l'aide du modèle secret-id:json-key:version-stage:version-id. Pour plus d'informations, consultez Secrets Manager reference-key in the buildspec file.

Important

Si vous utilisez le Gestionnaire de secrets, nous vous recommandons de stocker les secrets dont le nom commence par /CodeBuild/ (par exemple,/CodeBuild/dockerLoginPassword). Pour plus d'informations, consultez Présentation de AWS Secrets Manager dans le Guide de l'utilisateur AWS Secrets Manager .

Si votre projet de génération fait référence à des secrets stockés dans Secrets Manager, le rôle de service du projet de génération doit autoriser l'secretsmanager:GetSecretValueaction. Si vous avez choisi Nouveau rôle de service plus tôt, CodeBuild inclut cette action dans le rôle de service par défaut de votre projet de génération. En revanche, si vous avez choisi précédemment Existing service role (Rôle de service existant), vous devez inclure séparément cette action dans votre rôle de service.

Si votre projet de génération fait référence à des secrets stockés dans Secrets Manager avec des noms secrets ne commençant pas par/CodeBuild/, et que vous avez choisi Nouveau rôle de service, vous devez mettre à jour le rôle de service pour autoriser l'accès aux noms secrets qui ne commencent pas par/CodeBuild/. En effet, le rôle de service n'autorise l'accès qu'aux noms secrets commençant par/CodeBuild/.

Si vous choisissez Nouveau rôle de service, le rôle de service inclut l'autorisation de déchiffrer tous les secrets contenus dans l'/CodeBuild/espace de noms du Gestionnaire de secrets.

Spécifications de construction

Dans la section Buildspec, choisissez Modifier. Lorsque vos modifications sont terminées, choisissez Mettre à jour la configuration pour enregistrer la nouvelle configuration.

Vous pouvez modifier les propriétés suivantes :

Spécifications de construction

Effectuez l’une des actions suivantes :

  • Si votre code source inclut un fichier buildspec, choisissez Utiliser un fichier buildspec. Par défaut, CodeBuild recherche un fichier nommé buildspec.yml dans le répertoire racine de code source. Si votre fichier buildspec utilise un nom ou un emplacement différent, entrez son chemin depuis la racine source dans Buildspec name (par exemple, ou. buildspec-two.yml configuration/buildspec.yml Si le fichier buildspec se trouve dans un compartiment S3, il doit se trouver dans la même AWS région que votre projet de construction. Spécifiez le fichier buildspec à l'aide de son ARN (par exemple,arn:aws:s3:::<my-codebuild-sample2>/buildspec.yml).

  • Si votre code source ne comprend pas de fichier de spécification de génération ou si vous souhaitez exécuter des commandes de génération différentes de celles spécifiées pour la phase build dans le fichier buildspec.yml au sein du répertoire racine du code source, choisissez Insérer des commandes de génération. Pour Build commands (Commandes de génération), saisissez les commandes que vous souhaitez exécuter lors de la phase build. Pour plusieurs commandes, séparez celles-ci avec && (par exemple, mvn test && mvn package). Pour exécuter des commandes dans d'autres phases, ou si vous disposez d'une longue liste de commandes pour la build phase, ajoutez un buildspec.yml fichier au répertoire racine du code source, ajoutez les commandes au fichier, puis choisissez Utiliser le buildspec.yml dans le répertoire racine du code source.

Pour de plus amples informations, veuillez consulter Référence des spécifications de génération.

Configuration par lots

Dans la section Configuration par lots, choisissez Modifier. Lorsque vos modifications sont terminées, choisissez Mettre à jour la configuration pour enregistrer la nouvelle configuration. Pour de plus amples informations, veuillez consulter Exécutez des builds par lots.

Vous pouvez modifier les propriétés suivantes :

Rôle du service par lots

Fournit le rôle de service pour les créations par lots.

Sélectionnez l’une des méthodes suivantes :

  • Si vous n'avez pas de rôle de service par lots, choisissez Nouveau rôle de service. Dans Rôle de service, entrez le nom du nouveau rôle.

  • Si vous avez un rôle de service par lots, choisissez Rôle de service existant. Dans Rôle de service, choisissez le rôle de service.

Les générations en lot introduisent un nouveau rôle de sécurité dans la configuration par lots. Ce nouveau rôle est obligatoire car vous CodeBuild devez être en mesure d'appeler les RetryBuild actions StartBuildStopBuild, et en votre nom pour exécuter des builds dans le cadre d'un lot. Les clients doivent utiliser un nouveau rôle, et non le même rôle qu’ils utilisent dans leur build, pour deux raisons :

  • Donner au rôle de build StartBuild, StopBuild et RetryBuild les autorisations permettrait à une seule build de lancer davantage de builds via le buildspec.

  • CodeBuild les builds par lots fournissent des restrictions qui limitent le nombre de builds et les types de calcul qui peuvent être utilisés pour les builds du batch. Si le rôle de build dispose de ces autorisations, il est possible que les builds elles-mêmes puissent contourner ces restrictions.

Types de calcul autorisés pour le traitement par lots

Sélectionnez les types de calcul autorisés pour le lot. Sélectionnez toutes les réponses qui s'appliquent.

Flottes autorisées pour les lots

Sélectionnez les flottes autorisées pour le lot. Sélectionnez toutes les réponses qui s'appliquent.

Nombre maximum de versions autorisées par lot

Entrez le nombre maximum de versions autorisées dans le lot. Si un lot dépasse cette limite, il échouera.

Délai d'expiration du lot

Entrez la durée maximale pendant laquelle la génération par lots doit être terminée.

Combinez des artefacts

Sélectionnez Combiner tous les artefacts du lot en un seul emplacement pour regrouper tous les artefacts du lot en un seul emplacement.

Mode de rapport par lots

Sélectionnez le mode de rapport d'état de construction souhaité pour les constructions par lots.

Note

Ce champ n'est disponible que lorsque la source du projet est Bitbucket ou GitHub Enterprise GitHub, et que l'option Signaler les états de construction au fournisseur source au début et à la fin de vos builds est sélectionnée sous Source.

Constructions agrégées

Sélectionnez cette option pour que les statuts de toutes les versions du lot soient combinés dans un seul rapport d'état.

Constructions individuelles

Sélectionnez cette option pour que les états de construction de toutes les versions du lot soient signalés séparément.

Artefacts

Dans la section Artefacts, choisissez Modifier. Lorsque vos modifications sont terminées, choisissez Mettre à jour la configuration pour enregistrer la nouvelle configuration.

Vous pouvez modifier les propriétés suivantes :

Type

Effectuez l’une des actions suivantes :

  • Si vous ne souhaitez pas créer des artefacts de sortie de génération, choisissez Aucun artefact. Vous pouvez le faire si vous n'exécutez que des tests de construction ou si vous souhaitez envoyer une image Docker vers un référentiel Amazon ECR.

  • Pour stocker la sortie de compilation 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. (Si vous souhaitez produire un fichier ZIP et que vous voulez que celui-ci ait une extension de fichier, veillez à l'inclure après le nom de fichier ZIP.)

    • Sélectionnez Activer la gestion sémantique des versions si vous voulez qu'un nom spécifié dans le fichier buildspec remplace le nom spécifié dans la console. Le nom figurant dans un fichier buildspec est calculé au moment de la génération et utilise le langage de commandes Shell. Par exemple, vous pouvez ajouter une date et une heure au nom de votre artefact afin qu'il soit toujours unique. Les noms d'artefact uniques empêchent les artefacts d'être écrasés. Pour de plus amples informations, veuillez consulter Syntaxe d'un fichier buildspec.

    • 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.

    • Si vous ne souhaitez pas que vos artefacts de génération soient chiffrés, choisissez Remove artifacts encryption (Supprimer le chiffrement des artefacts).

Pour chaque ensemble d'artefacts secondaire que vous souhaitez :

  1. Pour Artifact identifier (Identifiant d'artefact), saisissez une valeur de moins de 128 caractères et contenant uniquement des caractères alphanumériques et des traits de soulignement.

  2. Choisissez Add artifact (Ajouter un artefact).

  3. Suivez les étapes précédentes pour configurer vos artefacts secondaires.

  4. Choisissez Save artifact (Enregistrer l'artefact).

Configuration supplémentaire
Clé de chiffrement

Effectuez l’une des actions suivantes :

  • Pour utiliser l' Clé gérée par AWS Amazon S3 de votre compte afin de chiffrer les artefacts de sortie de la compilation, laissez le champ Clé de chiffrement vide. Il s’agit de l’option par défaut.

  • Pour utiliser une clé gérée par le client afin de chiffrer les artefacts de sortie de compilation, dans Clé de chiffrement, entrez l'ARN de la clé gérée par le client. Utilisez le format arn:aws:kms:region-ID:account-ID:key/key-ID.

Type de cache

Pour Cache type (Type de cache), choisissez l'une des valeurs suivantes :

  • Si vous ne souhaitez pas utiliser un cache, choisissez Aucun cache.

  • Si vous souhaitez utiliser un cache Amazon S3, choisissez Amazon S3, puis procédez comme suit :

    • Pour Compartiment, choisissez le nom du compartiment S3 dans lequel le cache est stocké.

    • (Facultatif) Pour Préfixe du chemin du cache, entrez un préfixe de chemin Amazon S3. La valeur Cache path prefix (Préfixe du chemin de cache) est semblable à un nom de répertoire. Cela vous permet de stocker le cache sous le même répertoire au sein d'un compartiment.

      Important

      N'ajoutez pas de barre oblique de fin (/) à la fin du préfixe du chemin.

  • Si vous souhaitez utiliser un cache local, choisissez Local, puis sélectionnez une ou plusieurs modes de cache local.

    Note

    Le mode de cache de couche Docker est disponible pour Linux uniquement. Si vous choisissez ce mode, votre projet doit être exécuté en mode privilégié.

L'utilisation d'un cache permet de gagner beaucoup de temps de génération, car les parties réutilisables de l'environnement de génération sont stockées dans le cache et utilisées d'une génération à l'autre. Pour de plus amples informations sur la spécification d'un cache dans le fichier de spécification de génération, consultez Syntaxe d'un fichier buildspec. Pour plus d'informations sur la mise en cache, consultez Le cache est créé pour améliorer les performances.

Journaux

Dans la section Journaux, choisissez Modifier. Lorsque vos modifications sont terminées, choisissez Mettre à jour la configuration pour enregistrer la nouvelle configuration.

Vous pouvez modifier les propriétés suivantes :

Choisissez les journaux que vous souhaitez créer. Vous pouvez créer des CloudWatch journaux Amazon, des journaux Amazon S3 ou les deux.

CloudWatch

Si vous souhaitez consulter CloudWatch les journaux Amazon Logs :

CloudWatch journaux

Sélectionnez Journaux CloudWatch .

Nom du groupe

Entrez le nom de votre groupe de CloudWatch journaux Amazon Logs.

Nom du stream

Entrez le nom de votre flux de CloudWatch journaux Amazon Logs.

S3

Si vous voulez des journaux Amazon S3 :

Journaux S3

Sélectionnez Journaux S3.

Compartiment

Choisissez le nom du compartiment S3 pour vos journaux.

Préfixe du chemin

Entrez le préfixe de vos journaux.

Désactiver le chiffrement des journaux S3

Sélectionnez cette option si vous ne souhaitez pas que vos journaux S3 soient chiffrés.

Modifier les paramètres d'un projet de build (AWS CLI)

Pour plus d'informations sur l'utilisation AWS CLI de with AWS CodeBuild, consultez leRéférence des commandes en ligne.

Pour mettre à jour un CodeBuild projet avec le AWS CLI, vous créez un fichier JSON avec les propriétés mises à jour et vous transmettez ce fichier à la update-project commande. Toutes les propriétés qui ne figurent pas dans le fichier de mise à jour restent inchangées.

Dans le fichier JSON de mise à jour, seules la name propriété et les propriétés modifiées sont requises. La name propriété identifie le projet à modifier. Pour toute structure modifiée, les paramètres requis pour ces structures doivent également être inclus. Par exemple, pour modifier l'environnement du projet, les environment/computeType propriétés environment/type et sont requises. Voici un exemple qui met à jour l'image de l'environnement :

{
  "name": "<project-name>",
  "environment": {
    "type": "LINUX_CONTAINER",
    "computeType": "BUILD_GENERAL1_SMALL",
    "image": "aws/codebuild/amazonlinux-x86_64-standard:4.0"
  }
}

Si vous devez obtenir les valeurs de propriétés actuelles d'un projet, utilisez la batch-get-projects commande pour obtenir les propriétés actuelles du projet que vous modifiez et écrivez la sortie dans un fichier.

aws codebuild batch-get-projects --names "<project-name>" > project-info.json

Le project-info.json fichier contient un tableau de projets, il ne peut donc pas être utilisé directement pour mettre à jour un projet. Vous pouvez toutefois copier les propriétés que vous souhaitez modifier à partir du project-info.json fichier et les coller dans votre fichier de mise à jour en tant que référence pour les propriétés que vous souhaitez modifier. Pour de plus amples informations, veuillez consulter Affichage des détails d'un projet de génération (AWS CLI).

Modifiez le fichier JSON de mise à jour comme décrit dansCréez un projet de construction (AWS CLI), puis enregistrez vos résultats. Lorsque vous avez fini de modifier le fichier JSON de mise à jour, exécutez la update-project commande en transmettant le fichier JSON de mise à jour.

aws codebuild update-project --cli-input-json file://<update-project-file>

En cas de succès, le JSON du projet mis à jour apparaît dans la sortie. Si des paramètres requis sont manquants, un message d'erreur s'affiche dans la sortie pour identifier les paramètres manquants. Par exemple, voici le message d'erreur affiché si le environment/type paramètre est absent :

aws codebuild update-project --cli-input-json file://update-project.json

Parameter validation failed:
Missing required parameter in environment: "type"

Modifier les paramètres d'un projet de build (AWS SDK)

Pour plus d'informations sur AWS CodeBuild l'utilisation des AWS kits SDK, consultez leAWS Référence des kits de développement logiciel et des outils.