OpenShift docs are moving and will soon only be available at docs.redhat.com, the home of all Red Hat product documentation. Explore the new docs experience today.
  1. Documentation
    2. history
×

Enabling OpenShift Container Platform features using FeatureGates

Understanding FeatureGates and Technology Preview features

You can use the FeatureGate Custom Resource to toggle on and off Technology Preview features throughout your cluster.

This allows you, for example, to ensure that Technology Preview features are off for production clusters while leaving the features on for test clusters where you can fully test them.

Features that are affected by FeatureGates

The following features are affected by FeatureGates:

FeatureGate Description Default

RotateKubeletServerCertificate

Enables the rotation of the server TLS certificate on the cluster.

True

SupportPodPidsLimit

Enables support for limiting the number of processes (PIDs) running in a pod.

True

MachineHealthCheck

Enables automatically repairing unhealthy machines in a machine pool.

True

LocalStorageCapacityIsolation

Enable the consumption of local ephemeral storage and also the sizeLimit property of an emptyDir volume.

False

You can enable these features by editing the Feature Gate Custom Resource. Turning on these features cannot be undone and prevents the ability to upgrade your cluster.

Enabling Technology Preview features using FeatureGates

You can turn on Technology Preview features on for all nodes in the cluster by editing the FeatureGate custom resource, named cluster, in the openshift-config project.

The following Technology Preview features are enabled by feature gates:

  • RotateKubeletServerCertificate

  • SupportPodPidsLimit

Turning on Technology Preview features using the FeatureGate custom resource cannot be undone and prevents upgrades.
Procedure

To turn on the Technology Preview features for the entire cluster:

  1. Create the FeatureGates instance:

    1. Switch to the Administration → Custom Resource Definitions page.

    2. On the Custom Resource Definitions page, click FeatureGate.

    3. On the Custom Resource Definitions page, click the Actions Menu and select View Instances.

    4. On the Feature Gates page, click Create Feature Gates.

    5. Replace the code with following sample:

      apiVersion: config.openshift.io/v1
kind: FeatureGate
metadata:
  name: cluster
spec: {}

    6. Click Create.

  2. To turn on the Technology Preview features, change the spec parameter to:

    apiVersion: config.openshift.io/v1
kind: FeatureGate
metadata:
  name: cluster
spec:
  featureSet: TechPreviewNoUpgrade (1)
    1 Add featureSet: TechPreviewNoUpgrade to enable the Technology Preview features that are affected by FeatureGates.

    Turning on Technology Preview features using the FeatureGate custom resource cannot be undone and prevents upgrades.