Skip to content

Commit

Permalink
Merge pull request openshift#541 from wking/channel-clearing-option-f…
Browse files Browse the repository at this point in the history
…or-VersionNotFound

docs/user/status: Mention channel-clearing for VersionNotFound
  • Loading branch information
openshift-merge-robot committed Apr 1, 2021
2 parents 07598f4 + c664b1b commit 20e52fd
Showing 1 changed file with 7 additions and 3 deletions.
10 changes: 7 additions & 3 deletions docs/user/status.md
Original file line number Diff line number Diff line change
Expand Up @@ -120,15 +120,19 @@ It could also be caused by response corruption, e.g. if the configured `upstream
The currently reconciling cluster version was not found in the configured `channel`.

This usually means that the configured `channel` is known to Cincinnati, but the version the cluster is currently applying is not found in that channel's graph.
Fix by setting `channel` to [a valid value][channels], e.g. `stable-4.3`.
You have some options to fix:

If this error occurs because you forced an update to a release that is not in any channel, fix by updating back to a release that occurs in a channel, although you are on your own to determine a safe update path.
* Set `channel` to [a valid value][channels].
For example, `stable-4.7`.
* Clear `channel` if you do not want the operator polling the configured `upstream` for recommended updates.
For example, if your operator is unable to reach any upstream update service, or if you updated to a release that is not in any channel.
* Update back to a release that occurs in a channel, although you are on your own to determine a safe update path.

### Unknown

If this happens it is a CVO coding error.
There is no mitigation short of updating to a new release image with a fixed CVO.

[api-desired-update]: https://github.com/openshift/api/blob/34f54f12813aaed8822bb5bc56e97cbbfa92171d/config/v1/types_cluster_version.go#L40-L54
[channels]: https://docs.openshift.com/container-platform/4.3/updating/updating-cluster-between-minor.html#understanding-upgrade-channels_updating-cluster-between-minor
[channels]: https://docs.openshift.com/container-platform/4.7/updating/updating-cluster-between-minor.html#understanding-upgrade-channels_updating-cluster-between-minor
[Cincinnati]: https://github.com/openshift/cincinnati/blob/master/docs/design/openshift.md

0 comments on commit 20e52fd

Please sign in to comment.