pbfoliveira/github-runner repository overview

⁠github-runner

GitHub Actions self-hosted runner, registrado no nível de organização (não funciona com conta pessoal — a API do GitHub não tem endpoint de runner a nível de usuário).

Código-fonte, documentação completa e exemplo real de uso: https://github.com/pbfoliveira-corp/github-runner⁠

⁠Destaques

• Base debian:bookworm-slim (~80MB)
• Modo ephemeral: registra um runner novo a cada job, roda um único job, desregistra — reduz risco entre jobs de repositórios diferentes na mesma organização
• Suporta Docker-in-Docker (default, isolado) ou Docker-out-of-Docker (monta /var/run/docker.sock do host e o runner passa a controlar o Docker do host — útil para automatizar deploys)

⁠Uso rápido

docker run -d \
  --name github-runner \
  --privileged \
  --restart unless-stopped \
  -e GITHUB_OWNER=sua-organizacao \
  -e GITHUB_PAT=seu_pat_com_escopo_admin:org \
  -v docker-data:/var/lib/docker \
  -v runner-work:/home/runner/actions-runner/_work \
  pbfoliveira/github-runner:1.0.3

Veja o README completo⁠ para configuração de variáveis, geração de token, modo DooD e avisos de segurança.