backup2swift is backup data to OpenStack Swift

This tool is that backup data to OpenStack Swift. provides features are command line interface, and backup rotatition. This tool is depend on swiftsc, that is simple client library of OpenStack Swift.

Requirements

Python 2.6 or Python 3.2
swiftsc 0.2 later

Setup

$ git clone https://github.com/mkouhei/backup2swift
$ cd backup2swift
$ sudo python setup.py install

or via PyPI:

$ virtualenv --no-site-packages venv
$ pip install backup2swift

Usage

Firstly setup configuration file. You may save the file name of your choice as setting. Example is as folloing:

[swift]
auth_url: https://example.org/auth/v1.0
username: username
password: password

[backup]
rotate_limit: 10

The “auth_url” is swift authentication url, “username” and “password” are swift’s. “rotate_limit” is limitation count of rotation for backup. If this value is 3, backup is as folloing;

backup target file name: example.txt

Firstly backup object is created as same name of backup target file (that is “example.txt”):

$ bu2sw -c bu2sw.conf -p example.txt
$ bu2sw -c bu2sw.conf -l
example.txt

Secondly backup object is created as same name of backup target file, and first backup object is renamed added timestamp as “example.txt_YYYYMMDD-hhmmss”.:

$ bu2sw -c bu2sw.conf -p example.txt
$ bu2sw -c bu2sw.conf -l
example.txt
example.txt_20130510-113930

Backup objects named with timestamp are created until “rotate_limit” value. Old backup object is remove when execute backup over limitation.:

$ bu2sw -c bu2sw.conf -p example.txt
$ bu2sw -c bu2sw.conf -l
example.txt
example.txt_20130510-113930
example.txt_20130510-113941
example.txt_20130510-113953
$ bu2sw -c bu2sw.conf -p example.txt
$ bu2sw -c bu2sw.conf -l
example.txt
example.txt_20130510-113941
example.txt_20130510-113953
example.txt_20130510-114110

Contribute

Firstly copy pre-commit hook script.:

$ cp -f utils/pre-commit.txt .git/hooks/pre-commit

Next install python2.6 later, and python-swiftsc, py.test. Below in Debian GNU/Linux Sid system,:

$ sudo apt-get install python python-swiftsc python-pytest pep8

Then checkout ‘devel’ branch for development, commit your changes. Before pull request, execute git rebase.

ToDo

create documents
add unit test

History

0.2 (2012-05-10)

add backup object command
fixes man manual

0.1.3 (2012-05-10)

applied changing api of swiftsc.client.is_container()
add how to setup and usage

0.1.2 (2012-05-09)

fixes #3 failed to execute in python2.6

0.1.1 (2012-05-08)

fixes #1 fail to execute firstly when there is no container

0.1 (2012-05-08)

first release

Metadata

Release files for backup2swift 0.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for backup2swift 0.2
File	Size	Uploaded
backup2swift-0.2.tar.gz	22.5 kB	May 10, 2013	Details

Release files / backup2swift-0.2.tar.gz

Download URL	backup2swift-0.2.tar.gz
Size	22.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`87b01abe1b774120c9c3066a42571f58f652c446fad79c2e6fcfc2f6ff5eefec`
BLAKE2b-256 checksum How to use checksums	`e07d8d924ec8268bd135c92342ac7884b22803da2096973473f5db39eb699697`
Upload date	May 10, 2013
Uploaded using Trusted Publishing? What is trusted publishing?	No