Chapter 6. Creating and managing host aggregates

Procedure

1. Open your Compute environment file.

2. Add the following values to the NovaSchedulerDefaultFilters parameter, if they are not already present:

   • AggregateInstanceExtraSpecsFilter: Add this value to filter Compute nodes by host aggregate metadata that match flavor extra specs.

     Note

     For this filter to perform as expected, you must scope the flavor extra specs by prefixing the extra_specs key with the aggregate_instance_extra_specs: namespace.

   • AggregateImagePropertiesIsolation: Add this value to filter Compute nodes by host aggregate metadata that match image metadata properties.

     Note

     To filter host aggregate metadata by using image metadata properties, the host aggregate metadata key must match a valid image metadata property. For information about valid image metadata properties, see Image metadata.

   • AvailabilityZoneFilter: Add this value to filter by availability zone when launching an instance.

     Note

     Instead of using the AvailabilityZoneFilter Compute scheduler service filter, you can use the Placement service to process availability zone requests. For more information, see Filtering by availability zone using the Placement service.

3. Save the updates to your Compute environment file.

4. Add your Compute environment file to the stack with your other environment files and deploy the overcloud:

   (undercloud)$ openstack overcloud deploy --templates \
     -e [your environment files] \
     -e /home/stack/templates/<compute_environment_file>.yaml

Procedure

1. To create a host aggregate, enter the following command:

   (overcloud)# openstack aggregate create <aggregate_name>

   Replace <aggregate_name> with the name you want to assign to the host aggregate.

2. Add metadata to the host aggregate:

   (overcloud)# openstack aggregate set \
    --property <key=value> \
    --property <key=value> \
    <aggregate_name>

   • Replace <key=value> with the metadata key-value pair. If you are using the AggregateInstanceExtraSpecsFilter filter, the key can be any arbitrary string, for example, ssd=true. If you are using the AggregateImagePropertiesIsolation filter, the key must match a valid image metadata property. For more information about valid image metadata properties, see Image metadata.
   • Replace <aggregate_name> with the name of the host aggregate.

3. Add the Compute nodes to the host aggregate:

   (overcloud)# openstack aggregate add host \
    <aggregate_name> \
    <host_name>

   • Replace <aggregate_name> with the name of the host aggregate to add the Compute node to.
   • Replace <host_name> with the name of the Compute node to add to the host aggregate.

4. Create a flavor or image for the host aggregate:

   • Create a flavor:

     (overcloud)$ openstack flavor create \
       --ram <size_mb> \
       --disk <size_gb> \
       --vcpus <no_reserved_vcpus> \
       host-agg-flavor

   • Create an image:

     (overcloud)$ openstack image create host-agg-image

5. Set one or more key-value pairs on the flavor or image that match the key-value pairs on the host aggregate.

   • To set the key-value pairs on a flavor, use the scope aggregate_instance_extra_specs:

     (overcloud)# openstack flavor set \
      --property aggregate_instance_extra_specs:ssd=true \
      host-agg-flavor

   • To set the key-value pairs on an image, use valid image metadata properties as the key:

     (overcloud)# openstack image set \
      --property os_type=linux \
      host-agg-image

Procedure

1. To create an availability zone, you can create a new availability zone host aggregate, or make an existing host aggregate an availability zone:

   1. To create a new availability zone host aggregate, enter the following command:

      (overcloud)# openstack aggregate create \
       --zone <availability_zone> \
       <aggregate_name>

      • Replace <availability_zone> with the name you want to assign to the availability zone.
      • Replace <aggregate_name> with the name you want to assign to the host aggregate.

   2. To make an existing host aggregate an availability zone, enter the following command:

      (overcloud)# openstack aggregate set --zone <availability_zone> \
        <aggregate_name>

      • Replace <availability_zone> with the name you want to assign to the availability zone.
      • Replace <aggregate_name> with the name of the host aggregate.

2. Optional: Add metadata to the availability zone:

   (overcloud)# openstack aggregate set --property <key=value> \
     <aggregate_name>

   • Replace <key=value> with your metadata key-value pair. You can add as many key-value properties as required.
   • Replace <aggregate_name> with the name of the availability zone host aggregate.

3. Add Compute nodes to the availability zone host aggregate:

   (overcloud)# openstack aggregate add host <aggregate_name> \
     <host_name>

   • Replace <aggregate_name> with the name of the availability zone host aggregate to add the Compute node to.
   • Replace <host_name> with the name of the Compute node to add to the availability zone.

Procedure

1. To view a list of all the Compute nodes assigned to the host aggregate, enter the following command:

   (overcloud)# openstack aggregate show <aggregate_name>

2. To remove all assigned Compute nodes from the host aggregate, enter the following command for each Compute node:

   (overcloud)# openstack aggregate remove host <aggregate_name> \
     <host_name>

   • Replace <aggregate_name> with the name of the host aggregate to remove the Compute node from.
   • Replace <host_name> with the name of the Compute node to remove from the host aggregate.

3. After you remove all the Compute nodes from the host aggregate, enter the following command to delete the host aggregate:

   (overcloud)# openstack aggregate delete <aggregate_name>

Procedure

1. Open your Compute environment file.
2. To schedule project instances on the project-isolated host aggregate, set the NovaSchedulerLimitTenantsToPlacementAggregate parameter to True in the Compute environment file.

3. Optional: To ensure that only the projects that you assign to a host aggregate can create instances on your cloud, set the NovaSchedulerPlacementAggregateRequiredForTenants parameter to True.

   Note

   NovaSchedulerPlacementAggregateRequiredForTenants is False by default. When this parameter is False, projects that are not assigned to a host aggregate can create instances on any host aggregate.

4. Save the updates to your Compute environment file.

5. Add your Compute environment file to the stack with your other environment files and deploy the overcloud:

   (undercloud)$ openstack overcloud deploy --templates \
     -e [your environment files] \
     -e /home/stack/templates/<compute_environment_file>.yaml \

6. Create the host aggregate.

7. Retrieve the list of project IDs:

   (overcloud)# openstack project list

8. Use the filter_tenant_id<suffix> metadata key to assign projects to the host aggregate:

   (overcloud)# openstack aggregate set \
    --property filter_tenant_id<ID0>=<project_id0> \
    --property filter_tenant_id<ID1>=<project_id1> \
    ...
    --property filter_tenant_id<IDn>=<project_idn> \
    <aggregate_name>

   • Replace <ID0>, <ID1>, and all IDs up to <IDn> with unique values for each project filter that you want to create.
   • Replace <project_id0>, <project_id1>, and all project IDs up to <project_idn> with the ID of each project that you want to assign to the host aggregate.

   • Replace <aggregate_name> with the name of the project-isolated host aggregate.

     For example, use the following syntax to assign projects 78f1, 9d3t, and aa29 to the host aggregate project-isolated-aggregate:

     (overcloud)# openstack aggregate set \
      --property filter_tenant_id0=78f1 \
      --property filter_tenant_id1=9d3t \
      --property filter_tenant_id2=aa29 \
      project-isolated-aggregate

     Tip

     You can create a host aggregate that is available only to a single specific project by omitting the suffix from the filter_tenant_id metadata key:

     (overcloud)# openstack aggregate set \
      --property filter_tenant_id=78f1 \
      single-project-isolated-aggregate