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 --json

Argumentos

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 --force

Desregistrar mas manter rodando (migracao)

Util quando quer parar de gerenciar via Runner mas manter o servico ativo:

runner unregister print --force --keep-running --keep-traefik

Remove 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-traefik

Output 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

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