{"meta":{"title":"Configurar o aplicativo do executor auto-hospedado como um serviço","intro":"Você pode configurar o aplicativo do executor auto-hospedado como um serviço para que inicie o aplicativo do executor automaticamente quando a máquina for iniciada.","product":"GitHub Actions","breadcrumbs":[{"href":"/pt/actions","title":"GitHub Actions"},{"href":"/pt/actions/how-tos","title":"Instruções"},{"href":"/pt/actions/how-tos/manage-runners","title":"Gerenciar corredores"},{"href":"/pt/actions/how-tos/manage-runners/self-hosted-runners","title":"Executores auto-hospedados"},{"href":"/pt/actions/how-tos/manage-runners/self-hosted-runners/configure-the-application","title":"Configurar o aplicativo"}],"documentType":"article"},"body":"# Configurar o aplicativo do executor auto-hospedado como um serviço\n\nVocê pode configurar o aplicativo do executor auto-hospedado como um serviço para que inicie o aplicativo do executor automaticamente quando a máquina for iniciada.\n\n<div class=\"ghd-tool linux\">\n\n> \\[!NOTE]\n> Você deve adicionar um executor a GitHub antes de poder configurar o aplicativo do executor auto-hospedado como um serviço.\n> Para saber mais, confira [Adicionar executores auto-hospedados](/pt/actions/how-tos/manage-runners/self-hosted-runners/add-runners).\n\nPara sistemas Linux que usam `systemd`, você pode usar o script `svc.sh` que é criado após incluir com êxito o executor a fim de instalar e gerenciar usando o aplicativo como um serviço.\n\nNo computador executor, abra um shell no diretório em que você instalou o aplicativo executor auto-hospedado. Use os comandos abaixo para instalar e gerenciar o serviço de executor auto-hospedado.\n\n</div>\n\n<div class=\"ghd-tool windows\">\n\n> \\[!NOTE]\n> Configurar o aplicativo executor auto-hospedado como um serviço no Windows faz parte do processo de configuração do aplicativo. Se você já configurou o aplicativo de executor auto-hospedado, mas não escolheu configurá-lo como um serviço, você deve remover o executor do GitHub e reconfigurar o aplicativo. Ao reconfigurar o aplicativo, selecione a opção para configurar o aplicativo como um serviço.\n>\n> Para saber mais, confira [Remover executores auto-hospedados](/pt/actions/how-tos/manage-runners/self-hosted-runners/remove-runners) e [Adicionar executores auto-hospedados](/pt/actions/how-tos/manage-runners/self-hosted-runners/add-runners).\n\nVocê pode gerenciar o serviço de executor no aplicativo **Serviços** Windows ou usar o PowerShell para executar os comandos abaixo.\n\n</div>\n\n<div class=\"ghd-tool mac\">\n\n> \\[!NOTE]\n> Você deve adicionar um executor a GitHub antes de poder configurar o aplicativo do executor auto-hospedado como um serviço.\n> Para saber mais, confira [Adicionar executores auto-hospedados](/pt/actions/how-tos/manage-runners/self-hosted-runners/add-runners).\n\nNo computador executor, abra um shell no diretório em que você instalou o aplicativo executor auto-hospedado. Use os comandos abaixo para instalar e gerenciar o serviço de executor auto-hospedado.\n\n</div>\n\n<div class=\"ghd-tool linux\">\n\n## Instalar o serviço\n\n1. Pare o aplicativo de executor auto-hospedado se ele estiver em execução no momento.\n\n2. Instale o serviço com o comando a seguir:\n\n   ```shell\n   sudo ./svc.sh install\n   ```\n\n3. Como alternativa, o comando usa um argumento `user` opcional para instalar o serviço como outro usuário.\n\n   ```shell\n   ./svc.sh install USERNAME\n   ```\n\n</div>\n\n<div class=\"ghd-tool mac\">\n\n## Instalar o serviço\n\n1. Pare o aplicativo de executor auto-hospedado se ele estiver em execução no momento.\n2. Instale o serviço com o comando a seguir:\n\n   ```shell\n   ./svc.sh install\n   ```\n\n</div>\n\n## Iniciar o serviço\n\nInicie o serviço com o seguinte comando:\n\n<div class=\"ghd-tool linux\">\n\n```shell\nsudo ./svc.sh start\n```\n\n> \\[!NOTE]\n> Em sistemas Linux baseados em Debian (como Debian ou Ubuntu) com `needrestart` habilitado, `needrestart` você pode impedir a reinicialização do serviço executor durante um trabalho de fluxo de trabalho configurando-o para ignorar o serviço executor. Execute o comando a seguir:\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## Verificando o status do serviço\n\nVerifique o status do serviço com o comando a seguir:\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\nPara obter mais informações sobre como visualizar o status do seu executor auto-hospedado, consulte [Monitorar e solucionar problemas de executores auto-hospedados](/pt/actions/how-tos/manage-runners/self-hosted-runners/monitor-and-troubleshoot).\n\n## Interromper o serviço\n\nInterrompa o serviço com o comando a seguir:\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## Desinstalando o serviço\n\n1. Interrompa o serviço se estiver em execução.\n2. Desinstale o serviço com o comando a seguir:\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## Personalizar o serviço do executor auto-hospedado\n\nCaso não deseje usar a configuração padrão do serviço `systemd` acima, crie um serviço personalizado ou use o mecanismo de serviço que preferir. Considere o uso do modelo `serviced` localizado em `actions-runner/bin/actions.runner.service.template` como uma referência. Se você usa um serviço personalizado, o serviço do executor auto-hospedado precisa sempre ser acessado por meio do ponto de entrada `runsvc.sh`.\n\n</div>\n\n<div class=\"ghd-tool mac\">\n\n## Personalizar o serviço do executor auto-hospedado\n\nSe você não desejar usar a configuração-padrão do serviço do launchd acima, você poderá criar um serviço personalizado ou usar o mecanismo de serviço que preferir. Considere o uso do modelo `plist` localizado em `actions-runner/bin/actions.runner.plist.template` como uma referência. Se você usa um serviço personalizado, o serviço do executor auto-hospedado precisa sempre ser acessado por meio do ponto de entrada `runsvc.sh`.\n\n</div>"}