{"meta":{"title":"Configuration de l’application d’exécuteur auto-hébergé en tant que service","intro":"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.","product":"GitHub Actions","breadcrumbs":[{"href":"/fr/actions","title":"GitHub Actions"},{"href":"/fr/actions/how-tos","title":"Guides pratiques"},{"href":"/fr/actions/how-tos/manage-runners","title":"Gérer les exécuteurs"},{"href":"/fr/actions/how-tos/manage-runners/self-hosted-runners","title":"Exécuteurs auto-hébergés"},{"href":"/fr/actions/how-tos/manage-runners/self-hosted-runners/configure-the-application","title":"Configurer l’application"}],"documentType":"article"},"body":"# Configuration de l’application d’exécuteur auto-hébergé en tant que service\n\nVous 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.\n\n<div class=\"ghd-tool linux\">\n\n> \\[!NOTE]\n> Vous devez ajouter un runner à GitHub avant de pouvoir configurer l’application de runner auto-hébergé en tant que service.\n> Pour plus d’informations, consultez « [Ajout d’exécuteurs auto-hébergés](/fr/actions/how-tos/manage-runners/self-hosted-runners/add-runners) ».\n\nPour les systèmes Linux qui utilisent `systemd`, vous pouvez utiliser le script `svc.sh`, créé après l'ajout réussi de l’exécuteur, pour installer et gérer l'application en tant que service.\n\nSur la machine du runner, ouvrez un interpréteur de commandes dans le répertoire où vous avez installé l’application de runner auto-hébergé. Utilisez les commandes ci-dessous pour installer et gérer le service d’exécuteur auto-hébergé.\n\n</div>\n\n<div class=\"ghd-tool windows\">\n\n> \\[!NOTE]\n> 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 du runner auto-hébergé, mais que vous n’avez pas choisi de la configurer en tant que service, vous devez supprimer le runner de GitHub et reconfigurer l’application. Lorsque vous configurez à nouveau l’application, choisissez l’option permettant de configurer l’application en tant que service.\n>\n> Pour plus d’informations, consultez « [Suppression d’exécuteurs auto-hébergés](/fr/actions/how-tos/manage-runners/self-hosted-runners/remove-runners) » et « [Ajout d’exécuteurs auto-hébergés](/fr/actions/how-tos/manage-runners/self-hosted-runners/add-runners) ».\n\nVous pouvez gérer le service de l’exécuteur dans l’application Windows **Services** ou utiliser PowerShell pour exécuter les commandes ci-dessous.\n\n</div>\n\n<div class=\"ghd-tool mac\">\n\n> \\[!NOTE]\n> Vous devez ajouter un runner à GitHub avant de pouvoir configurer l’application de runner auto-hébergé en tant que service.\n> Pour plus d’informations, consultez « [Ajout d’exécuteurs auto-hébergés](/fr/actions/how-tos/manage-runners/self-hosted-runners/add-runners) ».\n\nSur la machine du runner, ouvrez un interpréteur de commandes dans le répertoire où vous avez installé l’application de runner auto-hébergé. Utilisez les commandes ci-dessous pour installer et gérer le service d’exécuteur auto-hébergé.\n\n</div>\n\n<div class=\"ghd-tool linux\">\n\n## Installation du service\n\n1. Arrêtez l’application du runner auto-hébergé si elle est en cours d’exécution.\n\n2. Installez le service en utilisant la commande suivante :\n\n   ```shell\n   sudo ./svc.sh install\n   ```\n\n3. Sinon, la commande accepte un argument facultatif `user` pour installer le service en tant qu’utilisateur différent.\n\n   ```shell\n   ./svc.sh install USERNAME\n   ```\n\n</div>\n\n<div class=\"ghd-tool mac\">\n\n## Installation du service\n\n1. Arrêtez l’application du runner auto-hébergé si elle est en cours d’exécution.\n2. Installez le service en utilisant la commande suivante :\n\n   ```shell\n   ./svc.sh install\n   ```\n\n</div>\n\n## Démarrage du service\n\nDémarrez le service en utilisant la commande suivante :\n\n<div class=\"ghd-tool linux\">\n\n```shell\nsudo ./svc.sh start\n```\n\n> \\[!NOTE]\n> Sur les systèmes Linux basés sur Debian (tels que Debian ou Ubuntu) avec `needrestart` activé, vous pouvez empêcher `needrestart` de redémarrer le service d’exécuteur pendant une tâche de flux de travail en le configurant pour qu’il ignore le service d’exécuteur. Exécutez la commande suivante :\n>\n> ```bash\n> echo '$nrconf{override_rc}{qr(^actions\\.runner\\..+\\.service$)} = 0;' | sudo tee /etc/needrestart/conf.d/actions_runner_services.conf\n> ```\n\n</div>\n\n<div class=\"ghd-tool windows\">\n\n```shell\nStart-Service \"actions.runner.*\"\n```\n\n</div>\n\n<div class=\"ghd-tool mac\">\n\n```shell\n./svc.sh start\n```\n\n</div>\n\n## Vérification de l’état du service\n\nVérifiez l’état du service avec la commande suivante :\n\n<div class=\"ghd-tool linux\">\n\n```shell\nsudo ./svc.sh status\n```\n\n</div>\n\n<div class=\"ghd-tool windows\">\n\n```shell\nGet-Service \"actions.runner.*\"\n```\n\n</div>\n\n<div class=\"ghd-tool mac\">\n\n```shell\n./svc.sh status\n```\n\n</div>\n\nPour plus d’informations sur la consultation de l’état de votre runner auto-hébergé, consultez [Surveillance des exécuteurs auto-hébergés et résolution des problèmes](/fr/actions/how-tos/manage-runners/self-hosted-runners/monitor-and-troubleshoot).\n\n## Arrêt du service\n\nArrêtez le service en utilisant la commande suivante :\n\n<div class=\"ghd-tool linux\">\n\n```shell\nsudo ./svc.sh stop\n```\n\n</div>\n\n<div class=\"ghd-tool windows\">\n\n```shell\nStop-Service \"actions.runner.*\"\n```\n\n</div>\n\n<div class=\"ghd-tool mac\">\n\n```shell\n./svc.sh stop\n```\n\n</div>\n\n## Désinstallation du service\n\n1. Arrêtez le service s’il est en cours d’exécution.\n2. Désinstallez le service en utilisant la commande suivante :\n\n    <div class=\"ghd-tool linux\">\n\n   ```shell\n   sudo ./svc.sh uninstall\n   ```\n\n    </div>\n\n    <div class=\"ghd-tool windows\">\n\n   ```shell\n   Remove-Service \"actions.runner.*\"\n   ```\n\n    </div>\n\n    <div class=\"ghd-tool mac\">\n\n   ```shell\n   ./svc.sh uninstall\n   ```\n\n    </div>\n\n<div class=\"ghd-tool linux\">\n\n## Personnalisation du service de l’exécuteur auto-hébergé\n\nSi 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`.\n\n</div>\n\n<div class=\"ghd-tool mac\">\n\n## Personnalisation du service de l’exécuteur auto-hébergé\n\nSi 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`.\n\n</div>"}