canasta backup create

Create a backup

Synopsis

Create a backup snapshot. Dumps all wiki databases, stages config/extensions/images/skins/public_assets and the sidecars/ build contexts, and uploads to the repository.

A wiki whose data extends into a second database — Cargo's $wgCargoDBname being the usual case — declares it with canasta backup databases add.

Declared databases are dumped in the same invocation as the wiki's own, so both come from one transaction. That matters for Cargo, whose data tables live in the extra database while the metadata tracking them (cargo_pages) lives in the wiki database: captured at different moments, the metadata under-reports, and editing an affected page appends duplicate rows instead of replacing them.

If a wiki's databases cannot be dumped, the other wikis are still dumped and the snapshot is still saved, but it is tagged INCOMPLETE with a missing-db:<name> tag for each database it lacks, and the command exits non-zero naming each failed database and its error. A scheduled backup's purge therefore does not run.

canasta backup create [flags]

Examples

canasta backup create -t before-upgrade

Flags

Flag	Shorthand	Description	Default	Required	Orchestrator
`--tag`	`-t`	Backup tag		✓	Both
`--id`	`-i`	Canasta instance ID	*		Both

* Defaults to the Canasta instance matching the current directory, if any.

Global flags

Flag	Shorthand	Description	Default	Required	Orchestrator
`--help`	`-h`	Show help message and exit			Both
`--verbose`	`-v`	Enable verbose output			Both