Gestão de dados no Bun
O deployment do Bun mantém seu banco de dados SQLite em $GMPAY_DATA_DIR/gmpay.sqlite e os objetos privados no diretório $GMPAY_DATA_DIR/objects. Tanto a CLI (interface de linha de comando) quanto o servidor de aplicação são executados utilizando o Bun e seu driver SQLite.
Backup e restauração
Pare de executar o contêiner GMPay Edge antes de fazer backup ou restauração, para garantir que o banco de dados e os arquivos de objeto permaneçam no mesmo ponto lógico de tempo.
GMPAY_DATA_DIR=/srv/gmpay bun run data -- backup --output /srv/backups/gmpay-backup
GMPAY_DATA_DIR=/srv/gmpay-restored bun run data -- restore --input /srv/backups/gmpay-backupA imagem publicada contém o mesmo CLI. Após interromper o serviço, monte um diretório de backup externo e execute:
docker compose stop gmpay-edge
docker compose run --rm --no-deps \
--volume "$PWD/backups:/backups" \
gmpay-edge bun run data -- backup --output /backups/gmpay-backupO caminho de entrada ou de saída é sempre explícito. As cópias de segurança da saída devem estar fora do diretório de dados. A restauração aceita apenas um novo ou diretório vazio, e nunca sobrescreve um diretório não vazio. O manifesto verifica todos os arquivos; a restauração também executa verificações de integridade, chaves estrangeiras e checksums de migrações.
As cópias de segurança contêm credenciais, dados de usuário, registros de pagamentos e uploads privados. Criptografe-os em repouso, limite o acesso e teste a restauração regularmente.
Importar exportação do Cloudflare
Exporte o D1 como SQL e exporte os objetos R2 para um diretório local, utilizando os caminhos relativos originais dos objetos como base. Em seguida, importe para um novo ou diretório de dados Bun:
wrangler d1 export DB --remote --output ./d1-export.sql
GMPAY_DATA_DIR=/srv/gmpay bun run data -- import-cloudflare \
--d1-sql ./d1-export.sql \
--r2-dir ./r2-export \
--r2-manifest ./r2-metadata.json--r2-dir é opcional quando a instância não possui objetos. --r2-manifest também é opcional, mas requer --r2-dir; utilize-o para preservar os metadados HTTP do R2 e os metadados personalizados. É um objeto JSON, indexado pela chave original do objeto R2.
{
"evidence/receipt.txt": {
"httpMetadata": {
"contentType": "text/plain; charset=utf-8",
"cacheExpiry": "2026-09-01T00:00:00.000Z"
},
"customMetadata": { "orderId": "order-123" }
}
}Os campos HTTP suportados são contentType, contentLanguage, contentDisposition, contentEncoding, cacheControl e um ISO 8601 cacheExpiry. Campos não suportados, metadados personalizados não-string e chaves de manifesta sem um objeto exportado correspondente são rejeitados. Sem este “sidecar”, os bytes do objeto e as chaves são importados, mas os metadados R2 não podem ser reconstruídos.
A import verifica se todas as migrações do repositório existem na exportação D1, registra seus checksums para o executador de migração Bun, valida as chaves estrangeiras e converte os caminhos de chaves R2 para o layout de objetos privados criptografados. Ela se recusa a um alvo vazio, portanto, uma importação malsucedida ou repetida não pode sobrescrever uma instância existente.