Contrôle de l’accès aux exécuteurs plus grands

Vous pouvez utiliser des stratégies pour limiter l’accès aux exécuteur plus grand qui ont été ajoutés à une organisation ou à une entreprise.

Qui peut utiliser cette fonctionnalité ?

Les Exécuteur de plus grande taille sont uniquement disponibles pour les organisations et les entreprises qui utilisent les plans GitHub Team ou GitHub Enterprise Cloud.

Dans cet article

Remarque

Les informations et les instructions de cet article s’appliquent uniquement aux données exécuteur plus grands avec des systèmes d’exploitation Linux et Windows.

Gestion de l’accès à des exécuteurs de plus grande taille

Remarque

Avant que vos workflows ne puissent envoyer des travaux aux exécuteur plus grand, vous devez d’abord configurer des autorisations pour le groupe d’exécuteurs. Pour plus d’informations, consultez les sections suivantes.

Les groupes d’exécuteurs sont utilisés pour contrôler les dépôts qui peuvent exécuter des travaux sur vos exécuteur plus grand. Vous devez gérer l’accès au groupe depuis chaque niveau de la hiérarchie de gestion, selon l’emplacement où vous avez défini le exécuteur plus grand :

  •         **Exécuteurs au niveau de l’entreprise** : Par défaut, les dépôts d’une organisation n’ont pas accès aux groupes d’exécuteurs de niveau entreprise. Pour donner aux référentiels l'accès aux groupes d'exécution d'entreprise, les propriétaires de l'organisation doivent configurer chaque groupe d'exécution d'entreprise et choisir les référentiels qui y ont accès.

  •         **Exécuteurs au niveau de l’organisation** : Par défaut, tous les dépôts d’une organisation reçoivent l’autorisation d’accès aux groupes d’exécuteurs de niveau organisation. Pour restreindre l’accès aux référentiels, les propriétaires d'organisation  doivent configurer les groupes d’exécuteurs d’organisation et choisir les référentiels qui y ont accès.

Par exemple, le schéma suivant comporte un groupe d’exécuteurs nommé grp-ubuntu-24.04-16core au niveau de l’entreprise. Avant que le dépôt nommé octo-repo puisse utiliser les exécuteurs du groupe, vous devez d’abord configurer le groupe au niveau de l’entreprise pour autoriser l’accès à l’organisation octo-org. Vous devez ensuite configurer le groupe au niveau de l’organisation pour autoriser l’accès à octo-repo.

Diagramme montrant un groupe d’exécuteurs défini au niveau de l’entreprise avec une configuration d’organisation qui autorise l’accès à deux référentiels.

Création d'un groupe de runners pour une organisation

Avertissement

Si vous utilisez une plage d’adresses IP fixe, nous vous recommandons d’utiliser uniquement des exécuteur plus grands avec des référentiels privés. Les duplications (forks) de votre dépôt peuvent exécuter du code potentiellement dangereux sur votre exécuteur plus grand en créant une demande de tirage qui exécute le code dans un workflow.

Remarque

Lors de la création d'un groupe d'exécution, vous devez choisir une politique qui définit quels référentiels ont accès au groupe d'exécution. Pour modifier la liste de référentiels et flux de travail ayant accès au groupe d’exécuteurs, les propriétaires d'organisation peuvent définir une stratégie pour l’organisation. Pour plus d’informations, consultez « Application de stratégies pour GitHub Actions dans votre entreprise ».

Toutes les organisations disposent d’un seul groupe d’exécuteurs par défaut. Les propriétaires d’organisation utilisant le plan GitHub Team peuvent créer des groupes d’exécuteurs supplémentaires au niveau de l’organisation.

Si aucun groupe n’est spécifié pendant le processus d’inscription, les exécuteurs sont automatiquement ajoutés au groupe par défaut. Vous pouvez déplacer ultérieurement l’exécuteur du groupe par défaut vers un groupe personnalisé.

Pour obtenir des informations sur la façon de créer un groupe d’exécuteurs avec l’API REST, consultez Points de terminaison d’API REST pour GitHub Actions.

  1. Sur GitHub, accédez à la page principale de l’organisation.

  2. Sous le nom de votre organisation, cliquez sur Settings. Si vous ne voyez pas l’onglet « Paramètres », sélectionnez le menu déroulant , puis cliquez sur Paramètres.

    Capture d’écran des onglets dans le profil d’une organisation. L’onglet « Paramètres » est présenté en orange foncé.

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

  4. Dans la section « Groupes d’exécuteurs », cliquez sur Nouveau groupe d’exécuteurs.

  5. Entrez un nom pour votre groupe d’exécuteurs.

  6. Affectez une stratégie d’accès au dépôt.

    Vous pouvez configurer un groupe d’exécuteurs pour qu’il soit accessible à une liste spécifique de référentiels ou à l’ensemble des référentiels de l’organisation. Par défaut, seuls les dépôts privés peuvent accéder aux exécuteurs dans un groupe d’exécuteurs, mais vous pouvez remplacer cette autorisation. Ce paramètre ne peut pas être remplacé si vous configurez un groupe d’exécuteurs d’une organisation qui a été partagé par une entreprise.

  7. Cliquez sur Créer un groupe pour créer le groupe et appliquer la stratégie.

Changer les dépôts qui peuvent accéder à un groupe d’exécuteurs

Avertissement

Si vous utilisez une plage d’adresses IP fixe, nous vous recommandons d’utiliser uniquement des exécuteur plus grands avec des référentiels privés. Les duplications (forks) de votre dépôt peuvent exécuter du code potentiellement dangereux sur votre exécuteur plus grand en créant une demande de tirage qui exécute le code dans un workflow.

Pour les groupes d’exécuteurs d’une organisation, vous pouvez changer les dépôts qui peuvent accéder à un groupe d’exécuteurs.

  1. Accédez à la page principale de l’organisation où se trouvent vos groupes d’exécuteurs.

  2. Cliquez sur Paramètres.

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

  4. Dans la liste des groupes, cliquez sur le groupe d’exécuteurs à configurer.

  5. Sous « Accès au référentiel », utilisez le menu déroulant pour cliquer sur Référentiels sélectionnés.

    1. À droite du menu déroulant, cliquez sur .
    2. Dans la fenêtre contextuelle, cochez les cases pour sélectionner les référentiels qui peuvent accéder à ce groupe d’exécuteurs.

  6. Cliquez sur Enregistrer le groupe.

Configuration de l'accès au réseau privé pour des exécuteurs de plus grande taille

Si vous avez configuré votre entreprise pour vous connecter à un VNet Azure, vous pouvez accorder aux groupes d’exécuteurs l’accès au réseau virtuel. Pour plus d’informations, consultez « Mise en réseau privée avec des runners hébergés par GitHub ».

Changement du nom d’un groupe de runners

  1. Accédez à la page principale de l’organisation où se trouvent vos groupes d’exécuteurs.
  2. Cliquez sur Paramètres.
  3. Dans la barre latérale gauche, cliquez sur Actions, puis sur Groupes Exécuteurs.
  4. Dans la liste des groupes, cliquez sur le groupe d’exécuteurs à configurer.
  5. Entrez le nom du nouveau groupe d’exécuteurs dans le champ de texte sous « Nom du groupe ».
  6. Cliquez sur Enregistrer.

Déplacement d’un exécuteur vers un groupe

Si vous ne spécifiez pas de groupe d’exécuteurs pendant le processus d’inscription, vos nouveaux exécuteurs sont automatiquement affectés au groupe par défaut et peuvent ensuite être déplacés vers un autre groupe.

  1. Sur GitHub, accédez à la page principale de l’organisation.

  2. Sous le nom de votre organisation, cliquez sur Settings. Si vous ne voyez pas l’onglet « Paramètres », sélectionnez le menu déroulant , puis cliquez sur Paramètres.

    Capture d’écran des onglets dans le profil d’une organisation. L’onglet « Paramètres » est présenté en orange foncé.

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

  4. Dans la liste « Exécuteurs », cliquez sur l’exécuteur que vous souhaitez configurer.

  5. Sélectionnez la liste déroulante Groupe d’exécuteurs.

  6. Dans « Déplacer l’exécuteur vers le groupe », choisissez un groupe de destination pour l’exécuteur.

Supprimer un groupe de runners

Pour pouvoir supprimer un groupe d’exécuteurs, vous devez d’abord déplacer ou supprimer tous les exécuteurs du groupe.

  1. Accédez à la page principale de l’organisation où se trouvent vos groupes d’exécuteurs.
  2. Cliquez sur Paramètres.
  3. Dans la barre latérale gauche, cliquez sur Actions, puis sur Groupes Exécuteurs.
  4. Dans la liste des groupes, à droite du groupe à supprimer, cliquez sur .
  5. Pour supprimer le groupe, cliquez sur Supprimer le groupe.
  6. Passez en revue les invites de confirmation, puis cliquez sur Supprimer ce groupe d’exécuteurs.