runner reset

Limpa versoes deployadas de uma instancia, permitindo redeploy do zero. Opcionalmente regenera .env e .secrets via Env Wizard.

Sintaxe

runner reset <app>
runner reset <app> --instance <instance>
runner reset <app> --hard
runner reset <app> --hard --env KEY=VALUE
runner reset <app> --json

Argumentos

Argumento Tipo Obrigatorio Descricao
app string Sim Nome da app, path ou project/system

Flags

Flag Default Descricao
--instance, -i auto Instancia a resetar (default: state file ou deploy.yml)
--hard false Remove tambem .env, .secrets e diretorios persistentes
--skip-tests false Pula testes apos redeploy
--json false Output em JSON
--env KEY=VALUE - Valores para env wizard (repetivel, modo remoto)

Modos

Reset soft (padrao)

Limpa versoes e containers mas mantem .env e .secrets:

runner reset print

O que faz:

  1. Para todos os containers da instancia
  2. Remove diretorios de versao (src/{instance}/v*/)
  3. Remove symlink current
  4. Remove config Traefik

Apos o reset, rode runner deploy print para redeployar.

Reset hard (--hard)

Limpa tudo incluindo .env e .secrets:

runner reset print --hard

Se o .deploy.yml tem environment: ou secrets: com wizard syntax, o Runner regenera os arquivos automaticamente:

# Interativo: pergunta cada valor
runner reset print --hard

# Remoto: passa valores via --env
runner reset print --hard \
  --env DB_NAME=novo_banco \
  --env API_KEY=nova_chave

Escolher instancia

runner reset print --instance staging
runner reset print --instance production

Se nao especificado, usa a instancia do state file ou o default do .deploy.yml.

Exemplos

Reset basico + redeploy

runner reset print
runner deploy print

Reset hard com env wizard remoto

runner reset print --hard \
  --env DB_NAME=prod_db \
  --env SMTP_PASSWORD=segredo
runner deploy print

Output JSON

runner reset print --instance production --json
{
  "app": "print",
  "instance": "production",
  "hard": false,
  "reset": true
}

Diferenca entre reset e unregister

Aspecto reset unregister
App continua registrada Sim Nao
State file mantido Sim Removido
Pode redeployar depois Sim Precisa runner add de novo
Remove .env/.secrets Apenas com --hard Sempre

Veja Tambem

By Borlot.com.br on 20/04/2026