# 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

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

### 3. Iniciar o Runner

```bash
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

```bash
# Ver logs
docker compose logs -f act_runner

# Verificar configuração
cat config.yaml
```

### Docker socket permission denied

```bash
# 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

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