Skip to content

Commit 7b83ce2

Browse files
PCP-5891 - Skip worker upgrade option for AWS IaaS clusters (#9403)
* docs: Skip worker upgrade option for AWS IaaS clusters * chore: trigger Netlify * docs: Apply suggestions from code review Co-authored-by: Amanda Churi Filanowski <[email protected]> * ci: auto-formatting prettier issues --------- Co-authored-by: Amanda Churi Filanowski <[email protected]>
1 parent f663847 commit 7b83ce2

File tree

3 files changed

+81
-18
lines changed

3 files changed

+81
-18
lines changed

docs/docs-content/clusters/cluster-management/cluster-updates.md

Lines changed: 56 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -60,12 +60,12 @@ This is the recommended best practice for updating a cluster in Palette.
6060

6161
1. Log in to [Palette](https://console.spectrocloud.com).
6262

63-
2. Navigate to the left **Main Menu** and select **Profiles**.
63+
2. Navigate to the left main menu and select **Profiles**.
6464

6565
3. Create a new version of the profile you want to update. For more information, refer to
6666
[Version a Cluster Profile](../../profiles/cluster-profiles/modify-cluster-profiles/version-cluster-profile.md).
6767

68-
4. Navigate to the left **Main Menu** and select **Clusters**.
68+
4. Navigate to the left main menu and select **Clusters**.
6969

7070
5. Select the cluster you want to update, and navigate to the **Profile** tab of the cluster.
7171

@@ -119,7 +119,7 @@ guidance on creating a new cluster profile version.
119119

120120
1. Log in to [Palette](https://console.spectrocloud.com).
121121

122-
2. Navigate to the left **Main Menu** and select **Clusters**.
122+
2. Navigate to the left main menu and select **Clusters**.
123123

124124
3. Select the cluster you want to update, and navigate to the **Profile** tab of the cluster.
125125

@@ -131,18 +131,69 @@ guidance on creating a new cluster profile version.
131131
</TabItem>
132132
</Tabs>
133133

134-
### Validation
134+
### Validate
135135

136136
You can follow these steps to validate all cluster update approaches.
137137

138138
1. Log in to [Palette](https://console.spectrocloud.com).
139139

140-
2. Navigate to the left **Main Menu** and select **Clusters**.
140+
2. Navigate to the left main menu and select **Clusters**.
141141

142142
3. Select the cluster you updated, and navigate to the **Profile** tab of the cluster.
143143

144144
4. Confirm that the cluster is now using an updated profile.
145145

146+
## Trigger Worker Node Upgrade on AWS IaaS Clusters
147+
148+
If you have enabled the
149+
[**Skip worker node update (Optional)**](../public-cloud/aws/create-cluster.md#node-configuration-settings) option for
150+
worker nodes on an AWS IaaS cluster, you can manually trigger a worker node upgrade at any time after updating the
151+
control plane.
152+
153+
This action repaves the worker nodes to match the control plane's Kubernetes version. This may incur downtime for
154+
workloads running on those nodes, so plan accordingly.
155+
156+
### Prerequisites
157+
158+
- An active AWS IaaS cluster in Palette with the **Skip worker node update (Optional)** option enabled.
159+
160+
- The cluster control plane must be updated to a newer Kubernetes version within the supported N-3 minor version skew.
161+
162+
### Enablement
163+
164+
1. Log in to [Palette](https://console.spectrocloud.com).
165+
166+
2. Navigate to the left main menu and select **Clusters**.
167+
168+
3. Locate and select the AWS IaaS cluster you want to upgrade.
169+
170+
4. Click the **Nodes** tab to view the cluster's node pools.
171+
172+
5. Identify the worker node pool that has the **Skip worker node update (Optional)** option enabled and click the
173+
**Edit** button next to it.
174+
175+
6. In the **Edit node pool** dialog, disable the **Skip worker node update (Optional)** option.
176+
177+
7. Click **Confirm** to save the changes and click **Continue** in the pop-up window to confirm the node pool repave.
178+
179+
Palette then schedules the worker node upgrade.
180+
181+
8. Repeat steps 5-7 for each worker node pool that you want to upgrade.
182+
183+
The worker nodes are repaved to match the control plane's Kubernetes version. This process may take some time depending
184+
on the size of the node pool.
185+
186+
### Validate
187+
188+
1. Log in to [Palette](https://console.spectrocloud.com).
189+
190+
2. Navigate to the left main menu and select **Clusters**.
191+
192+
3. Select the cluster you updated, and navigate to the **Nodes** tab of the cluster.
193+
194+
4. Confirm that the **K8s Version** column for the updated worker node pools now matches the control plane pool's
195+
Kubernetes version.
196+
146197
## Palette Reconciliation After Updating
147198

148199
When cluster profile updates are applied, Palette will apply the changes to the cluster but will not delete any

0 commit comments

Comments
 (0)