# runner export

Exporta o manifest, o fingerprint do ckey e os metadados de uma app como um bundle portavel. Opcionalmente inclui os segredos selados para transferencia segura entre servidores ou clientes.

Use quando: voce precisa migrar uma app para outro servidor, entregar a configuracao para um cliente, ou criar um backup portavel do estado da app. Ver guia de migracao em recuperar/restaurar-em-novo-servidor.md.

# Sintaxe

runner export --project <PROJECT> [flags]

# Flags

# Exemplos

# Export basico (manifest + metadados)

runner export --project cdn-front

Saida em formato human:

project:       cdn-front
version:       v2.4.1
ckey_fingerprint: 3a7f...c91e
manifest_hash: d84e...b201
exported_at:   2026-05-27T14:30:00Z

# Export com segredos selados

runner export --project cdn-front --include-secrets-sealed

O bundle inclui o arquivo .runner/secrets.enc selado com a ckey da app. O receptor precisa da ckey para decriptar os segredos no servidor de destino.

# Export em JSON para automacao

runner export --project cdn-front --json

{
  "project": "cdn-front",
  "version": "v2.4.1",
  "ckey_fingerprint": "3a7f...c91e",
  "manifest_hash": "d84e...b201",
  "exported_at": "2026-05-27T14:30:00Z",
  "secrets_sealed": false
}

# Seguranca dos segredos

O flag --include-secrets-sealed exporta segredos ainda cifrados (AES-256-GCM). O blob so pode ser decriptado com a ckey original da app — o transporte e seguro mesmo por canais nao criptografados. Nunca inclua segredos em bundles compartilhados publicamente.

# Erros comuns

• project not found — O nome passado em --project nao corresponde a nenhum projeto registrado; verifique com runner list.
• no secrets file found — Usado --include-secrets-sealed em uma app sem .runner/secrets.enc; a app pode ter sido registrada sem ckey.