Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

https://issues.redhat.com/browse/ACM-16860--versioning in cluster boo… #7392

Open
wants to merge 1 commit into
base: 2.13_stage
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
64 changes: 37 additions & 27 deletions clusters/cluster_lifecycle/sync_release_image.adoc
Original file line number Diff line number Diff line change
@@ -1,70 +1,80 @@
[#synchronizing-available-release-images]
= Synchronizing available release images
//placed in mce doc but should not be here since we moved all of the acm doc--bcs unless we chage that strategy

The release images are updated frequently, so you might want to synchronize the list of release images to ensure that you can select the latest available versions. Release images are available in the link:https://github.com/stolostron/acm-hive-openshift-releases/tree/release-2.5[`acm-hive-openshift-releases`] GitHub repository for release 2.5.
The release images are updated frequently. You can synchronize the list of release images to ensure that you can select the latest available versions. Release images are available in the link:https://github.com/stolostron/acm-hive-openshift-releases/tree/backplane-2.8[acm-hive-openshift-releases] repository.

There are three levels of stability of the release images:
[#stability-level]
== Stability levels

There are three levels of stability of the release images, as displayed in the following table:

.Stability levels of release images
|===
|Category |Description
|stable
|Fully tested images that are confirmed to install and build clusters correctly.

|fast
|Partially tested, but likely less stable than a stable version.

|candidate
|Not tested, but the most current image. Might have some bugs.
|Most current images that are not tested and might have some bugs.
|fast
|Images are partially tested, but likely less stable than a stable version.
|stable
|These fully-tested images are confirmed to install and build clusters correctly.
|===

Complete the following steps to refresh the list:
[#refresh-list]
== Refreshing the release images list

Complete the following steps to refresh and synchronize the list of images by using a Linux or MacOS operating system:

. If the installer-managed `acm-hive-openshift-releases` subscription is enabled, disable the subscription by setting the value of `disableUpdateClusterImageSets` to `true` in the `multiclusterhub` resource.

. Clone the link:https://github.com/stolostron/acm-hive-openshift-releases/tree/release-2.5[`acm-hive-openshift-releases`] GitHub repository for release 2.5.
. Clone the link:https://github.com/stolostron/acm-hive-openshift-releases/tree/backplane-2.8[acm-hive-openshift-releases] GitHub repository.

. Remove the subscription by running the following command:

. Remove the subscription by entering a command that is similar to the following command:
+
[source,bash]
----
oc delete -f subscribe/subscription-fast
----

. Connect to the stable release images and synchronize your {acm} hub cluster by entering the following command:
. To synchronize and display the `candidate` release images, run the following command by using a Linux or MacOS operating system:

+
[source,bash]
----
make subscribe-stable
make subscribe-candidate
----
+
*Note:* You can only run this `make` command when you are using the Linux or MacOS operating system.
+
After about one minute, the latest list of `stable` release images is available.
After about one minute, the latest list of `candidate` release images is available.

. To synchronize and display the `fast` release images, run the following command:

* To synchronize and display the fast release images, enter the following command:
+
[source,bash]
----
make subscribe-fast
----

+
*Note:* You can only run this `make` command when you are using the Linux or MacOS operating system.
+
About one minute after running the command, the list of available `stable` and `fast` release images updates with the currently available images.
+
* To synchronize and display the `candidate` release images, enter the following command:
After about one minute, the latest list of `fast` release images is available.

. Connect to the `stable` release images and synchronize your {acm-short} hub cluster. Run the following command using a Linux or MacOS operating system:

+
[source,bash]
----
make subscribe-candidate
make subscribe-stable
----
+
*Note:* You can only run this `make` command when you are using the Linux or MacOS operating system.
+
About one minute after running the command, the list of available `stable`, `fast`, and `candidate` release images updates with the currently available images.
After about one minute, the list of available `candidate`, `fast`, and `stable` release images updates with the currently available images.

. View the list of currently available release images in the {acm-short} console when you are creating a cluster.

. You can unsubscribe from any of these channels to stop viewing the updates by entering a command in the following format:
. Unsubscribe from any of these channels to stop viewing the updates by running the following command:

+
[source,bash]
----
oc delete -f subscribe/subscription-fast
----
Loading