openstack-helm/doc/source/devref/oslo-config.rst
Pete Birley 75ecf8fdf4 Gotpl: remove quote and trunc to suppress output
This PS removes the use of the `quote and truncate` approach to
suppress output from gotpl actions in templates and replaces it
with the recommended practice of defining `$_` instead.

Change-Id: I5f35c5f7e70b4f7f461d772e3b72ed1c695c56a8
Signed-off-by: Pete Birley <pete@port.direct>
2018-06-16 18:52:13 +00:00

3.5 KiB

OSLO-Config Values

OpenStack-Helm generates oslo-config compatible formatted configuration files for services dynamically from values specified in a yaml tree. This allows operators to control any and all aspects of an OpenStack services configuration. An example snippet for an imaginary Keystone configuration is described here:

conf:
  keystone:
    DEFAULT: # Keys at this level are used for section headings
      max_token_size: 255
    token:
      provider: fernet
    fernet_tokens:
      key_repository: /etc/keystone/fernet-keys/
    credential:
      key_repository: /etc/keystone/credential-keys/
    database:
      max_retries: -1
    cache:
      enabled: true
      backend: dogpile.cache.memcached
    oslo_messaging_notifications:
      driver: # An example of a multistring option's syntax
        type: multistring
        values:
          - messagingv2
          - log
    security_compliance:
      password_expires_ignore_user_ids:
      # Values in a list will be converted to a comma separated key
        - "123"
        - "456"

This will be consumed by the templated configmap-etc.yaml manifest to produce the following config file:

---
# Source: keystone/templates/configmap-etc.yaml
apiVersion: v1
kind: ConfigMap
metadata:
  name: keystone-etc
data:
  keystone.conf: |
    [DEFAULT]
    max_token_size = 255
    transport_url = rabbit://keystone:password@rabbitmq.default.svc.cluster.local:5672/openstack
    [cache]
    backend = dogpile.cache.memcached
    enabled = true
    memcache_servers = memcached.default.svc.cluster.local:11211
    [credential]
    key_repository = /etc/keystone/credential-keys/
    [database]
    connection = mysql+pymysql://keystone:password@mariadb.default.svc.cluster.local:3306/keystone
    max_retries = -1
    [fernet_tokens]
    key_repository = /etc/keystone/fernet-keys/
    [oslo_messaging_notifications]
    driver = messagingv2
    driver = log
    [security_compliance]
    password_expires_ignore_user_ids = 123,456
    [token]
    provider = fernet

Note that some additional values have been injected into the config file, this is performed via statements in the configmap template, which also calls the helm-toolkit.utils.to_oslo_conf to convert the yaml to the required layout:

{{- if empty .Values.conf.keystone.database.connection -}}
{{- $_ := tuple "oslo_db" "internal" "user" "mysql" . | include "helm-toolkit.endpoints.authenticated_endpoint_uri_lookup"| set .Values.conf.keystone.database "connection" -}}
{{- end -}}

{{- if empty .Values.conf.keystone.DEFAULT.transport_url -}}
{{- $_ := tuple "oslo_messaging" "internal" "user" "amqp" . | include "helm-toolkit.endpoints.authenticated_endpoint_uri_lookup" | set .Values.conf.keystone.DEFAULT "transport_url" -}}
{{- end -}}

{{- if empty .Values.conf.keystone.cache.memcache_servers -}}
{{- $_ := tuple "oslo_cache" "internal" "memcache" . | include "helm-toolkit.endpoints.host_and_port_endpoint_uri_lookup" | set .Values.conf.keystone.cache "memcache_servers" -}}
{{- end -}}

---
apiVersion: v1
kind: ConfigMap
metadata:
  name: keystone-etc
data:
  keystone.conf: |
{{ include "helm-toolkit.utils.to_oslo_conf" .Values.conf.keystone | indent 4 }}
{{- end }}