View a markdown version of this page

Les remplacements d'étiquettes sont pris en charge avec le CodeBuild-hosted Buildkite Runner - AWS 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.

Les remplacements d'étiquettes sont pris en charge avec le CodeBuild-hosted Buildkite Runner

Dans les étiquettes des balises d'agent des étapes de votre pipeline Buildkite, vous pouvez proposer diverses modifications d'étiquettes qui modifient la version de votre runner auto-hébergée. Toutes les versions non reconnues par CodeBuild seront ignorées mais votre demande de webhook n'échouera pas. Par exemple, le flux de travail YAML suivant inclut des remplacements pour l'image, la taille de l'instance, la flotte et la spécification de construction :

agents:
  queue: "myQueue"
steps:
  - command: "echo \"Hello World\""
    agents:
      project: "codebuild-myProject"
      image: "{{matrix.os}}"
      instance-size: "{{matrix.size}}"
      buildspec-override: "true"
    matrix:
      setup:
        os:
          - "arm-3.0"
          - "al2-5.0"
        size:
          - "small"
          - "large"

project:codebuild-<project-name> (obligatoire)

  • Exemple : project: "codebuild-myProject"

  • Obligatoire pour toutes les configurations d'étapes du pipeline Buildkite. <project name>doit être égal au nom du projet pour lequel le webhook du runner auto-hébergé est configuré.

queue: "<queue-name>"

  • Exemple : queue: "<queue-name>"

  • Utilisé pour acheminer les tâches Buildkite vers une file d'attente spécifique. Consultez la balise Buildkite Agent Queue pour plus d'informations.

image: "<environment-type>-<image-identifier>"

  • Exemple : image: "arm-3.0"

  • Remplace l'image et le type d'environnement utilisés lors du démarrage de la version auto-hébergée du coureur par une image sélectionnée. Pour en savoir plus sur les valeurs prises en charge, consultezCalculez les images prises en charge par le moteur CodeBuild-hosted Buildkite.

    1. Pour remplacer l'image et le type d'environnement utilisés par une image personnalisée, utilisez image: "custom-<environment-type>-<custom-image-identifier>"

    2. Exemple : 

      image:
      "custom-arm-public.ecr.aws/codebuild/amazonlinux-aarch64-standard:3.0"
    Note

    Si l'image personnalisée se trouve dans un registre privé, vous devez configurer les informations d'identification de registre appropriées dans votre CodeBuild projet.

instance-size: "<instance-size>"

fleet: "<fleet-name>"

  • Exemple : fleet: "myFleet"

  • Remplace les paramètres de flotte configurés sur votre projet pour utiliser le parc spécifié. Pour plus d'informations, voir Exécuter des builds sur des flottes à capacité réservée.

buildspec-override: "<boolean>"

  • Exemple : buildspec-override: "true"

  • Permet à la compilation d'exécuter les commandes buildspec dans les POST_BUILD phases INSTALLPRE_BUILD, et si elle est définie sur. true