docs: adiciona troubleshooting para CI/CD Forgejo
Some checks failed
CI/CD Web + Desktop / Detect changes (push) Successful in 5s
Quality Checks / Lint, Test and Build (push) Successful in 4m30s
CI/CD Web + Desktop / Deploy Convex functions (push) Has been skipped
CI/CD Web + Desktop / Deploy (VPS Linux) (push) Failing after 3m56s

Adiciona solucoes para problemas comuns:
- Regeneracao de hooks quando workflows nao disparam
- Correcao de erro de LevelDB lock
- Reinicio do runner apos reinicio do Forgejo

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
esdrasrenan 2025-12-16 22:26:44 -03:00
parent d067bda610
commit 04226c16cc

View file

@ -249,13 +249,33 @@ journalctl -u forgejo-runner --no-pager -n 50
# Verificar conectividade
curl -s https://git.esdrasrenan.com.br/api/healthz
# Se o runner mostrar erro "404 Not Found" apos reinicio do Forgejo:
systemctl restart forgejo-runner
```
### Workflow nao dispara
### Workflow nao dispara apos push
1. Verificar se o arquivo esta em `.forgejo/workflows/`
2. Verificar se Actions esta habilitado no repositorio (Settings > Actions)
3. Verificar se o runner esta online (Settings > Actions > Runners)
4. **Regenerar hooks do repositorio:**
```bash
docker exec -u 1000:1000 $(docker ps -q --filter "name=forgejo_forgejo") \
/usr/local/bin/gitea admin regenerate hooks --config /data/gitea/conf/app.ini
```
### Erro de LevelDB Lock (queue nao inicia)
Se o Forgejo mostrar erro `unable to lock level db at /data/gitea/queues/common`:
1. O stack.yml ja usa `FORGEJO__queue__TYPE=channel` para evitar esse problema
2. Se o erro persistir, limpe o diretorio de queues:
```bash
docker exec $(docker ps -q --filter "name=forgejo_forgejo") \
rm -rf /data/gitea/queues/*
docker service update --force forgejo_forgejo
```
### Erro de permissao no deploy