# Inicio Rapido

Configure a entrega automatica de releases em 5 minutos.

# Pre-requisitos

• Repositorio no GitHub com pelo menos um release publicado
• Arquivo .gitops.yml na raiz do repositorio

# Passo 1: Criar o .gitops.yml

Adicione na raiz do seu repositorio:

version: 2.0

artifacts:
  # Binario descompactado (latest)
  - source: meu-binario
    destination: meu-binario
    type: binary
    latest: true

  # ZIP (latest)
  - source: meu-binario
    destination: meu-binario.zip
    type: zip
    latest: true

  # Versionado
  - source: meu-binario
    destination: v{version}/meu-binario
    type: binary
    versioned: true

docs:
  - source: README.md
    destination: docs/latest/README.md
    latest: true
  - source: README.md
    destination: docs/v{version}/README.md
    versioned: true

storage:
  provider: b2
  bucket: ccs-systems
  folder_name: meu-projeto
  delivery_url: https://meu-projeto.ccs.systems

publish:
  auto_latest: true
  preserve_versions: true
  max_versions: 10

# Passo 2: Registrar o Repositorio

Via MCP (Claude Code):

> Use a tool get_status para verificar se o GitOps esta funcionando
> Use add_repository com "devborlot/meu-projeto"

Ou via API:

curl -X POST https://sys.gitops.borlot.com.br/monitor/repositories \
  -H "X-API-Key: SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"repository": "devborlot/meu-projeto"}'

Ou via Dashboard:

1. Acesse app.gitops.borlot.com.br
2. Clique em Adicionar Repositorio
3. Insira devborlot/meu-projeto

# Passo 3: Configurar Webhook (Recomendado)

O webhook notifica o GitOps instantaneamente quando um release e publicado:

curl -X POST https://sys.gitops.borlot.com.br/monitor/webhooks/devborlot/meu-projeto \
  -H "X-API-Key: SUA_API_KEY"

Sem webhook, o GitOps usa polling a cada 10 minutos.

# Passo 4: Publicar um Release

# Build local
cargo build --release
cp target/release/meu-binario .

# Commit e tag
git add meu-binario
git commit -m "build: meu-binario v1.0.0"
git tag -a v1.0.0 -m "Release v1.0.0"
git push origin main --tags

# Criar GitHub Release
zip meu-binario.zip meu-binario
gh release create v1.0.0 --title "v1.0.0" ./meu-binario.zip

# Passo 5: Verificar

O GitOps processara automaticamente. Verifique:

# Binario direto
curl -sI https://meu-projeto.ccs.systems/meu-binario

# ZIP
curl -sI https://meu-projeto.ccs.systems/meu-binario.zip

# Documentacao
curl -s https://meu-projeto.ccs.systems/docs/latest/README.md

# Proximo Passo

• Formato .gitops.yml - Todas as opcoes de configuracao
• Canais Stable/RC - Release candidates
• Referencia API - Endpoints completos