Skip to main content

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.

Platform navigation

Note

Vous devez ajouter un programme d'exécution à GitHub Enterprise Cloud avant de pouvoir configurer l'application d'exécution 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 programme d'exécution à GitHub Enterprise Cloud avant de pouvoir configurer l'application d'exécution 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

  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 « 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

  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
    
```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.