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, lorsqu’un exécuteur plus grand est créé pour une entreprise, il est ajouté à un groupe de runners 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 doit configurer le groupe de runners afin de déterminer quels référentiels peuvent accéder au runner d’entreprise. Pour plus d’informations, consultez Autoriser les référentiels à accéder à exécuteur plus grands.

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. Accédez à votre entreprise. Par exemple, depuis la page Entreprises sur GitHub.com.

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

3. Sous «  Politiques », cliquez Actions.

4. Cliquez sur l’onglet Exécuteurs.

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

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

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

8. 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 de l’organisation ainsi que 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 quels dépôts 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 en savoir plus, reportez-vous à la section Autoriser l’accès des référentiels à des exécuteurs plus puissants.

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 référentiels à accéder à vos exécuteur plus grands, ajoutez-les à la liste des référentiels qui peuvent l’utiliser. Pour plus d’informations, consultez Autoriser les référentiels à accéder à exécuteur plus grands.

Permettre aux référentiels d’accéder à exécuteur plus grands

Les référentiels se voient accorder l’accès à exécuteur plus grands via des groupes de runners. Les administrateurs d’entreprise peuvent choisir quelles organisations bénéficient d’un accès aux groupes de runners au niveau de l’entreprise, et les propriétaires d’organisation ainsi que les utilisateurs disposant de l’autorisation « Gérer les runners d’organisation et les groupes de runners » contrôlent l’accès au niveau du dépôt à tous les groupeexécuteur plus grands de runners.

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 du droit « 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 Autorisations des rôles d’organisation personnalisés.

• **Pour les groupes de runners 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.
• **Pour les groupes de runners 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 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 référentiel a accès à exécuteur plus grands, les exécuteur plus grands peuvent être ajoutés aux fichiers de flux de travail. 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 de coureurs dans l'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 référentiels spécifiques, cliquez sur , puis sélectionnez les référentiels auxquels vous souhaitez accorder l’accès dans la liste.

Si vous souhaitez imposer que les workflows ciblent les runners uniquement via des groupes de runners, vous pouvez désactiver les runners standard hébergés sur GitHub au niveau de l’organisation ou de l’entreprise. Consultez Désactivation ou limitation des GitHub Actions pour votre organisation et Application de stratégies pour GitHub Actions dans votre entreprise.

Modification du nom d’un exécuteur plus grand

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

• Modification du nom d’un exécuteur d’organisation
• Modifier le nom d’un runner d’entreprise

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. Accédez à votre entreprise. Par exemple, depuis la page Entreprises sur GitHub.com.
2. En haut de la page, cliquez sur Stratégies.
3. Sous «  Politiques », cliquez Actions.
4. Cliquez sur l’onglet Exécuteurs.
5. Dans la liste des exécuteurs, sélectionnez l’exécuteur que vous souhaitez modifier.
6. Entrez un nouveau nom pour l’exécuteur dans le champ de texte sous « Nom ».
7. Cliquez sur Enregistrer.

Modification de 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 d’organisation
• Modification de la taille d’un exécuteur d’entreprise

Modification de la taille 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 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. Accédez à votre entreprise. Par exemple, depuis la page Entreprises sur GitHub.com.
2. En haut de la page, cliquez sur Stratégies.
3. Sous «  Politiques », cliquez Actions.
4. Cliquez sur l’onglet Exécuteurs.
5. Dans la liste des exécuteurs, sélectionnez l’exécuteur que vous souhaitez modifier.
6. 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.
7. Cliquez sur Enregistrer.

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

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

• Changement de l’image d’un exécuteur d’organisation
• Changement de l’image d’un exécuteur d’entreprise

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

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

1. Accédez à votre entreprise. Par exemple, depuis la page Entreprises sur GitHub.com.
2. En haut de la page, cliquez sur Stratégies.
3. Sous «  Politiques », cliquez Actions.
4. Cliquez sur l’onglet Exécuteurs.
5. Dans la liste des exécuteurs, sélectionnez l’exécuteur que vous souhaitez modifier.
6. 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.
7. Cliquez sur Enregistrer.

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

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.

• Paramétrage de la mise à l’échelle automatique pour un exécuteur d’organisation
• Paramétrage de la mise à l’échelle automatique pour un exécuteur d’entreprise

Paramétrage 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 « Capacité », sous « Concurrence maximale », entrez le nombre maximal de travaux que vous souhaitez autoriser à exécuter en même temps.

6. Cliquez sur Enregistrer.

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

1. Accédez à votre entreprise. Par exemple, depuis la page Entreprises sur GitHub.com.
2. En haut de la page, cliquez sur Stratégies.
3. Sous «  Politiques », cliquez Actions.
4. Cliquez sur l’onglet Exécuteurs.
5. Dans la liste des exécuteurs, sélectionnez l’exécuteur que vous souhaitez modifier.
6. Dans la section « Capacité », sous « Concurrence maximale », entrez le nombre maximal de travaux que vous souhaitez autoriser à exécuter en même temps.
7. Cliquez sur Enregistrer.

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

Vous pouvez activer les adresses IP statiques pour exécuteur plus grands. Lorsque vous procédez ainsi, des plages d’adresses IP statiques sont attribuées aux exécuteur plus grand. Toutes les adresses IP de la plage attribuée sont utilisables. Par défaut, vous pouvez configurer jusqu’à 10 exécuteur plus grand pools avec des plages d’adresses IP statiques pour votre compte. Si vous souhaitez utiliser plus de 10 pools d’exécuteurs plus grands avec des plages d’adresses IP statiques, contactez nous via le portail de support GitHub.

Chaque exécuteur plus grand que vous créez n’est pas une machine unique. Il s’agit d’un pool d’exécuteurs qui s’adapte automatiquement pour gérer les tâches simultanées, jusqu’au niveau maximal de concurrence que vous avez défini lors de la création de l’exécuteur. Toutes les tâches du pool partagent une même plage d’adresses IP statiques. Cela signifie qu’une seule exécuteur plus grand plage d’adresses IP statiques peut gérer de nombreux travaux en même temps sans nécessiter d’autres exécuteurs.

Le nombre d’adresses IP disponibles dans les plages affectées ne limite pas le nombre de travaux simultanés. 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
• Création d’adresses IP statiques pour les exécuteurs d’entreprise

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. Accédez à votre entreprise. Par exemple, depuis la page Entreprises sur GitHub.com.
2. En haut de la page, cliquez sur Stratégies.
3. Sous «  Politiques », cliquez Actions.
4. Cliquez sur l’onglet Exécuteurs.
5. Dans la liste des exécuteurs, sélectionnez l’exécuteur que vous souhaitez modifier.
6. 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.
7. Cliquez sur Enregistrer.