openshift/openshift-docs
1
0
Fork 0
mirror of https://github.com/openshift/openshift-docs.git synced 2026-02-05 12:46:18 +01:00
Code Issues Releases Activity

Merge pull request #82470 from openshift-cherrypick-robot/cherry-pick-82375-to-enterprise-4.17

Browse Source 
[enterprise-4.17] OSDOCS 10733: Added a note to specify the EUS versions in ImageSetConfiguration file
This commit is contained in:
Alex Dellapenta
2024-09-25 09:30:06 -06:00
committed by GitHub
parent 4103fb1008 eb8c529d37
commit 88e3456133
3 changed files with 42 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
modules/oc-mirror-creating-image-set-config.adoc
View File

@@ -70,6 +70,10 @@ mirror:
[NOTE]
====
The `graph: true` field also mirrors the `ubi-micro` image along with other mirrored images.
When upgrading {product-title} Extended Update Support (EUS) versions, an intermediate version might be required between the current and target versions. For example, if the current version is `4.14` and target version is `4.16`, you might need to include a version such as `4.15.8` in the `ImageSetConfiguration` when using the oc-mirror plugin v1.
The oc-mirror plugin v1 might not always detect this automatically, so check the link:https://access.redhat.com/labs/ocpupgradegraph/update_path[Cincinnati graph web page] to confirm any required intermediate versions and add them manually to your configuration.
====
+
See "Image set configuration parameters" for the full list of parameters and "Image set configuration examples" for various mirroring use cases.

7
modules/oc-mirror-enclave-support.adoc
View File

@@ -102,6 +102,13 @@ $ export UPDATE_URL_OVERRIDE=https://<osus.enterprise.in>/graph
+
For more information on setting up OSUS on an OpenShift cluster, see "Updating a cluster in a disconnected environment using the OpenShift Update Service".
[NOTE]
====
When upgrading {product-title} Extended Update Support (EUS) versions, an intermediate version might be required between the current and target versions. For example, if the current version is `4.14` and target version is `4.16`, you might need to include a version such as `4.15.8` in the `ImageSetConfiguration` when using the oc-mirror plugin v2.
The oc-mirror plugin v2 might not always detect this automatically, so check the link:https://access.redhat.com/labs/ocpupgradegraph/update_path[Cincinnati graph web page] to confirm any required intermediate versions and add them manually to your configuration.
====
. Generate a mirror archive from the enterprise registry for the enclave.
+
To prepare an archive for the `enclave1`, the user executes oc-mirror plugin v2 in the enterprise disconnected environment by using the `imageSetConfiguration` specific for that enclave. This ensures that only images needed by that enclave are mirrored:

31
modules/oc-mirror-image-set-config-examples.adoc
View File

@@ -268,3 +268,34 @@ mirror:
blockedImages:
- name: registry.redhat.io/ubi8/ubi:fake
----
[discrete]
[id="oc-mirror-image-set-examples-eus_{context}"]
== Use case: Including the upgrade path for EUS releases
The following `ImageSetConfiguration` file includes the `eus-<version>` channel, where the `maxVersion` value is at least two minor versions higher than the `minVersion` value.
For example, in this `ImageSetConfiguration` file, the `minVersion` is set to `4.12.28`, while the `maxVersion` for the `eus-4.14` channel is `4.14.16`.
.Example `ImageSetConfiguration` file
[source,yaml,subs="attributes+"]
----
kind: ImageSetConfiguration
apiVersion: mirror.openshift.io/v2alpha1
mirror:
platform:
graph: true # Required for the OSUS Operator
architectures:
- amd64
channels:
- name: stable-4.12
minVersion: '4.12.28'
maxVersion: '4.12.28'
shortestPath: true
type: ocp
- name: eus-4.14
minVersion: '4.12.28'
maxVersion: '4.14.16'
shortestPath: true
type: ocp
----