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

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

Un exécuteur auto-hébergé peut se trouver dans les paramètres du compte de votre dépôt, organisation ou les paramètres de votre entreprise sur votre instance GitHub Enterprise Server. 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.

• Entreprise : Vous devez être administrateur de site GitHub Enterprise.

Création d’une étiquette personnalisée

1. Accédez à l’emplacement auquel votre exécuteur est inscrit :

   • Dans une organisation ou un dépôt : accédez à la page principale et cliquez sur Paramètres.

   • Si vous utilisez un exécuteur au niveau de l’entreprise :

     1. Dans le coin supérieur droit de GitHub Enterprise Server, cliquez sur votre photo de profil, puis sur Paramètres d’entreprise.

2. Accédez aux paramètres GitHub Actions :

   • Dans une organisation ou un dépôt :

     1. Dans la barre latérale gauche, cliquez sur Actions, puis sur Exécuteurs.

   • Si vous utilisez un exécuteur au niveau de l’entreprise :

     1. Dans la barre latérale du compte d’entreprise, cliquez sur Stratégies. 1. Sous «  », cliquez sur Actions. 1. Cliquez sur l’onglet Exécuteurs. 1. Dans la liste des exécuteurs, cliquez sur le nom de celui que vous souhaitez configurer.

3. Dans la section « Étiquettes », cliquez sur .

4. 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 à l’emplacement auquel votre exécuteur est inscrit :

   • Dans une organisation ou un dépôt : accédez à la page principale et cliquez sur Paramètres.

   • Si vous utilisez un exécuteur au niveau de l’entreprise :

     1. Dans le coin supérieur droit de GitHub Enterprise Server, cliquez sur votre photo de profil, puis sur Paramètres d’entreprise.

2. Accédez aux paramètres GitHub Actions :

   • Dans une organisation ou un dépôt :

     1. Dans la barre latérale gauche, cliquez sur Actions, puis sur Exécuteurs.

   • Si vous utilisez un exécuteur au niveau de l’entreprise :

     1. Dans la barre latérale du compte d’entreprise, cliquez sur Stratégies. 1. Sous «  », cliquez sur Actions. 1. Cliquez sur l’onglet 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 .

3. 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 à l’emplacement auquel votre exécuteur est inscrit :

   • Dans une organisation ou un dépôt : accédez à la page principale et cliquez sur Paramètres.

   • Si vous utilisez un exécuteur au niveau de l’entreprise :

     1. Dans le coin supérieur droit de GitHub Enterprise Server, cliquez sur votre photo de profil, puis sur Paramètres d’entreprise.

2. Accédez aux paramètres GitHub Actions :

   • Dans une organisation ou un dépôt :

     1. Dans la barre latérale gauche, cliquez sur Actions, puis sur Exécuteurs.

   • Si vous utilisez un exécuteur au niveau de l’entreprise :

     1. Dans la barre latérale du compte d’entreprise, cliquez sur Stratégies. 1. Sous «  », cliquez sur Actions. 1. Cliquez sur l’onglet 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 .

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