swift

Documentation

Overview

The `swift` plugin for SHIELD is intended to be a back-end storage plugin, wrapping OpenStack Swift.

PLUGIN FEATURES

This plugin implements functionality suitable for use with the following SHIELD Job components:

Target: no
Store:  yes

PLUGIN CONFIGURATION

The endpoint configuration passed to this plugin is used to determine how to connect to S3, and where to place/retrieve the data once connected. your endpoint JSON should look something like this:

{
    "auth_url":      "host",
    "project_name":  "openstack-project",
    "username":      "your-username",
    "password":      "secret-access-key",
    "container":     "bucket-name",
    "prefix":        "/path/inside/bucket/to/place/backup/data",
    "debug":         false
}

Default Configuration

{
    "prefix" : "",
    "debug"  : false
}

STORE DETAILS

When storing data, this plugin connects to the Swift service, and uploads the data into the specified container, using a path/filename with the following format:

<prefix>/<YYYY>/<MM>/<DD>/<HH-mm-SS>-<UUID>

Upon successful storage, the plugin then returns this filename to SHIELD to use as the `store_key` when the data needs to be retrieved, or purged.

RETRIEVE DETAILS

When retrieving data, this plugin connects to the Swift service, and retrieves the data located in the specified container, identified by the `store_key` provided by SHIELD.

PURGE DETAILS

When purging data, this plugin connects to the Swift service, and deletes the data located in the specified container, identified by the `store_key` provided by SHIELD.

DEPENDENCIES

None.