À propos des exécuteurs auto-hébergés

Vous pouvez héberger vos propres exécuteurs et personnaliser l’environnement utilisé pour exécuter les travaux dans vos workflows GitHub Actions.

Dans cet article

À propos des exécuteurs auto-hébergés

Un runner auto-hébergé est un système que vous déployez et gérez pour exécuter des tâches à partir de GitHub Actions sur GitHub.

Exécuteurs autohébergés :

  • Vous donnent plus de contrôle sur le matériel, le système d'exploitation et les outils logiciels que ne le font les exécuteurs hébergés par GitHub.
  • Peuvent être utilisés gratuitement avec GitHub Actions, mais vous êtes responsable du coût de maintenance de vos machines d’exécuteur.
  • Vous permet de créer des configurations matérielles personnalisées qui répondent à vos besoins en matière de puissance de traitement ou de mémoire pour exécuter des tâches plus importantes, installer des logiciels disponibles sur votre réseau local.
  • Reçoivent des mises à jour automatiques pour l’application d’exécuteur auto-hébergée seulement, bien que vous puissiez désactiver les mises à jour automatiques de l’exécuteur.
  • Peut utiliser des services cloud ou des ordinateurs locaux que vous payez déjà.
  • Vous n’avez pas besoin d’avoir une instance propre pour chaque exécution de tâche.
  • Peuvent être physiques ou virtuels, et se trouver dans un conteneur, localement ou dans un cloud.

Vous pouvez utiliser des exécuteurs auto-hébergés n’importe où dans la hiérarchie de gestion. Les exécuteurs au niveau du référentiel sont dédiés à un seul référentiel, tandis que les exécuteurs au niveau de l’organisation peuvent traiter des tâches pour plusieurs référentiels d’une organisation. Les propriétaires d’organisation peuvent choisir les référentiels autorisés à créer des exécuteurs auto-hébergés au niveau du référentiel. Consultez Désactivation ou limitation de la fonctionnalité GitHub Actions pour votre organisation. Enfin, les exécuteurs au niveau de l’entreprise peuvent être affectés à plusieurs organisations dans un compte d’entreprise.

Configuration requise pour les machines d’exécuteur auto-hébergé

Vous pouvez utiliser n’importe quelle machine en tant qu’exécuteur auto-hébergé tant qu’elle répond aux exigences suivantes :

  • Vous pouvez installer et exécuter l’application d’exécuteur auto-hébergée sur la machine.
  • La machine peut communiquer avec GitHub Actions.
  • La machine dispose de suffisamment de ressources matérielles pour le type de workflows que vous envisagez d’exécuter. L’application d’exécuteur auto-hébergé elle-même nécessite uniquement des ressources minimales.
  • Si vous souhaitez exécuter des workflows qui utilisent des actions de conteneur Docker ou des conteneurs de service, vous devez utiliser une machine Linux et Docker doit être installé.

Pour aller plus loin