Skip to main content
Nous publions des mises à jour fréquentes de notre documentation, et la traduction de cette page peut encore être en cours. Pour obtenir les informations les plus actuelles, consultez la documentation anglaise.

Utilisation d’étiquettes avec des exécuteurs auto-hébergés

Vous pouvez utiliser des étiquettes pour organiser vos exécuteurs autohébergés en fonction de leurs caractéristiques.

Pour obtenir des informations sur l’utilisation d’étiquettes pour router des travaux vers des types spécifiques d’exécuteurs auto-hébergés, consultez « Utilisation d’exécuteurs auto-hébergés dans un workflow ». Vous pouvez également router des travaux vers des exécuteurs dans un groupe spécifique. Pour plus d’informations, consultez « Ciblage des exécuteurs dans un groupe ».

Un exécuteur auto-hébergé peut se trouver dans les paramètres du compte de votre dépôt, organisation ou entreprise sur GitHub. Pour gérer un exécuteur auto-hébergé, vous devez disposer des autorisations suivantes, selon l’emplacement auquel il a été ajouté :

  • Dépôt utilisateur : Vous devez être le propriétaire du dépôt.
  • Organisation : Vous devez être propriétaire de l’organisation.
  • Dépôt d’organisation : Vous devez être propriétaire de l’organisation ou disposer d’un accès administrateur au dépôt.

Création d’une étiquette personnalisée

  1. Accédez à la page principale de l’organisation ou du dépôt dans laquelle votre groupe d’exécuteurs auto-hébergés est inscrit.
  2. Cliquez sur Paramètres.
  3. Dans la barre latérale gauche, cliquez sur Actions, puis sur Exécuteurs. 1. Dans la liste des exécuteurs, cliquez sur le nom de celui que vous souhaitez configurer.
  4. Dans la section « Étiquettes », cliquez sur .
  5. Dans le champ « Rechercher ou créer une étiquette », tapez le nom de votre nouvelle étiquette, puis cliquez sur Créer une nouvelle étiquette. L’étiquette personnalisée est créée et affectée à l’exécuteur auto-hébergé. Les étiquettes personnalisées peuvent être supprimées des exécuteurs auto-hébergés, mais elles ne peuvent pas être supprimées manuellement. Toute étiquette non utilisée et non attribuée à un exécuteur est automatiquement supprimée dans les 24 heures.

Affectation d’une étiquette à un exécuteur auto-hébergé

  1. Accédez à la page principale de l’organisation ou du dépôt dans laquelle votre groupe d’exécuteurs auto-hébergés est inscrit.
  2. Cliquez sur Paramètres.
  3. Dans la barre latérale gauche, cliquez sur Actions, puis sur Exécuteurs. 1. Dans la liste des exécuteurs, cliquez sur le nom de celui que vous souhaitez configurer. 1. Dans la section « Étiquettes », cliquez sur .
  4. Pour affecter une étiquette à votre exécuteur auto-hébergé, dans le champ « Rechercher ou créer une étiquette », cliquez sur l’étiquette.

Suppression d’une étiquette personnalisée d’un exécuteur auto-hébergé

  1. Accédez à la page principale de l’organisation ou du dépôt dans laquelle votre groupe d’exécuteurs auto-hébergés est inscrit.
  2. Cliquez sur Paramètres.
  3. Dans la barre latérale gauche, cliquez sur Actions, puis sur Exécuteurs. 1. Dans la liste des exécuteurs, cliquez sur le nom de celui que vous souhaitez configurer. 1. Dans la section « Étiquettes », cliquez sur .
  4. Dans le champ « Rechercher ou créer une étiquette », les étiquettes affectées sont marquées avec l’icône . Cliquez sur une étiquette marquée pour annuler son affectation à l’exécuteur auto-hébergé.

Attribuer des étiquettes par programmation

Vous pouvez attribuer par programmation des étiquettes à un exécuteur auto-hébergé après la création de l’exécuteur ou pendant sa configuration initiale.

  • Pour attribuer par programmation des étiquettes à un exécuteur auto-hébergé existant, vous devez utiliser l’API REST. Pour plus d’informations, consultez l’API REST « Exécuteurs auto-hébergés ».

  • Pour attribuer par programmation des étiquettes à un exécuteur auto-hébergé pendant sa configuration initiale, vous pouvez passer des noms d’étiquettes au script config à l’aide du paramètre labels.

    Remarque : vous ne pouvez pas utiliser le script config pour attribuer des étiquettes à un exécuteur auto-hébergé existant.

    Par exemple, cette commande attribue une étiquette nommée gpu lors de la configuration d’un nouvel exécuteur auto-hébergé :

    ./config.sh --url <REPOSITORY_URL> --token <REGISTRATION_TOKEN> --labels gpu
    

    L’étiquette est créée si elle n’existe pas encore. Vous pouvez également utiliser cette approche pour affecter les étiquettes par défaut aux exécuteurs, tels que x64 ou linux. Lorsque des étiquettes par défaut sont affectées à l’aide du script de configuration, GitHub Actions les accepte telles qu’elles sont donnés et ne vérifie pas si l’exécuteur utilise réellement ce système d’exploitation ou cette architecture.

    Vous pouvez utiliser des virgules de séparation pour affecter plusieurs étiquettes. Par exemple :

    ./config.sh --url <REPOSITORY_URL> --token <REGISTRATION_TOKEN> --labels gpu,x64,linux
    

    Remarque : Si vous remplacez un exécuteur existant, vous devez réaffecter toutes les étiquettes personnalisées.