Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

backup upload-artifact

把已经生成好的备份文件上传到对象存储。

Command Format:

peppykeep backup upload-artifact --input-file <FILE> [--apply] [--config-home <DIR>]

Description

  • --input-file <FILE>:本地已有备份文件路径,通常为 *.ppke。
  • --apply:真正执行上传;默认只输出检查信息。
  • --config-home<DIR>: configuration directory.

Behaviour description

  • 不带 --apply 时,输出 bucket 和远端 key。
  • 带 --apply 时,读取 bak.toml 中的 [object_storage] 配置并执行上传。
  • 远端 key 默认按 prj_key/文件名 生成。
  • [object_storage].prefix 非空时,远端 key 为 prefix/prj_key/文件名。

Dependent Configuration

  • bak.toml 中的 [object_storage]
  • prj.toml 中的 local.prj_key

Usage Sample

peppykeep backup upload-artifact --input-file /path/to/user/bak_u2/u2/u2-bak_2026_03_20_12_00_00.ppke --config-home /path/to/user/.peppykeep/u2-tmp
peppykeep backup upload-artifact --apply --input-file /path/to/user/bak_u2/u2/u2-bak_2026_03_20_12_00_00.ppke --config-home /path/to/user/.peppykeep/u2-tmp

与 backup run 的配合

需要先在本地生成文件、再单独上传时:

peppykeep backup run --apply --config-home /path/to/user/.peppykeep/u2-tmp --no-upload
peppykeep backup upload-artifact --apply --input-file /path/to/user/bak_u2/u2/你的文件名.ppke --config-home /path/to/user/.peppykeep/u2-tmp