This library arose during the development of Backup & Restore for the Blueprint-Service as part of the Service Fabrik‘s Backup & Restore offering. It can be used for two IaaS providers, Amazon Web Services and OpenStack, as it abstracts some basic functionalities, like volume creation/deletion/attaching/detaching, by implementing provider-specific clients.
However, for local development also a BOSH-Lite Client is provided which allows speeding up the development process before actually testing the scripts on real infrastructure providers. Service teams may like to use the library to avoid implementing the same features from scratch during their service-specific Backup & Restore development.
The following features are exposed:
- Abstraction of the underlying IaaS provider
- Implicit waiting for operations to be finished before further processing
- Implicit retry logic to catch briefly occurring infrastructure problems
- Reliable clean-up of created resources to avoid orphans (in case of errors)
- Proper exception handling in case of errors
- Enabling easy and transparent backup & restore implementations
You need to have Python3 as well as pip3 installed. pip3 is used for the installation of the library’s dependencies. Please find further details on links given.
Assuming, your working directory is ~/workspace/my_service:
Most likely your working directory is already a git repository so that you may want to add this repository as submodule:
$ cd ~/workspace/my_service
$ git submodule add https://github.com/SAP/service-fabrik-backup-restore.git service_fabrik_backup_restore
Otherwise, just clone this repository (assuming your working directory is ~/workspace/my_service:
$ cd ~/workspace/my_service
$ git clone https://github.com/SAP/service-fabrik-backup-restore.git service_fabrik_backup_restore
pip3 is the PyPa recommended tool for installing Python packages:
$ cd ~/workspace/my_service/service_fabrik_backup_restore
$ pip3 install -r requirements.txt
Basically, you have to create a new file, e.g. backup.py, and import the Backup & Restore library:
$ cd ~/workspace/my_service
$ touch backup.py
Within the backup.py, put this line at the top of the file:
from service_fabrik_backup_restore import create_iaas_client, parse_options
Now you can start implementing the backup / restore for your service and take advantage of this library’s functionalities.
If you need any support, have any question or have found a bug, please report it in the GitHub bug tracking system. We shall get back to you.
This project is licensed under the Apache Software License, v. 2 except as noted otherwise in the LICENSE file