Como Configurar um Runner Autohospedado do GitHub

Requisitos para iniciar nosso próprio runner do GitHub:

• Token PAT
• Nome da organização
• Container com github runner
• Host Docker

Vamos configurá-lo passo a passo. Para o container com github runner, usaremos github-runner.

Obtendo o token PAT

1. Vá para a página de Tokens de Acesso Pessoal e clique em Generate new token.
2. Insira o Nome do Token, selecione o Proprietário do Recurso (nome da sua organização) e a Expiração (por questões de segurança, é melhor não usar tempo ilimitado).
3. Clique na seta à direita das permissões da organização.
4. Selecione Access: Read and write para Self-hosted runners.
5. Agora clique em Generate token.
6. Copie o token gerado (começa com github_pat_...) em um local seguro.

Obtendo o nome da organização

Eu sou dono de várias organizações. Por exemplo, usarei um runner autohospedado para a organização fasthelp-ai.

Iniciando nosso runner

Provavelmente precisaremos alterar os direitos para docker.sock, pois nosso runner precisará acessar o docker.sock. É possível fazer isso através deste comando no terminal. No caso de debian/ubuntu:

sudo chmod 666 /var/run/docker.sock

Opção 1. Comando único do Docker

Agora podemos usar nosso token PAT, nome da organização e nome opcional.

docker run --rm \
  -e ORG=fasthelp-ai \
  -e ACCESS_TOKEN=github_pat_... \
  -e NAME=hetzner-1 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  ghcr.io/romnovi/github-runner:main

Opção 2. Docker compose

services:
  runner:
    image: ghcr.io/romnovi/github-runner:main
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    environment:
      - ORG=fasthelp-ai
      - ACCESS_TOKEN=github_pat_...
      - NAME=hetzner-1

Verificação

Depois de iniciar o runner, podemos verificar seu status na página de configurações da organização: Actions -> Runners.