Remarque : les informations et les instructions de cet article ne s’appliquent qu’aux exécuteur plus grands avec les systèmes d’exploitation Linux et Windows.
Ajout d’un exécuteur plus grand à une organisation
Vous pouvez ajouter un exécuteur plus grand à une organisation, dont les propriétaires peuvent contrôler quels référentiels 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 à un groupe d’exécuteurs ».
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 ».
-
Sur GitHub.com, accédez à la page principale de l’organisation.
-
Sous le nom de votre organisation, cliquez sur Paramètres. Si vous ne voyez pas l’onglet « Paramètres », sélectionnez le menu déroulant , puis cliquez sur Paramètres.
-
Dans la barre latérale gauche, cliquez sur Actions, puis sur Exécuteurs.
-
Cliquez sur Nouvel exécuteur, puis sur Nouvel exécuteur hébergé par GitHub .
-
Complétez les détails nécessaires pour configurer votre nouvel exécuteur :
- Nom : Entrez un nom pour votre nouvel exécuteur. Pour faciliter son identification, ce nom doit indiquer sa configuration matérielle et son système d’exploitation, comme
ubuntu-20.04-16core
. - Image de l’exécuteur : Choisissez un système d’exploitation dans les options disponibles. Une fois que vous avez sélectionné un système d’exploitation, vous pouvez choisir une version spécifique.
- Taille de l’exécuteur : Choisissez une configuration matérielle dans la liste déroulante des options disponibles.
- Mise à l’échelle automatique : choisissez le nombre maximal de travaux 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.
- Nom : Entrez un nom pour votre nouvel exécuteur. Pour faciliter son identification, ce nom doit indiquer sa configuration matérielle et son système d’exploitation, comme
-
Cliquez sur Créer un exécuteur.
-
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 grands 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 contrôlent l’accès au niveau du référentiel à tous les exécuteur plus grand. Les propriétaires d’organisation 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.
- 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 limiter l'accès aux référentiels, les propriétaires d'organisation doivent configurer les groupes de gestionnaires d'organisation et choisir les référentiels auxquels ils 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 ».
-
Accédez à la page principale de l’organisation où se trouvent vos groupes d’exécuteurs.
-
Cliquez sur Paramètres.
-
Dans la barre latérale gauche, cliquez sur Actions, puis sur Groupes d’exécuteurs.
-
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 ».
-
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.
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 plus d’informations, consultez « Contrôle de l’accès aux exécuteurs plus grands ».
Modification du nom d’un exécuteur plus grand
-
Sur GitHub.com, accédez à la page principale de l’organisation.
-
Sous le nom de votre organisation, cliquez sur Paramètres. Si vous ne voyez pas l’onglet « Paramètres », sélectionnez le menu déroulant , puis cliquez sur Paramètres.
-
Dans la barre latérale gauche, cliquez sur Actions, puis sur Exécuteurs.
-
Dans la liste des exécuteurs, sélectionnez l’exécuteur que vous souhaitez modifier.
-
Entrez un nouveau nom pour l’exécuteur dans le champ de texte sous « Nom ».
-
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.
-
Sur GitHub.com, accédez à la page principale de l’organisation.
-
Sous le nom de votre organisation, cliquez sur Paramètres. Si vous ne voyez pas l’onglet « Paramètres », sélectionnez le menu déroulant , puis cliquez sur Paramètres.
-
Dans la barre latérale gauche, cliquez sur Actions, puis sur Exécuteurs.
-
Dans la liste des exécuteurs, sélectionnez l’exécuteur que vous souhaitez modifier.
-
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.
-
Cliquez sur Enregistrer.
Création d’adresses IP statiques pour des exécuteur plus grand
Remarque : Pour utiliser des adresses IP statiques, votre organisation doit utiliser GitHub Enterprise Cloud. Pour plus d’informations sur la façon d’essayer gratuitement GitHub Enterprise Cloud, consultez « Configuration d’un essai de GitHub Enterprise Cloud ».
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. 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 nous via le portail de support GitHub.
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.
-
Sur GitHub.com, accédez à la page principale de l’organisation.
-
Sous le nom de votre organisation, cliquez sur Paramètres. Si vous ne voyez pas l’onglet « Paramètres », sélectionnez le menu déroulant , puis cliquez sur Paramètres.
-
Dans la barre latérale gauche, cliquez sur Actions, puis sur Exécuteurs.
-
Dans la liste des exécuteurs, sélectionnez l’exécuteur que vous souhaitez modifier.
-
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.
-
Cliquez sur Enregistrer.