Observação: Executores hospedados em GitHub não são atualmente compatíveis com GitHub Enterprise Server. Você pode ver mais informações sobre suporte futuro planejado no Itinerário público do GitHub.
Você deve adicionar um executor a GitHub Enterprise Server 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 Server 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 -
Ccomo alternativa, o comando usa um argumento
usuárioopcional para instalar o serviço como um usuário diferente../svc.sh install USERNAME
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
Iniciar o serviço
Inicie o serviço com o seguinte comando:
sudo ./svc.sh startStart-Service "actions.runner.*"./svc.sh startVerificando o status do serviço
Verifique o status do serviço com o comando a seguir:
sudo ./svc.sh statusGet-Service "actions.runner.*"./svc.sh statusPara 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 stopStop-Service "actions.runner.*"./svc.sh stopDesinstalando o serviço
-
Interrompa o serviço se estiver em execução.
-
Desinstale o serviço com o comando a seguir:
sudo ./svc.sh uninstallStop-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.