tripleo-heat-templates/puppet/services
Juan Antonio Osorio Robles f2e72352b1 Fix placement region setting
We were using a deprecated interfce to set this value. This uses the
correct one.

Closes-Bug: #1793665
Change-Id: Ib7717911aba3267f855ac6682b0144bfe92034fb
2018-10-04 15:58:50 +03:00
..
database ansible: replace yum module by package module when possible 2018-07-21 00:17:25 +00:00
disabled Check if openstack-glance-registry is enabled before stopping it. 2018-09-26 08:45:56 +02:00
logging ansible: replace yum module by package module when possible 2018-07-21 00:17:25 +00:00
messaging Use rabbitmq service principal in metadata settings 2018-05-17 09:39:14 +03:00
metrics Enable collectd to connect to metrics QDR 2018-08-14 14:22:13 +00:00
monitoring ansible: replace yum module by package module when possible 2018-07-21 00:17:25 +00:00
pacemaker Pacemaker-cinder-volume & pacemaker-cinder-backup log path fix 2018-09-19 10:52:04 +02:00
time Add host prep step for ntp time sync 2018-06-20 13:08:52 -06:00
README.rst trivialfix:fix a typo 2018-06-05 17:33:05 +08:00
aide.yaml ansible: replace yum module by package module when possible 2018-07-21 00:17:25 +00:00
aodh-api.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
aodh-base.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
aodh-evaluator.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
aodh-listener.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
aodh-notifier.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
apache.j2.yaml ansible: replace yum module by package module when possible 2018-07-21 00:17:25 +00:00
auditd.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
barbican-api.yaml ansible: replace yum module by package module when possible 2018-07-21 00:17:25 +00:00
barbican-backend-dogtag.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
barbican-backend-kmip.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
barbican-backend-pkcs11-crypto.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
barbican-backend-simple-crypto.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
ca-certs.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
ceilometer-agent-central.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
ceilometer-agent-compute.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
ceilometer-agent-ipmi.yaml ansible: replace yum module by package module when possible 2018-07-21 00:17:25 +00:00
ceilometer-agent-notification.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
ceilometer-base.yaml ceilometer: deprecation cleanup 2018-07-02 08:58:49 +02:00
certmonger-user.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
cinder-api.yaml Ensure Cinder has a default volume type 2018-08-06 12:06:44 -04:00
cinder-backend-dellemc-unity.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
cinder-backend-dellemc-vmax-iscsi.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
cinder-backend-dellemc-vnx.yaml storage_vnx_pool_name is incorrect for VNX cinder driver. 2018-06-26 17:44:28 +08:00
cinder-backend-dellemc-xtremio-iscsi.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
cinder-backend-dellps.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
cinder-backend-dellsc.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
cinder-backend-netapp.yaml Correct Cinder NetApp backend name parameter mapping 2018-06-30 14:01:10 -06:00
cinder-backend-nvmeof.yaml Remove step_config from NVMEoF cinder backend 2018-07-11 14:38:35 +00:00
cinder-backend-pure.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
cinder-backend-scaleio.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
cinder-backend-veritas-hyperscale.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
cinder-backup.yaml Fluentd: Set cinder-backup log path 2018-07-12 08:45:00 +02:00
cinder-base.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
cinder-hpelefthand-iscsi.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
cinder-scheduler.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
cinder-volume.yaml Replace hiera lookup for ceph::profile::params::fsid 2018-05-25 15:29:18 +02:00
congress.yaml ansible: replace yum module by package module when possible 2018-07-21 00:17:25 +00:00
container-image-prepare.j2.yaml Pass NeutronMechanismDrivers parameter to prepare 2018-09-25 13:52:45 +12:00
designate-api.yaml Remove references to logging_group 2018-08-29 13:43:30 +03:00
designate-base.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
designate-central.yaml Merge "Remove references to logging_group" 2018-09-19 08:01:19 +00:00
designate-mdns.yaml Merge "Remove references to logging_group" 2018-09-19 08:01:19 +00:00
designate-producer.yaml Remove references to logging_group 2018-08-29 13:43:30 +03:00
designate-sink.yaml Remove references to logging_group 2018-08-29 13:43:30 +03:00
designate-worker.yaml Don't configure BIND to listen on localhost 2018-09-28 14:24:52 -05:00
docker-registry.yaml Break out image prepare into its own "service" 2018-08-02 11:29:39 +12:00
docker.yaml Merge "Do undercloud container prepare in external_deploy_tasks" 2018-07-26 09:23:44 +00:00
ec2-api.yaml ansible: replace yum module by package module when possible 2018-07-21 00:17:25 +00:00
etcd.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
external-swift-proxy.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
glance-api.yaml Fixed wrong when condition in mounting staging location 2018-08-06 15:34:08 +05:30
gnocchi-api.yaml Add support to set cors config in gnocchi templates 2018-07-31 17:49:36 +00:00
gnocchi-base.yaml Add a way to override base path when file driver is used 2018-06-05 07:49:22 +02:00
gnocchi-metricd.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
gnocchi-statsd.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
haproxy-internal-tls-certmonger.j2.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
haproxy-public-tls-certmonger.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
haproxy-public-tls-inject.yaml Assert container's ssl cert exists before upgrade. 2018-08-06 10:58:00 +02:00
haproxy.yaml Only set ca_bundle for HAProxy if internal TLS enabled & fix mounts 2018-09-18 22:03:59 -04:00
heat-api-cfn.yaml heat-api-cfn fix log path 2018-08-28 10:40:49 +02:00
heat-api.yaml heat-api fix log path 2018-08-28 13:34:04 +02:00
heat-base.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
heat-engine.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
horizon.yaml use versioned keystone endpoint in OPENSTACK_KEYSTONE_URL 2018-06-20 10:05:27 -04:00
ironic-api.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
ironic-base.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
ironic-conductor.yaml Expose IronicImageDownloadSource as a parameter 2018-09-19 15:36:15 +02:00
ironic-inspector.yaml Enable inspector dnsmasq dhcp filter 2018-06-04 16:36:14 +02:00
ironic-neutron-agent.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
iscsid.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
keepalived.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
kernel.yaml Do not disable ipv6 on loopback interface for epmd 2018-07-04 05:47:19 -04:00
keystone.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
liquidio-compute-config.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
login-defs.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
manila-api.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
manila-backend-cephfs.yaml Unify the Manila HA and non-HA docker configurations 2018-07-12 11:23:39 -04:00
manila-backend-isilon.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
manila-backend-netapp.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
manila-backend-unity.yaml Fix for the manila backend configuration errors 2018-05-14 13:43:04 -05:00
manila-backend-vmax.yaml Fix for the manila backend configuration errors 2018-05-14 13:43:04 -05:00
manila-backend-vnx.yaml Fix for the manila backend configuration errors 2018-05-14 13:43:04 -05:00
manila-base.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
manila-scheduler.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
manila-share.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
masquerade-networks.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
memcached.yaml Activate memcached debug only when using MemcachedDebug param. 2018-06-18 12:18:52 +00:00
mistral-api.yaml Set allow_action_execution_deletion to true in mistral api config 2018-08-08 17:03:46 +05:30
mistral-base.yaml Allow a containerized mistral-executor to access docker 2018-06-20 10:17:01 +12:00
mistral-engine.yaml ansible: replace yum module by package module when possible 2018-07-21 00:17:25 +00:00
mistral-event-engine.yaml ansible: replace yum module by package module when possible 2018-07-21 00:17:25 +00:00
mistral-executor.yaml ansible: replace yum module by package module when possible 2018-07-21 00:17:25 +00:00
neutron-api.yaml Decoupling number of API and RPC workers for neutron-api 2018-08-14 16:21:39 +02:00
neutron-base.yaml Make vlan_transparent in neutron.conf configurable from Undercloud 2018-08-15 01:50:47 -04:00
neutron-bgpvpn-api.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
neutron-bgpvpn-bagpipe.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
neutron-bigswitch-agent.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
neutron-compute-plugin-midonet.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
neutron-compute-plugin-nuage.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
neutron-compute-plugin-plumgrid.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
neutron-dhcp.yaml Expose dnsmasq_local_resolv option 2018-07-09 20:01:58 +00:00
neutron-l2gw-agent.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
neutron-l2gw-api.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
neutron-l3-compute-dvr.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
neutron-l3.yaml Merge "Add compute node L3 agent container for DVR" 2018-05-14 23:37:11 +00:00
neutron-lbaas-agent.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
neutron-lbaas-api.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
neutron-linuxbridge-agent.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
neutron-metadata.yaml Remove deprecated value used to set nova_metadata_ip 2018-08-20 11:44:16 +02:00
neutron-midonet.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
neutron-ovs-agent.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
neutron-ovs-dpdk-agent.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
neutron-plugin-ml2-ansible.yaml Add networking-ansible ML2 plugin support 2018-07-02 13:22:04 +05:30
neutron-plugin-ml2-cisco-vts.yaml Add site id parameter to cisco vts ml2 template 2018-05-30 10:01:48 +00:00
neutron-plugin-ml2-fujitsu-cfab.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
neutron-plugin-ml2-fujitsu-fossw.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
neutron-plugin-ml2-mlnx-sdn-assist.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
neutron-plugin-ml2-nuage.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
neutron-plugin-ml2-odl.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
neutron-plugin-ml2-ovn.yaml ovn: Add dns_servers configuration support 2018-06-25 16:10:56 +05:30
neutron-plugin-ml2.yaml Allow setting physical network MTU via heat template 2018-07-23 15:31:29 +02:00
neutron-plugin-nsx.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
neutron-plugin-nuage.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
neutron-plugin-plumgrid.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
neutron-sfc-api.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
neutron-sriov-agent.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
neutron-sriov-host-config.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
neutron-vpp-agent.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
nova-api.yaml nova: add parameters to configure nova::cron::archive_deleted_rows 2018-07-29 03:42:16 +00:00
nova-base.yaml Fix placement region setting 2018-10-04 15:58:50 +03:00
nova-compute.yaml Merge "Instance create fails due to wrong default secontext with NFS" 2018-08-21 15:26:16 +00:00
nova-conductor.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
nova-consoleauth.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
nova-ironic.yaml Merge "Remove ironic_host_manager usage" 2018-05-30 09:38:23 +00:00
nova-libvirt-guests.yaml Add NovaResumeGuestsStateOnHostBoot and NovaResumeGuestsShutdownTimeout 2018-07-31 12:24:08 +02:00
nova-libvirt.yaml Use fqdn for live_migration_inbound_addr 2018-08-07 17:13:30 +01:00
nova-metadata.yaml Move nova-metadata api to httpd wsgi 2018-09-19 15:07:38 +02:00
nova-migration-target.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
nova-placement.yaml ansible: replace yum module by package module when possible 2018-07-21 00:17:25 +00:00
nova-scheduler.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
nova-vnc-proxy.yaml SSL support for haproxy -> novnc proxy connection 2018-08-09 08:20:42 +02:00
octavia-api.yaml Pass parameters for TLS proxy in front of Octavia-API 2018-09-01 11:28:30 +00:00
octavia-base.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
octavia-health-manager.yaml Add OctaviaEventStreamerDriver and change default 2018-08-17 17:35:37 +02:00
octavia-housekeeping.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
octavia-worker.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
opendaylight-api.yaml Merge "Delete deprecated parameters" 2018-06-28 18:15:43 +00:00
opendaylight-ovs.yaml Set OVS local ip through OVS ODL class 2018-08-28 13:11:37 +05:30
openvswitch.yaml Remove the OVS-DPDK deprecated parameters 2018-06-27 14:26:12 +05:30
ovn-controller.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
ovn-dbs.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
ovn-metadata.yaml Configure http/https on OVN Metadata service to talk to Nova 2018-09-28 15:12:21 +00:00
pacemaker.yaml Enable deep_compare of pcmk resources by default 2018-07-19 15:52:36 +02:00
pacemaker_remote.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
panko-api.yaml ansible: replace yum module by package module when possible 2018-07-21 00:17:25 +00:00
panko-base.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
podman.yaml Introduce OS::TripleO::Services::Podman 2018-10-02 01:47:46 +00:00
qdr.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
rabbitmq.yaml Add ERL args parameter for rabbit and set the busy wait threshold to none 2018-09-17 18:02:58 +02:00
sahara-api.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
sahara-base.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
sahara-engine.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
securetty.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
selinux.yaml Add SELinux management to containerized undercloud 2018-06-28 09:12:30 -06:00
snmp.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
sshd.yaml ssh: enable PasswordAuthentication for containerized undercloud 2018-06-03 01:49:26 +00:00
swift-base.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
swift-dispersion.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
swift-proxy.yaml Enable s3api by default 2018-05-29 17:46:00 -04:00
swift-ringbuilder.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
swift-storage.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
tacker.yaml ansible: replace yum module by package module when possible 2018-07-21 00:17:25 +00:00
tripleo-firewall.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
tripleo-packages.yaml Fix typo in ansible's module name. 2018-09-13 13:34:47 +02:00
tripleo-ui.yaml Remove references to logging_group 2018-08-29 13:43:30 +03:00
tripleo-validations.yaml Implement TripleoValidations composable service 2018-06-13 11:35:49 -07:00
tuned.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
veritas-hyperscale-controller.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
vpp.yaml Change template names to rocky 2018-05-09 08:28:42 +02:00
zaqar-api.yaml ansible: replace yum module by package module when possible 2018-07-21 00:17:25 +00:00

README.rst

services

A TripleO nested stack Heat template that encapsulates generic configuration data to configure a specific service. This generally includes everything needed to configure the service excluding the local bind ports which are still managed in the per-node role templates directly (controller.yaml, compute.yaml, etc.). All other (global) service settings go into the puppet/service templates.

Input Parameters

Each service may define its own input parameters and defaults. Operators will use the parameter_defaults section of any Heat environment to set per service parameters.

Apart from sevice specific inputs, there are few default parameters for all the services. Following are the list of default parameters:

  • ServiceData: Mapping of service specific data. It is used to encapsulate all the service specific data. As of now, it contains net_cidr_map, which contains the CIDR map for all the networks. Additional data will be added as and when required.

  • ServiceNetMap: Mapping of service_name -> network name. Default mappings for service to network names are defined in ../network/service_net_map.j2.yaml, which may be overridden via ServiceNetMap values added to a user environment file via parameter_defaults.

  • EndpointMap: Mapping of service endpoint -> protocol. Contains a mapping of endpoint data generated for all services, based on the data included in ../network/endpoints/endpoint_data.yaml.

  • DefaultPasswords: Mapping of service -> default password. Used to pass some passwords from the parent templates, this is a legacy interface and should not be used by new services.

  • RoleName: Name of the role on which this service is deployed. A service can be deployed in multiple roles. This is an internal parameter (should not be set via environment file), which is fetched from the name attribute of the roles_data.yaml template.

  • RoleParameters: Parameter specific to a role on which the service is applied. Using the format "<RoleName>Parameters" in the parameter_defaults of user environment file, parameters can be provided for a specific role. For example, in order to provide a parameter specific to "Compute" role, below is the format:

    parameter_defaults:
      ComputeParameters:
        Param1: value

Config Settings

Each service may define three ways in which to output variables to configure Hiera settings on the nodes.

  • config_settings: the hiera keys will be pushed on all roles of which the service is a part of.
  • global_config_settings: the hiera keys will be distributed to all roles
  • service_config_settings: Takes an extra key to wire in values that are defined for a service that need to be consumed by some other service. For example: service_config_settings: haproxy: foo: bar This will set the hiera key 'foo' on all roles where haproxy is included.

Deployment Steps

Each service may define an output variable which returns a puppet manifest snippet that will run at each of the following steps. Earlier manifests are re-asserted when applying latter ones.

  • config_settings: Custom hiera settings for this service.

  • global_config_settings: Additional hiera settings distributed to all roles.

  • step_config: A puppet manifest that is used to step through the deployment sequence. Each sequence is given a "step" (via hiera('step') that provides information for when puppet classes should activate themselves.

    Steps correlate to the following:

    1. Load Balancer configuration
    2. Core Services (Database/Rabbit/NTP/etc.)
    3. Early Openstack Service setup (Ringbuilder, etc.)
    4. General OpenStack Services
    5. Service activation (Pacemaker)

It is also possible to use Mistral actions or workflows together with a deployment step, these are executed before the main configuration run. To describe actions or workflows from within a service use:

  • workflow_tasks: One or more workflow task properties

which expects a map where the key is the step and the value a list of dictionaries descrbing each a workflow task, for example:

workflow_tasks:
  step2:
    - name: echo
      action: std.echo output=Hello
  step3:
    - name: external
      workflow: my-pre-existing-workflow-name
      input:
        workflow_param1: value
        workflow_param2: value

The Heat guide for the OS::Mistral::Workflow task property has more details about the expected dictionary.

  • external_deploy_tasks: Ansible tasks to be run each step on the undercloud where a variable "step" is provided to enable conditionally running tasks at a given step.
  • external_post_deploy_tasks: Ansible tasks to be run on the undercloud after all other deploy steps have completed.

Batch Upgrade Steps (deprecated)

Note: the upgrade_batch_tasks are no longer used and deprecated for Queens. The information below applies to upgrade_batch_tasks as they were used for the Ocata major upgrade. The upgrade_batch_tasks were used exclusively by the ceph services and for Pike ceph is now configured by ceph-ansible.

Each service template may optionally define a upgrade_batch_tasks key, which is a list of ansible tasks to be performed during the upgrade process.

Similar to the step_config, we allow a series of steps for the per-service upgrade sequence, defined as ansible tasks with a tag e.g "step1" for the first step, "step2" for the second, etc (currently only two steps are supported, but more may be added when required as additional services get converted to batched upgrades).

Note that each step is performed in batches, then we move on to the next step which is also performed in batches (we don't perform all steps on one node, then move on to the next one which means you can sequence rolling upgrades of dependent services via the step value).

The tasks performed at each step is service specific, but note that all batch upgrade steps are performed before the upgrade_tasks described below. This means that all services that support rolling upgrades can be upgraded without downtime during upgrade_batch_tasks, then any remaining services are stopped and upgraded during upgrade_tasks

The default batch size is 1, but this can be overridden for each role via the upgrade_batch_size option in roles_data.yaml

Update Steps

Each service template may optionally define a update_tasks key, which is a list of ansible tasks to be performed during the minor update process. These are executed in a rolling manner node-by-node.

We allow a series of steps for the per-service update sequence via conditionals referencing a step variable e.g when: step|int == 2.

Pre-upgrade Rolling Steps

Each service template may optionally define a pre_upgrade_rolling_tasks key, which is a list of ansible tasks to be performed before the main upgrade phase, and these tasks are executed in a node-by-node rolling manner on the overcloud, similarly as update_tasks.

Upgrade Steps

Each service template may optionally define a upgrade_tasks key, which is a list of ansible tasks to be performed during the upgrade process.

Similar to the update_tasks, we allow a series of steps for the per-service upgrade sequence, defined as ansible tasks with a "when: step|int == 1" for the first step, "== 2" for the second, etc.

Steps correlate to the following:

  1. Perform any pre-upgrade validations.
  2. Stop the control-plane services, e.g disable LoadBalancer, stop pacemaker cluster and stop any managed resources. The exact order is controlled by the cluster constraints.
  3. Perform a package update and install new packages: A general upgrade is done, and only new package should go into service ansible tasks.
  4. Start services needed for migration tasks (e.g DB)
  5. Perform any migration tasks, e.g DB sync commands

Note that the services are not started in the upgrade tasks - we instead re-run puppet which does any reconfiguration required for the new version, then starts the services.

Nova Server Metadata Settings

One can use the hook of type OS::TripleO::ServiceServerMetadataHook to pass entries to the nova instances' metadata. It is, however, disabled by default. In order to overwrite it one needs to define it in the resource registry. An implementation of this hook needs to conform to the following:

  • It needs to define an input called RoleData of json type. This gets as input the contents of the role_data for each role's ServiceChain.
  • This needs to define an output called metadata which will be given to the Nova Server resource as the instance's metadata.