Comment on page
Patch node groups
Learn how to patch node groups to update their AMI or Kubernetes version
This guide will show you how to update your Kubernetes node groups for a Release cluster.
This function is useful after you upgrade your cluster's Kubernetes version or when you want to update the Amazon Machine Images (AMI) running on your node groups.
Log in to your Release account, then navigate to your cluster settings:
- 1.Click on the account settings icon, top-left.
- 2.Click on Clusters in the left menu.
- 3.Open the relevant cluster by clicking the cluster name.

Navigate to your cluster
- 4.Click on the Patch Node Groups button.

Patch node groups button
- 5.In the confirmation dialog, click Confirm.

Patch node groups confirm button
The node group upgrade process should start now and can take up to 30 minutes to complete.
Release drains each node of its pods, one node at a time, by scheduling pods to run on other nodes. This ensures that your services remain online.
Nevertheless, as with any system update, we recommend running this process during a maintenance window to avoid unforeseen downtime during times of high load.
Before updating nodes, Release sets
ForceUpdateEnabled
to false
, which prevents forcing the update if the Kubernetes scheduler fails to drain a node's pods.The scheduler might fail to drain a node if there is a shortage of available nodes. To work around this shortage, temporarily increase the maximum nodes on affected groups by following the steps in our guide on managing your node groups. Readjust your group size after patching.
Click on Logs to view the output of the patching process. The process is complete when the cluster log displays
nodegroup successfully upgraded
.
Cluster log output
Last modified 26d ago