docker/services/README.rst

   1 ========
   2 services
   3 ========
   4
   5 A TripleO nested stack Heat template that encapsulates generic configuration
   6 data to configure a specific service. This generally includes everything
   7 needed to configure the service excluding the local bind ports which
   8 are still managed in the per-node role templates directly (controller.yaml,
   9 compute.yaml, etc.). All other (global) service settings go into
  10 the puppet/service templates.
  11
  12 Input Parameters
  13 ----------------
  14
  15 Each service may define its own input parameters and defaults.
  16 Operators will use the parameter_defaults section of any Heat
  17 environment to set per service parameters.
  18
  19 Config Settings
  20 ---------------
  21
  22 Each service may define a config_settings output variable which returns
  23 Hiera settings to be configured.
  24
  25 Steps
  26 -----
  27
  28 Each service may define an output variable which returns a puppet manifest
  29 snippet that will run at each of the following steps. Earlier manifests
  30 are re-asserted when applying latter ones.
  31
  32  * config_settings: Custom hiera settings for this service. These are
  33    used to generate configs.
  34
  35  * step_config: A puppet manifest that is used to step through the deployment
  36    sequence. Each sequence is given a "step" (via hiera('step') that provides
  37    information for when puppet classes should activate themselves.
  38
  39  * docker_compose:
  40
  41  * container_name:
  42
  43  * volumes:
  44
  45 Steps correlate to the following:
  46
  47    1) Service configuration generation with puppet.
  48
  49    2) Early Openstack Service setup (database init?)
  50
  51    3) Early containerized networking services startup (OVS)
  52
  53    4) Network configuration
  54
  55    5) General OpenStack Services
  56
  57    6) Service activation (Pacemaker)
  58
  59    7) Fencing (Pacemaker)
  60