Managing machines with the Cluster API is a Technology Preview feature only. Technology Preview features
are not supported with Red Hat production service level agreements (SLAs) and
might not be functionally complete. Red Hat does not recommend using them
in production. These features provide early access to upcoming product
features, enabling customers to test functionality and provide feedback during
the development process.
The Cluster API is an upstream project that is integrated into OKD as a Technology Preview for Amazon Web Services (AWS) and Google Cloud Platform (GCP) clusters. You can use the Cluster API to create and manage compute machine sets and machines in your OKD cluster. This capability is in addition or an alternative to managing machines with the Machine API.
For OKD 4 clusters, you can use the Cluster API to perform node host provisioning management actions after the cluster installation finishes. This system enables an elastic, dynamic provisioning method on top of public or private cloud infrastructure.
With the Cluster API Technology Preview, you can create compute machines and compute machine sets on OKD clusters for supported providers. You can also explore the features that are enabled by this implementation that might not be available with the Machine API.
By using the Cluster API, OKD users and developers are able to realize the following advantages:
The option to use upstream community Cluster API infrastructure providers which might not be supported by the Machine API.
The opportunity to collaborate with third parties who maintain machine controllers for infrastructure providers.
The ability to use the same set of Kubernetes tools for infrastructure management in OKD.
The ability to create compute machine sets using the Cluster API that support features that are not available with the Machine API.
Using the Cluster API to manage machines is a Technology Preview feature and has the following limitations:
Only AWS and GCP clusters are supported.
To use this feature, you must enable the
ClusterAPIEnabled feature gate in the
TechPreviewNoUpgrade feature set. Enabling this feature set cannot be undone and prevents minor version updates.
You must create the primary resources that the Cluster API requires manually.
Control plane machines cannot be managed by the Cluster API.
Migration of existing compute machine sets created by the Machine API to Cluster API compute machine sets is not supported.
Full feature parity with the Machine API is not available.