#
`runner assets`
Exposicao CLI do modelo de assets (v2.37.0, issue #28). Cada subcomando opera sobre o
diretorio <app>/data/ declarado no bloco assets: do manifesto.
Assets sao o que sobrevive ao deploy: uploads de usuario, caches, credenciais de
terceiros em arquivo. Como o blue-green troca o container inteiro, esses dados nao
podem morar dentro da imagem.
#
Sintaxe
runner assets <subcomando> <app> [OPTIONS]
#
Subcomandos
| Subcomando |
O que faz |
list |
Lista os assets da app: categoria, source, mount, tamanho e se e required |
upload |
Copia arquivos locais pro asset dir — com chown automatico e validacao |
snapshot |
Tar de <app>/data — a primitiva de backup e de migracao entre servidores |
restore |
Restaura um tar em <app>/data (confirma antes de sobrescrever) |
clean |
Limpa o conteudo dos assets de cache, respeitando ttl como filtro de idade |
#
`list`
runner assets list myapp
runner assets list myapp -o json
#
`upload`
runner assets upload myapp --to poc/secrets /tmp/oauth.json
| Flag |
Obrigatorio |
Descricao |
--to <SOURCE> |
Sim |
Source do asset (ex.: poc/secrets) — precisa existir no manifesto |
Os arquivos sao caminhos no servidor, nao na sua maquina.
#
`snapshot`
runner assets snapshot myapp -f /tmp/myapp-assets.tar
| Flag |
Descricao |
-f, --file <FILE> |
Destino do tar |
#
`restore`
runner assets restore myapp -i /tmp/myapp-assets.tar --yes
| Flag |
Descricao |
-i, --input <FILE> |
Tar de origem |
--yes |
Pula a confirmacao de sobrescrita |
#
`clean`
runner assets clean myapp --yes
runner assets clean myapp --category cache --yes
| Flag |
Descricao |
--category <CATEGORY> |
Restringe a uma categoria de asset |
--yes |
Pula a confirmacao |
clean so mexe em assets de cache. Assets de dados nao sao limpos por ele — o
ttl declarado no manifesto entra como filtro de idade, nao como permissao.
#
Flags globais do grupo
| Flag |
Descricao |
-o, --output |
human | json | yaml |
--json |
DEPRECATED — use -o json. Removido na v3.0.0 |
--insecure |
Bypass dos guards de seguranca |
#
Migrar uma app entre servidores
# no servidor de origem
runner assets snapshot myapp -f /tmp/myapp-assets.tar
# no destino, depois de registrar a app
runner assets restore myapp -i /tmp/myapp-assets.tar --yes
#
Ver tambem
By
Borlot.com.br on 19/08/2026