From eb654589db4c34345d54c119d0a46372bea95e5a Mon Sep 17 00:00:00 2001 From: Donald Huang Date: Fri, 11 Dec 2015 00:02:50 +0000 Subject: [PATCH] help converge disagreeing swift docs Signed-off-by: Donald Huang --- docs/configuration.md | 102 +++++++++++++++++++++------------- docs/storage-drivers/swift.md | 4 +- 2 files changed, 64 insertions(+), 42 deletions(-) diff --git a/docs/configuration.md b/docs/configuration.md index 129f2e75..2cf2d967 100644 --- a/docs/configuration.md +++ b/docs/configuration.md @@ -384,6 +384,39 @@ If you are deploying a registry on Windows, be aware that a Windows volume mount mkdir /XXX protocol error and your registry will not function properly. +### Maintenance + +Currently upload purging and read-only mode are the only maintenance functions available. +These and future maintenance functions which are related to storage can be configured under +the maintenance section. + +### Upload Purging + +Upload purging is a background process that periodically removes orphaned files from the upload +directories of the registry. Upload purging is enabled by default. To +configure upload directory purging, the following parameters +must be set. + + +| Parameter | Required | Description + --------- | -------- | ----------- +`enabled` | yes | Set to true to enable upload purging. Default=true. | +`age` | yes | Upload directories which are older than this age will be deleted. Default=168h (1 week) +`interval` | yes | The interval between upload directory purging. Default=24h. +`dryrun` | yes | dryrun can be set to true to obtain a summary of what directories will be deleted. Default=false. + +Note: `age` and `interval` are strings containing a number with optional fraction and a unit suffix: e.g. 45m, 2h10m, 168h (1 week). + +### Read-only mode + +If the `readonly` section under `maintenance` has `enabled` set to `true`, +clients will not be allowed to write to the registry. This mode is useful to +temporarily prevent writes to the backend storage so a garbage collection pass +can be run. Before running garbage collection, the registry should be +restarted with readonly's `enabled` set to true. After the garbage collection +pass finishes, the registry may be restarted again, this time with `readonly` +removed from the configuration (or set to false). + ### delete Use the `delete` subsection to enable the deletion of image blobs and manifests @@ -698,39 +731,6 @@ This storage backend uses Amazon's Simple Storage Service (S3). -### Maintenance - -Currently upload purging and read-only mode are the only maintenance functions available. -These and future maintenance functions which are related to storage can be configured under -the maintenance section. - -### Upload Purging - -Upload purging is a background process that periodically removes orphaned files from the upload -directories of the registry. Upload purging is enabled by default. To -configure upload directory purging, the following parameters -must be set. - - -| Parameter | Required | Description - --------- | -------- | ----------- -`enabled` | yes | Set to true to enable upload purging. Default=true. | -`age` | yes | Upload directories which are older than this age will be deleted. Default=168h (1 week) -`interval` | yes | The interval between upload directory purging. Default=24h. -`dryrun` | yes | dryrun can be set to true to obtain a summary of what directories will be deleted. Default=false. - -Note: `age` and `interval` are strings containing a number with optional fraction and a unit suffix: e.g. 45m, 2h10m, 168h (1 week). - -### Read-only mode - -If the `readonly` section under `maintenance` has `enabled` set to `true`, -clients will not be allowed to write to the registry. This mode is useful to -temporarily prevent writes to the backend storage so a garbage collection pass -can be run. Before running garbage collection, the registry should be -restarted with readonly's `enabled` set to true. After the garbage collection -pass finishes, the registry may be restarted again, this time with `readonly` -removed from the configuration (or set to false). - ### Openstack Swift This storage backend uses Openstack Swift object storage. @@ -793,7 +793,7 @@ This storage backend uses Openstack Swift object storage. yes - The container name in which you want to store the registry's data. + The name of your Swift container where you wish to store the registry's data. The driver creates the named container during its initialization. @@ -804,7 +804,7 @@ This storage backend uses Openstack Swift object storage. no - Your Openstack tenant name. + Your Openstack tenant name. You can either use tenant or tenantid. @@ -815,7 +815,7 @@ This storage backend uses Openstack Swift object storage. no - Your Openstack tenant id. + Your Openstack tenant id. You can either use tenant or tenantid. @@ -826,7 +826,7 @@ This storage backend uses Openstack Swift object storage. no - Your Openstack domain name for Identity v3 API. + Your Openstack domain name for Identity v3 API. You can either use domain or domainid. @@ -837,7 +837,7 @@ This storage backend uses Openstack Swift object storage. no - Your Openstack domain id for Identity v3 API. + Your Openstack domain id for Identity v3 API. You can either use domain or domainid. @@ -875,13 +875,35 @@ This storage backend uses Openstack Swift object storage. - rootdirectory + 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. + 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. diff --git a/docs/storage-drivers/swift.md b/docs/storage-drivers/swift.md index b2f937da..ca17e9ff 100644 --- a/docs/storage-drivers/swift.md +++ b/docs/storage-drivers/swift.md @@ -49,7 +49,7 @@ An implementation of the `storagedriver.StorageDriver` interface that uses [Open

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

@@ -139,7 +139,7 @@ An implementation of the `storagedriver.StorageDriver` interface that uses [Open

- Optionally, supply the root directory tree in which to store all registry files. Defaults to the empty string which is the container's root.

+ 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.