Executores autogerenciados para ambientes locais

Boas-vindas ao mundo das máquinas executoras auto-hospedadas! Essas ferramentas poderosas permitem executar fluxos de trabalho do GitHub Actions em suas próprias máquinas.

Em vez de usar as máquinas executoras hospedadas na nuvem do GitHub, você pode fornecer seu próprio hardware, sistema operacional e ambiente de rede para executar seus trabalhos de CI/CD.

Embora as máquinas executoras hospedadas pelo GitHub sejam convenientes, as máquinas executoras auto-hospedadas oferecem vantagens exclusivas:

• Hardware específico: Usar hardware personalizado, como GPUs ou arquiteturas específicas de CPU.
• Acesso à rede: Conectar-se diretamente a redes e recursos privados (bancos de dados e serviços internos).
• Segurança: Manter ambientes de compilação confidenciais dentro da sua própria infraestrutura controlada.
• Otimização de custos: Reduzir potencialmente os custos de uso em grande escala aproveitando a infraestrutura existente.

Para configurar um executor auto-hospedado, sua máquina precisa atender a alguns requisitos básicos:

• Sistema operacional: Linux, Windows ou macOS são compatíveis.
• Acesso à rede: a máquina do executor deve conseguir se comunicar com GitHub.com (ou com o Servidor GitHub Enterprise).
• Recursos: CPU, RAM e espaço em disco suficientes para lidar com os trabalhos do seu fluxo de trabalho.
• Software: todas as ferramentas ou SDKs exigidos pelos seus fluxos de trabalho devem estar instalados no executor.

Configurar um executor auto-hospedado envolve algumas etapas principais. É como preparar sua máquina para se tornar um trabalhador dedicado do GitHub Actions:

1. Gere um token de registro exclusivo no GitHub.
2. Baixe e extraia o aplicativo do executor na sua máquina.
3. Configure o executor com a URL do repositório ou da organização no GitHub e com o token.
4. Inicie o aplicativo do executor para que ele aguarde trabalhos.

Primeiro, você precisa informar ao GitHub que está configurando um novo executor. Para isso, é necessário um token exclusivo.

Acesse as configurações do seu repositório ou da sua organização em GitHub.com:

• Para um repositório: Settings > Actions > Runners > New self-hosted runner
• Para uma organização: Settings > Actions > Runners > New self-hosted runner

Siga as instruções para gerar um token. Esse token é usado somente para o registro.

Em seguida, baixe o aplicativo do executor para a máquina escolhida. A interface do GitHub fornecerá comandos específicos para o seu sistema operacional.

Por exemplo, em uma máquina Linux, você pode usar:

Depois de extraí-lo, você configurará o executor. Isso o vincula ao seu repositório ou à sua organização no GitHub e permite definir rótulos.

Execute o script config.sh (Linux/macOS) ou config.cmd (Windows). Você informará a URL do GitHub e o token gerado anteriormente.

Depois de configurado, você poderá iniciar o aplicativo do executor. Ele se conectará ao GitHub e aguardará trabalhos.

Basta executar ./run.sh (Linux/macOS) ou run.cmd (Windows). Em ambientes de produção, recomenda-se instalar o executor como um serviço para que ele seja iniciado automaticamente.

Para usar seu executor auto-hospedado, especifique-o no arquivo YAML do seu fluxo de trabalho usando a palavra-chave runs-on. Você pode usar self-hosted ou rótulos específicos atribuídos durante a configuração.

Os executores auto-hospedados oferecem vantagens exclusivas em comparação com os executores hospedados pelo GitHub. Qual das opções a seguir é um benefício principal de usar um executor auto-hospedado?

Você aprendeu sobre executores auto-hospedados! Eles permitem executar fluxos de trabalho do GitHub Actions na sua própria infraestrutura, proporcionando controle sobre hardware, acesso à rede e segurança.

Abordamos o processo de configuração: gerar um token, baixar o aplicativo, configurar e iniciar o executor. Você também viu como direcionar seus executores personalizados nos arquivos YAML do fluxo de trabalho usando runs-on.