Skip to content

Docs for MCO-836 [GA] Machine Config Node #92503

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Docs for MCO-836 [GA] Machine Config Node #92503

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
132 changes: 66 additions & 66 deletions modules/checking-mco-node-status-configuring.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand Down Expand Up @@ -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:
Expand All @@ -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]
----
Expand All @@ -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
# ...
----
Loading