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

Vous pouvez ajouter un exécuteur auto-hébergé à un dépôt, à une organisation ou à une entreprise.

Dans cet article

Avertissement

Pour plus d’informations, consultez « Informations de référence sur l’utilisation sécurisée ».

Prérequis

Avant d'ajouter un exécuteur auto-hébergé, vous devez comprendre ce que c'est et comment cela fonctionne. Consultez Exécuteurs auto-hébergés.

De plus, vous devez remplir les conditions suivantes :

  • Vous devez avoir accès à la machine que vous allez utiliser en tant qu’exécuteur auto-hébergé dans votre environnement.

Ajout d’un exécuteur auto-hébergé dans un dépôt

Vous pouvez ajouter des exécuteurs auto-hébergés dans un dépôt individuel. Pour ajouter un exécuteur auto-hébergé dans un dépôt utilisateur, vous devez être propriétaire du dépôt. Pour un référentiel d’organisation, vous devez être un propriétaire d’organisation ou avoir un accès administrateur au référentiel.

Pour obtenir des informations sur la façon d’ajouter un exécuteur auto-hébergé avec l’API REST, consultez « Points de terminaison d’API REST pour les exécuteurs auto-hébergés ».

Remarque

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.

Pour plus d’informations, consultez Désactivation ou limitation des GitHub Actions pour votre organisation.

  1. Cliquez sur Nouvel exécuteur auto-hébergé.

  2. Sélectionnez l’image et l’architecture du système d’exploitation de votre machine d’exécuteur auto-hébergée.

    Capture d’écran du choix du système d’exploitation et de l’architecture. Ces options sont mises en surbrillance avec un contour orange foncé.

  3. Des instructions vous montrent comment télécharger l’application d’exécuteur et l’installer sur votre machine d’exécuteur auto-hébergée.

    Ouvrez un interpréteur de commandes sur votre machine d’exécuteur auto-hébergée et exécutez toutes les commandes shell dans l’ordre indiqué.

    Remarque

    Sur Windows, si vous souhaitez installer l’application d’exécuteur auto-hébergée en tant que service, vous devez ouvrir un interpréteur de commandes avec des privilèges d’administrateur. Nous vous recommandons également d’utiliser C:\actions-runner comme répertoire pour l’application de l’exécuteur auto-hébergé afin que les comptes système Windows puissent accéder au répertoire de l’exécuteur.

    Les instructions vous guident tout au long des tâches suivantes :

    • Téléchargement et extraction de l’application d’exécuteur auto-hébergée.
    • Exécution du script config pour configurer l’application d’exécuteur auto-hébergée et l’inscrire auprès de GitHub Actions. L’URL de destination et un jeton limité dans le temps généré automatiquement sont nécessaires pour permettre au script config d’authentifier la demande. Le jeton expire au bout d’une heure.
    • Exécution de l’application d’exécuteur auto-hébergée pour connecter la machine à GitHub Actions.

Vérification de la réussite de l’ajout de votre exécuteur autohébergé

Après avoir effectué les étapes pour ajouter un exécuteur autohébergé, l’exécuteur et son statut sont listés sous « Exécuteurs ».

L’application de l’exécuteur autohébergée doit être active pour que l’exécuteur accepte les travaux. Quand l’application d’exécuteur est connectée à GitHub et qu’elle est prête à recevoir des travaux, le message suivant s’affiche sur le terminal de la machine.

√ Connected to GitHub

2019-10-24 05:45:56Z: Listening for Jobs

Pour plus d’informations, consultez « Surveillance des exécuteurs auto-hébergés et résolution des problèmes ».

Ajout d’un exécuteur auto-hébergé dans une organisation

Vous pouvez ajouter des exécuteurs auto-hébergés au niveau de l’organisation, où ils peuvent être utilisés pour traiter des travaux pour plusieurs dépôts de l’organisation. Pour ajouter un exécuteur auto-hébergé à une organisation, vous devez être un propriétaire d’organisation. Pour obtenir des informations sur la façon d’ajouter un exécuteur auto-hébergé avec l’API REST, consultez « Points de terminaison d’API REST pour les exécuteurs auto-hébergés ».

  1. Sur GitHub, accédez à la page principale de l’organisation.
  2. Cliquez sur Nouvel exécuteur, puis sur Nouvel exécuteur auto-hébergé. 1. Sélectionnez l’image et l’architecture du système d’exploitation de votre machine d’exécuteur auto-hébergée.

Capture d’écran du choix du système d’exploitation et de l’architecture. Ces options sont mises en surbrillance avec un contour orange foncé.

  1. Des instructions vous montrent comment télécharger l’application d’exécuteur et l’installer sur votre machine d’exécuteur auto-hébergée.

    Ouvrez un interpréteur de commandes sur votre machine d’exécuteur auto-hébergée et exécutez toutes les commandes shell dans l’ordre indiqué.

    Remarque

    Sur Windows, si vous souhaitez installer l’application d’exécuteur auto-hébergée en tant que service, vous devez ouvrir un interpréteur de commandes avec des privilèges d’administrateur. Nous vous recommandons également d’utiliser C:\actions-runner comme répertoire pour l’application de l’exécuteur auto-hébergé afin que les comptes système Windows puissent accéder au répertoire de l’exécuteur.

    Les instructions vous guident tout au long des tâches suivantes :

    • Téléchargement et extraction de l’application d’exécuteur auto-hébergée.
    • Exécution du script config pour configurer l’application d’exécuteur auto-hébergée et l’inscrire auprès de GitHub Actions. L’URL de destination et un jeton limité dans le temps généré automatiquement sont nécessaires pour permettre au script config d’authentifier la demande. Le jeton expire au bout d’une heure.
    • Exécution de l’application d’exécuteur auto-hébergée pour connecter la machine à GitHub Actions.

Vérification de la réussite de l’ajout de votre exécuteur autohébergé

Après avoir effectué les étapes pour ajouter un exécuteur autohébergé, l’exécuteur et son statut sont listés sous « Exécuteurs ».

L’application de l’exécuteur autohébergée doit être active pour que l’exécuteur accepte les travaux. Quand l’application d’exécuteur est connectée à GitHub et qu’elle est prête à recevoir des travaux, le message suivant s’affiche sur le terminal de la machine.

√ Connected to GitHub

2019-10-24 05:45:56Z: Listening for Jobs

Pour plus d’informations, consultez « Surveillance des exécuteurs auto-hébergés et résolution des problèmes ».

Remarque

Pour des raisons de sécurité, les dépôts publics ne peuvent pas utiliser d’exécuteurs dans un groupe d’exécuteurs par défaut, mais vous pouvez remplacer ce comportement dans les paramètres du groupe d’exécuteurs. Pour plus d’informations, consultez « Gestion de l’accès aux runners autohébergés à l’aide de groupes ».

Ajout d’un exécuteur auto-hébergé à une entreprise

Si vous utilisez GitHub Enterprise Cloud, vous pouvez ajouter des exécuteurs auto-hébergés à une entreprise, où ces derniers peuvent être affectés à plusieurs organisations. Les propriétaires d’organisation peuvent ensuite contrôler quels référentiels peuvent les utiliser. Pour plus d’informations, consultez la documentation GitHub Enterprise Cloud.

Étapes suivantes

Vous pouvez configurer l’automatisation afin d'ajuster le nombre d’exécuteurs auto-hébergés. Pour plus d’informations, consultez « Référence des exécuteurs auto-hébergés ».