Merge pull request #92503 from mburke5678/mco-machine-config-node-419

Docs for MCO-836 [GA] Machine Config Node

Author: mburke5678

modules/checking-mco-node-status-configuring.adoc

@@ -3,42 +3,13 @@
 // * machine_configuration/machine-config-index.adoc
 
 :_mod-docs-content-type: PROCEDURE
-[id="checking-mco-node-status-congifuring_{context}"]
+[id="checking-mco-node-status-configuring_{context}"]
 = Checking machine config node status
 
-During the update of a machine config pool (MCP), you can monitor the progress of all control plane and worker nodes in your cluster by using the `oc get machineconfignodes` and `oc describe machineconfignodes` commands. These commands provide information that can be helpful if issues arise during the update and you need to troubleshoot a node.
-
-You cannot use these commands with custom machine config pools.
+During the update of a machine config pool (MCP), you can monitor the progress of all of the nodes in your cluster by using the `oc get machineconfignodes` and `oc describe machineconfignodes` commands. These commands provide information that can be helpful if issues arise during the update and you need to troubleshoot a node.
 
 For more information on the meaning of these fields, see "About checking machine config node status."
 
-.Prerequisites
-
-* You enabled the required Technology Preview features for your cluster by editing the `FeatureGate` CR named `cluster`:
-+
-[source,terminal]
-----
-$ oc edit featuregate cluster
-----
-+
-.Example `FeatureGate` CR
-[source,yaml]
-----
-apiVersion: config.openshift.io/v1
-kind: FeatureGate
-metadata:
-  name: cluster
-spec:
-  featureSet: TechPreviewNoUpgrade
-----
-+
-[WARNING]
-====
-Enabling the `TechPreviewNoUpgrade` feature set on your cluster cannot be undone and prevents minor version updates. This feature set allows you to enable these Technology Preview features on test clusters, where you can fully test them. Do not enable this feature set on production clusters.
-====
-+
-After you save the changes, new machine configs are created, the machine config pools are updated, and scheduling on each node is disabled while the change is being applied.
-
 .Procedure
 
 * View the update status of all nodes in the cluster, including the current and desired machine configurations, by running the following command:
@@ -70,13 +41,13 @@ $ oc get machineconfignodes -o wide
 .Example output
 [source,text]
 ----
-NAME                                       POOLNAME   DESIREDCONFIG                                      CURRENTCONFIG                                      UPDATED   UPDATEPREPARED   UPDATEEXECUTED   UPDATEPOSTACTIONCOMPLETE   UPDATECOMPLETE   RESUMED   UPDATECOMPATIBLE   UPDATEDFILESANDOS   CORDONEDNODE   DRAINEDNODE   REBOOTEDNODE   RELOADEDCRIO   UNCORDONEDNODE
-ci-ln-g6dr34b-72292-g9btv-master-0         master     rendered-master-d4e122320b351cdbe1df59ddb63ddcfc   rendered-master-6f2064fcb36d2a914de5b0c660dc49ff   False     True             Unknown          False                      False            False     True               Unknown             False          False         False          False          False
-ci-ln-g6dr34b-72292-g9btv-master-1         master     rendered-master-6f2064fcb36d2a914de5b0c660dc49ff   rendered-master-6f2064fcb36d2a914de5b0c660dc49ff   True      False            False            False                      False            False     False              False               False          False         False          False          False
-ci-ln-g6dr34b-72292-g9btv-master-2         master     rendered-master-6f2064fcb36d2a914de5b0c660dc49ff   rendered-master-6f2064fcb36d2a914de5b0c660dc49ff   True      False            False            False                      False            False     False              False               False          False         False          False          False
-ci-ln-g6dr34b-72292-g9btv-worker-a-sjh5r   worker     rendered-worker-671b88c8c569fa3f60dc1a27cf9c91f2   rendered-worker-d5534cb730e5e108905fc285c2a42b6c   False     True             Unknown          False                      False            False     True               Unknown             False          False         False          False          False
-ci-ln-g6dr34b-72292-g9btv-worker-b-xthbz   worker     rendered-worker-d5534cb730e5e108905fc285c2a42b6c   rendered-worker-d5534cb730e5e108905fc285c2a42b6c   True      False            False            False                      False            False     False              False               False          False         False          False          False
-ci-ln-g6dr34b-72292-g9btv-worker-c-gnpd6   worker     rendered-worker-d5534cb730e5e108905fc285c2a42b6c   rendered-worker-d5534cb730e5e108905fc285c2a42b6c   True      False            False            False                      False            False     False              False               False          False         False          False          False
+NAME                                       POOLNAME   DESIREDCONFIG                                      CURRENTCONFIG                                      UPDATED   UPDATEPREPARED   UPDATEEXECUTED   UPDATEPOSTACTIONCOMPLETE   UPDATECOMPLETE   RESUMED   UPDATEDFILESANDOS   CORDONEDNODE   DRAINEDNODE   REBOOTEDNODE   UNCORDONEDNODE
+ci-ln-g6dr34b-72292-g9btv-master-0         master     rendered-master-d4e122320b351cdbe1df59ddb63ddcfc   rendered-master-6f2064fcb36d2a914de5b0c660dc49ff   False     True             Unknown          False                      False            False     Unknown             False          False         False          False
+ci-ln-g6dr34b-72292-g9btv-master-1         master     rendered-master-6f2064fcb36d2a914de5b0c660dc49ff   rendered-master-6f2064fcb36d2a914de5b0c660dc49ff   True      False            False            False                      False            False     False               False          False         False          False
+ci-ln-g6dr34b-72292-g9btv-master-2         master     rendered-master-6f2064fcb36d2a914de5b0c660dc49ff   rendered-master-6f2064fcb36d2a914de5b0c660dc49ff   True      False            False            False                      False            False     False               False          False         False          False
+ci-ln-g6dr34b-72292-g9btv-worker-a-sjh5r   worker     rendered-worker-671b88c8c569fa3f60dc1a27cf9c91f2   rendered-worker-d5534cb730e5e108905fc285c2a42b6c   False     True             Unknown          False                      False            False     Unknown             False          False         False          False
+ci-ln-g6dr34b-72292-g9btv-worker-b-xthbz   worker     rendered-worker-d5534cb730e5e108905fc285c2a42b6c   rendered-worker-d5534cb730e5e108905fc285c2a42b6c   True      False            False            False                      False            False     False               False          False         False          False
+ci-ln-g6dr34b-72292-g9btv-worker-c-gnpd6   worker     rendered-worker-d5534cb730e5e108905fc285c2a42b6c   rendered-worker-d5534cb730e5e108905fc285c2a42b6c   True      False            False            False                      False            False     False               False          False         False          False
 ----
 
 * Check the update status of nodes in a specific machine config pool by running the following command:
@@ -86,6 +57,10 @@ ci-ln-g6dr34b-72292-g9btv-worker-c-gnpd6   worker     rendered-worker-d5534cb730
 $ oc get machineconfignodes $(oc get machineconfignodes -o json | jq -r '.items[]|select(.spec.pool.name=="<pool_name>")|.metadata.name') <1>
 ----
 +
+where:
+
+`<pool_name>`:: Specifies the name of the machine config pool.
++
 .Example output
 [source,text]
 ----
@@ -105,35 +80,60 @@ $ oc describe machineconfignode/<node_name>
 .Example output
 [source,text]
 ----
-Name:         <node_name>
-Namespace:
-Labels:       <none>
-Annotations:  <none>
-API Version:  machineconfiguration.openshift.io/v1alpha1
-Kind:         MachineConfigNode
-Metadata:
-  Creation Timestamp:  2023-10-17T13:08:58Z
-  Generation:          1
-  Resource Version:    49443
-  UID:                 4bd758ab-2187-413c-ac42-882e61761b1d
-Spec:
-  Node Ref:
-    Name:         <node_name>
-  Pool:
-    Name:         master
-  ConfigVersion:
-    Desired: rendered-worker-823ff8dc2b33bf444709ed7cd2b9855b
-Status:
+apiVersion: machineconfiguration.openshift.io/v1
+kind: MachineConfigNode
+metadata:
+  creationTimestamp: "2025-04-28T18:52:16Z"
+  generation: 3
+  name: ci-ln-921r7qk-72292-kxv95-worker-a-zmxrr
+  ownerReferences:
+  - apiVersion: v1
+    kind: Node
+    name: ci-ln-921r7qk-72292-kxv95-worker-a-zmxrr
+    uid: e548a8d1-4f16-42cd-9234-87ac5aede6c1
+  resourceVersion: "62331"
+  uid: 11d96e07-582d-4569-a84a-9d8c5229a551
+spec:
+  configVersion:
+    desired: rendered-worker-1930ca7433b7f0153286a3f04e4cb57b
+  node:
+    name: ci-ln-921r7qk-72292-kxv95-worker-a-zmxrr
+  pool:
+    name: worker
+status:
+  conditions:
+# ...
+    lastTransitionTime: 2025-04-23T14:55:31Z
+    message: Update Compatible. Post Cfg Actions: [] Drain Required: true
+    reason: UpdatePrepared
+    status: True
+    type: UpdatePrepared
+# ...
+    lastTransitionTime: 2025-04-23T14:55:31Z
+    message: Draining node. The drain will not be complete until desired drainer drain-rendered-worker-1930ca7433b7f0153286a3f04e4cb57b
+      matches current drainer uncordon-rendered-worker-a9673968884f1ea42c26edcd914af907
+    reason: UpdateExecutedDrained
+    status: True
+    type: Drained
+# ...
+    lastTransitionTime: 2025-04-23T14:55:31Z
+    message: Cordoned node. The node is reporting Unschedulable = true
+    reason: UpdateExecutedCordoned
+    status: True
+    type: Cordoned
 # ...
-    Message:               Drained node. The drain is complete as the desired drainer matches current drainer: drain-rendered-worker-01f27f752eb84eba917450e43636b210
-    Reason:                UpdateExecutedDrained
-    Status:                True
-    Type:                  Drained
-    Last Transition Time:  2025-01-14T15:45:55Z
+  - lastTransitionTime: "2025-04-28T18:52:16Z"
+    message: This node has not yet entered the NodeDegraded phase
+    reason: NotYetOccurred
+    status: "False"
+    type: NodeDegraded
 # ...
-  Config Version:
-    Current:            rendered-master-8110974a5cea69dff5b263237b58abd8
-    Desired:            rendered-worker-823ff8dc2b33bf444709ed7cd2b9855b
-  Observed Generation:  6
+  configversion:
+    current: rendered-worker-8110974a5cea69dff5b263237b58abd8
+    desired: rendered-worker-1930ca7433b7f0153286a3f04e4cb57b
+  observedgeneration:  4
+  pinnedImageSets:
+  - desiredGeneration: 1
+    name: worker-pinned-images
 # ...  
 ----