Skip to content

Commit 967a40e

Browse files
authored
Merge pull request #35380 from opayne1/BZ1860503
adds instructions and guidance for user to change channels
2 parents 8437938 + fce8f8c commit 967a40e

File tree

1 file changed

+17
-1
lines changed

1 file changed

+17
-1
lines changed

modules/understanding-upgrade-channels.adoc

Lines changed: 17 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -134,5 +134,21 @@ ifndef::openshift-origin[]
134134
[discrete]
135135
== Switching between channels
136136

137-
Your cluster is still supported if you change from the `stable-{product-version}` channel to the `fast-{product-version}` channel. Although you can switch to the `candidate-{product-version}` channel at any time, some releases in that channel might be unsupported release candidates. You can switch from the `candidate-{product-version}` channel to the `fast-{product-version}` channel if your current release is a general availability release. You can always switch from the `fast-{product-version}` channel to the `stable-{product-version}` channel, although if the current release was recently promoted to `fast-{product-version}` there can be a delay of up to a day for the release to be promoted to `stable-{product-version}`. If you change to a channel that does not include your current release, an alert displays and no updates can be recommended, but you can safely change back to your original channel at any point.
137+
A channel can be switched from the web console or through the `adm upgrade channel` command:
138+
139+
----
140+
$ oc adm upgrade channel clusterversion version --type json -p '[{"op": "add", "path": "/spec/channel", "value": "<channel>”}]'
141+
----
142+
143+
The web console will display an alert if you switch to a channel that does not include the current release. The web console does not recommend any updates while on a channel without the current release. You can return to the original channel at any point, however.
144+
145+
Changing your channel might impact the supportability of your cluster. The following conditions might apply:
146+
147+
* Your cluster is still supported if you change from the `stable-{product-version}` channel to the `fast-{product-version}` channel.
148+
149+
* You can switch to the `candidate-{product-version}` channel at any time, but some releases for this channel might be unsupported.
150+
151+
* You can switch from the `candidate-{product-version}` channel to the `fast-{product-version}` channel if your current release is a general availability release.
152+
153+
* You can always switch from the `fast-{product-version}` channel to the `stable-{product-version}` channel. There is a possible delay of up to a day for the release to be promoted to `stable-{product-version}` if the current release was recently promoted.
138154
endif::openshift-origin[]

0 commit comments

Comments
 (0)