Configure capacity reservations by using machine sets in ARO

OpenShift Container Platform version 4.18 and later supports on-demand Capacity Reservation with Capacity Reservation groups on Microsoft Azure Red Hat OpenShift clusters.

You can configure a machine set to deploy machines on any available resources that match the parameters of a capacity request that you define. These parameters specify the VM size, region, and number of instances that you want to reserve. If your Azure subscription quota can accommodate the capacity request, the deployment succeeds.

For more information, including limitations and suggested use cases for this Azure instance type, see On-demand Capacity Reservation.

Note

You can't change an existing Capacity Reservation configuration for a machine set. To use a different Capacity Reservation group, you must replace the machine set and the machines that the previous machine set deployed. Capacity reservations aren't supported at the time of cluster creation.

Prerequisites

1. You have access to the cluster with cluster-admin privileges.
2. You installed the OpenShift CLI (oc).
3. You created a Capacity Reservation group.

For more information, see Associate a capacity reservation to a VM.

Procedure

1. In a text editor, open the YAML file for an existing machine set or create a new one.

2. Edit the following section under the providerSpec field:

   apiVersion: machine.openshift.io/v1beta1
   kind: MachineSet
   # ...
   spec:
     template:
       spec:
         providerSpec:
           value:
             capacityReservationGroupID: <capacity_reservation_group> 
   # ...
   

   Specify the ID of the Capacity Reservation group that you want the machine set to deploy machines on.

Verification

To verify the machine deployment, list the machines that the machine set created by running the following command. Replace <machine_set_name> with the name of the compute machine set:

oc get machines.machine.openshift.io \
  -n openshift-machine-api \
  -l machine.openshift.io/cluster-api-machineset=<machine_set_name>

In the output, verify that the characteristics of the listed machines match the parameters of your capacity reservation.

Next steps

Modifying a compute machine set.