-
Notifications
You must be signed in to change notification settings - Fork 1.8k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
TELCODOCS-1861: Add Lifecycle Agent Enhancements 4.17
- Loading branch information
1 parent
4e93433
commit 74ce796
Showing
12 changed files
with
552 additions
and
80 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,84 @@ | ||
| // Module included in the following assemblies: | ||
| // * edge_computing/image-based-upgrade/ztp-image-based-upgrade.adoc | ||
|
|
||
| :_mod-docs-content-type: CONCEPT | ||
| [id="ztp-image-based-upgrade-procedure-cancel_{context}"] | ||
| = Canceling an image-based upgrade on managed clusters at scale | ||
|
|
||
| You can cancel the upgrade on a set of managed clusters that completed the `Prep` stage. | ||
|
|
||
| include::snippets/ibu-supported-action-combinations.adoc[] | ||
|
|
||
| .Prerequisites | ||
|
|
||
| * You have logged in to the hub cluster as a user with `cluster-admin` privileges. | ||
| .Procedure | ||
|
|
||
| . Create a separate YAML file on the hub cluster that contains the `ImageBasedGroupUpgrade` CR: | ||
| + | ||
| [source,yaml] | ||
| ---- | ||
| apiVersion: lcm.openshift.io/v1alpha1 | ||
| kind: ImageBasedGroupUpgrade | ||
| metadata: | ||
| name: <filename> | ||
| namespace: default | ||
| spec: | ||
| clusterLabelSelectors: | ||
| - matchExpressions: | ||
| - key: name | ||
| operator: In | ||
| values: | ||
| - spoke4 | ||
| ibuSpec: | ||
| seedImageRef: | ||
| image: quay.io/seed/image:4.16.0-rc.1 | ||
| version: 4.16.0-rc.1 | ||
| pullSecretRef: | ||
| name: "<seed_pull_secret>" | ||
| extraManifests: | ||
| - name: example-extra-manifests | ||
| namespace: openshift-lifecycle-agent | ||
| oadpContent: | ||
| - name: oadp-cm | ||
| namespace: openshift-adp | ||
| plan: | ||
| - actions: ["Abort"] | ||
| rolloutStrategy: | ||
| maxConcurrency: 5 | ||
| timeout: 10 | ||
| ---- | ||
| + | ||
| All managed clusters that completed the `Prep` stage are moved back to the `Idle` stage. | ||
|
|
||
| . Apply the created file by running the following command on the hub cluster: | ||
| + | ||
| [source,terminal] | ||
| ---- | ||
| $ oc apply -f <filename>.yaml | ||
| ---- | ||
|
|
||
| .Verification | ||
|
|
||
| * Monitor the status updates by running the following command: | ||
| + | ||
| [source,terminal] | ||
| ---- | ||
| $ oc get ibgu -o yaml | ||
| ---- | ||
| + | ||
| .Example output | ||
| [source,yaml] | ||
| ---- | ||
| # ... | ||
| status: | ||
| clusters: | ||
| - completedActions: | ||
| - action: Prep | ||
| currentActions: | ||
| - action: Abort | ||
| name: spoke4 | ||
| # ... | ||
| ---- |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,63 @@ | ||
| // Module included in the following assemblies: | ||
| // * edge_computing/image-based-upgrade/ztp-image-based-upgrade.adoc | ||
|
|
||
| :_mod-docs-content-type: CONCEPT | ||
| [id="ztp-image-based-upgrade-procedure-one-step_{context}"] | ||
| = Performing an image-based upgrade on managed clusters at scale in one step | ||
|
|
||
| For use cases when service interruption is not a concern, you can upgrade a set of your managed clusters by using the `ImageBasedGroupUpgrade` CR with several actions combined in one step with one rollout strategy. | ||
| With one rollout strategy, the upgrade time can be reduced but you can only troubleshoot failed clusters after the upgrade plan is complete. | ||
|
|
||
| .Prerequisites | ||
|
|
||
| * You have logged in to the hub cluster as a user with `cluster-admin` privileges. | ||
| * You have created policies and `ConfigMap` objects for resources used in the image-based upgrade. | ||
| * You have installed the {lcao} and OADP Operators on all managed clusters through the hub cluster. | ||
| .Procedure | ||
|
|
||
| . Create a YAML file on the hub cluster that contains the `ImageBasedGroupUpgrade` CR: | ||
| + | ||
| -- | ||
| include::snippets/ibu-ImageBasedGroupUpgrade.adoc[] | ||
| -- | ||
|
|
||
| . Apply the created file by running the following command on the hub cluster: | ||
| + | ||
| [source,terminal] | ||
| ---- | ||
| $ oc apply -f <filename>.yaml | ||
| ---- | ||
|
|
||
| .Verification | ||
|
|
||
| * Monitor the status updates by running the following command: | ||
| + | ||
| -- | ||
| [source,terminal] | ||
| ---- | ||
| $ oc get ibgu -o yaml | ||
| ---- | ||
| .Example output | ||
| [source,yaml] | ||
| ---- | ||
| # ... | ||
| status: | ||
| clusters: | ||
| - completedActions: | ||
| - action: Prep | ||
| failedActions: | ||
| - action: Upgrade | ||
| name: spoke1 | ||
| - completedActions: | ||
| - action: Prep | ||
| - action: Upgrade | ||
| - action: FinalizeUpgrade | ||
| name: spoke4 | ||
| - failedActions: | ||
| - action: Prep | ||
| name: spoke6 | ||
| # ... | ||
| ---- | ||
| -- |
Oops, something went wrong.