Skip to main content

Cette version de GitHub Enterprise Server n'est plus disponible depuis le 2025-06-04. Aucune publication de correctifs n’est effectuée, même pour les problèmes de sécurité critiques. Pour de meilleures performances, une sécurité améliorée et de nouvelles fonctionnalités, effectuez une mise à niveau vers la dernière version de GitHub Enterprise. Pour obtenir de l’aide sur la mise à niveau, contactez le support GitHub Enterprise.

Using labels with self-hosted runners

You can use labels to organize your self-hosted runners based on their characteristics.

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.

For information on how to use labels to route jobs to specific types of self-hosted runners, see Using self-hosted runners in a workflow. You can also route jobs to runners in a specific group. For more information, see Choosing the runner for a job.

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

Remarque

Actions Runner Controller does not support multiple labels, to find out more please read our Actions Runner Controller documentation

Creating a custom label

You can create custom labels for runners at the repository, organization, and enterprise levels.

Remarque

Labels are case-insensitive.

Creating a custom label for a repository runner

  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.

Creating a custom label for an organization runner

  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.

Creating a custom label for an enterprise runner

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

    Capture d’écran du menu déroulant affiché lorsque vous cliquez sur la photo du profil sur GitHub Enterprise Server. L’option « Paramètres de l’entreprise » est mise en évidence.

  2. Sur le côté gauche de la page, dans la barre latérale du compte d’entreprise, cliquez sur Stratégies.

  3. Sous « Stratégies  », cliquez sur Actions.

  4. Cliquez sur l’onglet Exécuteurs.

  5. Dans la liste des exécuteurs, cliquez sur le nom de celui que vous souhaitez configurer.

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

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

Assigning a label to a self-hosted runner

You can assign labels to self-hosted runners at the repository, organization, and enterprise levels.

Assigning a label to a repository runner

  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.

Assigning a label to an organization runner

  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.

Assigning a label to an enterprise runner

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

    Capture d’écran du menu déroulant affiché lorsque vous cliquez sur la photo du profil sur GitHub Enterprise Server. L’option « Paramètres de l’entreprise » est mise en évidence.

  2. Sur le côté gauche de la page, dans la barre latérale du compte d’entreprise, cliquez sur Stratégies.

  3. Sous « Stratégies  », cliquez sur Actions.

  4. Cliquez sur l’onglet Exécuteurs.

  5. Dans la liste des exécuteurs, cliquez sur le nom de celui que vous souhaitez configurer.

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

  7. Pour affecter une étiquette à votre exécuteur auto-hébergé, dans le champ « Rechercher ou créer une étiquette », cliquez sur l’étiquette.

Removing a custom label from a self-hosted runner

You can remove custom labels from self-hosted runners at the repository, organization, and enterprise levels.

Removing a custom label from a repository runner

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

Removing a custom label from an organization runner

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

Removing a custom label from an enterprise runner

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

    Capture d’écran du menu déroulant affiché lorsque vous cliquez sur la photo du profil sur GitHub Enterprise Server. L’option « Paramètres de l’entreprise » est mise en évidence.

  2. Sur le côté gauche de la page, dans la barre latérale du compte d’entreprise, cliquez sur Stratégies.

  3. Sous « Stratégies  », cliquez sur Actions.

  4. Cliquez sur l’onglet Exécuteurs.

  5. Dans la liste des exécuteurs, cliquez sur le nom de celui que vous souhaitez configurer.

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

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

Programmatically assign labels

You can programmatically assign labels to a self-hosted runner after the runner is created, or during its initial configuration.

  • To programmatically assign labels to an existing self-hosted runner, you must use the REST API. For more information, see Points de terminaison d’API REST pour les exécuteurs auto-hébergés.

  • To programmatically assign labels to a self-hosted runner during the initial runner configuration, you can pass label names to the config script using the labels parameter.

    Remarque

    You cannot use the config script to assign labels to an existing self-hosted runner.

    For example, this command assigns a label named gpu when configuring a new self-hosted runner:

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

    The label is created if it does not already exist. You can also use this approach to assign the default labels to runners, such as x64 or linux. When default labels are assigned using the configuration script, GitHub Actions accepts them as given and does not validate that the runner is actually using that operating system or architecture.

    You can use comma separation to assign multiple labels. For example:

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

    Remarque

    If you replace an existing runner, then you must reassign any custom labels.