cinder.backup.driver module¶
Base class for all backup drivers.
- class BackupDriver(context)¶
Bases:
cinder.db.base.Base
- abstract backup(backup, volume_file, backup_metadata=False)¶
Start a backup of a specified volume.
Some I/O operations may block greenthreads, so in order to prevent starvation parameter volume_file will be a proxy that will execute all methods in native threads, so the method implementation doesn’t need to worry about that..
- check_for_setup_error()¶
Method for checking if backup backend is successfully installed.
- abstract delete_backup(backup)¶
Delete a saved backup.
- export_record(backup)¶
Export driver specific backup record information.
If backup backend needs additional driver specific information to import backup record back into the system it must overwrite this method and return it here as a dictionary so it can be serialized into a string.
Default backup driver implementation has no extra information.
- Parameters
backup – backup object to export
- Returns
driver_info - dictionary with extra information
- get_metadata(volume_id)¶
- import_record(backup, driver_info)¶
Import driver specific backup record information.
If backup backend needs additional driver specific information to import backup record back into the system it must overwrite this method since it will be called with the extra information that was provided by export_record when exporting the backup.
Default backup driver implementation does nothing since it didn’t export any specific data in export_record.
- Parameters
backup – backup object to export
driver_info – dictionary with driver specific backup record information
- Returns
nothing
- put_metadata(volume_id, json_metadata)¶
- abstract restore(backup, volume_id, volume_file, volume_is_new)¶
Restore a saved backup.
Some I/O operations may block greenthreads, so in order to prevent starvation parameter volume_file will be a proxy that will execute all methods in native threads, so the method implementation doesn’t need to worry about that..
May raise BackupRestoreCancel to indicate that the restoration of a volume has been aborted by changing the backup status.
- class BackupMetadataAPI(context)¶
Bases:
cinder.db.base.Base
- TYPE_TAG_VOL_BASE_META = 'volume-base-metadata'¶
- TYPE_TAG_VOL_GLANCE_META = 'volume-glance-metadata'¶
- TYPE_TAG_VOL_META = 'volume-metadata'¶
- get(volume_id)¶
Get volume metadata.
Returns a json-encoded dict containing all metadata and the restore version i.e. the version used to decide what actually gets restored from this container when doing a backup restore.
- put(volume_id, json_metadata)¶
Restore volume metadata to a volume.
The json container should contain a version that is supported here.