about summary refs log tree commit diff
path: root/.env.production.sample
diff options
context:
space:
mode:
authorPatrick Figel <patrick@figel.email>2017-09-11 15:11:13 +0200
committerEugen Rochko <eugen@zeonfederated.com>2017-09-11 15:11:13 +0200
commit3018043fc2b405e42070b49e965bc7a0a38ecf2a (patch)
treeab67cd7a674eed03236bfc9ce0aef8fbe911a3e0 /.env.production.sample
parentc2bee07dbc12c799f412a39a4d5499264baac81e (diff)
Add OpenStack Keystone V3 support (#4889)
Keystone V2 is deprecated in favour of V3. This adds the necessary
connection parameters for establishing a V3 connection. Connections
to V2 endpoints are still possible and the configuration should
remain compatible.

This also introduces a SWIFT_REGION variable for multi-region
OpenStack environments and a SWIFT_CACHE_TTL that controls how long
tokens and other meta-data is cached for. Caching tokens avoids
rate-limiting errors that would result in media uploads becoming
unavailable during high load or when using tasks like
media:remove_remote. fog-openstack only supports token caching for
V3 endpoints, so a recommendation for using V3 was added.
Diffstat (limited to '.env.production.sample')
-rw-r--r--.env.production.sample8
1 files changed, 8 insertions, 0 deletions
diff --git a/.env.production.sample b/.env.production.sample
index 3e054db84..e022a8405 100644
--- a/.env.production.sample
+++ b/.env.production.sample
@@ -101,11 +101,19 @@ SMTP_FROM_ADDRESS=notifications@example.com
 # Swift (optional)
 # SWIFT_ENABLED=true
 # SWIFT_USERNAME=
+# For Keystone V3, the value for SWIFT_TENANT should be the project name
 # SWIFT_TENANT=
 # SWIFT_PASSWORD=
+# Keystone V2 and V3 URLs are supported. Use a V3 URL if possible to avoid
+# issues with token rate-limiting during high load.
 # SWIFT_AUTH_URL=
 # SWIFT_CONTAINER=
 # SWIFT_OBJECT_URL=
+# SWIFT_REGION=
+# Defaults to 'default'
+# SWIFT_DOMAIN_NAME=
+# Defaults to 60 seconds. Set to 0 to disable
+# SWIFT_CACHE_TTL=
 
 # Optional alias for S3 if you want to use Cloudfront or Cloudflare in front
 # S3_CLOUDFRONT_HOST=