Criando um executor auto-hospedado com GitHub Actions

Introduo

GitHub Actions uma ferramenta que permite automatizar fluxos de trabalho de maneira muito simples, diretamente dos repositrios do prprio GitHub. Sua verso gratuita permite o processamento de at 2000 minutos por ms em repositrios privados, compartilhando recursos de hardware. Mas possvel instalar a verso 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 repositrio onde o fluxo ser configurado e selecione a aba Settings.

2. Selecione a opo Actions e no menu lateral e selecione a opo Runner, em seguida clique no boto New self-hosted runner para adicionar um novo executor auto-hospedado.

3. Selecione o sistema operacional e siga as instrues para download e instalao do executor, que incluem a configurao de tokens de acesso e outras informaes necessrias para a comunicao com o GitHub.

Configurando o executor no Linux:

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

No seu servidor, crie o diretrio 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

Faa a extrao 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 usurio, torne o arquivo svc.sh executvel:

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 parmetro runs-on: self-hosted no arquivo do fluxo de trabalho, por exemplo:

name: Seu fluxo de trabalhoon:  push:    branches: masterjobs:  deploy:    runs-on: self-hosted    steps:      - name: Etapa 1        run: echo "Lero lero"

E isso tudo, crie seus workflows e faa o mximo de proveito dessa poderosa ferramenta. Para saber mais, consulte a documentao oficial do GitHub Actions, especialmente a seo sobre executores auto-hospedados.