registry/docs/storage-drivers/swift.md
Donald Huang eb654589db help converge disagreeing swift docs
Signed-off-by: Donald Huang <don.hcd@gmail.com>
2015-12-20 23:22:19 +00:00

4.1 KiB

OpenStack Swift storage driver

An implementation of the storagedriver.StorageDriver interface that uses OpenStack Swift for object storage.

Parameters

authurl

URL for obtaining an auth token.

username

Your OpenStack user name.

password

Your OpenStack password.

container

The name of your Swift container where you wish to store the registry's data. The driver creates the named container during its initialization.

tenant

Optionally, your OpenStack tenant name. You can either use tenant or tenantid.

tenantid

Optionally, your OpenStack tenant id. You can either use tenant or tenantid.

domain

Optionally, your OpenStack domain name for Identity v3 API. You can either use domain or domainid.

domainid

Optionally, your OpenStack domain id for Identity v3 API. You can either use domain or domainid.

trustid

Optionally, your OpenStack trust id for Identity v3 API.

insecureskipverify

Optionally, set insecureskipverify to true to skip TLS verification for your OpenStack provider. The driver uses false by default.

region

Optionally, specify the OpenStack region name in which you would like to store objects (for example fr).

chunksize

Optionally, specify the segment size for Dynamic Large Objects uploads (performed by WriteStream) to Swift. The default is 5 MB. You might experience better performance for larger chunk sizes depending on the speed of your connection to Swift.

prefix

Optionally, supply a prefix that will be applied to all Swift keys to allow you to segment data in your container if necessary. Defaults to the empty string which is the container's root.

secretkey

Optionally, the secret key used to generate temporary URLs.

accesskey

Optionally, the access key to generate temporary URLs. It is used by HP Cloud Object Storage in addition to the `secretkey` parameter.

The features supported by the Swift server are queried by requesting the /info URL on the server. In case the administrator disabled that feature, the configuration file can specify the following optional parameters :

tempurlcontainerkey

Specify whether to use container secret key to generate temporary URL when set to true, or the account secret key otherwise.

tempurlmethods

Array of HTTP methods that are supported by the TempURL middleware of the Swift server. Example:

- tempurlmethods: - GET - PUT - HEAD - POST - DELETE