runner self-update

Atualiza o binario do Runner para a versao mais recente.

Sintaxe

runner self-update [--force] [--channel <channel>] [--path <path>]

Parametros

Parametro Tipo Default Descricao
--force flag - Forca reinstalacao mesmo se ja atualizado
--channel string stable Canal de atualizacao (stable, rc)
--path string binario atual Caminho de instalacao

Exemplos

Atualizar para Versao Estavel

runner self-update

Output:

Checking for updates...
Current version: 1.0.0
Latest version: 1.1.0

Downloading v1.1.0...
  [====================] 100%

Backing up current binary...
  /opt/runner/runner -> /opt/runner/runner.backup

Installing new version...
  /opt/runner/runner

Verifying installation...
  runner v1.1.0

Update complete!

Forcar Reinstalacao

runner self-update --force

Reinstala mesmo se a versao atual for a mais recente.

Usar Release Candidate

runner self-update --channel rc

Baixa a versao RC mais recente para testes.

Instalar em Caminho Customizado

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

Canais

Canal Descricao URL
stable Versoes estaveis https://runner.ccs.systems/runner
rc Release candidates https://runner.ccs.systems/rc/runner

Processo de Atualizacao

  1. Verificar versao atual

    • Executa runner --version
  2. Verificar versao remota

    • Baixa metadata do canal selecionado
  3. Download do binario

    • Baixa novo binario para arquivo temporario
  4. Backup

    • Copia binario atual para {path}.backup
  5. Instalacao

    • Move novo binario para destino
    • Define permissoes executaveis
  6. Verificacao

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

    • Remove arquivo temporario

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 (evita download incompleto)
  • Validacao com --version apos instalacao
  • Backup automatico antes de substituir

Exit Codes

Codigo Significado
0 Sucesso ou ja atualizado
1 Erro de download
2 Verificacao falhou
3 Permissao negada

Atualizacao Automatica

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

Se desejar notificacao de novas versoes:

# Verifica sem instalar
runner self-update --check-only
By Borlot.com.br on 12/02/2026