From 48d8e9574d04eb2d03950f437d1f546ac0476420 Mon Sep 17 00:00:00 2001
From: Andrey Petrov <andrey@xpetrov.com>
Date: Mon, 15 Dec 2025 20:32:16 +0300
Subject: [PATCH 1/2] Fix VPA updateMode example (Auto deprecated since VPA
 1.4)

---
 en/_tutorials/k8s/vpa-autoscaling.md | 2 +-
 ru/_tutorials/k8s/vpa-autoscaling.md | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/en/_tutorials/k8s/vpa-autoscaling.md b/en/_tutorials/k8s/vpa-autoscaling.md
index c4ffcfc062..5f4b50c550 100644
--- a/en/_tutorials/k8s/vpa-autoscaling.md
+++ b/en/_tutorials/k8s/vpa-autoscaling.md
@@ -120,7 +120,7 @@ The support cost for this solution includes:
        kind:       Deployment
        name:       nginx
      updatePolicy:
-       updateMode:  "Auto"
+       updateMode:  "Recreate"
        minReplicas: 1
    ```
 
diff --git a/ru/_tutorials/k8s/vpa-autoscaling.md b/ru/_tutorials/k8s/vpa-autoscaling.md
index 59382b593a..92a9ddee9f 100644
--- a/ru/_tutorials/k8s/vpa-autoscaling.md
+++ b/ru/_tutorials/k8s/vpa-autoscaling.md
@@ -120,7 +120,7 @@
        kind:       Deployment
        name:       nginx
      updatePolicy:
-       updateMode:  "Auto"
+       updateMode:  "Recreate"
        minReplicas: 1
    ```
 

From 91b4634882a056491ccbefd53f2f490f0af12619 Mon Sep 17 00:00:00 2001
From: Andrey Petrov <andrey@xpetrov.com>
Date: Mon, 15 Dec 2025 21:05:22 +0300
Subject: [PATCH 2/2] Update remaining VPA updateMode references

---
 en/managed-kubernetes/concepts/autoscale.md | 4 +++-
 ru/managed-kubernetes/concepts/autoscale.md | 5 ++++-
 2 files changed, 7 insertions(+), 2 deletions(-)

diff --git a/en/managed-kubernetes/concepts/autoscale.md b/en/managed-kubernetes/concepts/autoscale.md
index 31aa0ad0bc..a285a57069 100644
--- a/en/managed-kubernetes/concepts/autoscale.md
+++ b/en/managed-kubernetes/concepts/autoscale.md
@@ -56,8 +56,10 @@ You can learn more about {{ k8s-hpa }} in the [{{ k8s }} documentation](https://
 If required, {{ k8s-vpa }} allocates additional vCPU and RAM resources to pods.
 
 When [creating a {{ k8s-vpa }}](../operations/autoscale.md#vpa), set the autoscaling option in the specification:
-* `updateMode: "Auto"` for {{ k8s-vpa }} to manage pod resources automatically.
 * `updateMode: "Off"` for {{ k8s-vpa }} to [provide recommendations](https://github.com/kubernetes/autoscaler/tree/master/vertical-pod-autoscaler#quick-start) on managing pod resources without modifying them.
+* `updateMode: "Initial"`, for {{ k8s-vpa }} only sets resource requests when Pods are first created. It does not update resources for already running Pods, even if recommendations change over time.
+* `updateMode: "Recreate"`, for {{ k8s-vpa }} actively manages Pod resources by evicting Pods when their current resource requests differ significantly from recommendations.
+* `updateMode: "InPlaceOrRecreate"`, for {{ k8s-vpa }} attempts to update resource requests and limits without restarting the Pod when possible. If in-place updates are not supported, the Pod is recreated in the same way as in `Recreate` mode. 
 
 You can learn more about {{ k8s-vpa }} in the [{{ k8s }} documentation](https://github.com/kubernetes/autoscaler/tree/master/vertical-pod-autoscaler).
 
diff --git a/ru/managed-kubernetes/concepts/autoscale.md b/ru/managed-kubernetes/concepts/autoscale.md
index 8ba9f67e78..384a65cbd7 100644
--- a/ru/managed-kubernetes/concepts/autoscale.md
+++ b/ru/managed-kubernetes/concepts/autoscale.md
@@ -56,8 +56,11 @@
 {{ k8s-vpa }} при необходимости выделяет дополнительные ресурсы vCPU и RAM для подов.
 
 При [создании {{ k8s-vpa }}](../operations/autoscale.md#vpa) укажите в спецификации опцию автоматического масштабирования:
-* `updateMode: "Auto"`, чтобы {{ k8s-vpa }} автоматически управлял ресурсами подов.
 * `updateMode: "Off"`, чтобы {{ k8s-vpa }} [предоставлял рекомендации](https://github.com/kubernetes/autoscaler/tree/master/vertical-pod-autoscaler#quick-start) по управлению ресурсами подов, но не изменял их.
+* `updateMode: "Initial"`, чтобы {{ k8s-vpa }} применял рекомендации только при создании подов. Для уже запущенных подов ресурсы не изменяются, даже если рекомендации со временем обновляются.
+* `updateMode: "Recreate"`, чтобы {{ k8s-vpa }} автоматически управлял ресурсами подов, пересоздавая их при значительном расхождении между текущими запросами и рекомендациями. После удаления пода контроллер (Deployment, StatefulSet и т. д.) создаёт новый под с обновлёнными значениями ресурсов.
+* `updateMode: "InPlaceOrRecreate"`, чтобы {{ k8s-vpa }} пытался обновлять запросы и лимиты ресурсов без перезапуска пода, если это возможно. Если обновление «in place» недоступно, под будет пересоздан аналогично режиму Recreate.
+В этом режиме используется механизм Resize Container Resources In-Place.
 
 Подробнее о {{ k8s-vpa }} см. в [документации {{ k8s }}](https://github.com/kubernetes/autoscaler/tree/master/vertical-pod-autoscaler).