# runner self-update

Atualiza o binario do Runner para a versao mais recente.

# Sintaxe

runner self-update [OPTIONS]

# Parametros

# Exemplos

# Atualizar para Versao Estavel

runner self-update

Output:

════════════════════════════════════════════════════════════
   RUNNER SELF UPDATE
════════════════════════════════════════════════════════════

  Versao atual: 1.1.6
  Destino:      /opt/runner/runner
  Canal:        stable
  Download:     https://runner.ccs.systems/runner

  Baixando versao mais recente...

  ✅ Atualizacao concluida!
  Nova versao: runner 1.1.7

════════════════════════════════════════════════════════════

# Verificar Atualizacao (sem baixar)

runner self-update --check
runner self-update -C

Output:

════════════════════════════════════════════════════════════
   RUNNER SELF UPDATE
════════════════════════════════════════════════════════════

  Versao atual: 1.1.6
  Destino:      /opt/runner/runner
  Canal:        stable
  Download:     https://runner.ccs.systems/runner

  Verificando disponibilidade de atualizacao...

  ✓ Atualizacao disponivel!

  Para atualizar, execute:
    runner self-update

════════════════════════════════════════════════════════════

# Usar Release Candidate

runner self-update --rc
runner self-update --channel rc

Baixa a versao RC mais recente para testes.

# Verificar RC Disponivel

runner self-update --rc --check

# Forcar Reinstalacao

runner self-update --force
runner self-update -f

Reinstala mesmo se a versao atual for a mais recente.

# Instalar em Caminho Customizado

runner self-update --path /usr/local/bin/runner

# Canais

Nota: A flag --rc tem prioridade sobre --channel. Ou seja, --channel stable --rc usa o canal RC.

# Processo de Atualizacao

1. Verificar versao atual

   • Executa runner --version

2. Verificar versao remota

   • HEAD request (se --check) ou GET request

3. Download do binario

   • Baixa novo binario para arquivo temporario
   • Valida tamanho minimo (evita download incompleto)

4. Backup

   • Copia binario atual para {path}.backup

5. Instalacao

   • Move novo binario para destino
   • Define permissoes executaveis (755)

6. Verificacao

   • Executa {path} --version do novo binario
   • Confirma versao correta

7. Cleanup

   • Remove backup se instalacao OK

# Rollback Manual

Se algo der errado:

# Restaurar backup
cp /opt/runner/runner.backup /opt/runner/runner

# Verificar
runner --version

# Verificacoes de Seguranca

• Tamanho minimo do binario (> 1MB)
• Validacao com --version apos instalacao
• Backup automatico antes de substituir
• Permissoes 755 garantidas

# Exit Codes

# Atualizacao Automatica

Nao e recomendado atualizar automaticamente via cron. Atualizacoes devem ser feitas manualmente para evitar problemas em producao.

Para verificar periodicamente sem instalar:

# Cron job para notificar (nao instala)
0 8 * * 1 /opt/runner/runner self-update --check 2>&1 | grep -q "disponivel" && echo "Runner update disponivel"