-
Task
-
Resolution: Done
-
Normal
-
ACM 2.11.0
-
False
-
None
-
False
-
-
-
No
Create an informative issue (See each section, incomplete templates/issues won't be triaged)
Using the current documentation as a model, please complete the issue template.
Note: Doc team updates the current version and the two previous versions (n-2). For earlier versions, we will address only high-priority, customer-reported issues for releases in support.
Prerequisite: Start with what we have
Always look at the current documentation to describe the change that is needed. Use the source or portal link for Step 4:
- Use the Customer Portal: https://access.redhat.com/documentation/en-us/red_hat_advanced_cluster_management_for_kubernetes
- Use the GitHub link to find the staged docs in the repository: https://github.com/stolostron/rhacm-docs
Describe the changes in the doc and link to your dev story
Provide info for the following steps:
1. - [x] Mandatory Add the required version to the Fix version/s field.
2. - [x] Mandatory Choose the type of documentation change.
- [x] New topic in an existing section or new section
- [ ] Update to an existing topic
3. - [x] Mandatory for GA content:
- [x] Add steps and/or other important conceptual information here:
Under https://access.redhat.com/documentation/en-us/red_hat_advanced_cluster_management_for_kubernetes/2.10/html/clusters/cluster_mce_overview#specify-ansible-inventory add the following:
Performing EUS to EUS upgrades
You can use the `ClusterCurator` resource to perform EUS to EUS upgrades. See the following example:
apiVersion: cluster.open-cluster-management.io/v1beta1
kind: ClusterCurator
metadata:
annotations:
cluster.open-cluster-management.io/upgrade-clusterversion-backoff-limit: "10"
name: feng-managed
namespace: feng-managed
spec:
desiredCuration: upgrade
upgrade:
intermediateUpdate: 4.13.37
desiredUpdate: 4.14.16
monitorTimeout: 120
posthook:
- extra_vars: {}
name: Unpause machinepool
type: Job
prehook:
- extra_vars: {}
name: Pause machinepool
type: Job
A new field `spec.upgrade.intermediateUpdate` has been added to specify the intermediate cluster version.
The `spec.upgrade.desiredUpdate` field will become the final/target upgrade version. In the example above,
the starting cluster version is 4.12.14 which will then upgrade to 4.13.37 and finally to 4.14.16. During an EUS to EUS upgrade, it
is recommended to pause the cluster machinepool in the prehook job and unpause the cluster machinepool in the posthook job.
- [ ] Add Required access level for the user to complete the task here:
- [ ] Add verification at the end of the task, how does the user verify success (a command to run or a result to see?)
- [x] Add link to dev story here: https://issues.redhat.com/browse/ACM-10683
4. - [ ] Mandatory for bugs: What is the diff? Clearly define what the problem is, what the change is, and link to the current documentation:
- documents
-
ACM-10683 Implement ClusterCurator EUS to EUS upgrade feature
- Review