Cette page explique comment redimensionner manuellement les clusters standards Google Kubernetes Engine (GKE). Le redimensionnement d'un cluster peut viser à augmenter ou à réduire le nombre de nœuds de ce cluster. Vous pouvez également effectuer un autoscaling de votre cluster, où GKE redimensionne automatiquement vos pools de nœuds selon l'évolution des conditions, notamment en cas de changement dans vos charges de travail ou dans votre utilisation des ressources.
Ces instructions ne s'appliquent pas aux clusters Autopilot GKE, qui sont redimensionnés automatiquement en fonction du nombre de pods dans le cluster.
Lorsque vous ajoutez ou supprimez des nœuds de votre cluster, GKE ajoute ou supprime les instances de machine virtuelle (VM) associées des groupes d'instances gérés Compute Engine provisionnés pour vos pools de nœuds. Pour supprimer des nœuds, n'utilisez pas kubectl delete node, car cela ne supprime pas l'instance de VM Compute Engine dans le MIG sous-jacent du pool de nœuds. Utilisez l'autoscaler de cluster ou réduisez manuellement la taille de votre cluster.
Avant de commencer
Avant de commencer, effectuez les tâches suivantes :
Si vous souhaitez utiliser Google Cloud CLI pour cette tâche, installez puis initialisez gcloud CLI. Si vous avez déjà installé gcloud CLI, assurez-vous de disposer de la dernière version en exécutant la commande gcloud components update.
Augmenter la taille de votre cluster
Lorsque vous augmentez la taille d'un cluster, les modifications suivantes se produisent :
Les nouvelles instances de nœud sont créées à l'aide de la même configuration que les instances existantes.
Vous pouvez programmer de nouveaux pods sur les nouvelles instances.
Les pods existants ne sont pas déplacés vers les nouvelles instances.
POOL_NAME : nom du pool de nœuds à redimensionner.
NUM_NODES : nombre de nœuds du pool dans un
cluster zonal. Si vous utilisez des clusters multizones ou régionaux,
NUM_NODES est le nombre de nœuds pour chaque zone dans laquelle se trouvent les
pools de nœuds.
Répétez cette commande pour chaque pool de nœuds. Si votre cluster ne comporte qu'un seul pool de nœuds, omettez l'indicateur --node-pool.
Console
Pour augmenter la taille des pools de nœuds d'un cluster, procédez comme suit :
Accédez à la page Google Kubernetes Engine dans la console Google Cloud .
À côté du cluster que vous souhaitez modifier, cliquez sur more_vertActions, puis sur Modifier.
Cliquez sur l'onglet Nœuds à côté de l'onglet Détails.
Dans la section Pools de nœuds, cliquez sur le nom du pool de nœuds dont vous souhaitez augmenter la taille.
Cliquez sur editRedimensionner.
Dans le champ Nombre de nœuds, saisissez le nombre de nœuds que vous souhaitez inclure dans
le pool de nœuds, puis cliquez sur Redimensionner.
Répétez cette procédure pour chaque pool de nœuds s'il y a lieu.
Réduire la taille de votre cluster
Lorsque vous réduisez la taille d'un cluster, les modifications suivantes se produisent :
GKE arrête progressivement les nœuds en cours de suppression en utilisant le processus de drainage pour supprimer les pods de l'instance. Les valeurs PodDisruptionBudget et terminationGracePeriodSeconds sont toutes deux respectées pendant une heure au maximum.
Les pods gérés par un contrôleur de réplication sont reprogrammés par ce contrôleur pour s'exécuter sur les instances restantes.
Les pods non gérés par un contrôleur de réplication ne sont pas redémarrés.
Le groupe d'instances gérées ne fait pas de distinction entre les instances exécutant des pods et les instances sans pods. La réduction supprime des instances choisies de manière aléatoire.
Pour savoir comment ajouter des pools de nœuds et gérer les pools de nœuds existants, consultez la page
Ajouter et gérer des pools de nœuds.
POOL_NAME : nom du pool de nœuds à redimensionner.
NUM_NODES : nombre de nœuds du pool dans un
cluster zonal. Si vous utilisez des clusters multizones ou régionaux,
NUM_NODES est le nombre de nœuds pour chaque zone dans laquelle se trouvent les
pools de nœuds.
Répétez cette commande pour chaque pool de nœuds. Si votre cluster ne comporte qu'un seul pool de nœuds, omettez l'indicateur --node-pool.
Console
Pour réduire la taille des pools de nœuds d'un cluster, procédez comme suit :
Accédez à la page Google Kubernetes Engine dans la console Google Cloud .
À côté du cluster que vous souhaitez modifier, cliquez sur more_vertActions, puis sur Modifier.
Cliquez sur l'onglet Nœuds à côté de l'onglet Détails.
Dans la section Pools de nœuds, cliquez sur le nom du pool de nœuds dont vous souhaitez réduire la taille.
Cliquez sur editRedimensionner.
Dans le champ Nombre de nœuds, saisissez le nombre de nœuds que vous souhaitez inclure dans
le pool de nœuds, puis cliquez sur Redimensionner.
Répétez cette procédure pour chaque pool de nœuds s'il y a lieu.
Procéder à l'autoscaling d'un cluster
La fonctionnalité d'autoscaling de cluster de GKE redimensionne automatiquement vos pools de nœuds selon l'évolution des conditions, notamment en cas de changement dans vos charges de travail ou dans votre utilisation des ressources.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/04 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/09/04 (UTC)."],[],[],null,["# Resize a Standard cluster by adding or removing nodes\n\n[Standard](/kubernetes-engine/docs/concepts/choose-cluster-mode)\n\n*** ** * ** ***\n\nThis page explains how to manually resize Google Kubernetes Engine (GKE)\nStandard clusters. You can resize a cluster to increase or decrease the\nnumber of nodes in that cluster. Alternatively, you can [autoscale](#autoscale)\nyour cluster, where GKE automatically resizes your node pools in\nresponse to changing conditions, such as changes in your workloads and resource\nusage.\n\nThese instructions don't apply to GKE\n[Autopilot](/kubernetes-engine/docs/concepts/autopilot-overview)\nclusters, which automatically resize based on the number of Pods in the cluster.\n\nWhen you add or remove nodes in your cluster, GKE adds or removes\nthe associated virtual machine (VM) instances from the underlying\nCompute Engine [Managed Instance Groups\n(MIGs)](/compute/docs/instance-groups#managed_instance_groups) provisioned for\nyour node pools. For removing nodes, do not use `kubectl delete node` as this\ndoes not delete the Compute Engine VM instance in the node pool's underlying\nMIG. Use [cluster autoscaler](#autoscale) or manually [decrease the size of your\ncluster](#decrease).\n| **Note:** When you increase or decrease the size of a node pool that spans multiple zones, the new size represents the number of nodes in the node pool per zone. For example, if you have a node pool size of two that spans two zones, the total node count is four. If you resize the node pool to a size of four nodes, the total node count becomes eight.\n\nBefore you begin\n----------------\n\nBefore you start, make sure that you have performed the following tasks:\n\n- Enable the Google Kubernetes Engine API.\n[Enable Google Kubernetes Engine API](https://console.cloud.google.com/flows/enableapi?apiid=container.googleapis.com)\n- If you want to use the Google Cloud CLI for this task, [install](/sdk/docs/install) and then [initialize](/sdk/docs/initializing) the gcloud CLI. If you previously installed the gcloud CLI, get the latest version by running `gcloud components update`. **Note:** For existing gcloud CLI installations, make sure to set the `compute/region` [property](/sdk/docs/properties#setting_properties). If you use primarily zonal clusters, set the `compute/zone` instead. By setting a default location, you can avoid errors in the gcloud CLI like the following: `One of [--zone, --region] must be supplied: Please specify location`. You might need to specify the location in certain commands if the location of your cluster differs from the default that you set.\n\nIncrease the size of your cluster\n---------------------------------\n\nWhen you increase the size of a cluster, the following changes occur:\n\n- New node instances are created using the same configuration as the existing instances.\n- New Pods may be scheduled on the new instances.\n- Existing Pods are **not** moved to the new instances.\n\n### gcloud\n\nTo increase the size of a cluster's node pools, run the [`gcloud container clusters resize`](/sdk/gcloud/reference/container/clusters/resize) command: \n\n```\ngcloud container clusters resize CLUSTER_NAME --node-pool POOL_NAME \\\n --num-nodes NUM_NODES\n```\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003eCLUSTER_NAME\u003c/var\u003e: the name of the cluster to resize.\n- \u003cvar translate=\"no\"\u003ePOOL_NAME\u003c/var\u003e: the name of the node pool to resize.\n- \u003cvar translate=\"no\"\u003eNUM_NODES\u003c/var\u003e: the number of nodes in the pool in a zonal cluster. If you use multi-zonal or regional clusters, \u003cvar translate=\"no\"\u003eNUM_NODES\u003c/var\u003e is the number of nodes for each zone the node pools is in.\n\nRepeat this command for each node pool. If your cluster has only one node\npool, omit the `--node-pool` flag.\n\n### Console\n\nTo increase the size of a cluster's node pools, perform the following steps:\n\n1. Go to the **Google Kubernetes Engine** page in the Google Cloud console.\n\n [Go to Google Kubernetes Engine](https://console.cloud.google.com/kubernetes/list)\n2. Beside the cluster you want to edit, click *more_vert*\n **Actions** , then click **Edit**.\n\n3. Click the **Nodes** tab next to the **Details** tab.\n\n4. In the **Node Pools** section, click the name of the node pool that you\n want to increase in size.\n\n5. Click *edit* **Resize**.\n\n6. In the **Number of nodes** field, enter how many nodes that you want in\n the node pool, and then click **Resize**.\n\n7. Repeat for each node pool as needed.\n\nDecrease the size of your cluster\n---------------------------------\n\n| **Warning:** Do not use both cluster autoscaler and manual resize commands simultaneously on a node pool, as this can cause interactions that result in unstable or incorrect node pool size.\n\nWhen you decrease the size of a cluster, the following changes occur:\n\n- GKE gracefully terminates nodes that are being deleted, using the [drain](https://kubernetes.io/docs/tasks/administer-cluster/safely-drain-node/) process to remove the Pods from the instance. [`PodDisruptionBudget`](https://kubernetes.io/docs/tasks/run-application/configure-pdb/) and [`terminationGracePeriodSeconds`](https://kubernetes.io/docs/concepts/workloads/pods/pod/#termination-of-pods) are both respected for up to one hour.\n- Pods managed by a replication controller are rescheduled by the controller to run on the remaining instances.\n- Pods not managed by a replication controller are not restarted.\n\nThe MIG does not differentiate between instances running\nPods and instances without Pods. Resizing down removes instances at random.\n\nTo learn how to add node pools and to manage existing ones, refer to\n[Adding and managing node pools](/kubernetes-engine/docs/how-to/node-pools). \n\n### gcloud\n\nTo decrease the size of a cluster's node pools, run the [`gcloud container clusters resize`](/sdk/gcloud/reference/container/clusters/resize) command: \n\n```\ngcloud container clusters resize CLUSTER_NAME --node-pool POOL_NAME \\\n --num-nodes NUM_NODES\n```\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003eCLUSTER_NAME\u003c/var\u003e: the name of the cluster to resize.\n- \u003cvar translate=\"no\"\u003ePOOL_NAME\u003c/var\u003e: the name of the node pool to resize.\n- \u003cvar translate=\"no\"\u003eNUM_NODES\u003c/var\u003e: the number of nodes in the pool in a zonal cluster. If you use multi-zonal or regional clusters, \u003cvar translate=\"no\"\u003eNUM_NODES\u003c/var\u003e is the number of nodes for each zone the node pools is in.\n\nRepeat this command for each node pool. If your cluster has only one node\npool, omit the `--node-pool` flag.\n\n### Console\n\nTo decrease the size of a cluster's node pools, perform the following steps:\n\n1. Go to the **Google Kubernetes Engine** page in the Google Cloud console.\n\n [Go to Google Kubernetes Engine](https://console.cloud.google.com/kubernetes/list)\n2. Beside the cluster you want to edit, click *more_vert*\n **Actions** , then click **Edit**.\n\n3. Click the **Nodes** tab next to the **Details** tab.\n\n4. In the **Node Pools** section, click the name of the node pool that you\n want to decrease in size.\n\n5. Click *edit* **Resize**.\n\n6. In the **Number of nodes** field, enter how many nodes that you want in\n the node pool, and then click **Resize**.\n\n7. Repeat for each node pool as needed.\n\nAutoscaling a cluster\n---------------------\n\nGKE's [cluster autoscaler](/kubernetes-engine/docs/concepts/cluster-autoscaler) feature automatically resizes\nyour node pools in response to changing conditions, such as changes in your\nworkloads and resource usage.\n\nTo learn more about how autoscaling works, refer to the [cluster autoscaler](/kubernetes-engine/docs/concepts/cluster-autoscaler)\ndocumentation. To set up autoscaling for your cluster, see\n[Autoscaling a cluster](/kubernetes-engine/docs/how-to/cluster-autoscaler).\n\nWhat's next\n-----------\n\n- [Learn more about clusters](/kubernetes-engine/docs/concepts/cluster-architecture)."]]
