Sobre executores auto-hospedados

Sobre executores auto-hospedados

Um executor auto-hospedado é um sistema que você implanta e gerencia para executar trabalhos do GitHub Actions em GitHub Enterprise Server. Para saber mais sobre GitHub Actions, confira "Entendendo o GitHub Actions" e "Sobre o GitHub Actions para empresas".

Com os executores auto-hospedados, você pode criar configurações de hardware personalizadas de acordo com suas necessidades, com o poder de processamento ou a memória para executar trabalhos maiores, instalar programas de software disponíveis na sua rede local e escolher um sistema operacional. Os executores auto-hospedados podem ser físicos, virtuais, em um contêiner, no local ou em uma nuvem.

Você pode adicionar runners auto-hospedados em vários níveis na hierarquia de gerenciamento:

• Runners em nível de repositório são dedicados a um único repositório.
• Executores no nível da organização podem processar trabalhos para vários repositórios em uma organização.
• Runners de nível empresarial podem ser atribuídos a várias organizações em uma conta corporativa.

A sua máquina do executor conecta-se ao GitHub Enterprise Server usando o aplicativo do executor auto-hospedado de GitHub Actions. O aplicativo de executor do GitHub Actions tem código aberto. Você pode contribuir e apresentar problemas no repositório do executor. Quando uma nova versão for lançada, o aplicativo executor será atualizado automaticamente em até 24 horas.

Um executor auto-hospedado é automaticamente removido de GitHub Enterprise Server se não se conectar a GitHub Actions por mais de 14 dias. Um executor auto-hospedado efêmero é removido automaticamente de GitHub Enterprise Server se não estiver conectado a GitHub Actions por mais de 1 dia.

Para saber mais sobre como instalar e usar executores auto-hospedados, confira "Adicionar executores auto-hospedados" e "Usar os executores auto-hospedados em um fluxo de trabalho".

Diferenças entre executores auto-hospedados e hospedados pelo GitHub

Os executores hospedados no GitHub oferecem uma maneira mais rápida e mais simples de executar seus fluxos de trabalho, enquanto os executores auto-hospedados são uma maneira altamente configurável de executar fluxos de trabalho em seu próprio ambiente personalizado.

Executores hospedado em GitHub:

• Receba atualizações automáticas do sistema operacional, pacotes e ferramentas pré-instalados e o aplicativo do executor auto-hospedado.
• São gerenciados e mantidos por GitHub.
• Fornecem uma instância limpa para cada execução de trabalho.
• Use minutos grátis no seu plano GitHub, com taxas por minuto aplicadas após exceder os minutos grátis.

Executores auto-hospedados:

• Receba atualizações automáticas apenas para o aplicativo do executor auto-hospedado, embora você possa desabilitar atualizações automáticas do executor. Para obter mais informações sobre como controlar as atualizações de software do executor em executores auto-hospedados, confira "Redimensionamento automático com executores auto-hospedados". Você é responsável por atualizar o sistema operacional e todos os outros softwares.
• Podem usar serviços de nuvem ou máquinas locais pelos quais você já pagou.
• São personalizáveis conforme seus requisitos de hardware, sistema operacional, software e segurança.
• Não precisam ter uma instância limpa para cada execução de trabalho.
• É grátis para usar com GitHub Actions, mas você é o responsável pelo custo de manter seus executores.
• Podem ser organizados em grupos para restringir o acesso a fluxos de trabalho, organizações e repositórios específicos. Para obter mais informações, confira "Gerenciar o acesso a executores auto-hospedados usando grupos".

Requisitos para executores auto-hospedados

Você pode usar qualquer máquina como um executor auto-hospedado, desde que ela atenda a estes requisitos:

• Você pode instalar e executar o aplicativo do executor auto-hospedado na máquina. Para obter mais informações, confira "Arquiteturas e sistemas operacionais compatíveis com executores auto-hospedados".
• A máquina pode comunicar-se com GitHub Actions. Para obter mais informações, confira "Comunicação entre executores auto-hospedados e o GitHub Enterprise Server".
• A máquina tem recursos de hardware suficientes para o tipo de fluxos de trabalho que você planeja executar. O aplicativo do executor auto-hospedado requer apenas recursos mínimos.
• Se você desejar executar fluxos de trabalho que usam ações do contêiner do Docker ou dos contêineres de serviço, você deverá usar uma máquina Linux e o Docker deve estar instalados.

Dimensionar automaticamente os seus executores auto-hospedados

Você pode aumentar ou diminuir automaticamente o número de executores auto-hospedados no seu ambiente em resposta aos eventos que você receber. Para obter mais informações, confira "Redimensionamento automático com executores auto-hospedados".

Limites de uso

Existem alguns limites sobre o uso de GitHub Actions ao usar executores auto-hospedados. Estes limites estão sujeitos a mudanças.

• Tempo de execução do fluxo de trabalho – Cada execução de fluxo de trabalho é limitada a 35 dias. Se a execução de um fluxo de trabalho atingir esse limite, a execução do fluxo de trabalho será cancelada. Esse período inclui a duração da execução e o tempo gasto em espera e aprovação.
• Tempo da fila de trabalho - Cada trabalho para executores auto-hospedados que estiver na fila por pelo menos 24 horas será cancelado. O tempo real na fila pode chegar a 48 horas antes de ocorrer o cancelamento. Se um executor auto-hospedado não começar a executar a tarefa dentro deste limite, a tarefa será encerrada e não será concluída.
• Solicitações de API - Você pode executar até 1.000 solicitações para a API do GitHub em uma hora em todas as ações dentro de um repositório. Se o número de solicitações for excedido, as chamadas à API adicionais falharão, o que poderá causar falha nos trabalhos.
• Matriz de trabalho – Uma matriz de tarefas pode gerar 256 tarefas no máximo por execução do fluxo de trabalho. Esse limite se aplica a executores hospedados por GitHub Enterprise Server e auto-hospedados.
• Fila de execução de fluxo de trabalho – No máximo, 500 execuções de fluxo de trabalho podem ser colocadas na fila em um intervalo de dez segundos por repositório. Se a execução de um fluxo de trabalho atingir esse limite, a execução do fluxo de trabalho terminará e falhará em ser concluída.
• Como registrar executores auto-hospedados – você pode ter no máximo 10.000 executores auto-hospedados em um grupo de corredores. Se esse limite for atingido, não será possível adicionar um novo executor.

Continuidade do fluxo de trabalho para executores auto-hospedados

Se os serviços de GitHub Actions estiverem temporariamente indisponíveis, a execução do fluxo de trabalho será descartada se não tiver sido enfileirada em 30 minutos após ser acionada. Por exemplo, se um fluxo de trabalho for acionado e os serviços de GitHub Actions não estiverem disponíveis por 31 minutos ou mais, a execução do fluxo de trabalho não será processada.

Arquiteturas e sistemas operacionais compatíveis com executores auto-hospedados

Os sistemas operacionais a seguir são compatíveis com o aplicativo de execução auto-hospedado.

Linux

• Red Hat Enterprise Linux 8 ou posterior
• CentOS 8 ou posterior
• Oracle Linux 8 ou posterior
• Fedora 29 ou versão posterior
• Debian 10 ou versão posterior
• Ubuntu 20.04 ou posterior
• Linux Mint 20 ou posterior
• openSUSE 15.2 ou posterior
• SUSE Enterprise Linux (SLES) 15 SP2 ou posterior

Windows

• Windows 10 64 bits
• Windows 11 de 64 bits
• Windows Server 2016 de 64 bits
• Windows Server 2019 64-bit
• Windows Server 2022 de 64 bits

macOS

• macOS 11.0 (Big Sur) ou posterior

Arquiteturas

As seguintes arquiteturas de processador são compatíveis com o aplicativo do executor auto-hospedado.

• x64 – Linux, macOS e Windows.
• ARM64 – Linux, macOS.
• ARM32 – Linux.

Ações com suporte em corredores auto-hospedados

Algumas configurações extras podem ser necessárias para usar as ações do GitHub com GitHub Enterprise Server, ou para usar as ações actions/setup-LANGUAGE com executores auto-hospedados sem acesso à Internet. Para saber mais, confira "Gerenciar o acesso a ações do GitHub.com" e entre em contato com o administrador do site do GitHub Enterprise.

Comunicação entre executores auto-hospedados e GitHub Enterprise Server

O executor auto-hospedado conecta-se a GitHub Enterprise Server para receber atividades de trabalho e fazer o download de novas versões do aplicativo do executor. O executor auto-hospedado usa uma sondagem longa HTTP(S) que abre uma conexão com o GitHub Enterprise Server por 50 segundos. Se nenhuma resposta for recebida, ela atingirá o tempo limite e criará uma sondagem longa. O aplicativo deve estar rodando na máquina para aceitar e executar trabalhos do GitHub Actions.

A conexão entre os executores auto-hospedados e o GitHub Enterprise Server é feita por HTTP (porta 80) ou HTTPS (porta 443). Para garantir a conectividade por HTTPS, configure o TLS para o GitHub Enterprise Server. Para obter mais informações, confira "Configurar o TLS".

Somente uma conexão de saída do executor com GitHub Enterprise Server é necessária. Não há necessidade de uma conexão de entrada de GitHub Enterprise Server para o executor. Para que o cache funcione, o executor precisa conseguir se comunicar com o armazenamento de blobs e baixar diretamente o conteúdo dele.

O precisa aceitar as conexões de entrada dos executores via HTTP(S) no nome do host de sua instância do GitHub Enterprise Server e no subdomínio da API. Os executores devem permitir conexões de saída via HTTP(S) pelo nome do host de sua instância do GitHub Enterprise Server e o subdomínio de API.

Os executores auto-hospedados não exigem acesso à internet para funcionar. Como resultado, você pode usar o roteamento de rede para direcionar a comunicação entre o executor auto-hospedado e GitHub Enterprise Server. Por exemplo, você pode atribuir um endereço IP privado para o executor auto-hospedado e configurar o roteamento para enviar tráfego para GitHub Enterprise Server, sem necessidade de tráfego para atravessar uma rede pública.

Você também pode usar executores auto-hospedados com um servidor proxy. Para obter mais informações, confira "Usar um servidor proxy com os executores auto-hospedados".

Para saber mais sobre como solucionar problemas comuns de conectividade de rede, confira "Monitorar e solucionar problemas de executores auto-hospedados".

Comunicação entre os executores auto-hospedados e o GitHub.com

Os executores auto-hospedados não precisam se conectar a GitHub.com, a menos que você tenha habilitado o acesso automático às ações de GitHub.com para GitHub Enterprise Server. Para obter mais informações, confira "Sobre como usar ações na sua empresa".

Se você tiver habilitado o acesso automático a ações GitHub.com, o executor auto-hospedado irá se conectar diretamente a GitHub.com para fazer o download das ações. Você deve garantir que a máquina tenha acesso adequado à rede para comunicar-se com as GitHub URLs listadas abaixo.

github.com
api.github.com
codeload.github.com
ghcr.io
*.actions.githubusercontent.com

github.com
api.github.com
codeload.github.com
ghcr.io
*.actions.githubusercontent.com

Segurança dos executores auto-hospedados

Os fluxos de trabalho não confiáveis no seu executor auto-hospedado representam riscos de segurança significativos para seu ambiente de rede e máquina, especialmente se sua máquina persistir no ambiente entre os trabalhos. Alguns dos riscos incluem:

• Programas maliciosos em execução na máquina.
• Sair do sandbox do executor da máquina.
• Expor acesso ao ambiente de rede da máquina.
• Dados persistentes, indesejados ou perigosos na máquina.

Para saber mais sobre proteção de segurança para executores auto-hospedados, confira "Fortalecimento de segurança para o GitHub Actions".

Como restringir o uso de executores auto-hospedados

Proprietários de empresas e organizações podem escolher que repositórios têm permissão para criar executores auto-hospedados no nível do repositório. .

Para obter mais informações, confira "Aplicando políticas para o GitHub Actions na sua empresa" e "Desabilitar ou limitar o GitHub Actions para sua organização".

Leitura adicional

• "Primeiros passos vom executores auto-hospedados da sua empresa"