`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