# FAQ

# Geral

# O que e o GitOps?

Sistema que automatiza a distribuicao de releases do GitHub para Backblaze B2 + CDN. Quando voce publica um release, o GitOps baixa os assets, processa conforme o .gitops.yml e disponibiliza via URLs amigaveis.

# Qual a diferenca entre GitOps e CI/CD Runner?

# Preciso de webhook?

Nao e obrigatorio. Sem webhook, o scheduler verifica a cada 10 minutos. Com webhook, o processamento e instantaneo.

# Configuracao

# Onde fica o .gitops.yml?

Na raiz do repositorio, commitado na tag do release. O GitOps busca o arquivo na tag sendo processada, nao na branch.

# Posso usar dominio proprio?

Sim. Configure delivery_url no .gitops.yml:

storage:
  delivery_url: https://get.meudominio.com

O DNS deve apontar para o CDN (Cloudflare).

# Como funciona o versionamento?

O GitOps cria copias "latest" (sempre atualizadas) e "versionadas" (permanentes):

/binario           ← latest (atualizado a cada release)
/v1.2.3/binario    ← versionado (permanente)

# Posso ter stable e RC ao mesmo tempo?

Sim, configure channels no .gitops.yml. Tags como v1.0.0 vao para stable, tags como v1.0.0-rc.1 vao para a pasta rc/.

# Processamento

# O que acontece com releases draft?

Sao ignorados. Apenas releases "published" sao processados.

# Posso reprocessar um release?

Sim, via API (POST /monitor/reprocess/owner/repo), Dashboard ou MCP.

# Como sei se um release foi processado?

• Dashboard: Pagina do repositorio mostra historico
• API: GET /monitor/history/owner/repo
• CDN: Tente acessar a URL do artefato

# E se o .gitops.yml mudar depois do release?

O GitOps usa o .gitops.yml da tag. Se voce mudar o arquivo e quiser aplicar, faca um novo release ou use reprocess.

# Storage

# Quanto espaco tenho?

O Backblaze B2 tem 10GB gratuitos. Apos isso, $0.005/GB/mes.

# Versoes antigas sao deletadas?

Configura via publish.max_versions no .gitops.yml. Default: 10 versoes.

# O CDN tem cache?

Sim, Cloudflare com Cache-Control: public, max-age=300, s-maxage=3600. Apos um novo release, pode levar ate 5 minutos para o cache expirar.