Gestion des exécuteurs de plus grande taille

Ajout d’un exécuteur plus grand à une entreprise

Les propriétaires d’entreprise peuvent ajouter des exécuteur plus grand à une entreprise et les affecter à des organisations. Par défaut, quand un exécuteur plus grand est créé pour une entreprise, il est ajouté à un groupe d’exécuteurs par défaut, auquel toutes les organisations de l’entreprise ont accès. Bien que toutes les organisations se voient accorder l’accès à l’exécuteur, les dépôts de chaque organisation ne bénéficient pas de l’accès. Pour chaque organisation, un propriétaire d’organisation doit configurer le groupe d’exécuteurs pour spécifier les référentiels qui ont accès à l’exécuteur d’entreprise. Pour plus d’informations, consultez « Autoriser des dépôts à accéder à des exécuteur plus grand ».

Vous pouvez choisir un système d’exploitation et une configuration matérielle dans la liste des options disponibles. Quand de nouvelles instances de cet exécuteur sont déployées par le biais d’une mise à l’échelle automatique, elles utilisent le même système d’exploitation et la même configuration matérielle que ceux que vous avez définis ici.

Les nouveaux exécuteurs sont automatiquement affectés au groupe par défaut. Vous pouvez aussi choisir le groupe qu’un exécuteur doit rejoindre pendant son processus de création. De plus, vous pouvez modifier l’appartenance à un groupe de l’exécuteur une fois que vous avez inscrit cet exécuteur. Pour plus d’informations, consultez « Contrôle de l’accès aux exécuteurs plus grands ».

1. Dans le coin supérieur droit de GitHub, cliquez sur votre image de profil.

2. Selon votre environnement, cliquez sur Entreprise, ou sur Entreprises , puis sur l’entreprise que vous souhaitez afficher.

3. En haut de la page, cliquez sur Stratégies.

4. Sous «  Politiques », cliquez Actions.

5. Cliquez sur l’onglet Exécuteurs.

6. Cliquez sur Nouvel exécuteur, puis sur Nouvel exécuteur hébergé par GitHub.

7. Complétez les détails nécessaires pour configurer votre nouvel exécuteur :

   •     **Nom** : Entrez un nom pour votre nouveau runner. Pour faciliter son identification, ce nom doit indiquer sa configuration matérielle et son système d’exploitation, comme `ubuntu-24.04-16core`.
     

   •     **Plateforme** : choisissez une plateforme parmi les options disponibles. Une fois que vous avez sélectionné une plateforme, vous pourrez choisir une image spécifique.
     

     Si vous créez une image personnalisée, la plateforme que vous sélectionnez pour votre exécuteur doit correspondre à la plateforme de l’image que vous souhaitez générer. La plateforme de l’exécuteur peut être l’une des plateformes suivantes :

     • Linux x64
     • Linux ARM64
     • Windows x64

   •     **Image** : choisissez une image parmi les options disponibles. Une fois que vous avez sélectionné une image, vous pouvez choisir une taille spécifique.
     

     * Propriété de GitHub : pour les images gérées par GitHub, sélectionnez une image sous cet onglet. * Partenaire : pour les images gérées par un partenaire, sélectionnez une image sous cet onglet. Par exemple, les images de base de Windows 11 Desktop, optimisées par GPU et arm64 se trouvent sous cet onglet. * Coutume: Pour les images créées par votre organisation ou votre entreprise, sélectionnez une image sous cet onglet. Les images personnalisées sont créées en exécutant un flux de travail sur un exécuteur de génération d’images que vous, votre organisation ou votre entreprise avez configuré. Pour plus d’informations, consultez Installation d’images personnalisées.

   •     **Taille** : choisissez une configuration matérielle dans la liste des options disponibles. Les tailles disponibles dépendent de l'image que vous avez sélectionnée à l'étape précédente. Pour les exécuteurs GPU, sélectionnez une taille sous l’onglet **Alimenté par GPU**.
     

   •     **Concurrence maximale** : choisissez le nombre maximal de projets pouvant être actifs à un moment donné.
     

   •     **Groupe d’exécuteurs** : Choisissez le groupe dont votre exécuteur sera membre. Ce groupe va héberger plusieurs instances de votre exécuteur, au fur et à mesure de leurs scale-up et scale-down pour répondre à la demande. 
     

   •     **Réseaux** : choisissez si des plages d’adresses IP statiques vont être attribuées aux instances de l’exécuteur plus grand. Vous pouvez utiliser jusqu’à 10 exécuteur plus grand avec des adresses IP statiques au total. 
     

   Remarque

   Les noms des exécuteurs plus grands peuvent dicter leurs fonctionnalités. Par exemple, pour utiliser un exécuteur plus grand pour l’installation par défaut de code scanning, l’exécuteur doit être nommé code-scanning. Pour plus d’informations sur code scanning avec exécuteurs plus grands, consultez Configuration de runners de plus grande capacité pour la configuration par défaut.

8. Cliquez sur Créer un exécuteur.

9. Pour permettre aux organisations d'accéder à votre exécuteur plus grand, indiquez quelles organisations peuvent utiliser le groupe d’exécuteurs auquel l'exécuteur est affecté. Pour plus d’informations, consultez « Contrôle de l’accès aux exécuteurs plus grands ».

Ajout d’un exécuteur plus grand à une organisation

Les propriétaires d’organisation et les utilisateurs disposant de l’autorisation « Gérer les exécuteurs d’organisation et les groupes d’exécuteurs » peuvent ajouter un exécuteur plus grand à une organisation et contrôler les référentiels qui peuvent l’utiliser. Quand vous créez un exécuteur pour un organisation, par défaut, tous les dépôts de l’organisation ont accès à l’exécuteur. Pour limiter les dépôts qui peuvent utiliser l’exécuteur, affectez-le à un groupe d’exécuteurs avec un accès à des dépôts spécifiques. Pour plus d’informations, consultez « Autoriser des dépôts à accéder à des exécuteurs de plus grande taille ».

Vous pouvez choisir un système d’exploitation et une configuration matérielle dans la liste des options disponibles. Quand de nouvelles instances de cet exécuteur sont déployées par le biais d’une mise à l’échelle automatique, elles utilisent le même système d’exploitation et la même configuration matérielle que ceux que vous avez définis ici.

Les nouveaux exécuteurs sont automatiquement affectés au groupe par défaut. Vous pouvez aussi choisir le groupe qu’un exécuteur doit rejoindre pendant son processus de création. De plus, vous pouvez modifier l’appartenance à un groupe de l’exécuteur une fois que vous avez inscrit cet exécuteur. Pour plus d’informations, consultez « Contrôle de l’accès aux exécuteurs plus grands ».

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.

   

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

4. Cliquez sur Nouvel exécuteur, puis sur Nouvel exécuteur hébergé par GitHub.

5. Complétez les détails nécessaires pour configurer votre nouvel exécuteur :

   •     **Nom** : Entrez un nom pour votre nouveau runner. Pour faciliter son identification, ce nom doit indiquer sa configuration matérielle et son système d’exploitation, comme `ubuntu-24.04-16core`.
     

   •     **Plateforme** : choisissez une plateforme parmi les options disponibles. Une fois que vous avez sélectionné une plateforme, vous pourrez choisir une image spécifique.
     

     Si vous créez une image personnalisée, la plateforme que vous sélectionnez pour votre exécuteur doit correspondre à la plateforme de l’image que vous souhaitez générer. La plateforme de l’exécuteur peut être l’une des plateformes suivantes :

     • Linux x64
     • Linux ARM64
     • Windows x64

   •     **Image** : choisissez une image parmi les options disponibles. Une fois que vous avez sélectionné une image, vous pouvez choisir une taille spécifique.
     

     * Propriété de GitHub : pour les images gérées par GitHub, sélectionnez une image sous cet onglet. * Partenaire : pour les images gérées par un partenaire, sélectionnez une image sous cet onglet. Par exemple, les images de base de Windows 11 Desktop, optimisées par GPU et arm64 se trouvent sous cet onglet. * Coutume: Pour les images créées par votre organisation ou votre entreprise, sélectionnez une image sous cet onglet. Les images personnalisées sont créées en exécutant un flux de travail sur un exécuteur de génération d’images que vous, votre organisation ou votre entreprise avez configuré. Pour plus d’informations, consultez Installation d’images personnalisées.

   •     **Taille** : choisissez une configuration matérielle dans la liste des options disponibles. Les tailles disponibles dépendent de l'image que vous avez sélectionnée à l'étape précédente. Pour les exécuteurs GPU, sélectionnez une taille sous l’onglet **Alimenté par GPU**.
     

   •     **Concurrence maximale** : choisissez le nombre maximal de projets pouvant être actifs à un moment donné.
     

   •     **Groupe d’exécuteurs** : Choisissez le groupe dont votre exécuteur sera membre. Ce groupe va héberger plusieurs instances de votre exécuteur, au fur et à mesure de leurs scale-up et scale-down pour répondre à la demande. 
     

   •     **Réseaux** : choisissez si des plages d’adresses IP statiques vont être attribuées aux instances de l’exécuteur plus grand. Vous pouvez utiliser jusqu’à 10 exécuteur plus grand avec des adresses IP statiques au total. 
     

   Remarque

   Les noms des exécuteurs plus grands peuvent dicter leurs fonctionnalités. Par exemple, pour utiliser un exécuteur plus grand pour l’installation par défaut de code scanning, l’exécuteur doit être nommé code-scanning. Pour plus d’informations sur code scanning avec exécuteurs plus grands, consultez Configuration de runners de plus grande capacité pour la configuration par défaut.

6. Cliquez sur Créer un exécuteur.

7. Pour autoriser les dépôts à accéder à vos exécuteur plus grand, ajoutez-les à la liste des dépôts qui peuvent les utiliser. Pour plus d’informations, consultez « Autoriser des dépôts à accéder à des exécuteur plus grand ».

Autoriser des dépôts à accéder à des exécuteur plus grand

Les dépôts reçoivent l’autorisation d’accès à des exécuteur plus grand via des groupes d’exécuteurs. Les administrateurs d’entreprise peuvent choisir les organisations autorisées à accéder aux groupes d’exécuteurs au niveau de l’entreprise, et les propriétaires d’organisation et utilisateurs disposant de l’autorisation « Gérer les exécuteurs d’organisation et les groupes d’exécuteurs » contrôlent l’accès au niveau du référentiel à tous les exécuteur plus grand.

Les propriétaires d’organisations peuvent utiliser et configurer des groupes d’exécuteurs au niveau de l’entreprise pour les référentiels de leur organisation, ou créer des groupes d’exécuteurs au niveau de l’organisation pour contrôler l’accès. Les utilisateurs disposant de l’autorisation « Gérer les exécuteurs d’organisation et les groupes d’exécuteurs » ne peuvent gérer que les groupes d’exécuteurs au niveau de l’organisation. Pour plus d’informations, consultez « À propos des rôles personnalisés dans une organisation ».

•         **Pour les groupes d’exécuteurs de niveau 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.
  

•         **Pour les groupes d’exécuteurs de niveau 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  et les utilisateurs disposant de l’autorisation « Gérer les exécuteurs d’organisation et les groupes d’exécuteurs » doivent configurer les groupes d’exécuteurs d’organisation et choisir les référentiels qui y ont accès.
  

Une fois qu’un dépôt a accès à des exécuteur plus grand, les exécuteur plus grand peuvent être ajoutés aux fichiers de workflow. Pour plus d’informations, consultez « Exécution de travaux sur des exécuteurs de plus grande taille ».

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. Sélectionnez un groupe d’exécuteurs dans une des listes de la page. Les groupes d’exécuteurs de niveau organisation sont listés en haut de la page, et les groupes d’exécuteurs de niveau entreprise sont listés sous « Partagé par l’entreprise ».
5. Dans la page du groupe d’exécuteurs, sous « Accès au dépôt », sélectionnez Tous les dépôts ou Dépôts sélectionnés. Si vous choisissez d’accorder l’accès à des dépôts spécifiques, cliquez sur , puis sélectionnez les dépôts auxquels vous souhaitez accorder l’accès dans la liste.

Modification du nom d’un exécuteur plus grand

Vous pouvez modifier le nom de vos exécuteur plus grand.

•         [Modification du nom d’un exécuteur d’organisation](#changing-the-name-of-an-organization-runner)
  

•         [Modification du nom d’un exécuteur d’entreprise](#changing-the-name-of-an-enterprise-runner)
  

Modification du nom d’un exécuteur d’organisation

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.

   

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

4. Dans la liste des exécuteurs, sélectionnez l’exécuteur que vous souhaitez modifier.

5. Entrez un nouveau nom pour l’exécuteur dans le champ de texte sous « Nom ».

6. Cliquez sur Enregistrer.

Modification du nom d’un exécuteur d’entreprise

1. Dans le coin supérieur droit de GitHub, cliquez sur votre image de profil.
2. Selon votre environnement, cliquez sur Entreprise, ou sur Entreprises , puis sur l’entreprise que vous souhaitez afficher.
3. En haut de la page, cliquez sur Stratégies.
4. Sous «  Politiques », cliquez Actions.
5. Cliquez sur l’onglet Exécuteurs.
6. Dans la liste des exécuteurs, sélectionnez l’exécuteur que vous souhaitez modifier.
7. Entrez un nouveau nom pour l’exécuteur dans le champ de texte sous « Nom ».
8. Cliquez sur Enregistrer.

Modifier la taille d'un exécuteur plus grand

Vous pouvez modifier la taille de vos exécuteur plus grands.

•         [Modification de la taille d'un exécuteur de l'organisation](#changing-the-size-of-an-organization-runner)
  

•         [Modification de la taille d'un exécuteur d'entreprise](#changing-the-size-of-an-enterprise-runner)
  

Modification de la taille d'un exécuteur de l'organisation

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.

   

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

4. Dans la liste des exécuteurs, sélectionnez l’exécuteur que vous souhaitez modifier.

5. Sélectionnez une nouvelle taille pour l’exécuteur dans la liste des options disponibles sous « Taille » Les tailles disponibles dépendent de l’image installée sur l’exécuteur.

6. Cliquez sur Enregistrer.

Modification de la taille d'un exécuteur d'entreprise

1. Dans le coin supérieur droit de GitHub, cliquez sur votre image de profil.
2. Selon votre environnement, cliquez sur Entreprise, ou sur Entreprises , puis sur l’entreprise que vous souhaitez afficher.
3. En haut de la page, cliquez sur Stratégies.
4. Sous «  Politiques », cliquez Actions.
5. Cliquez sur l’onglet Exécuteurs.
6. Dans la liste des exécuteurs, sélectionnez l’exécuteur que vous souhaitez modifier.
7. Sélectionnez une nouvelle taille pour l’exécuteur dans la liste des options disponibles sous « Taille » Les tailles disponibles dépendent de l’image installée sur l’exécuteur.
8. Cliquez sur Enregistrer.

Modification de l’image d’un exécuteur plus grand

Vous pouvez modifier l’image de vos exécuteur plus grand si vous utilisez une image appartenant à GitHub. Pour obtenir la liste de nos images gérées, consultez le référentiel Images exécuteurs GitHub Actions.

•         [Modification de l’image d’un exécuteur d’organisation](#changing-the-image-of-an-organization-runner)
  

•         [Modification de l’image d’un exécuteur d’entreprise](#changing-the-image-of-an-enterprise-runner)
  

Modification de l’image d’un exécuteur d’organisation

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.

   

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

4. Dans la liste des exécuteurs, sélectionnez l’exécuteur que vous souhaitez modifier.

5. Sélectionnez une nouvelle image pour l’exécuteur dans la liste des options disponibles sous « Image ». Les images disponibles sont limitées aux images appartenant à GitHub.

6. Cliquez sur Enregistrer.

Modification de l’image d’un exécuteur d’entreprise

1. Dans le coin supérieur droit de GitHub, cliquez sur votre image de profil.
2. Selon votre environnement, cliquez sur Entreprise, ou sur Entreprises , puis sur l’entreprise que vous souhaitez afficher.
3. En haut de la page, cliquez sur Stratégies.
4. Sous «  Politiques », cliquez Actions.
5. Cliquez sur l’onglet Exécuteurs.
6. Dans la liste des exécuteurs, sélectionnez l’exécuteur que vous souhaitez modifier.
7. Sélectionnez une nouvelle image pour l’exécuteur dans la liste des options disponibles sous « Image ». Les images disponibles sont limitées aux images appartenant à GitHub.
8. Cliquez sur Enregistrer.

Configuration de la mise à l’échelle automatique pour des exécuteur plus grand

Vous pouvez contrôler le nombre maximal de travaux autorisés à s’exécuter simultanément pour des ensembles d’exécuteurs spécifiques. La définition de ce champ sur une valeur plus élevée peut éviter que des workflows soient bloqués en raison du parallélisme.

•         [Configuration de la mise à l’échelle automatique pour un exécuteur d’organisation](#configuring-autoscaling-for-an-organization-runner)
  

•         [Configuration de la mise à l’échelle automatique pour un exécuteur d’entreprise](#configuring-autoscaling-for-an-enterprise-runner)
  

Configuration de la mise à l’échelle automatique pour un exécuteur d’organisation

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.

   

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

4. Dans la liste des exécuteurs, sélectionnez l’exécuteur que vous souhaitez modifier.

5. Dans la section « Mise à l’échelle automatique », sous « Concurrence maximale des travaux », entrez le nombre maximal de travaux que vous souhaitez autoriser à s’exécuter en même temps.

6. Cliquez sur Enregistrer.

Configuration de la mise à l’échelle automatique pour un exécuteur d’entreprise

1. Dans le coin supérieur droit de GitHub, cliquez sur votre image de profil.
2. Selon votre environnement, cliquez sur Entreprise, ou sur Entreprises , puis sur l’entreprise que vous souhaitez afficher.
3. En haut de la page, cliquez sur Stratégies.
4. Sous «  Politiques », cliquez Actions.
5. Cliquez sur l’onglet Exécuteurs.
6. Dans la liste des exécuteurs, sélectionnez l’exécuteur que vous souhaitez modifier.
7. Dans la section « Mise à l’échelle automatique », sous « Concurrence maximale des travaux », entrez le nombre maximal de travaux que vous souhaitez autoriser à s’exécuter en même temps.
8. Cliquez sur Enregistrer.

Création d’adresses IP statiques pour des exécuteur plus grand

Vous pouvez activer des adresses IP statiques pour des exécuteur plus grand. Dans ce cas, les exécuteur plus grand sont affectés aux plages d’adresses IP statiques. Toutes les adresses IP de la plage attribuée sont utilisables. Par défaut, vous pouvez configurer jusqu’à 10 exécuteur plus grand différents avec des plages d’adresses IP pour votre compte. Si vous voulez utiliser plus de 10 exécuteurs plus grands avec des plages d’adresses IP statiques, veuillez contacter .

Le nombre d’adresses IP disponibles dans la plage attribuée ne restreint pas le nombre de projets simultanés spécifiés pour la mise à l’échelle automatique. Dans un pool d’exécuteurs, il existe un équilibreur de charge qui permet une réutilisation élevée des adresses IP dans les plages attribuées. Ceci garantit que vos workflows peuvent s’exécuter simultanément à grande échelle tandis que chaque machine se voit attribuer une adresse IP statique.

•         [Création d’adresses IP statiques pour les exécuteurs d’organisation](#creating-static-ip-addresses-for-organization-runners)
  

•         [Création d’adresses IP statiques pour les exécuteurs d’entreprise](#creating-static-ip-addresses-for-enterprise-runners)
  

Création d’adresses IP statiques pour les exécuteurs d’organisation

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.

   

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

4. Dans la liste des exécuteurs, sélectionnez l’exécuteur que vous souhaitez modifier.

5. Pour attribuer une adresse IP statique à l’exécuteur, sous « Réseau », cochez Attribuer des plages d’adresses IP publiques statiques et uniques pour cet exécuteur.

6. Cliquez sur Enregistrer.

Création d’adresses IP statiques pour les exécuteurs d’entreprise

1. Dans le coin supérieur droit de GitHub, cliquez sur votre image de profil.
2. Selon votre environnement, cliquez sur Entreprise, ou sur Entreprises , puis sur l’entreprise que vous souhaitez afficher.
3. En haut de la page, cliquez sur Stratégies.
4. Sous «  Politiques », cliquez Actions.
5. Cliquez sur l’onglet Exécuteurs.
6. Dans la liste des exécuteurs, sélectionnez l’exécuteur que vous souhaitez modifier.
7. Pour attribuer une adresse IP statique à l’exécuteur, sous « Réseau », cochez Attribuer des plages d’adresses IP publiques statiques et uniques pour cet exécuteur.
8. Cliquez sur Enregistrer.