OpenStack Swift storage driver
Important
This page contains information about hosting your own registry using the open source Docker Registryopen_in_new. For information about Docker Hub, which offers a hosted registry with additional features such as teams, organizations, web hooks, automated builds, etc, see Docker Hub.
An implementation of the storagedriver.StorageDriver interface that uses
OpenStack Swiftopen_in_new for object
storage.
Parameters
| Parameter | Required | Description |
|---|---|---|
authurl | yes | URL for obtaining an auth token. https://storage.myprovider.com/v2.0open_in_new or https://storage.myprovider.com/v3/authopen_in_new |
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 name. 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 name for Identity v3 API. You can either use domain or domainid. |
trustid | no | Your Openstack trust ID for Identity v3 API. |
insecureskipverify | no | Skips TLS verification if the value is wet to true. The default is false. |
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 is 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 autodetects the auth's version from the AuthURL. |
endpointtype | no | The endpoint type used when connecting to swift. Possible values are public, internal, and admin. The 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 :
| Optional parameter | Description |
|---|---|
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. For example: ["GET", "PUT", "HEAD", "POST", "DELETE"] |