runner unregister
Remove completamente uma aplicacao registrada do Runner. Para containers, remove configs Traefik, deleta o diretorio da app e limpa todos os state files.
Sintaxe
runner unregister <app>
runner unregister <app> --force
runner unregister <app> --keep-running
runner unregister <app> --keep-traefik
runner unregister <app> --force --jsonArgumentos
| Argumento | Tipo | Obrigatorio | Descricao |
|---|---|---|---|
app |
string | Sim | Nome da app, path ou project/system |
Flags
| Flag | Default | Descricao |
|---|---|---|
--force |
false | Pula confirmacao interativa |
--keep-running |
false | Nao para nem remove containers |
--keep-traefik |
false | Nao remove configs Traefik |
--json |
false | Output em JSON |
O que e removido
Por padrao (sem flags), o unregister executa 5 etapas:
| Etapa | O que remove | Flag para pular |
|---|---|---|
| 1 | Containers (por label CCS) | --keep-running |
| 2 | Configs Traefik (*.yml) | --keep-traefik |
| 3 | Diretorio da app | - |
| 4 | State files (principal + PRs) | - |
| 5 | State de canary | - |
Cenarios de Uso
Remover tudo (padrao)
runner unregister print
# Remove app 'print' and all its data? [y/N] y
# Unregistered 'print' (8 items cleaned)Remover sem confirmacao (automacao)
runner unregister print --forceDesregistrar mas manter rodando (migracao)
Util quando quer parar de gerenciar via Runner mas manter o servico ativo:
runner unregister print --force --keep-running --keep-traefikRemove apenas: diretorio da app, state files, canary state. Mantém: container rodando, Traefik roteando.
Parar container mas manter rota (debug)
runner unregister print --force --keep-traefikOutput JSON (integracao CCS Client)
runner unregister print --force --json{
"app": "print",
"project": "print",
"removed": true,
"cleaned": [
"container:print_production_v1-0-0",
"traefik:devborlot_print_production.yml",
"dir:/data/apps/print",
"state:print.yml"
]
}Diferenca entre unregister, remove e destroy
| Comando | Escopo | Uso |
|---|---|---|
runner unregister <app> |
App inteira | Remove tudo: containers, traefik, dir, state |
runner remove <app> --pr N |
PR deploy | Remove apenas um PR deploy especifico |
runner destroy <project> -i <instance> |
Instancia | Remove containers e traefik de uma instancia |
Veja Tambem
- runner reset — reset sem desregistrar
- runner add — registrar nova app
- runner destroy — remover instancia especifica
By Borlot.com.br on 20/04/2026