Explorar os executores
Os executores do GitHub são recursos de computação que executam fluxos de trabalho do GitHub Actions. Cada executor pode executar apenas um trabalho de cada vez. Eles permitem que os desenvolvedores executem tarefas de build, de teste e de implantação diretamente nos repositórios do GitHub. Há dois tipos principais de executores do GitHub:
- Os executores hospedados no GitHub são recursos de computação virtualizados ou em contêineres, fornecidos e gerenciados pelo GitHub.
- Os executores auto-hospedados são recursos de computação físicos, virtualizados ou em contêineres que os usuários e organizações do GitHub provisionam e gerenciam por conta própria.
Cada tipo tem algumas características exclusivas, apresenta uma série de funcionalidades distintas e garante várias considerações diferentes.
É importante observar que o GitHub não recomenda o uso de executores auto-hospedados em repositórios públicos. Isso introduz um risco de segurança significativo, pois potencialmente permite que qualquer pessoa execute código dentro do ambiente privado da organização.
Executores hospedados no GitHub
Os executores hospedados no GitHub oferecem uma solução conveniente para executar fluxos de trabalho no GitHub Actions, eliminando a necessidade de administrar os componentes de hardware e software subjacentes. Eles são projetados para serem dimensionados automaticamente com base na demanda, garantindo um desempenho ideal durante os períodos de pico de uso. O GitHub fornece vários ambientes pré-configurados para executores hospedados no GitHub, abrangendo diferentes configurações de software e sistemas operacionais, incluindo Ubuntu Linux, Microsoft Windows e macOS.
Os executores hospedados no GitHub incluem as ferramentas internas padrão do sistema operacional. Por exemplo, os executores do Ubuntu e do macOS incluem grep, find e which. Para identificar todas as outras ferramentas pré-instaladas em executores, os usuários podem examinar a SBOM (lista de materiais de software) para cada build das imagens do executor do Windows e do Ubuntu. Como alternativa, os usuários podem examinar a subseção Imagem do Executor da seção Configurar trabalho nos logs de fluxo de trabalho. O link após a entrada Software Incluído descreve todas as ferramentas pré-instaladas no executor que executou o fluxo de trabalho. Também é possível instalar software adicional em executores hospedados no GitHub criando um trabalho que instala os pacotes como parte do fluxo de trabalho existente.
Os executores hospedados no GitHub são executados na infraestrutura de nuvem do GitHub, aproveitando máquinas virtuais ou contêineres para executar fluxos de trabalho. Cada execução de fluxo de trabalho é isolada em um ambiente próprio, garantindo segurança e reprodutibilidade. Os executores hospedados no GitHub integram-se perfeitamente ao GitHub Actions, permitindo que os usuários os referenciem diretamente nos fluxos de trabalho hospedados nos repositórios do GitHub.
Há alguns limites para o uso do GitHub Actions ao usar os executores hospedados no GitHub. Em particular, cada trabalho em um fluxo de trabalho tem o máximo de seis horas de tempo de execução. Se um trabalho atingir esse limite, o trabalho será terminado e não será completado. Cada execução de fluxo de trabalho é limitada a 35 dias. Se uma execução de fluxo de trabalho atingir esse limite, a execução dela será cancelada. Esse período inclui a duração da execução e o tempo gasto em espera e aprovação.
Pré-requisitos
Antes de implementar os executores hospedados no GitHub, os usuários precisam ter um repositório do GitHub em que possam definir fluxos de trabalho usando o GitHub Actions. Os executores estão disponíveis para todos os usuários do GitHub com acesso ao GitHub Actions.
Implementação
Ao contrário dos executores auto-hospedados, aqueles hospedados no GitHub são provisionados automaticamente como parte de uma execução de fluxo de trabalho individual. Os usuários definem fluxos de trabalho como arquivos formatados em YAML armazenados no diretório .github/workflows em repositórios do GitHub. Dentro da configuração do fluxo de trabalho, os usuários especificam o ambiente desejado do executor, incluindo o sistema operacional e as dependências de software. Os executores com especificações correspondentes são configurados sob demanda sempre que o fluxo de trabalho é disparado, com um executor por trabalho. Os gatilhos podem ser manuais ou automáticos, com base em eventos como pushes de código, solicitações de pull ou eventos de expedição de repositório.
Os executores hospedados no GitHub autenticam-se com o GitHub usando tokens ou credenciais fornecidas pelo GitHub Actions. Eles dependem da conectividade interna para se comunicar com a plataforma GitHub e baixar artefatos de fluxo de trabalho.
Manutenção
O GitHub gerencia atualizações e manutenção de executores hospedados no GitHub, garantindo que eles permaneçam atualizados com as versões de software mais recentes e patches de segurança. As ferramentas de software incluídas nos executores são atualizadas semanalmente. As atividades do executor são monitoradas e registradas em log, facilitando o acompanhamento de execuções de fluxo de trabalho e solução de problemas.
Licenciamento e custo
Os executores hospedados no GitHub estão incluídos nos preços do GitHub Actions, com cobrança baseada em uso para minutos de fluxo de trabalho além da camada gratuita. Os usuários se beneficiam da escala automatizada e econômica, pois o GitHub provisiona e desaloca automaticamente os executores com base na demanda.
Executores auto-hospedados
Em comparação com os executores hospedados no GitHub, os auto-hospedados fornecem opções de controle e personalização maiores, com ambientes de execução capazes de acomodar uma gama mais ampla de requisitos. Eles podem ser implantados localmente ou na nuvem, dependendo de critérios como conectividade de rede, custo e disponibilidade de recursos.
Os executores auto-hospedados são provisionados e gerenciados pelos usuários, dando-lhes controle total sobre o ambiente de execução. Eles são totalmente personalizáveis, incluindo especificações de hardware, configurações de software e configurações de rede. Eles também facilitam a integração com a infraestrutura e as ferramentas existentes, minimizando a possibilidade de problemas de compatibilidade e interoperabilidade.
Ao contrário dos executores hospedados pelo GitHub, não há limites para o tempo necessário para concluir uma execução de trabalho individual e execuções de fluxo de trabalho.
Pré-requisitos
Os usuários precisam preparar e configurar executores auto-hospedados na infraestrutura escolhida por eles, incluindo a instalação do software executor e quaisquer dependências de software adicionais. O código-fonte para os executores auto-hospedados está disponível como um projeto de código aberto no GitHub em https://github.com/actions/runner. Cada executor auto-hospedado atua como um agente que se comunica com o GitHub Actions para executar fluxos de trabalho.
Os executores auto-hospedados exigem conectividade de rede de saída, credenciais de autenticação e autorização para acessar a plataforma GitHub e baixar artefatos de fluxo de trabalho. Dependendo do local dos executores, talvez seja necessário configurar regras de firewall para atender a esses requisitos.
Implementação
Assim como acontece com os executores hospedados no GitHub, a implementação envolve a definição de fluxos de trabalho formatados por YAML e o armazenamento do diretório .github/workflows nos repositórios do GitHub. No entanto, para que os fluxos de trabalho usem executores auto-hospedados, os usuários precisam registrá-los primeiro, fornecendo os tokens ou credenciais de autenticação necessários. Como parte do registro, os usuários especificam características como o nome do executor, bem como rótulos e parâmetros do ambiente de execução.
O registro pode ocorrer em diferentes níveis em uma empresa:
- Nível do repositório (repositório único)
- Nível organizacional (vários repositórios em uma organização)
- Nível empresarial (várias organizações em uma empresa)
Manutenção
Os usuários são responsáveis por atualizar e manter executores auto-hospedados, incluindo a instalação de atualizações de software e patches de segurança. A manutenção também envolve o monitoramento da integridade e do desempenho do executor, bem como a solução de problemas que surgem em todo o runtime do executor.
Licenciamento e custo
Os executores auto-hospedados não incorrem em encargos de licenciamento adicionais além dos preços do GitHub Actions e dos custos de infraestrutura associados, incluindo computação, armazenamento e rede. Otimizar a alocação e a utilização de recursos torna-se responsabilidade do usuário.