Skip to main content
We publish frequent updates to our documentation, and translation of this page may still be in progress. For the most current information, please visit the English documentation.
GitHub AE is currently under limited release.

Configuration de l’application d’exécuteur auto-hébergé en tant que service

Vous pouvez configurer l’application de l’exécuteur auto-hébergée en tant que service pour démarrer automatiquement l’application de l’exécuteur au démarrage de la machine.

Remarque : Vous devez ajouter un exécuteur à GitHub AE avant de configurer l’application d’exécuteur auto-hébergé en tant que service. Pour plus d’informations, consultez « Ajout d’exécuteurs auto-hébergés ».

Pour les systèmes Linux qui utilisent systemd, vous pouvez utiliser le script svc.sh qui est créé après l’ajout de l’exécuteur que vous devez installer et gérer à l’aide de l’application en tant que service.

Sur l’ordinateur de l’exécuteur, ouvrez un interpréteur de commandes dans le répertoire où vous avez installé l’application d’exécuteur auto-hébergée. Utilisez les commandes ci-dessous pour installer et gérer le service d’exécution auto-hébergé.

Remarque : la configuration de l’application d’exécuteur auto-hébergée en tant que service sur Windows fait partie du processus de configuration de l’application. Si vous avez déjà configuré l’application d’exécution auto-hébergée, mais que vous n’avez pas choisi de la configurer en tant que service, vous devez supprimer l’exécuteur de GitHub et reconfigurer l’application. Lorsque vous configurez à nouveau l’application, choisissez l’option permettant de configurer l’application en tant que service.

Pour plus d’informations, consultez « Suppression d’exécuteurs auto-hébergés et « Ajout d’exécuteurs auto-hébergés ».

Vous pouvez gérer le service de l’exécuteur dans l’application Windows Services ou utiliser PowerShell pour exécuter les commandes ci-dessous.

Remarque : Vous devez ajouter un exécuteur à GitHub AE avant de configurer l’application d’exécuteur auto-hébergé en tant que service. Pour plus d’informations, consultez « Ajout d’exécuteurs auto-hébergés ».

Sur l’ordinateur de l’exécuteur, ouvrez un interpréteur de commandes dans le répertoire où vous avez installé l’application d’exécuteur auto-hébergée. Utilisez les commandes ci-dessous pour installer et gérer le service d’exécution auto-hébergé.

Installation du service

  1. Arrêtez l’application d’exécution auto-hébergée si elle est en cours d’exécution.

  2. Installez en utilisant la commande suivante :

    sudo ./svc.sh install
  3. Sinon, la commande accepte un argument facultatif user pour installer le service en tant qu’utilisateur différent.

    ./svc.sh install USERNAME

Installation du service

  1. Arrêtez l’application d’exécution auto-hébergée si elle est en cours d’exécution.

  2. Installez en utilisant la commande suivante :

    ./svc.sh install

Démarrage du service

Démarrez le service en utilisant la commande suivante :

sudo ./svc.sh start
Start-Service "actions.runner.*"
./svc.sh start

Vérification de l’état du service

Vérifiez l’état du service avec la commande suivante :

sudo ./svc.sh status
Get-Service "actions.runner.*"
./svc.sh status

Pour plus d’informations sur l’affichage de l’état de votre exécuteur auto-hébergé, consultez « Analyse et résolution des problèmes des exécuteurs auto-hébergés ».

Arrêt du service

Arrêtez le service en utilisant la commande suivante :

sudo ./svc.sh stop
Stop-Service "actions.runner.*"
./svc.sh stop

Désinstallation du service

  1. Arrêtez le service s’il est en cours d’exécution.

  2. Désinstallez le service en utilisant la commande suivante :

    sudo ./svc.sh uninstall
    Remove-Service "actions.runner.*"
    ./svc.sh uninstall

Personnalisation du service de l’exécuteur auto-hébergé

Si vous ne souhaitez pas utiliser la configuration de service par défaut systemd ci-dessus, vous pouvez créer un service personnalisé ou utiliser le mécanisme de service que vous préférez. Envisagez d’utiliser le modèle serviced sur actions-runner/bin/actions.runner.service.template en tant que référence. Si vous utilisez un service personnalisé, le service de l’exécuteur auto-hébergé doit toujours être appelé à l’aide du point d’entrée runsvc.sh.

Personnalisation du service de l’exécuteur auto-hébergé

Si vous ne souhaitez pas utiliser la configuration de service launchd par défaut ci-dessus, vous pouvez créer un service personnalisé ou utiliser le mécanisme de service que vous préférez. Envisagez d’utiliser le modèle plist sur actions-runner/bin/actions.runner.plist.template en tant que référence. Si vous utilisez un service personnalisé, le service de l’exécuteur auto-hébergé doit toujours être appelé à l’aide du point d’entrée runsvc.sh.