mirror of
https://github.com/openshift/openshift-docs.git
synced 2026-02-05 12:46:18 +01:00
59 lines
2.3 KiB
Plaintext
59 lines
2.3 KiB
Plaintext
:_mod-docs-content-type: ASSEMBLY
|
|
[id="upgrade-edges"]
|
|
= Upgrade edges
|
|
include::_attributes/common-attributes.adoc[]
|
|
:context: upgrade-edges
|
|
|
|
toc::[]
|
|
|
|
:FeatureName: {olmv1-first}
|
|
include::snippets/technology-preview.adoc[]
|
|
|
|
When determining upgrade edges, also known as upgrade paths or upgrade constraints, for an installed cluster extension, {olmv1-first} supports {olmv0} semantics starting in {product-title} 4.16. This support follows the behavior from {olmv0}, including `replaces`, `skips`, and `skipRange` directives, with a few noted differences.
|
|
|
|
By supporting {olmv0} semantics, {olmv1} now honors the upgrade graph from catalogs accurately.
|
|
|
|
[IMPORTANT]
|
|
====
|
|
include::snippets/olmv1-known-issue-private-registries.adoc[]
|
|
====
|
|
|
|
.Differences from original {olmv0} implementation
|
|
|
|
* If there are multiple possible successors, {olmv1} behavior differs in the following ways:
|
|
** In {olmv0}, the successor closest to the channel head is chosen.
|
|
** In {olmv1}, the successor with the highest semantic version (semver) is chosen.
|
|
|
|
* Consider the following set of file-based catalog (FBC) channel entries:
|
|
+
|
|
[source,yaml]
|
|
----
|
|
# ...
|
|
- name: example.v3.0.0
|
|
skips: ["example.v2.0.0"]
|
|
- name: example.v2.0.0
|
|
skipRange: >=1.0.0 <2.0.0
|
|
----
|
|
+
|
|
If `1.0.0` is installed, {olmv1} behavior differs in the following ways:
|
|
+
|
|
--
|
|
** {olmv0-caps} will not detect an upgrade edge to `v2.0.0` because `v2.0.0` is skipped and not on the `replaces` chain.
|
|
** {olmv1} will detect the upgrade edge because {olmv1} does not have a concept of a `replaces` chain. {olmv1} finds all entries that have a `replace`, `skip`, or `skipRange` value that covers the currently installed version.
|
|
--
|
|
|
|
[role="_additional-resources"]
|
|
.Additional resources
|
|
* xref:../../operators/understanding/olm/olm-workflow.adoc#olm-upgrades_olm-workflow[{olmv0-caps} upgrade semantics]
|
|
|
|
include::modules/olmv1-version-range-support.adoc[leveloffset=+1]
|
|
|
|
include::modules/olmv1-version-range-comparisons.adoc[leveloffset=+1]
|
|
include::modules/olmv1-about-target-versions.adoc[leveloffset=+1]
|
|
include::modules/olmv1-forcing-an-update-or-rollback.adoc[leveloffset=+1]
|
|
|
|
[role="_additional-resources"]
|
|
.Additional resources
|
|
* xref:../../extensions/ce/upgrade-edges.adoc#olmv1-version-range-support_upgrade-edges[Support for version ranges]
|
|
// after #82245 merges, add an xref to _Creating a service account to manage cluster extensions_
|