From 09d5d755ce57bbfe839533130b2d70e7f68eeac8 Mon Sep 17 00:00:00 2001 From: Luca Lorenzetto Date: Fri, 14 Apr 2017 13:48:52 +0200 Subject: [PATCH] Documentation for Support for external swift proxy Users may have an external swift proxy already available (i.e. radosgw from already existing ceph, or hardware appliance implementing swift proxy). With this change user may specify an environment file that registers the specified urls as endpoint for the object-store service. The internal swift proxy is left as unconfigured. Change-Id: I5f60f9cf321fcccdb9801f4678fd3cb922812548 Depends-On: I5e6f0a50f26d4296565f0433f720bfb40c5d2109 --- doc/source/advanced_deployment/backends.rst | 1 + .../advanced_deployment/swift_external.rst | 30 +++++++++++++++++++ 2 files changed, 31 insertions(+) create mode 100644 doc/source/advanced_deployment/swift_external.rst diff --git a/doc/source/advanced_deployment/backends.rst b/doc/source/advanced_deployment/backends.rst index fab009c6..86b72c68 100644 --- a/doc/source/advanced_deployment/backends.rst +++ b/doc/source/advanced_deployment/backends.rst @@ -14,3 +14,4 @@ OpenStack projects. ceph_external neutron_midonet domain_specific_ldap_backends + swift_external diff --git a/doc/source/advanced_deployment/swift_external.rst b/doc/source/advanced_deployment/swift_external.rst new file mode 100644 index 00000000..bd8101f8 --- /dev/null +++ b/doc/source/advanced_deployment/swift_external.rst @@ -0,0 +1,30 @@ +Use an external Ceph cluster with the Overcloud +=============================================== + +|project| supports use of an external Swift proxy already available to the +operator, that may need to configure at deploy time. + +This happens by enabling a particular environment file when deploying the +Overcloud, specifically `environments/swift-external.yaml`. + +In the environment file above user must adjust the parameters to fit +its setup by creating a custom environment file (i.e. +*~/my-swift-settings.yaml*):: + + parameter_defaults: + ExternalPublicUrl: 'http://swiftproxy:9024/v1/%(tenant_id)s' + ExternalInternalUrl: 'http://swiftproxy:9024/v1/%(tenant_id)s' + ExternalAdminUrl: 'http://swiftproxy:9024/v1/%(tenant_id)s' + ExternalSwiftUserTenant: 'service' + + +The user can create an environment file with the required settings +and add the files above to the deploy commandline:: + + openstack overcloud deploy --templates -e /usr/share/openstack-tripleo-heat-templates/environments/swift-external.yaml -e ~/my-swift-settings.yaml + +Once the deploy has succeeded, user has to complete the +configuration on the external swift proxy, configuring it to use the +keystone authentication provider. This environment files creates also +a service user called *swift* that can be used for this purpose. +