Criando um executor auto-hospedado com GitHub Actions

Introdução

GitHub Actions é uma ferramenta que permite automatizar fluxos de trabalho de maneira muito simples, diretamente dos repositórios do próprio GitHub. Sua versão gratuita permite o processamento de até 2000 minutos por mês em repositórios privados, compartilhando recursos de hardware. Mas é possível instalar a versão auto-hospedada no seu servidor e fazer uso ilimitado da ferramenta sem pagar nada a mais por isso.

Criando executor auto-hospedado

1. Acesse o repositório onde o fluxo será configurado e selecione a aba ‘Settings’.

2. Selecione a opção ‘Actions’ e no menu lateral e selecione a opção ‘Runner’, em seguida clique no botão ‘New self-hosted runner’ para adicionar um novo executor auto-hospedado.

3. Selecione o sistema operacional e siga as instruções para download e instalação do executor, que incluem a configuração de tokens de acesso e outras informações necessárias para a comunicação com o GitHub.

Configurando o executor no Linux:

Os passos a seguir serão um resumo do passo 3 da etapa anterior, usando o sistema operacional Linux.

No seu servidor, crie o diretório onde o executor será instalado:

mkdir actions-runner && cd actions-runner

Baixe o pacote do GitHub Actions:

curl -o actions-runner-linux-x64-2.303.0.tar.gz -L https://github.com/actions/runner/releases/download/v2.303.0/actions-runner-linux-x64-2.303.0.tar.gz

Faça a extração dos arquivos:

tar xzf ./actions-runner-linux-x64-2.303.0.tar.gz

Crie o executor:

./config.sh --url <link-do-repositorio> --token <token>

Como super usuário, torne o arquivo svc.sh executável:

sudo chmod +x svc.sh

em seguida, instale o executor:

sudo ./svc.sh install

e o inicie:

sudo ./svc.sh start

Tudo certo! O executor está rodando em “daemon” e pronto para executar seus fluxos de trabalho.

Os logs podem ser verificados com o seguinte comando:

sudo ./svc.sh status

Usando o executor nos fluxos de trabalho

Para usar o executor auto-hospedado, basta configurar o parâmetro runs-on: self-hosted no arquivo do fluxo de trabalho, por exemplo:

name: Seu fluxo de trabalho

on:
  push:
    branches: master

jobs:
  deploy:
    runs-on: self-hosted

    steps:
      - name: Etapa 1
        run: echo "Lero lero"

E isso é tudo, crie seus workflows e faça o máximo de proveito dessa poderosa ferramenta. Para saber mais, consulte a documentação oficial do GitHub Actions, especialmente a seção sobre executores auto-hospedados.