runner archive
Arquiva uma app: para os containers, remove-os e marca o projeto como arquivado. O manifest, os segredos cifrados e o state file sao preservados, permitindo redeploy futuro sem reconfigurar do zero.
Use quando: voce precisa pausar permanentemente uma app sem perder a
configuracao — por exemplo, encerrar um ambiente de staging ou desativar
um cliente temporariamente. Para encerramento definitivo sem possibilidade de
recuperacao, use runner destroy.
Sintaxe
runner archive --project <PROJECT> [flags]Flags
| Flag | Default | Descricao |
|---|---|---|
-p, --project <PROJECT> |
— | Obrigatorio. Nome do projeto (campo project do .deploy.yml) |
-o, --output <FORMAT> |
human |
Formato de saida: human, json, yaml |
--json |
— | Atalho para --output json |
-h, --help |
— | Exibe ajuda |
Exemplo
runner archive --project cdn-front
# Project cdn-front archived.
# Containers stopped and removed. Manifest and state preserved.Verificar o estado apos o archive:
runner status --project cdn-front
# project: cdn-front
# status: archived
# ...Para redeployar uma app arquivada, basta rodar runner deploy normalmente.
O Runner localiza o manifest existente e sobe a app novamente.
Diferenca entre archive e destroy
| Caracteristica | runner archive |
runner destroy |
|---|---|---|
| Containers parados | Sim | Sim |
| Manifest preservado | Sim | Nao |
| Secrets preservados | Sim | Nao |
| State file preservado | Sim | Nao |
| Redeploy possivel | Sim | Nao |
Use archive quando a intencao e pausar. Use destroy quando o projeto
nao sera mais utilizado.
Erros comuns
project not found— O nome passado em--projectnao corresponde a nenhum projeto registrado; verifique comrunner list.project already archived— O projeto ja esta no estadoarchived; nenhuma acao adicional e necessaria.
By Borlot.com.br on 27/05/2026