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.

Dans cet article

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 « Choix de l’exécuteur pour un travail ».

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.

Note

Actions Runner Controller ne prend pas en charge plusieurs étiquettes. Pour plus d’informations, consultez notre Documentation Actions Runner Controller

Création d’une étiquette personnalisée

Vous pouvez créer des étiquettes personnalisées pour les exécuteurs au niveau du référentiel et de l’organisation.

Remarque : Les étiquettes sont insensibles à la casse.

Création d’une étiquette personnalisée pour un exécuteur de référentiel

  1. Accédez à la page principale du référentiel 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.
  4. Dans la liste des exécuteurs, cliquez sur le nom de celui que vous souhaitez configurer.
  5. Dans la section « Étiquettes », cliquez sur .
  6. 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.

Création d’une étiquette personnalisée pour un exécuteur d’organisation

  1. Accédez à la page principale de l’organisation 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.
  4. Dans la liste des exécuteurs, cliquez sur le nom de celui que vous souhaitez configurer.
  5. Dans la section « Étiquettes », cliquez sur .
  6. 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é

Vous pouvez attribuer des étiquettes personnalisées pour les exécuteurs auto-hébergés au niveau du référentiel et de l’organisation.

Attribution d’une étiquette à un exécuteur de référentiel

  1. Accédez à la page principale du référentiel 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.
  4. Dans la section « Étiquettes », cliquez sur .
  5. Pour affecter une étiquette à votre exécuteur auto-hébergé, dans le champ « Rechercher ou créer une étiquette », cliquez sur l’étiquette.

Attribution d’une étiquette à un exécuteur d’organisation

  1. Accédez à la page principale de l’organisation 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.
  4. Dans la section « Étiquettes », cliquez sur .
  5. 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é

Vous pouvez supprimer des étiquettes personnalisées pour les exécuteurs auto-hébergés au niveau du référentiel et de l’organisation.

Suppression d’une étiquette personnalisée à partir d’un exécuteur de référentiel

  1. Accédez à la page principale du référentiel 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.
  4. Dans la section « Étiquettes », cliquez sur .
  5. 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é.

Suppression d’une étiquette personnalisée à partir d’un exécuteur d’organisation

  1. Accédez à la page principale de l’organisation 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.
  4. Dans la section « Étiquettes », cliquez sur .
  5. 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 « Points de terminaison d’API REST pour les 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.