homelab/gitea-runner

Gitea Actions Runner — Hestia

Este diretório contém a configuração do runner de Gitea Actions para executar workflows CI/CD.

Visão Geral

O act_runner é o agente que executa os jobs definidos nos workflows .gitea/workflows/*.yml. Ele roda no Hestia (10.0.0.50) usando Docker.

Arquivos

gitea-runner/
├── docker-compose.yml   # Serviço do runner
├── config.yaml          # Configuração (gerado no registro)
├── register.sh         # Script de registro
└── data/               # Dados persistentes do runner

Instalação

1. Obter Token de Registro

Acesse o Gitea como admin:

https://gitea.hackerfortress.cc/admin/runners

Clique em "New Runner" e copie o token.

2. Registrar o Runner

cd gitea-runner
export RUNNER_TOKEN="seu-token-aqui"
./register.sh

3. Iniciar o Runner

docker compose up -d

4. Verificar

Acesse:

https://gitea.hackerfortress.cc/admin/runners

O runner deve aparecer como "Active".

Labels Disponíveis

Label	Descrição
gitea-runner-Hestia	Runner principal
ubuntu-latest	Container Ubuntu para jobs

Troubleshooting

Runner não aparece como active

# Ver logs
docker compose logs -f act_runner

# Verificar configuração
cat config.yaml

Docker socket permission denied

# No host (Hestia), adicionar usuário ao grupo docker
sudo usermod -aG docker $USER

Jobs ficam em "Pending"

• Verificar se runner está online
• Verificar se o token está correto
• Verificar se o runner tem labels necessárias

Atualização

cd gitea-runner
docker compose pull
docker compose up -d