Resizing the control plane node for a user cluster
Stay organized with collections
Save and categorize content based on your preferences.
This page describes how to resize the Google Distributed Cloud control-plane node for the user cluster. Resizing the
control-plane node means adding or removing CPUs and changing the amount of memory from the control-plane node for the user cluster.
You cannot resize the control-plane node manually if you have enabled automatic node resizing.
To add or remove CPUs and memory in the control-plane node:
Replace ADMIN_CLUSTER_KUBECONFIG with the path of your admin cluster kubeconfig file.
Replace USER_CONFIG_FILE with the path of your user cluster configuration file.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-29 UTC."],[[["\u003cp\u003eThis guide details how to resize the Google Distributed Cloud control-plane node for a user cluster by adjusting CPU and memory resources.\u003c/p\u003e\n"],["\u003cp\u003eResizing involves editing the user cluster configuration file to modify the \u003ccode\u003emasterNode.cpus\u003c/code\u003e and \u003ccode\u003emasterNode.memoryMB\u003c/code\u003e values.\u003c/p\u003e\n"],["\u003cp\u003eManual resizing is not possible if automatic node resizing is enabled.\u003c/p\u003e\n"],["\u003cp\u003eThe update process is performed using the \u003ccode\u003egkectl update cluster\u003c/code\u003e command with the admin cluster kubeconfig and the user cluster configuration file.\u003c/p\u003e\n"]]],[],null,["# Resizing the control plane node for a user cluster\n\nThis page describes how to resize the Google Distributed Cloud control-plane node for the user cluster. Resizing the\ncontrol-plane node means adding or removing CPUs and changing the amount of memory from the control-plane node for the user cluster.\n\nYou cannot resize the control-plane node manually if you have enabled [automatic node resizing](/anthos/clusters/docs/on-prem/1.8/how-to/node-auto-resize).\n\nTo add or remove CPUs and memory in the control-plane node:\n\n1. Edit the [user cluster configuration file](/anthos/clusters/docs/on-prem/1.8/how-to/user-cluster-configuration-file). Change the `masterNode.cpus` and `masterNode.memoryMB` values as desired.\n\n ```\n ...\n masterNode:\n cpus: 4\n memoryMB: 8192\n # How many machines of this type to deploy\n replicas: 3\n ...\n ```\n2. Run this command to update the cluster:\n\n ```\n gkectl update cluster --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config USER_CONFIG_FILE\n ```\n\n Replace \u003cvar class=\"edit\" translate=\"no\"\u003eADMIN_CLUSTER_KUBECONFIG\u003c/var\u003e with the path of your admin cluster kubeconfig file.\n Replace \u003cvar class=\"edit\" translate=\"no\"\u003eUSER_CONFIG_FILE\u003c/var\u003e with the path of your user cluster configuration file."]]
