Prise en main de GitHub Actions pour GitHub Enterprise Server

À propos GitHub Actions de GitHub Enterprise Server

Cet article explique comment les administrateurs de site peuvent configurer GitHub Enterprise Server pour utiliser GitHub Actions.

GitHub Actions n’est pas activé pour GitHub Enterprise Server par défaut. Vous devez déterminer si votre instance dispose de ressources processeur et de mémoire adéquates pour gérer la charge GitHub Actions sans entraîner de perte de performances, et éventuellement augmenter ces ressources. Vous devez aussi vous décider sur le fournisseur de stockage auquel vous allez faire appel pour le stockage d’objets blob nécessaire au stockage des artefacts et des caches générés par les exécutions de workflows. Ensuite, vous allez activer GitHub Actions pour votre entreprise, gérer les autorisations d’accès et ajouter des exécuteurs auto-hébergés pour exécuter des flux de travail.

Avant de commencer, vous devez planifier comment vous allez introduire GitHub Actions dans votre entreprise. Pour plus d’informations, consultez « Présentation de GitHub Actions à votre entreprise ».

Si vous migrez votre entreprise vers GitHub Actions depuis un autre fournisseur, il y a des points supplémentaires à prendre en compte. Pour plus d’informations, consultez « Migration de votre entreprise vers GitHub Actions ».

Passer en revue la configuration matérielle requise

Les ressources en processeur et en mémoire disponibles pour votre instance GitHub Enterprise Server déterminent le nombre d’exécuteurs qui peuvent être configurés sans perte de performances. GitHub a besoin d’un minimum de 8 processeurs virtuels et de 64 Go de mémoire pour exécuter GitHub Actions.

La quantité maximale d’exécuteurs connectés sans perte de performance dépend de certains facteurs, tels que la durée des travaux, l’utilisation des artefacts, le nombre de dépôts exécutant des GitHub Actions, ainsi que le niveau d'autres travaux effectués par votre instance qui ne sont pas liés aux GitHub Actions. Les tests internes à GitHub ont démontré des cibles de performances pour GitHub Enterprise Server sur une gamme de configurations processeur et mémoire.

Processeurs virtuels	Mémoire	Nombre maximal d’exécuteurs connectés
8	64 Go	740 coureurs
32	160 Go	2 700 coureurs
96	384 Go	7 000 coureurs

GitHub a mesuré le nombre maximal de runners connectés à l’aide de plusieurs dépôts, avec des travaux d’environ 10 minutes et des chargements d’artefacts de 10 Mo. Il se peut que vous observiez des niveaux de performance différents selon les niveaux globaux d’activité sur votre instance.

GitHub Enterprise Server À compter de la version 3.5, GitHubles tests internes utilisent des processeurs de 3e génération pour mieux refléter une configuration client classique. Cette modification du processeur représente une petite partie des modifications apportées aux cibles de performances dans cette version de GitHub Enterprise Server.

Si vous envisagez d’activer GitHub Actions les utilisateurs d’une instance existante, passez en revue les niveaux d’activité des utilisateurs et des automatisations sur l’instance et vérifiez que vous avez provisionné un processeur et une mémoire adéquats pour vos utilisateurs. Pour plus d’informations sur la surveillance de la capacité et des performances de GitHub Enterprise Server, consultez Surveillance de votre instance.

Pour plus d’informations sur la configuration matérielle minimale requise, votre instance GitHub Enterprise Serverconsultez les considérations matérielles relatives à la plateforme de votre instance.

• AWS
• Azure
• Google Cloud Platform
• Hyper-V
• OpenStack KVM
• VMware

Pour plus d’informations sur l’ajustement des ressources pour une instance existante, consultez Augmentation de la capacité de stockage et Augmentation des ressources processeur ou mémoire.

Si vous le souhaitez, vous pouvez limiter la consommation votre instance GitHub Enterprise Server des ressources en configurant une limite de débit pour GitHub Actions. Pour plus d’informations, consultez « Configuration des limites de débit ».

Exigences relatives au stockage externe

Pour activer GitHub Actions sur GitHub Enterprise Server, vous devez avoir accès à un stockage Blob externe.

GitHub Actions utilise le stockage blob externe pour stocker les données générées par les exécutions de workflow. Les données stockées incluent les journaux de workflow, les caches et les artefacts de build chargés par l’utilisateur. La quantité de stockage requise dépend de votre utilisation de GitHub Actions. Seule une configuration de stockage externe est prise en charge, et vous ne pouvez pas utiliser plusieurs fournisseurs de stockage à la fois.

Toutes les autres GitHub Actions données, telles que les fichiers de flux de travail dans la structure de fichiers d’un référentiel, sont stockées sur le volume de stockage des données pour votre instance GitHub Enterprise Server.

GitHub Actions prend en charge ces fournisseurs de stockage :

• Stockage Blob Azure
• Amazon S3
• Stockage cloud de Google
• Cluster MinIO compatible S3

Mise en réseau - Éléments à prendre en compte

Si GitHub Actions est activé pour votre entreprise, seuls les proxys HTTP sont pris en charge. Les proxys SOCKS5 et HTTPS ne sont pas pris en charge. Pour plus d’informations sur l’utilisation d’un proxy avec GitHub Enterprise Server, consultez Configuration d’un serveur proxy web de trafic sortant.

Activation GitHub Actions avec votre fournisseur de stockage

Suivez l’une des procédures ci-dessous pour activer GitHub Actions avec votre fournisseur de stockage choisi :

• Activation de GitHub Actions avec le stockage Blob Azure
• Activation des GitHub Actions avec le stockage Amazon S3
• Activation des Actions GitHub avec Google Cloud Storage
• Activation de GitHub Actions avec stockage MinIO

Gestion des autorisations d’accès à GitHub Actions dans votre entreprise

Vous pouvez utiliser des stratégies pour gérer l’accès à GitHub Actions. Pour plus d’informations, consultez « Application de stratégies pour GitHub Actions dans votre entreprise ».

Ajout d’exécuteurs auto-hébergés

Pour exécuter des workflows GitHub Actions, vous devez ajouter des runners auto-hébergés. Vous pouvez ajouter des exécuteurs auto-hébergés au niveau de l’entreprise, de l’organisation ou du dépôt. Pour plus d’informations, consultez « Ajout d’exécuteurs auto-hébergés ».

Gestion des actions qui peuvent être utilisées dans votre entreprise

Vous pouvez contrôler les actions que vos utilisateurs sont autorisés à utiliser dans votre entreprise. Cela inclut la configuration de GitHub Connect pour un accès automatique aux actions depuis GitHub.com, ou la synchronisation manuelle des actions depuis GitHub.com.

Pour plus d’informations, consultez « À propos de l’utilisation d’actions dans votre entreprise ».

Renforcement général de la sécurité pour GitHub Actions

Si vous souhaitez en savoir plus sur les pratiques de sécurité pour GitHub Actions, consultez Informations de référence sur l’utilisation sécurisée.

Noms réservés

Lorsque vous activez GitHub Actions pour votre entreprise, deux organisations sont créées : github et actions. Si votre entreprise utilise déjà le nom d’organisation github, github-org (ou github-github-org si github-org est aussi utilisé) est utilisé à la place. Si votre entreprise utilise déjà le nom d’organisation actions, github-actions (ou github-actions-org si github-actions est aussi utilisé) est utilisé à la place. Une fois les actions activées, vous ne pouvez plus utiliser ces noms.