Skip to main content
We publish frequent updates to our documentation, and translation of this page may still be in progress. For the most current information, please visit the English documentation.

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.

Observação: no momento, não há suporte para os executores hospedados no GitHub no GitHub Enterprise Server. Você pode ver mais informações sobre o suporte futuro planejado no GitHub public roadmap.

Você precisa adicionar um executor ao GitHub Enterprise Server antes de configurar o aplicativo do executor auto-hospedado como um serviço. Para obter mais informações, confira "Como adicionar executores auto-hospedados".

Para os sistemas Linux que usam systemd, use o script svc.sh distribuído com o aplicativo do executor auto-hospedado para instalá-lo e gerenciá-lo usando o aplicativo como um serviço.

No computador do executor, abra um shell no diretório em que você instalou o aplicativo do executor auto-hospedado. Use os comandos abaixo para instalar e gerenciar o serviço de 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, confira "Como remover executores auto-hospedados" e "Como adicionar executores auto-hospedados".

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

Você precisa adicionar um executor ao GitHub Enterprise Server antes de configurar o aplicativo do executor auto-hospedado como um serviço. Para obter mais informações, confira "Como adicionar executores auto-hospedados".

No computador do executor, abra um shell no diretório em que você instalou o aplicativo do executor auto-hospedado. Use os comandos abaixo para instalar e gerenciar o serviço de executor auto-hospedado.

Instalar o serviço

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

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

    sudo ./svc.sh install
  3. Como alternativa, o comando usa um argumento user opcional para instalar o serviço como outro usuário.

    ./svc.sh install USERNAME

Instalar o serviço

  1. Interrompa o aplicativo do executor auto-hospedado se ele 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 como ver o status do executor auto-hospedado, confira "Monitoramento e solução de problemas de 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
    Remove-Service "actions.runner.*"
    ./svc.sh uninstall

Personalizar o serviço do executor auto-hospedado

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

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