Skip to main content

hivepaas backup

An app's data backups: snapshots of its volumes, made by its data backup jobs into backup repositories. A snapshot is given by its id or short id, as ls shows them.

hivepaas backup [command]

Aliases: backup, backups

hivepaas backup download​

Write the file at PATH of a snapshot to -O FILE - by default PATH's last part, here - or with -O - to stdout. A file that is there is replaced with --force alone, once the whole file has come.

hivepaas backup download SNAPSHOT PATH [flags]

Flags:

FlagDescription
--forcereplace the file when it exists
-O, --output-file stringthe file to write; - for stdout

hivepaas backup files​

List what a snapshot holds, at a path

hivepaas backup files SNAPSHOT [PATH]

hivepaas backup ls​

List an app's snapshots, the newest first

hivepaas backup ls [flags]

Flags:

FlagDescription
--repo stringonly the snapshots of this backup repository

hivepaas backup restore​

Write a snapshot back into an app's volume - where its job backed it up, when the data goes back into the app it came from - and wait for the task, following its log. replace, the mode by default, makes the directory what it was, the old one kept aside, the app stopped during it; overwrite writes over what is there. It changes data: asked at a terminal, --yes elsewhere.

hivepaas backup restore SNAPSHOT [flags]

Examples:

hivepaas backup restore a1b2c3d4
hivepaas backup restore a1b2c3d4 --to api-staging --volume data --subpath uploads --yes

Flags:

FlagDescription
--mode stringreplace or overwrite (default: replace)
--no-waitstart the restore and return
--path stringa directory of the snapshot to restore alone
--stop-appstop the app during an overwrite, start it after; replace always does
--subpath stringwhere in the volume
--timeout durationhow long to wait for it (default: 2h0m0s)
--to stringanother app of the environment to write into
--volume stringthe volume to write into, by name or id
-y, --yesdo not ask: for a script

hivepaas backup rm​

Delete a snapshot from its repository

hivepaas backup rm SNAPSHOT [flags]

Flags:

FlagDescription
-y, --yesdo not ask: for a script

hivepaas backup run​

Run one of the app's data backup jobs now, and wait for it as job run does: the app's one data backup job when it has one, else the one JOB names.

hivepaas backup run [JOB] [flags]

Flags:

FlagDescription
--no-waitstart the run and return
--timeout durationhow long to wait for the run (default: 30m0s)

The global flags apply to every command.