Other Articles

GKE – Enable Node Auto-Upgrade and Auto-Repair

Secure Configuration Checks > GCP

This check ensures that every Standard node pool in a Google Kubernetes Engine (GKE) cluster has node auto-upgrade and auto-repair enabled. Auto-upgrade keeps nodes aligned with supported Kubernetes versions and applies scheduled updates. Auto-repair detects unhealthy nodes and automatically replaces them. Autopilot clusters manage node upgrades and repairs automatically.

Check Details

  • Resource: GKE Cluster
  • Check: Enable node auto-upgrade and auto-repair
  • Risk: Without automatic upgrades, nodes may continue running outdated Kubernetes versions and miss important security updates. Without automatic repair, unhealthy nodes may remain in the cluster, potentially affecting workload availability and reliability.

Remediation via Google Cloud Console

  1. Log in to the Google Cloud Console and navigate to Kubernetes Engine > Clusters. GKE Clusters
  2. Click the affected Standard GKE cluster.
  3. Locate the Node pools section and select the node pool that requires configuration. GKE Node Pools
  4. On the node pool details page, click Edit.
  5. Under Management, enable both Enable auto-upgrade and Enable auto-repair.
  6. Click Save to apply the changes. GKE Node Pool Management
  7. Repeat these steps for every Standard node pool in the cluster.

Note: Autopilot clusters automatically manage node upgrades and repairs. These settings cannot be disabled or manually configured for Autopilot nodes. If the node-pool management options are not available in your Console, use the Google Cloud CLI commands below.

Remediation via Google Cloud CLI

  1. Open the Google Cloud Console and launch Cloud Shell. GCP Cloud Shell
  2. List the node pools that do not have both auto-upgrade and auto-repair enabled. The output shows the cluster, its location, the node pool, and the two settings:

    gcloud container clusters list --format=json | jq -r '.[]
      | .name as $cluster | .location as $location
      | .nodePools[]?
      | select(((.management.autoUpgrade // false) | not)
          or ((.management.autoRepair // false) | not))
      | [$cluster, $location, .name,
         (.management.autoUpgrade // false),
         (.management.autoRepair // false)]
      | @tsv'
    
  3. Enable auto-upgrade and auto-repair on the node pool:

    gcloud container node-pools update <NODE_POOL_NAME> \
    --cluster <CLUSTER_NAME> \
    --location <LOCATION> \
    --enable-autoupgrade \
    --enable-autorepair
    
  4. Verify the settings:

    gcloud container node-pools describe <NODE_POOL_NAME> \
    --cluster <CLUSTER_NAME> \
    --location <LOCATION> \
    --format="yaml(management)"
    

    Replace <NODE_POOL_NAME> with the name of the node pool, <CLUSTER_NAME> with the name of your GKE cluster, and <LOCATION> with its region or zone. The output must show autoRepair: true and autoUpgrade: true. Repeat steps 3 and 4 for every node pool that step 2 lists. Auto-upgrade restarts nodes in a rolling update, so set a maintenance window and enough surge capacity, and make sure your workloads tolerate nodes being replaced.

Default Value

Auto-upgrade and auto-repair are enabled by default on new node pools. They can be turned off on older Standard node pools. Autopilot clusters manage their nodes automatically.

Updated on 09 November, 2026