Chapter 6. Deployment
At this point, you should have already configured the necessary settings to mitigate resource contention between colocated Compute and Ceph Storage services (as described in Chapter 4, Configuring Resource Isolation on Hyper-Converged Nodes).
Before you proceed, ensure that:
You are using a separate base environment file (or set of files) for all other Ceph settings. Both sections assume that you are using the same
/home/stack/templates/storage-config.yamlfile from Customizing the Storage Service and Sample Environment File: Creating a Ceph Cluster (both sections from Deploying an Overcloud with Containerized Red Hat Ceph).
/home/stack/templates/storage-config.yamlenvironment file also defines how many nodes you are assigning to each role. For related information on this, see Assigning Nodes and Flavors to Roles (also from Deploying an Overcloud with Containerized Red Hat Ceph).
Red Hat recommends not to enable Instance HA by default for hyperconverged OpenStack deployments with Ceph (RHHI-C). It is possible to enable Instance HA with hyperconverged OpenStack deployments with Ceph provided that Red Hat reviews the configuration and that a support exception is filed. Please contact your Red Hat representative if you wish to use Instance HA with hyperconverged OpenStack deployments with Ceph.
To deploy your overcloud, run the following command:
$ openstack overcloud deploy --templates \ -p /usr/share/openstack-tripleo-heat-templates/plan-samples/plan-environment-derived-params.yaml \ -r /home/stack/templates/roles_data.yaml \ -e /home/stack/templates/ports.yaml -e /home/stack/templates/environment-rhel-registration.yaml -e /usr/share/openstack-tripleo-heat-templates/environments/ceph-ansible/ceph-ansible.yaml \ -e /home/stack/templates/storage-config.yaml \ -e /home/stack/templates/storage-container-config.yaml \ -e /home/stack/templates/network.yaml \ -e /home/stack/templates/ceph-backfill-recovery.yaml \ --ntp-server pool.ntp.org
--templates - Creates the Overcloud from the default Heat template collection (namely,
- -p /usr/share/openstack-tripleo-heat-templates/plan-samples/plan-environment-derived-params.yaml - Specifies that the derived parameters workflow should be run during the deployment to calculate how much memory and CPU should be reserved for a hyper-converged deployment.
-r /home/stack/templates/roles_data.yaml - Specifies the customized roles definition file from Chapter 3, Prepare Overcloud Role for Hyper-Converged Nodes, which includes the
-e /home/stack/templates/ports.yaml - Adds the environment file from Section 3.1, “Configuring Port Assignments for the ComputeHCI Role”, which configures the ports for the
- -e /home/stack/templates/environment-rhel-registration.yaml - Adds an environment file that registers overcloud nodes, as described in Registering the Overcloud with an Environment File (from Advanced Overcloud Customization).
- -e /usr/share/openstack-tripleo-heat-templates/environments/ceph-ansible/ceph-ansible.yaml - Adds the base environment file that deploys a containerized Red Hat Ceph cluster, with all default settings. See Deploying an Overcloud with Containerized Red Hat Ceph for more information.
-e /home/stack/templates/storage-config.yaml - Adds a custom environment file that defines all other Ceph settings. For a detailed example of this, see Sample Environment File: Creating a Ceph Cluster (from Deploying an Overcloud with Containerized Red Hat Ceph).Note
In Sample Environment File: Creating a Ceph Cluster (from Deploying an Overcloud with Containerized Red Hat Ceph), the
/home/stack/templates/storage-config.yamlfile is also used to specify what flavors and how many nodes to assign per role. See Assigning Nodes and Flavors to Roles for details.
- /home/stack/templates/storage-container-config.yaml - Reserves CPU and Memory for each Ceph OSD storage container from Section 4.4, Reserving Memory and CPU Resources for Ceph.
- -e /home/stack/templates/network.yaml - Adds the environment file from Chapter 5, Finalize Networking Settings.
- -e /home/stack/templates/ceph-backfill-recovery.yaml - Adds the environment file from Section 4.2, “Reduce Ceph Backfill and Recovery Operations”.
- --ntp-server pool.ntp.org - Sets our NTP server.
-e flag to add environment files as needed for your planned overcloud deployment. For example, to also enable Single-Root Input/Output Virtualization (SR-IOV), add its corresponding environment file:
To apply your SR-IOV network preferences, add an environment file defining them:
For a full list of deployment options, run:
$ openstack help overcloud deploy