#
Referencia CLI
O Runner oferece uma CLI completa para gerenciamento de deploys.
#
Comandos Principais
#
Inicializacao e Registro
| Comando |
Descricao |
runner init |
Inicializa ambiente Runner |
runner add --repo user/repo |
Registra nova aplicacao |
runner list [--detailed] |
Lista apps registradas |
#
Deploy e Rollback
| Comando |
Descricao |
runner deploy --app /path |
Executa deploy |
runner rollback --app /path |
Rollback para versao anterior |
runner reset --app /path |
Reset completo (wipe + redeploy) |
runner fetch [--deploy] |
Busca atualizacoes |
#
Gerenciamento de Instancias
| Comando |
Descricao |
runner instances <project> |
Lista instancias |
runner versions <project> -i <inst> |
Lista versoes |
runner destroy <project> -i <inst> |
Remove instancia |
runner cleanup [--expired] |
Limpa versoes antigas |
#
Canary Deployment
| Comando |
Descricao |
runner weights <project> -i <inst> |
Mostra distribuicao de trafego |
runner weight <proj> <inst> <ver> <pct> |
Ajusta peso |
runner promote <project> -i <inst> <ver> |
Promove para 100% |
#
Staging de PRs
| Comando |
Descricao |
runner stage deploy --repo user/repo --pr N |
Deploy de PR |
runner stage list [--json] |
Lista stagings |
runner stage destroy --id <id> |
Remove staging |
runner stage cleanup |
Limpa expirados |
#
Environment
| Comando |
Descricao |
runner env status --app /path |
Mostra variaveis |
runner env set --app /path --key K --value V |
Define variavel |
runner env set ... --secret |
Define secret |
runner env validate --app /path --required "A,B" |
Valida variaveis |
#
Logs
| Comando |
Descricao |
runner logs history --app /path |
Historico de deploys |
runner logs tail --app /path |
Ultimas linhas |
runner logs stats --app /path |
Estatisticas |
#
Configuracao
| Comando |
Descricao |
runner generate-config |
Gera template .deploy.yml |
runner validate --file /path |
Valida configuracao |
runner upgrade --path /path |
Migra formato legado |
runner migrate --app /path |
Migra estrutura de app |
#
MCP Server
| Comando |
Descricao |
runner mcp serve |
Inicia servidor MCP |
runner mcp install |
Instala config MCP |
runner mcp uninstall |
Remove config MCP |
runner mcp status |
Mostra info do servidor |
#
Self-Update
| Comando |
Descricao |
runner self-update |
Atualiza para versao estavel |
runner self-update --force |
Forca reinstalacao |
runner self-update --channel rc |
Usa release candidate |
#
Flags Globais
| Flag |
Descricao |
--help |
Mostra ajuda |
--version |
Mostra versao |
--json |
Output em JSON |
#
Exemplos Rapidos
# Primeiro uso
runner init
runner add --repo usuario/meu-app
# Deploy
runner fetch --deploy
runner deploy --app /apps/usuario_meu-app
# Rollback
runner rollback --app /apps/usuario_meu-app
# Canary
runner deploy meu-app --version v1.1.0
runner weight meu-app production v1.1.0 10
runner promote meu-app -i production v1.1.0
# Staging
runner stage deploy --repo usuario/meu-app --pr 42
runner stage list
runner stage destroy --id staging_meu-app_pr42
# MCP
runner mcp install
runner mcp status
#
Documentacao Detalhada
By
Borlot.com.br on 12/02/2026