distribution/docs/storage-drivers/swift.md
John Mulhausen 908a1f14f5 Converges titles to imperative-form, front-matter based, and sentence-case (#438)
Multiple title fixes, consistency fixes, convergence into metadata-based titles.
2016-11-04 15:38:40 -07:00

4.7 KiB

description keywords title
Explains how to use the OpenStack swift storage driver
registry, service, driver, images, storage, swift
OpenStack Swift storage driver

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

Parameters

Parameter Required Description
authurl yes URL for obtaining an auth token. https://storage.myprovider.com/v2.0 or https://storage.myprovider.com/v3/auth
username yes Your Openstack user name.
password yes Your Openstack password.
region no The Openstack region in which your container exists.
container yes 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 no Your Openstack tenant name. You can either use tenant or tenantid.
tenantid no Your Openstack tenant id. You can either use tenant or tenantid.
domain no Your Openstack domain name for Identity v3 API. You can either use domain or domainid.
domainid no Your Openstack domain id for Identity v3 API. You can either use domain or domainid.
trustid no Your Openstack trust id for Identity v3 API.
insecureskipverify no true to skip TLS verification, false by default.
chunksize no Size of the data segments for the Swift Dynamic Large Objects. This value should be a number (defaults to 5M).
prefix no This is 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 no The secret key used to generate temporary URLs.
accesskey no The access key to generate temporary URLs. It is used by HP Cloud Object Storage in addition to the `secretkey` parameter.
authversion no Specify the OpenStack Auth's version,for example 3. By default the driver will autodetect the auth's version from the AuthURL.
endpointtype no The endpoint type used when connecting to swift. Possible values are `public`, `internal` and `admin`. Default is `public`.

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