openstack/openstack-manuals
Code Issues Proposed changes

Merge "[config-ref] update Object Storage container sync configuration"

Browse Source
This commit is contained in:
Jenkins 2016-08-08 04:46:07 +00:00 committed by Gerrit Code Review
commit 40d6bddde2
6 changed files with 29 additions and 28 deletions

1
doc/config-reference/source/object-storage.rst

@ -10,6 +10,7 @@ Object Storage service
object-storage/object-server.rst
object-storage/object-expirer.rst
object-storage/container-server.rst
object-storage/container-sync-realms.rst
object-storage/configure.rst
object-storage/features.rst
object-storage/configure-s3.rst

19
doc/config-reference/source/object-storage/configure.rst

@ -8,25 +8,6 @@ configurations. Default configuration options appear in the ``[DEFAULT]``
section. You can override the default values by setting values in the other
sections.
Container sync realms configuration
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Find an example container sync realms configuration at
``etc/container-sync-realms.conf-sample`` in the source code repository.
The available configuration options are:
.. include:: ../tables/swift-container-sync-realms-DEFAULT.rst
.. include:: ../tables/swift-container-sync-realms-realm1.rst
.. include:: ../tables/swift-container-sync-realms-realm2.rst
Sample container sync realms configuration file
-----------------------------------------------
.. remote-code-block:: ini
https://git.openstack.org/cgit/openstack/swift/plain/etc/container-sync-realms.conf-sample?h=stable/mitaka
Container reconciler configuration
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

19
doc/config-reference/source/object-storage/container-sync-realms.rst Normal file

@ -0,0 +1,19 @@
===================================
Container sync realms configuration
===================================
Find an example container sync realms configuration at
``etc/container-sync-realms.conf-sample`` in the source code repository.
The available configuration options are:
.. include:: ../tables/swift-container-sync-realms-DEFAULT.rst
.. include:: ../tables/swift-container-sync-realms-realm1.rst
.. include:: ../tables/swift-container-sync-realms-realm2.rst
Sample container sync realms configuration file
-----------------------------------------------
.. remote-code-block:: ini
https://git.openstack.org/cgit/openstack/swift/plain/etc/container-sync-realms.conf-sample?h=stable/mitaka

2
doc/config-reference/source/tables/swift-container-sync-realms-DEFAULT.rst

@ -10,4 +10,4 @@
* - Configuration option = Default value
- Description
* - ``mtime_check_interval`` = ``300``
- No help text available for this option.
- The number of seconds between checking the modified time of this config file for changes and therefore reloading it.

8
doc/config-reference/source/tables/swift-container-sync-realms-realm1.rst

@ -10,10 +10,10 @@
* - Configuration option = Default value
- Description
* - ``cluster_clustername1`` = ``https://host1/v1/``
- No help text available for this option.
- Any values in the realm section whose names begin with cluster\_ will indicate the name and endpoint of a cluster and will be used by external users in their containers' X-Container-Sync-To metadata header values with the format "realm_name/cluster_name/container_name". Realm and cluster names are considered case insensitive.
* - ``cluster_clustername2`` = ``https://host2/v1/``
- No help text available for this option.
- Any values in the realm section whose names begin with cluster\_ will indicate the name and endpoint of a cluster and will be used by external users in their containers' X-Container-Sync-To metadata header values with the format "realm_name/cluster_name/container_name". Realm and cluster names are considered case insensitive.
* - ``key`` = ``realm1key``
- No help text available for this option.
- The key is the overall cluster-to-cluster key used in combination with the external users' key that they set on their containers' X-Container-Sync-Key metadata header values. These keys will be used to sign each request the container sync daemon makes and used to validate each incoming container sync request.
* - ``key2`` = ``realm1key2``
- No help text available for this option.
- The key2 is optional and is an additional key incoming requests will be checked against. This is so you can rotate keys if you wish; you move the existing key to key2 and make a new key value.

8
doc/config-reference/source/tables/swift-container-sync-realms-realm2.rst

@ -10,10 +10,10 @@
* - Configuration option = Default value
- Description
* - ``cluster_clustername3`` = ``https://host3/v1/``
- No help text available for this option.
- Any values in the realm section whose names begin with cluster\_ will indicate the name and endpoint of a cluster and will be used by external users in their containers' X-Container-Sync-To metadata header values with the format "realm_name/cluster_name/container_name". Realm and cluster names are considered case insensitive.
* - ``cluster_clustername4`` = ``https://host4/v1/``
- No help text available for this option.
- Any values in the realm section whose names begin with cluster\_ will indicate the name and endpoint of a cluster and will be used by external users in their containers' X-Container-Sync-To metadata header values with the format "realm_name/cluster_name/container_name". Realm and cluster names are considered case insensitive.
* - ``key`` = ``realm2key``
- No help text available for this option.
- The key is the overall cluster-to-cluster key used in combination with the external users' key that they set on their containers' X-Container-Sync-Key metadata header values. These keys will be used to sign each request the container sync daemon makes and used to validate each incoming container sync request.
* - ``key2`` = ``realm2key2``
- No help text available for this option.
- The key2 is optional and is an additional key incoming requests will be checked against. This is so you can rotate keys if you wish; you move the existing key to key2 and make a new key value.