Remarque : Les exécuteurs hébergés sur GitHub ne sont pas pris en charge sur GitHub Enterprise Server. Vous pouvez voir plus d’informations sur le support futur planifié dans la GitHub public roadmap.
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
-
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 :
- Dans le coin supérieur droit de GitHub Enterprise Server, cliquez sur votre photo de profil, puis sur Paramètres d’entreprise.
- Dans le coin supérieur droit de GitHub Enterprise Server, cliquez sur votre photo de profil, puis sur Paramètres d’entreprise.
-
-
Accédez aux paramètres GitHub Actions :
-
Dans une organisation ou un dépôt :
- Dans la barre latérale gauche, cliquez sur Actions, puis sur Exécuteurs.
-
Si vous utilisez un exécuteur au niveau de l’entreprise :
- 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.
-
-
Dans la section « Étiquettes », cliquez sur .
-
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é
-
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 :
- Dans le coin supérieur droit de GitHub Enterprise Server, cliquez sur votre photo de profil, puis sur Paramètres d’entreprise.
- Dans le coin supérieur droit de GitHub Enterprise Server, cliquez sur votre photo de profil, puis sur Paramètres d’entreprise.
-
-
Accédez aux paramètres GitHub Actions :
-
Dans une organisation ou un dépôt :
- Dans la barre latérale gauche, cliquez sur Actions, puis sur Exécuteurs.
-
Si vous utilisez un exécuteur au niveau de l’entreprise :
- 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 .
-
-
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é
-
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 :
- Dans le coin supérieur droit de GitHub Enterprise Server, cliquez sur votre photo de profil, puis sur Paramètres d’entreprise.
- Dans le coin supérieur droit de GitHub Enterprise Server, cliquez sur votre photo de profil, puis sur Paramètres d’entreprise.
-
-
Accédez aux paramètres GitHub Actions :
-
Dans une organisation ou un dépôt :
- Dans la barre latérale gauche, cliquez sur Actions, puis sur Exécuteurs.
-
Si vous utilisez un exécuteur au niveau de l’entreprise :
- 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 .
-
-
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ètrelabels
.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
oulinux
. 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.