Esta versão do GitHub Enterprise foi descontinuada em 2021-09-23. Nenhum lançamento de patch será feito, mesmo para questões críticas de segurança. Para obter melhor desempenho, melhorar a segurança e novos recursos, upgrade to the latest version of GitHub Enterprise. Para ajuda com a atualização, contact GitHub Enterprise support.

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: GitHub Actions estava disponível para GitHub Enterprise Server 2.22 como um beta limitado. O beta terminou. GitHub Actions está agora geralmente disponível em GitHub Enterprise Server 3.0 ou posterior. Para obter mais informações, consulte as observações sobre a versão GitHub Enterprise Server 3.0.


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

  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

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:

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