You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: modules/mco-update-boot-images-about.adoc
+27-4Lines changed: 27 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -9,7 +9,12 @@
9
9
10
10
By default, for {gcp-first} and {aws-first} clusters, the Machine Config Operator (MCO) updates the boot image in the machine sets in your cluster whenever you update your cluster.
11
11
12
-
For {gcp-short} and {aws-short}, you can disable the boot image management feature, if needed. When the feature is disabled, the boot image no longer updates with the cluster. For example, with the feature disabled, if your cluster was originally created with {product-title} 4.16, the boot image that the MCO would use to create nodes is the same 4.16 version, even if your cluster is at a later version.
12
+
For {vmw-first}, you can enable boot image management as a Technology Preview feature. For information on how to enable this feature, see "Enabling boot image management".
13
+
14
+
:FeatureName: Boot image management on {vmw-short}
15
+
include::snippets/technology-preview.adoc[]
16
+
17
+
You can disable the boot image management feature, if needed. When the feature is disabled, the boot image no longer updates with the cluster. For example, with the feature disabled, if your cluster was originally created with {product-title} 4.16, the boot image that the MCO would use to create nodes is the same 4.16 version, even if your cluster is at a later version.
13
18
14
19
However, using an older boot image could cause the following issues:
15
20
@@ -44,13 +49,15 @@ How the cluster behaves after disabling or re-enabling the feature, depends upon
44
49
Because a boot image is used only when a node is scaled up, this feature has no effect on existing nodes.
45
50
====
46
51
47
-
To view the current boot image used in your cluster, examine a machine set.
52
+
To view the current boot image used in your cluster, use one of the following methods, based on your platform:
48
53
54
+
* For {gcp-short} and {aws-short}, you can examine a machine set.
55
+
+
49
56
[NOTE]
50
57
====
51
58
The location and format of the boot image within the machine set differs, based on the platform. However, the boot image is always listed in the `spec.template.spec.providerSpec.` parameter.
52
59
====
53
-
60
+
+
54
61
.Example {gcp-short} machine set with the boot image reference
55
62
56
63
[source,yaml]
@@ -76,7 +83,7 @@ spec:
76
83
# ...
77
84
----
78
85
<1> This boot image is the same as the originally-installed {product-title} version, in this example {product-title} 4.12, regardless of the current version of the cluster. The way that the boot image is represented in the machine set depends on the platform, as the structure of the `providerSpec` field differs from platform to platform.
79
-
86
+
+
80
87
.Example {aws-short} machine set with the boot image reference
81
88
82
89
[source,yaml]
@@ -99,6 +106,22 @@ spec:
99
106
# ...
100
107
----
101
108
109
+
* For {vmw-first}, examine an affected node by opening an `oc debug` session to the node and using the `rpm-ostree status` command.
110
+
+
111
+
[source,terminal]
112
+
----
113
+
sh-5.1# rpm-ostree status
114
+
----
115
+
+
116
+
.Example {aws-short} node with the boot image reference
Copy file name to clipboardExpand all lines: modules/mco-update-boot-images-configuring.adoc
+34-1Lines changed: 34 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -9,10 +9,43 @@
9
9
10
10
By default, for {gcp-first} and {aws-first} clusters, the Machine Config Operator (MCO) updates the boot image in the machine sets in your cluster whenever you update your cluster.
11
11
12
-
If you disabled the boot image management feature, so that the boot images are not updated, you can re-enable the feature by editing the `MachineConfiguration` object.
12
+
If you disabled the boot image management feature, so that the boot images are not updated, you can re-enable the feature by editing the `MachineConfiguration` object.
13
+
14
+
For {vmw-first}, you can enable boot image management as a Technology Preview feature.
15
+
16
+
:FeatureName: Boot image management on {vmw-short}
17
+
include::snippets/technology-preview.adoc[]
13
18
14
19
Enabling the feature updates the boot image to the current {product-title} version. If the cluster is again updated to a new {product-title} version in the future, the boot image is updated again. New nodes created after enabling the feature use the updated boot image. This feature has no effect on existing nodes.
15
20
21
+
.Prerequisites
22
+
23
+
* For {vmw-short}, enable the `TechPreviewNoUpgrade` feature set on the cluster. For more information, see "Enabling features using feature gates".
24
+
+
25
+
[NOTE]
26
+
====
27
+
Enabling the `TechPreviewNoUpgrade` feature set cannot be undone and prevents minor version updates. These feature sets are not recommended on production clusters.
28
+
====
29
+
+
30
+
Wait until the `managedBootImagesStatus` stanza displays in the `MachineConfiguration` object.
31
+
+
32
+
[source,yaml]
33
+
----
34
+
apiVersion: operator.openshift.io/v1
35
+
kind: MachineConfiguration
36
+
metadata:
37
+
name: cluster
38
+
# ...
39
+
status:
40
+
# ...
41
+
managedBootImagesStatus:
42
+
machineManagers:
43
+
- apiGroup: machine.openshift.io
44
+
resource: machinesets
45
+
selection:
46
+
mode: None
47
+
----
48
+
16
49
.Procedure
17
50
18
51
. Edit the `MachineConfiguration` object, named `cluster`, to enable the boot image management feature for some or all of your machine sets:
Copy file name to clipboardExpand all lines: modules/mco-update-boot-images-disable.adoc
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -7,13 +7,13 @@
7
7
[id="mco-update-boot-images-disable_{context}"]
8
8
= Disabling boot image management
9
9
10
-
By default, for {gcp-first} and {aws-first} clusters, the Machine Config Operator (MCO) manages and updates the boot image in the machine sets in your cluster whenever you update your cluster.
10
+
By default, for {gcp-first} and {aws-first} clusters, the Machine Config Operator (MCO) manages and updates the boot image in the machine sets in your cluster whenever you update your cluster. For {vmw-first}, you can enable boot image management as a Technology Preview feature.
11
11
12
12
You can disable the boot image management feature for your cluster by editing the `MachineConfiguration` object. When disabled, the Machine Config Operator (MCO) no longer manages the boot image in your cluster and no longer updates the boot image with each cluster update.
13
13
14
14
Disabling this feature does not rollback the nodes or machine sets to the originally-installed boot image. The machine sets retain the boot image version that was present when the feature was disabled and is not updated if the cluster is upgraded to a new {product-title} version in the future. This feature has no effect on existing nodes.
15
15
16
-
After disabling the feature in a {gcp-short} or {aws-short} cluster, you can re-enable the feature at any time. For more information, see "Enabling updated boot images".
16
+
After disabling the feature, you can re-enable the feature at any time. For more information, see "Enabling updated boot images".
For {gcp-first} and {aws-first} clusters, by default the Machine Config Operator (MCO) manages and updates the boot image that is used to scale up your nodes. This means that by default, the MCO updates the boot images whenever you upgrade your cluster.
9
9
10
+
For {vmw-first}, you can enable boot image management as a Technology Preview feature.
11
+
10
12
For all other platforms, the MCO does not update the boot image with each cluster update.
Copy file name to clipboardExpand all lines: snippets/mco-update-boot-images-verification.adoc
+36-2Lines changed: 36 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,7 +5,7 @@
5
5
6
6
:_mod-docs-content-type: SNIPPET
7
7
8
-
* View the current state of the boot image management feature by viewing the machine configuration object:
8
+
* When the affected nodes return to the `READY` state, view the current state of the boot image management feature by viewing the machine configuration object:
9
9
+
10
10
[source,terminal]
11
11
----
@@ -41,7 +41,9 @@ status:
41
41
mode: All
42
42
----
43
43
44
-
* Get the boot image version by running the following command. The location and format of the boot image within the machine set differs, based on the platform. However, the boot image is always listed in the `spec.template.spec.providerSpec.` parameter.
44
+
* When the affected nodes return to the `READY` state, check the current boot image by using one of the following methods:
45
+
46
+
** For {gcp-short} and {aws-short}, get the boot image version by running the following command. The location and format of the boot image within the machine set differs, based on the platform. However, the boot image is always listed in the `spec.template.spec.providerSpec.` parameter.
45
47
+
46
48
[source,terminal]
47
49
----
@@ -76,3 +78,35 @@ spec:
76
78
# ...
77
79
----
78
80
<1> This boot image is the same as the current {product-title} version.
81
+
82
+
** For {vmw-first}, get the boot image version from an affected node:
83
+
84
+
.. Open an `oc debug` session to the node by running a command similar to the following:
85
+
+
86
+
[source,terminal]
87
+
----
88
+
$ oc debug node/<node_name>
89
+
----
90
+
91
+
.. Set `/host` as the root directory within the debug shell by running the following command:
92
+
+
93
+
[source,terminal]
94
+
----
95
+
sh-5.1# chroot /host
96
+
----
97
+
98
+
.. Run the `rpm-ostree status` command to view that the custom layered image is in use:
0 commit comments