# runner fetch

Verifica atualizacoes nas apps registradas e opcionalmente executa deploy.

# Sintaxe

runner fetch [OPTIONS] [APP_PATH]

# Parametros

# Opcoes

# Exemplos

# Verificar Atualizacoes

runner fetch

Output ordenado alfabeticamente por projeto/sistema:

Runner v1.2.0
Verificando 7 app(s)...

  ✓ auth/api                   -        atualizado
  ✓ cdn-front/front            v2.6.0   atualizado
  ✓ cdn-sys/sys                -        atualizado
  ✓ hogi/front                 v1.0.2   atualizado
  ✓ hogi/sys                   v1.0.0   atualizado
  ✓ hogi/worker                -        atualizado
  ✓ runner-docs/front          -        atualizado

✓ 7 apps atualizadas

# Verificar e Deployar

runner fetch --deploy

# Output JSON (para cron)

runner fetch --json

# Forcar Atualizacao

runner fetch --force

Util quando o .deploy.yml no servidor esta desatualizado.

# Verificar sem Baixar (dry-run)

runner fetch --check

Apenas verifica se ha atualizacoes disponiveis, sem fazer git pull. Mostra status disponivel para apps com updates no remoto.

↑ │ meu-app/sys              │ dist     │ v1.0.0    │ abc123  │ v1.0.0    │ def456  │ disponível

# App Especifica

runner fetch /data/apps/meu-projeto

# Verbose (debugging)

runner fetch --verbose

# Processo de Fetch

1. Lista apps registradas

   • Escaneia apps_path por diretorios com .deploy.yml

2. Para cada app (ordenado alfabeticamente):

   • Se --force: git pull antes de ler config
   • Le .deploy.yml e estado
   • Compara commit local com remoto (via git fetch ou git ls-remote)

3. Verifica estado do container

   • Mesmo com git em dia, verifica se o container esta rodando
   • Se o container morreu ou foi removido (docker rm -f), marca como needs_deploy
   • Isso garante recuperacao automatica de servicos caidos

4. Se houver mudancas ou container ausente:

   • Com --deploy: executa deploy automaticamente
   • Sem --deploy: apenas reporta status

5. Atualiza estado

   • Registra timestamp do fetch
   • Registra versao encontrada
   • Salva em /opt/runner/state/{app}.yml

# Deteccao de Container Morto (v1.3.3)

O fetch verifica nao apenas a versao do codigo, mas tambem se o container esta vivo. Cenarios detectados:

Isso permite crash recovery completo com um unico comando:

# Container morreu? fetch --deploy detecta e recupera
runner fetch --deploy

Antes da v1.3.3, se o container morresse mas o codigo nao mudasse, o fetch dizia "up_to_date" e nao deployava. Agora detecta a ausencia do container e aciona o deploy automaticamente.

# Output

# Indicadores Visuais

# Output JSON

{
  "timestamp": "2026-02-16T10:30:00Z",
  "total": 7,
  "updated": 1,
  "up_to_date": 5,
  "errors": 1,
  "no_git": 0,
  "deployed": 0,
  "apps": [
    {
      "app_name": "auth_api",
      "app_path": "/data/apps/auth_api",
      "project": "auth",
      "system": "api",
      "current_version": "v1.0.0",
      "new_version": null,
      "has_updates": false,
      "pulled": false,
      "deployed": false,
      "status": "up_to_date",
      "error": null
    },
    {
      "app_name": "cdn_front",
      "app_path": "/data/apps/cdn_front",
      "project": "cdn-front",
      "system": "front",
      "current_version": "v2.6.0",
      "new_version": "v2.7.0",
      "has_updates": true,
      "pulled": true,
      "deployed": false,
      "status": "updated",
      "error": null
    }
  ]
}

# Configuracao de Cron

Recomendado executar a cada 5 minutos:

# crontab -e
*/5 * * * * /opt/runner/runner fetch --deploy --json >> /var/log/runner-fetch.json 2>&1

Ou use runner serve para webhook + canary scheduler integrados.

# Log de Fetch

O Runner mantem um log em /opt/runner/logs/fetch-audit.json:

{"timestamp":"2026-02-16T10:30:00Z","total":7,"updated":1,"up_to_date":5,"errors":1,"no_git":0,"deployed":0}

# Estados de App

# Exit Codes

# Flag --force

A flag --force (-F) executa git pull antes de carregar o .deploy.yml:

runner fetch --force

Quando usar:

• Apos migrar formato do .deploy.yml
• Quando o servidor esta com config desatualizada
• Resolver problemas de parsing

O que faz:

1. Detecta branch dist do estado salvo (ou usa "dist")
2. Executa git pull origin {branch} antes de ler config
3. Se houver conflitos, faz git reset --hard origin/{branch}
4. Continua com fetch normal

# Dicas

# Verificar Log de Fetch

tail -50 /opt/runner/logs/fetch-audit.json | jq .

# Fetch Manual de App Especifica

Para forcar update de uma app:

runner fetch --force /data/apps/meu-projeto

# Integracao com runner serve

Em vez de cron, considere usar:

runner serve

Que combina:

• Webhook server para eventos GitHub
• Canary scheduler para auto-promocao