Skip to content

openshift/machine-labels

Map of labels to apply to an OpenShift node after cluster install

This parameter defines a map of Kubernetes labels (key: value pairs) that will be applied to the OpenShift node corresponding to this machine after the cluster has finished installing. Labels are applied by the openshift-label-machines task, which runs on the cluster coordinator and uses oc label node <name> <key>=<value> --overwrite for each pair.

The map is compose-expanded, so profiles layered on the same machine merge their label maps. This lets you build labeling by composition — e.g. an openshift-infrastructure profile contributes node-role.kubernetes.io/infra: "", while a team-specific profile layered on top can add team: platform-eng.

Requirements

  • Labels must be valid Kubernetes label keys and values
  • Empty string values (e.g. role labels like node-role.kubernetes.io/infra: "") are supported
  • The cluster must be fully installed before this parameter is consumed

Usage

YAML
openshift/machine-labels:
  node-role.kubernetes.io/infra: ""
  team: platform-eng
  environment: production

Objects that Reference openshift/machine-labels

Objects used by openshift/machine-labels

Not used in current content packs