👋 We've unified all of GitHub's product documentation in one place! Check out the content for REST API, GraphQL API, and Developers. Learn more on the GitHub blog.


Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais recentes, acesse a documentação em inglês. Se houver problemas com a tradução desta página, entre em contato conosco.

Configurar o aplicativo do executor auto-hospedado como um serviço

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.

Neste artigo

Você conseguiu encontrar o que estava procurando?

Você deve adicionar um executor a GitHub antes de poder configurar o aplicativo do executor auto-hospedado um serviço. Para obter mais informações, consulte "Adicionando executores auto-hospedados".

Para os sistemas Linux que usam o systemd, você pode usar o script svc. h distribuído com o aplicativo do executor auto-hospedado para instalação e gerenciamento usando o aplicativo como um serviço.

Na máquina, abra um shell no diretório onde você instalou o aplicativo do executor auto-hospedado. Use os comandos abaixo para instalar e gerenciar o serviço do executor auto-hospedado.

Observação: A configuração do 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.

Para obter mais informações, consulte "Removendo os executores auto-hospedados" e "Adicionando executores auto-hospedados".

Você pode gerenciar o serviço do executor no aplicativo Serviços do Windows, ou você pode usar o PowerShell para executar os comandos abaixo.

Você deve adicionar um executor a GitHub antes de poder configurar o aplicativo do executor auto-hospedado um serviço. Para obter mais informações, consulte "Adicionando executores auto-hospedados".

Na máquina, abra um shell no diretório onde você instalou o aplicativo do executor auto-hospedado. Use os comandos abaixo para instalar e gerenciar o serviço do executor auto-hospedado.

Instalando o serviço

  1. Pare o aplicativo do executor auto-hospedado se estiver em execução no momento.

  2. Instale o serviço com o comando a seguir:

    sudo ./svc.sh install

Instalar o serviço

  1. Pare o aplicativo do executor auto-hospedado se estiver em execução no momento.

  2. Instale o serviço com o comando a seguir:

    ./svc.sh install

Iniciar o serviço

Inicie o serviço com o seguinte comando:

sudo ./svc.sh start
Start-Service "actions.runner.*"
./svc.sh start

Verificando o status do serviço

Verifique o status do serviço com o comando a seguir:

sudo ./svc.sh status
Get-Service "actions.runner.*"
./svc.sh status

Para obter mais informações sobre a visualização do status de seu executor auto-hospedado, consulte "Monitoramento e resolução de problemas dos executores auto-hospedados".

Interromper o serviço

Interrompa o serviço com o comando a seguir:

sudo ./svc.sh stop
Stop-Service "actions.runner.*"
./svc.sh stop

Desinstalando o serviço

  1. Interrompa o serviço se estiver em execução.

  2. Desinstale o serviço com o comando a seguir:

    sudo ./svc.sh uninstall
    Stop-Service "actions.runner.*"
    ./svc.sh uninstall

Personalizar o serviço do executor auto-hospedado

Se você não desejar usar a configuração-padrão doserviço do systemd acima, você poderá criar um serviço personalizado ou usar o mecanismo de serviço que preferir. Considere usar o template serviced em actions-runner/bin/actions.runner.service.template como referência. Se você usa um serviço personalizado, o serviço do executor auto-hospedado deve sempre ser acessado usando o ponto de entrada runsvc.sh.

Personalizar o serviço do executor auto-hospedado

Se 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 usar o modelo plist em actions-runner/bin/actions.runner.plist.template como referência. Se você usa um serviço personalizado, o serviço do executor auto-hospedado deve sempre ser acessado usando o ponto de entrada runsvc.sh.

Você conseguiu encontrar o que estava procurando?

Pergunte a uma pessoa

Não consegue encontrar o que procura?

Entrar em contato