Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais recentes, acesse a documentação em inglês. Se houver problemas com a tradução desta página, entre em contato conosco.
O GitHub AE está atualmente sob versão limitada. Entre em contato com nossa Equipe de Vendas para saber mais.

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.

Aviso: Os executores auto-hospedados estão desabilitados para GitHub AE. Isso porque GitHub AE oferece garantias para as fronteiras de segurança que são incompatíveis com a forma como os executores hospedados funcionam. No entanto, se você precisar usar executores auto-hospedados com GitHub AE e entender as implicações de segurança, você poderá entrar em contato com o suporte de GitHub para uma exceção de segurança que irá habilitar executores auto-hospedados.

Se você não precisar de executores auto-hospedados, você poderá usar AE hosted runners para executar seus fluxos de trabalho. Para obter mais informações, consulte "Sobre AE hosted runners".

Observação: GitHub Actions está atualmente na versão beta para GitHub AE.

Você deve adicionar um executor a GitHub AE 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 AE 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.

Esse documento ajudou você? Política de Privacidade

Ajude-nos a tornar esses documentos ótimos!

Todos os documentos do GitHub são de código aberto. Você percebeu que algo que está errado ou não está claro? Envie um pull request.

Faça uma contribuição

Ou, aprenda como contribuir.