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 --project nao corresponde a nenhum projeto registrado; verifique com runner list.
  • project already archived — O projeto ja esta no estado archived; nenhuma acao adicional e necessaria.
By Borlot.com.br on 27/05/2026