Você deve adicionar um executor a GitHub Enterprise Cloud 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 Enterprise Cloud 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
-
Pare o aplicativo do executor auto-hospedado se estiver em execução no momento.
-
Instale o serviço com o comando a seguir:
sudo ./svc.sh install
Instalando o serviço
-
Pare o aplicativo do executor auto-hospedado se estiver em execução no momento.
-
Instale o serviço com o comando a seguir:
./svc.sh install
O comando usa um argumento usuário
opcional para instalar o serviço como um usuário diferente.
./svc.sh install USERNAME
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
-
Interrompa o serviço se estiver em execução.
-
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
.