Skip to content

Commit 4614145

Browse files
authored
editorial changes
1 parent b0ec95d commit 4614145

1 file changed

Lines changed: 9 additions & 10 deletions

File tree

support/azure/azure-kubernetes/create-upgrade-delete/aks-memory-saturation-after-upgrade.md

Lines changed: 9 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Memory saturation occurs after upgrade to Kubernetes 1.25
33
description: Resolve pod failures caused by memory saturation and out-of-memory errors after you upgrade an Azure Kubernetes Service (AKS) cluster to Kubernetes 1.25.x.
4-
ms.date: 04/17/2025
4+
ms.date: 05/02/2025
55
editor: v-jsitser,momajed
66
ms.reviewer: aritraghosh, cssakscic, v-leedennis,momajed
77
ms.service: azure-kubernetes-service
@@ -34,6 +34,9 @@ Performance degradation can occur in apps that run in the following environments
3434
3535
## Solution
3636

37+
> [!NOTE]
38+
> If you only experience increased memory usage and no other symptoms that are mentioned in the [Symptoms](#symptoms) section, no action is needed.
39+
3740
Beginning in the release of Kubernetes 1.25, the [cgroup version 2 API](https://kubernetes.io/blog/2022/08/31/cgroupv2-ga-1-25/) has reached general availability (GA). AKS now uses Ubuntu Linux version 22.04. By default, version 22.04 uses cgroup version 2 API. To make sure the cgroup version 2 API is available for use in other environments to prevent the memory saturation issue, follow this guidance:
3841

3942
- If you run Java applications, [upgrade to a Java version that supports cgroup version 2](https://kubernetes.io/blog/2022/08/31/cgroupv2-ga-1-25/#migrate-to-cgroup-v2) and follow the guidance in [Containerize your Java applications](/azure/developer/java/containers/overview). You might be able to update the base image in certain versions in which the fix has been backported. Use a version or framework that natively supports cgroup version 2. For Azure customers, Microsoft officially supports [Eclipse Temurin](https://adoptium.net/) binaries (Java 8) and [Microsoft Build of OpenJDK](https://www.microsoft.com/openjdk) binaries (Java 11+).
@@ -60,18 +63,14 @@ Beginning in the release of Kubernetes 1.25, the [cgroup version 2 API](https://
6063

6164
- An alternative temporary solution is to revert the `cgroup` version on your nodes by using the DaemonSet. For more information, see [Revert to cgroup v1 DaemonSet](https://github.com/Azure/AKS/blob/master/examples/cgroups/revert-cgroup-v1.yaml).
6265

63-
> [!IMPORTANT]
64-
> - Use the DaemonSet cautiously. Test it in a lower environment before applying to production to ensure compatibility and prevent disruptions.
65-
> - By default, the DaemonSet applies to all nodes in the cluster and reboots them to implement the `cgroup` change.
66-
> - To control how the DaemonSet is applied, configure a `nodeSelector` to target specific nodes.
67-
68-
69-
> [!NOTE]
70-
> If you experience only an increase in memory use without any of the other symptoms that are mentioned in the "Symptoms" section, you don't have to take any action.
66+
> [!IMPORTANT]
67+
> - Use the DaemonSet cautiously. Test it in a lower environment before applying to production to ensure compatibility and avoid disruptions.
68+
> - The DaemonSet applies to all nodes in the cluster by default and reboots them to implement the `cgroup` change.
69+
> - To control how the DaemonSet is applied, configure a `nodeSelector` to target specific nodes.
7170
7271
## Status
7372

74-
We're actively working with the Kubernetes community to resolve the underlying issue. Progress on this effort can be tracked at [Azure/AKS Issue #3443](https://github.com/kubernetes/kubernetes/issues/118916).
73+
We are working with the Kubernetes community to resolve the issue. Track progress at [Azure/AKS Issue #3443](https://github.com/kubernetes/kubernetes/issues/118916).
7574

7675
As part of the resolution, we plan to adjust the eviction thresholds or update [resource reservations](/azure/aks/concepts-clusters-workloads#resource-reservations), depending on the outcome of the fix.
7776

0 commit comments

Comments
 (0)