Skip to main content

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.