Utilisation des exécuteurs plus grands

Présentation des exécuteur plus grand

En plus des exécuteurs standard hébergés par GitHub, GitHub propose également aux utilisateurs des plans GitHub Team et GitHub Enterprise Cloud une gamme de exécuteur plus grand disposant d’une plus grande mémoire RAM et de processeurs plus puissants. Ces exécuteurs sont hébergés par GitHub, et l’application exécuteur ainsi que d’autres outils y sont préinstallés.

Quand des exécuteur plus grand sont activés pour votre organisation, un groupe d’exécuteurs par défaut est automatiquement créé pour vous avec un ensemble de quatre exécuteur plus grand préconfigurés.

Lorsque vous ajoutez un exécuteur plus grand à une organisation, vous définissez un type d’ordinateur à partir d’une sélection de spécifications matérielles et d’images de systèmes d’exploitation. GitHub crée ensuite plusieurs instances de cet exécuteur qui font l’objet d’un scale-up ou d’un scale-down afin de répondre aux besoins de votre organisation, en fonction des limites de mise à l’échelle automatique que vous définissez.

Specs des ordinateurs pour les exécuteur plus grand

Taille (vcpu)	Mémoire (RAM)	Stockage (SSD)
4 cœurs	16 Go	150 Go
8 cœurs	32 Go	300 Go
16 cœurs	64 Go	600 Go
32 cœurs	128 Go	1200 Go
64 cœurs	256 Go	2 040 Go

Fonctionnalités supplémentaires pour les exécuteur plus grand

Comparé aux exécuteurs standard hébergés par GitHub, les exécuteur plus grand présentent les fonctionnalités supplémentaires suivantes :

• Pour les exécuteurs Ubuntu, l’accélération matérielle pour les outils Android SDK est activée. L’exécution des tests Android est donc beaucoup plus rapide et prend moins de minutes. Pour plus d’informations sur l’accélération matérielle Android, consultez la documentation Android Developer.

Pour obtenir la liste complète des outils compris dans chaque système d’exploitation d’exécuteur, consultez le dépôt Images d’exécuteur GitHub Actions.

Présentation de l’architecture des exécuteur plus grand

Les exécuteur plus grand sont gérés au niveau de l’organisation, où ils sont organisés en groupes pouvant contenir plusieurs instances d’exécuteur. Ils peuvent également être créés au niveau de l’entreprise et partagés avec les organisations de la hiérarchie. Une fois que vous avez créé un groupe, vous pouvez y ajouter un exécuteur et mettre à jour vos workflows afin de cibler le nom du groupe ou l’étiquette affectée au exécuteur plus grand. Vous pouvez également contrôler quels dépôts sont autorisés à envoyer des travaux au groupe à des fins de traitement. Pour plus d’informations sur les groupes, consultez « Contrôle de l’accès aux exécuteurs plus grands ».

Dans le schéma suivant, une classe d’exécuteur hébergé nommée ubuntu-20.04-16core a été définie avec une configuration personnalisée concernant le matériel et le système d’exploitation.

1. Les instances de cet exécuteur sont automatiquement créées et ajoutées à un groupe appelé grp-ubuntu-20.04-16core.
2. Les exécuteurs ont reçu l’étiquette ubuntu-20.04-16core.
3. Les travaux de workflow utilisent l’étiquette ubuntu-20.04-16core dans leur clé runs-on pour indiquer le type d’exécuteur dont ils ont besoin pour s’exécuter.
4. GitHub Actions vérifie le groupe d’exécuteurs pour voir si votre dépôt est autorisé à envoyer des travaux à l’exécuteur.
5. Le travail s’exécute sur la prochaine instance disponible de l’exécuteur ubuntu-20.04-16core.

Mise à l’échelle automatique des exécuteur plus grand

Vos exécuteur plus grand peuvent être configurés pour être mis à l’échelle automatiquement en fonction de vos besoins. Lorsque des travaux sont envoyés en vue de leur traitement, d’autres ordinateurs peuvent être automatiquement provisionnés pour exécuter les travaux, jusqu’à atteindre la limite maximale prédéfinie. Chaque machine ne gère qu’un seul travail à la fois. Ces paramètres déterminent donc le nombre de travaux qui peuvent être exécutés simultanément.

Pendant le processus de déploiement de l’exécuteur, vous pouvez configurer l’option Max, qui vous permet de contrôler vos coûts en définissant le nombre maximal de machines créées dans cet ensemble. Une valeur élevée peut vous permettre d’éviter que les workflows ne soient bloqués en raison du parallélisme.

Réseaux des exécuteur plus grand

Par défaut, les exécuteur plus grand reçoivent une adresse IP dynamique qui change à chaque exécution du travail. Les clients GitHub Enterprise Cloud ont la possibilité de configurer leurs exécuteur plus grand pour recevoir une adresse IP statique provenant du pool d’adresses IP de GitHub. Lorsque cette option est activée, les instances du exécuteur plus grand reçoivent une adresse provenant d’une plage qui est propre à l’exécuteur, ce qui vous permet d’utiliser cette plage pour configurer une liste d’autorisation de pare-feu. Vous pouvez utiliser jusqu’à 10 plages d’adresses IP statiques au total sur tous vos exécuteur plus grand.

Planification des exécuteur plus grand

Créer un groupe d’exécuteurs

Les groupes d’exécuteurs sont utilisés pour collecter des ensembles de machines virtuelles et créer une limite de sécurité autour d’elles. Vous pouvez ensuite décider quelles organisations ou dépôts sont autorisés à exécuter des travaux sur ces ensembles de machines. Pendant le processus de déploiement du exécuteur plus grand, l’exécuteur peut être ajouté à un groupe existant. Sinon, il rejoint un groupe par défaut. Vous pouvez créer un groupe en suivant les étapes dans « Contrôle de l’accès aux exécuteurs plus grands ».

Présentation de la facturation

Les exécuteur plus grand sont facturés différemment des exécuteurs standard hébergés dans GitHub. Pour plus d’informations, consultez « À propos de la facturation de GitHub Actions ».

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

Vous pouvez ajouter des exécuteur plus grand à une entreprise, où ils pourront être affectés à plusieurs organisations. Les administrateurs des organisations peuvent ensuite contrôler quels dépôts peuvent utiliser les exécuteurs. Pour ajouter un exécuteur plus grand à une entreprise, vous devez être propriétaire de l’entreprise.

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 la barre latérale du compte d’entreprise, cliquez sur Stratégies. 1. Sous «  », cliquez sur Actions. 1. Cliquez sur l’onglet Exécuteurs. 1. Cliquez sur Nouvel exécuteur, puis sur Nouvel exécuteur hébergé par GitHub .

2. 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 d’exécuteurs 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 : Uniquement pour GitHub Enterprise Cloud : Indiquez si une plage d’adresses IP statiques va être affectée aux instances de l’exécuteur plus grand. Vous pouvez utiliser jusqu’à 10 adresses IP statiques au total.

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

4. Pour permettre aux organisations d’accéder à vos exécuteur plus grand, spécifiez la liste des organisations qui peuvent les utiliser. Pour plus d’informations, consultez « Gestion de l’accès à vos exécuteurs ».

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

Vous pouvez ajouter un exécuteur plus grand à une organisation. Les administrateurs de l’organisation pourront contrôler quels dépôts peuvent l’utiliser.

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.com, accédez à la page principale de l’organisation. 1. 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.

   1. Dans la barre latérale gauche, cliquez sur Actions, puis sur Exécuteurs. 1. Cliquez sur Nouvel exécuteur, puis sur Nouvel exécuteur hébergé par GitHub .

2. 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 d’exécuteurs 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 : Uniquement pour GitHub Enterprise Cloud : Indiquez si une plage d’adresses IP statiques va être affectée aux instances de l’exécuteur plus grand. Vous pouvez utiliser jusqu’à 10 adresses IP statiques au total.

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

4. 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 « Gestion de l’accès à vos exécuteurs ».

Exécution de travaux sur votre exécuteur

Une fois que votre type d’exécuteur a été défini, vous pouvez mettre à jour vos fichiers YAML de workflow pour envoyer des travaux aux instances de l’exécuteur qui viennent d’être créées afin de les traiter. Vous pouvez utiliser des groupes d’exécuteurs ou des étiquettes pour définir l’emplacement d’exécution de vos travaux.

Seuls les comptes de propriétaire ou d’administrateur peuvent voir les paramètres de l’exécuteur. Les utilisateurs non administratifs peuvent contacter l’administrateur de l’organisation pour savoir quels exécuteurs sont activés. L'administrateur de votre organisation peut créer de nouveaux exécuteurs et groupes d'exécuteurs, ainsi que configurer des autorisations pour spécifier quels dépôts peuvent accéder à un groupe d'exécuteurs.

Utilisation de groupes pour contrôler où les travaux sont exécutés

Dans cet exemple, des exécuteurs Ubuntu ont été ajoutés à un groupe appelé ubuntu-runners. La clé runs-on envoie le travail à n’importe quel exécuteur disponible dans le groupe ubuntu-runners :

name: learn-github-actions
on: [push]
jobs:
  check-bats-version:
    runs-on: 
      group: ubuntu-runners
    steps:
      - uses: actions/checkout@v3
      - uses: actions/setup-node@v3
        with:
          node-version: '14'
      - run: npm install -g bats
      - run: bats -v

Utilisation d’étiquettes pour contrôler où les travaux sont exécutés

Dans cet exemple, un groupe d’exécuteurs est rempli avec des exécuteurs Ubuntu 16 cœurs, qui ont également reçu l’étiquette ubuntu-20.04-16core. La clé runs-on envoie le travail à n’importe quel exécuteur disponible avec une étiquette correspondante :

name: learn-github-actions
on: [push]
jobs:
  check-bats-version:
    runs-on:
      labels: ubuntu-20.04-16core
    steps:
      - uses: actions/checkout@v3
      - uses: actions/setup-node@v3
        with:
          node-version: '14'
      - run: npm install -g bats
      - run: bats -v

Utilisation d’étiquettes et de groupes pour contrôler où les travaux sont exécutés

Quand vous combinez des groupes et des étiquettes, l’exécuteur doit satisfaire aux deux exigences pour pouvoir exécuter le travail.

Dans cet exemple, un groupe d’exécuteurs appelé ubuntu-runners est rempli avec des exécuteurs Ubuntu, qui ont également reçu l’étiquette ubuntu-20.04-16core. La clé runs-on combine group et labels afin que le travail soit routé vers n’importe quel exécuteur disponible au sein du groupe qui a également une étiquette correspondante :

name: learn-github-actions
on: [push]
jobs:
  check-bats-version:
    runs-on:
      group: ubuntu-runners
      labels: ubuntu-20.04-16core
    steps:
      - uses: actions/checkout@v3
      - uses: actions/setup-node@v3
        with:
          node-version: '14'
      - run: npm install -g bats
      - run: bats -v

Gestion de l’accès aux exécuteurs

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 accorder l’accès au groupe à partir de 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 : configurez le groupe d’exécuteurs pour accorder l’accès à toutes les organisations nécessaires. En outre, pour chaque organisation, vous devez configurer le groupe afin de spécifier les dépôts qui sont autorisés à y accéder.
• Exécuteurs au niveau de l’organisation : configurez le groupe d’exécuteurs en spécifiant les dépôts qui sont autorisés à y accéder.

Par exemple, le schéma suivant comporte un groupe d’exécuteurs nommé grp-ubuntu-20.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 à partir de l’organisation octo-org. Vous devez ensuite configurer le groupe au niveau de l’organisation pour autoriser l’accès à partir de octo-repo.

Autoriser les dépôts à accéder à un groupe d’exécuteurs

Cette procédure montre comment configurer des autorisations de groupe aux niveaux de l’entreprise et de l’organisation :

1. Accédez à la page principale du dépôt ou 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 cliquez sur Groupes d’exécuteurs. 1. Dans la liste des groupes, cliquez sur le groupe d’exécuteurs à configurer.

• Pour les groupes d’exécuteurs d’une entreprise, sous Accès des organisations, modifiez la liste des organisations qui peuvent accéder au groupe d’exécuteurs.
• Pour les groupes d’exécuteurs d’une organisation, sous Accès au dépôt, modifiez les dépôts qui peuvent accéder au groupe d’exécuteurs.