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

Remarque : 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.

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