# Troubleshooting

Problemas comuns e suas solucoes.

# Release nao foi processado

Sintoma: Release publicado no GitHub mas nao aparece no GitOps.

Verificacoes:

1. Release nao e draft? O GitOps ignora releases marcados como draft.

2. Repositorio esta registrado?

   curl https://sys.gitops.borlot.com.br/monitor/repositories \
     -H "X-API-Key: KEY" | jq '.repositories[].full_name'

3. Repositorio esta ativo? Verifique o campo active na listagem.

4. Release ja foi processado? Verifique no historico. Se precisa reprocessar:

   curl -X POST https://sys.gitops.borlot.com.br/monitor/reprocess/owner/repo \
     -H "X-API-Key: KEY"

5. Webhook esta configurado? Sem webhook, o GitOps depende do scheduler (a cada 10 min).

# Binario nao aparece no CDN

Sintoma: O ZIP esta disponivel mas o binario descompactado nao.

Causas comuns:

1. Arquivo >1MB no repositorio: Verificado e corrigido na v0.3.1. O GitOps agora usa download_url para arquivos grandes.

2. source incorreto no .gitops.yml:

   • source: meu-binario → busca no repositorio (deve estar commitado na tag)
   • source: asset:projeto.zip:binario → extrai de dentro do ZIP do release

3. folder_name vazio: Se folder_name for "", o GitOps usa o nome do repo como fallback, o que pode gerar paths incorretos.

# Erro "file names must not contain //"

Causa: folder_name vazio no .gitops.yml da tag que esta sendo processada.

Solucao: Atualize o .gitops.yml com folder_name preenchido e faca um novo release.

# Webhook retorna 401

Causa: O GITHUB_WEBHOOK_SECRET do GitOps nao confere com o secret do webhook no GitHub.

Solucao: Verifique que ambos usam o mesmo secret. Delete e recrie o webhook via API.

# Rate limit do GitHub

Sintoma: Erros 403 ou processamento lento.

Verificacao:

curl https://sys.gitops.borlot.com.br/monitor/status | jq '.github_rate_limit'

Solucao:

• Use GITHUB_TOKEN para aumentar o limite de 60 para 5000 req/hora
• Reduza a frequencia do scheduler (MONITOR_INTERVAL)

# Upload falha para B2

Verificacao:

curl https://sys.gitops.borlot.com.br/monitor/status | jq '.services.b2'

Se false, verifique:

• B2_APPLICATION_KEY_ID e B2_APPLICATION_KEY estao corretos
• O bucket B2_BUCKET_NAME existe
• A chave tem permissao de escrita

# Documentacao nao aparece

Verificacoes:

1. Os arquivos existem na tag do release (nao apenas na branch dev)
2. O .gitops.yml tem a secao docs configurada
3. Os paths de source estao corretos

# Logs

# Producao
docker logs gitops_borlot_com_br | grep ERROR

# Desenvolvimento
docker logs dev_gitops_borlot_com_br | grep ERROR

# Filtrar por projeto
docker logs gitops_borlot_com_br | grep meu-projeto