Remarque : Vous devez ajouter un exécuteur à GitHub 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 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
-
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
user
pour 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
.