Note
Les exécuteurs hébergés sur GitHub ne sont pas pris en charge sur GitHub Enterprise Server. Vous pouvez voir plus d’informations sur le support futur planifié dans la GitHub public roadmap.
Note
Vous devez ajouter un exécuteur à GitHub avant de pouvoir configurer l'application exécuteur auto-hébergée 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é.
Note
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.
Note
Vous devez ajouter un exécuteur à GitHub avant de pouvoir configurer l'application exécuteur auto-hébergée 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
-
Arrêtez l’application d’exécution auto-hébergée si elle est en cours d’exécution.
-
Installez en utilisant la commande suivante :
sudo ./svc.sh install -
Sinon, la commande accepte un argument facultatif
userpour installer le service en tant qu’utilisateur différent../svc.sh install USERNAME
Installation du service
-
Arrêtez l’application d’exécution auto-hébergée si elle est en cours d’exécution.
-
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 « Surveillance des exécuteurs auto-hébergés et résolution des problèmes ».
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
-
Arrêtez le service s’il est en cours d’exécution.
-
Désinstallez le service en utilisant la commande suivante :
sudo ./svc.sh uninstall
```shell
Remove-Service "actions.runner.*"
```
</div>
```shell
./svc.sh uninstall
```
</div>
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.