From 2498700d5b32dcb682dbbf5bb7a1ce9f45af3e8f Mon Sep 17 00:00:00 2001 From: Kuni Sen Date: Fri, 31 Oct 2025 14:51:21 +0900 Subject: [PATCH 1/4] Reflect podman 5.4 support in ECE doc Reflect podman 5.4 support in ECE doc --- .../cloud-enterprise/configure-host-rhel.md | 12 +++++------ .../migrate-ece-to-podman-hosts.md | 14 ++++++------- .../cloud-enterprise/migrate-to-podman-5.md | 20 +++++++++---------- 3 files changed, 23 insertions(+), 23 deletions(-) diff --git a/deploy-manage/deploy/cloud-enterprise/configure-host-rhel.md b/deploy-manage/deploy/cloud-enterprise/configure-host-rhel.md index fc9d83daf3..27f52e3dfe 100644 --- a/deploy-manage/deploy/cloud-enterprise/configure-host-rhel.md +++ b/deploy-manage/deploy/cloud-enterprise/configure-host-rhel.md @@ -103,23 +103,23 @@ Make sure to use a supported combination of Linux distribution and container eng * Install the latest available version of Podman `5.2.2` using dnf. :::{note} - Podman versions `5.2.2-11` and `5.2.2-13` are affected by a known [memory leak issue](https://github.com/containers/podman/issues/25473). To avoid this bug, use a later build of `5.2.2`, such as `5.2.2-16` or newer. Refer to the official [Support matrix](https://www.elastic.co/support/matrix#elastic-cloud-enterprise) for more information. + Podman versions `5.2.2-11` and `5.2.2-13` are affected by a known [memory leak issue](https://github.com/containers/podman/issues/25473). To avoid this bug, use a later version. Refer to the official [Support matrix](https://www.elastic.co/support/matrix#elastic-cloud-enterprise) for more information. ::: ```sh - sudo dnf install podman-5.2.2 podman-remote-5.2.2 + sudo dnf install podman-5.4.* podman-remote-5.4.* ``` - * To prevent automatic Podman updates to unsupported versions, configure the Podman version to be locked at version `5.2.2`. + * To prevent automatic Podman updates to unsupported versions, configure the Podman version to be locked at version `5.4.*`. ```sh ## Install versionlock sudo dnf install 'dnf-command(versionlock)' ## Lock major version - sudo dnf versionlock add --raw 'podman-5.2.2' - sudo dnf versionlock add --raw 'podman-remote-5.2.2' + sudo dnf versionlock add --raw 'podman-5.4.*' + sudo dnf versionlock add --raw 'podman-remote-5.4.*' - ## Verify that podman-5.2.2 and podman-remote-5.2.2 appear in the output + ## Verify that podman-5.4.* and podman-remote-5.4.* appear in the output sudo dnf versionlock list ``` diff --git a/deploy-manage/deploy/cloud-enterprise/migrate-ece-to-podman-hosts.md b/deploy-manage/deploy/cloud-enterprise/migrate-ece-to-podman-hosts.md index 1cee5751a0..fbc064a76d 100644 --- a/deploy-manage/deploy/cloud-enterprise/migrate-ece-to-podman-hosts.md +++ b/deploy-manage/deploy/cloud-enterprise/migrate-ece-to-podman-hosts.md @@ -129,27 +129,27 @@ Using Docker or Podman as container runtime is a configuration local to the host * For Podman 5 - * Install the latest available version of Podman `5.2.2` using dnf. + * Install the latest available version of Podman `5.4` using dnf. :::{note} - Podman versions `5.2.2-11` and `5.2.2-13` are affected by a known [memory leak issue](https://github.com/containers/podman/issues/25473). To avoid this bug, use a later build of `5.2.2`, such as `5.2.2-16` or newer. Refer to the official [Support matrix](https://www.elastic.co/support/matrix#elastic-cloud-enterprise) for more information. + Podman versions `5.2.2-11` and `5.2.2-13` are affected by a known [memory leak issue](https://github.com/containers/podman/issues/25473). To avoid this bug, use a later version. Refer to the official [Support matrix](https://www.elastic.co/support/matrix#elastic-cloud-enterprise) for more information. ::: ```sh - sudo dnf install podman-5.2.2 podman-remote-5.2.2 + sudo dnf install podman-5.4.* podman-remote-5.4.* ``` - * To prevent automatic Podman updates to unsupported versions, configure the Podman version to be locked at version `5.2.2`. + * To prevent automatic Podman updates to unsupported versions, configure the Podman version to be locked at version `5.4.*`. ```sh ## Install versionlock sudo dnf install 'dnf-command(versionlock)' ## Lock major version - sudo dnf versionlock add --raw 'podman-5.2.2' - sudo dnf versionlock add --raw 'podman-remote-5.2.2' + sudo dnf versionlock add --raw 'podman-5.4.*' + sudo dnf versionlock add --raw 'podman-remote-5.4.*' - ## Verify that podman-5.2.2 and podman-remote-5.2.2 appear in the output + ## Verify that podman-5.4.* and podman-remote-5.4.* appear in the output sudo dnf versionlock list ``` diff --git a/deploy-manage/deploy/cloud-enterprise/migrate-to-podman-5.md b/deploy-manage/deploy/cloud-enterprise/migrate-to-podman-5.md index f414b1af51..5f30afe94c 100644 --- a/deploy-manage/deploy/cloud-enterprise/migrate-to-podman-5.md +++ b/deploy-manage/deploy/cloud-enterprise/migrate-to-podman-5.md @@ -13,21 +13,21 @@ This guide describes the supported ways to upgrade or migrate your {{ece}} (ECE) * **Grow-and-shrink upgrade**: [Add new hosts](./install-ece-on-additional-hosts.md) running the desired Podman version to your ECE installation, then [remove the old ones](/deploy-manage/uninstall/uninstall-elastic-cloud-enterprise.md). This method is safer and preferred, as it avoids potential risks associated with upgrading the container engine or the operating system in place. -ECE only supports Podman 5 in version `5.2.2`, regardless of your upgrade method. Later versions such as `5.2.3` and above are not supported. Refer always to the official [Support matrix](https://www.elastic.co/support/matrix#elastic-cloud-enterprise) for details on supported versions. +ECE supports Podman 5 in version `5.4`, regardless of your upgrade method. Refer always to the official [Support matrix](https://www.elastic.co/support/matrix#elastic-cloud-enterprise) for details on supported versions. :::{important} -Podman versions `5.2.2-11` and `5.2.2-13` are affected by a known [memory leak issue](https://github.com/containers/podman/issues/25473). To avoid this issue, use a later build such as `5.2.2-16` or newer. +Podman versions `5.2.2-11` and `5.2.2-13` are affected by a known [memory leak issue](https://github.com/containers/podman/issues/25473). To avoid this issue, use a later podman version. ::: The following table summarizes the supported upgrade paths to Podman 5 in ECE. -| **From ↓** ... **To →** | Podman 5.2.2-latest | Podman 5.2.3 | -|-----------------------------------------|-----------------|--------------| -| ** (grow)** | ✓ | X | -| **Docker (grow-and-shrink)** | ✓ | X | -| **Podman 4.9.4 (grow-and-shrink)** | ✓ | X | -| **Podman 4.9.4 (in-place)** | ✓ | X | -| **Podman 5.2.2 (grow-and-shrink)** | ✓ | X | -| **Podman 5.2.2 (in-place)** | ✓ | X | +| **From ↓** ... **To →** | Podman 5.4 | +|-----------------------------------------|-----------------| +| ** (grow)** | ✓ | +| **Docker (grow-and-shrink)** | ✓ | +| **Podman 4.9.4 (grow-and-shrink)** | ✓ | +| **Podman 4.9.4 (in-place)** | ✓ | +| **Podman 5.2.2 (grow-and-shrink)** | ✓ | +| **Podman 5.2.2 (in-place)** | ✓ | As shown in the table above, [migrations from Docker](./migrate-ece-to-podman-hosts.md) are only supported using the grow-and-shrink method. From de257ba5a6a59e6436fcd045f8673beabb46945c Mon Sep 17 00:00:00 2001 From: Kuni Sen Date: Fri, 31 Oct 2025 14:59:34 +0900 Subject: [PATCH 2/4] Update configure-host-rhel.md --- deploy-manage/deploy/cloud-enterprise/configure-host-rhel.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/deploy-manage/deploy/cloud-enterprise/configure-host-rhel.md b/deploy-manage/deploy/cloud-enterprise/configure-host-rhel.md index 27f52e3dfe..0db1974f0e 100644 --- a/deploy-manage/deploy/cloud-enterprise/configure-host-rhel.md +++ b/deploy-manage/deploy/cloud-enterprise/configure-host-rhel.md @@ -100,7 +100,7 @@ Make sure to use a supported combination of Linux distribution and container eng * For Podman 5 - * Install the latest available version of Podman `5.2.2` using dnf. + * Install the latest available version of Podman `5.4` using dnf. :::{note} Podman versions `5.2.2-11` and `5.2.2-13` are affected by a known [memory leak issue](https://github.com/containers/podman/issues/25473). To avoid this bug, use a later version. Refer to the official [Support matrix](https://www.elastic.co/support/matrix#elastic-cloud-enterprise) for more information. From d29ebea9533c20cd6b2d399c7f2e8887c37df19a Mon Sep 17 00:00:00 2001 From: Kuni Sen Date: Thu, 6 Nov 2025 13:53:30 +0900 Subject: [PATCH 3/4] update to reflect the sync result with ECE dev --- .../deploy/cloud-enterprise/configure-host-rhel.md | 12 ++++++------ .../cloud-enterprise/migrate-ece-to-podman-hosts.md | 12 ++++++------ .../deploy/cloud-enterprise/migrate-to-podman-5.md | 4 ++-- 3 files changed, 14 insertions(+), 14 deletions(-) diff --git a/deploy-manage/deploy/cloud-enterprise/configure-host-rhel.md b/deploy-manage/deploy/cloud-enterprise/configure-host-rhel.md index 0db1974f0e..1a89f797c4 100644 --- a/deploy-manage/deploy/cloud-enterprise/configure-host-rhel.md +++ b/deploy-manage/deploy/cloud-enterprise/configure-host-rhel.md @@ -100,26 +100,26 @@ Make sure to use a supported combination of Linux distribution and container eng * For Podman 5 - * Install the latest available version of Podman `5.4` using dnf. + * Install the latest available version `5.*` using dnf. :::{note} Podman versions `5.2.2-11` and `5.2.2-13` are affected by a known [memory leak issue](https://github.com/containers/podman/issues/25473). To avoid this bug, use a later version. Refer to the official [Support matrix](https://www.elastic.co/support/matrix#elastic-cloud-enterprise) for more information. ::: ```sh - sudo dnf install podman-5.4.* podman-remote-5.4.* + sudo dnf install podman-5.* podman-remote-5.* ``` - * To prevent automatic Podman updates to unsupported versions, configure the Podman version to be locked at version `5.4.*`. + * To prevent automatic Podman major version updates, configure the Podman version to be locked at version `5.*` while still allowing minor and patch updates. ```sh ## Install versionlock sudo dnf install 'dnf-command(versionlock)' ## Lock major version - sudo dnf versionlock add --raw 'podman-5.4.*' - sudo dnf versionlock add --raw 'podman-remote-5.4.*' + sudo dnf versionlock add --raw 'podman-5.*' + sudo dnf versionlock add --raw 'podman-remote-5.*' - ## Verify that podman-5.4.* and podman-remote-5.4.* appear in the output + ## Verify that podman-5.* and podman-remote-5.* appear in the output sudo dnf versionlock list ``` diff --git a/deploy-manage/deploy/cloud-enterprise/migrate-ece-to-podman-hosts.md b/deploy-manage/deploy/cloud-enterprise/migrate-ece-to-podman-hosts.md index fbc064a76d..b4ab3000aa 100644 --- a/deploy-manage/deploy/cloud-enterprise/migrate-ece-to-podman-hosts.md +++ b/deploy-manage/deploy/cloud-enterprise/migrate-ece-to-podman-hosts.md @@ -129,27 +129,27 @@ Using Docker or Podman as container runtime is a configuration local to the host * For Podman 5 - * Install the latest available version of Podman `5.4` using dnf. + * Install the latest available version `5.*` using dnf. :::{note} Podman versions `5.2.2-11` and `5.2.2-13` are affected by a known [memory leak issue](https://github.com/containers/podman/issues/25473). To avoid this bug, use a later version. Refer to the official [Support matrix](https://www.elastic.co/support/matrix#elastic-cloud-enterprise) for more information. ::: ```sh - sudo dnf install podman-5.4.* podman-remote-5.4.* + sudo dnf install podman-5.* podman-remote-5.* ``` - * To prevent automatic Podman updates to unsupported versions, configure the Podman version to be locked at version `5.4.*`. + * To prevent automatic Podman major version updates, configure the Podman version to be locked at version `5.*` while still allowing minor and patch updates. ```sh ## Install versionlock sudo dnf install 'dnf-command(versionlock)' ## Lock major version - sudo dnf versionlock add --raw 'podman-5.4.*' - sudo dnf versionlock add --raw 'podman-remote-5.4.*' + sudo dnf versionlock add --raw 'podman-5.*' + sudo dnf versionlock add --raw 'podman-remote-5.*' - ## Verify that podman-5.4.* and podman-remote-5.4.* appear in the output + ## Verify that podman-5.* and podman-remote-5.* appear in the output sudo dnf versionlock list ``` diff --git a/deploy-manage/deploy/cloud-enterprise/migrate-to-podman-5.md b/deploy-manage/deploy/cloud-enterprise/migrate-to-podman-5.md index 5f30afe94c..8424603440 100644 --- a/deploy-manage/deploy/cloud-enterprise/migrate-to-podman-5.md +++ b/deploy-manage/deploy/cloud-enterprise/migrate-to-podman-5.md @@ -13,7 +13,7 @@ This guide describes the supported ways to upgrade or migrate your {{ece}} (ECE) * **Grow-and-shrink upgrade**: [Add new hosts](./install-ece-on-additional-hosts.md) running the desired Podman version to your ECE installation, then [remove the old ones](/deploy-manage/uninstall/uninstall-elastic-cloud-enterprise.md). This method is safer and preferred, as it avoids potential risks associated with upgrading the container engine or the operating system in place. -ECE supports Podman 5 in version `5.4`, regardless of your upgrade method. Refer always to the official [Support matrix](https://www.elastic.co/support/matrix#elastic-cloud-enterprise) for details on supported versions. +ECE supports Podman 5, regardless of your upgrade method. Refer always to the official [Support matrix](https://www.elastic.co/support/matrix#elastic-cloud-enterprise) for details on supported versions. :::{important} Podman versions `5.2.2-11` and `5.2.2-13` are affected by a known [memory leak issue](https://github.com/containers/podman/issues/25473). To avoid this issue, use a later podman version. @@ -21,7 +21,7 @@ Podman versions `5.2.2-11` and `5.2.2-13` are affected by a known [memory leak i The following table summarizes the supported upgrade paths to Podman 5 in ECE. -| **From ↓** ... **To →** | Podman 5.4 | +| **From ↓** ... **To →** | Podman 5 | |-----------------------------------------|-----------------| | ** (grow)** | ✓ | | **Docker (grow-and-shrink)** | ✓ | From 93dbbedaef75cc529025e03818dd1c485d762a76 Mon Sep 17 00:00:00 2001 From: shainaraskas <58563081+shainaraskas@users.noreply.github.com> Date: Mon, 10 Nov 2025 11:42:44 -0500 Subject: [PATCH 4/4] Apply suggestions from code review --- deploy-manage/deploy/cloud-enterprise/migrate-to-podman-5.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/deploy-manage/deploy/cloud-enterprise/migrate-to-podman-5.md b/deploy-manage/deploy/cloud-enterprise/migrate-to-podman-5.md index 8424603440..b582317eb3 100644 --- a/deploy-manage/deploy/cloud-enterprise/migrate-to-podman-5.md +++ b/deploy-manage/deploy/cloud-enterprise/migrate-to-podman-5.md @@ -13,10 +13,10 @@ This guide describes the supported ways to upgrade or migrate your {{ece}} (ECE) * **Grow-and-shrink upgrade**: [Add new hosts](./install-ece-on-additional-hosts.md) running the desired Podman version to your ECE installation, then [remove the old ones](/deploy-manage/uninstall/uninstall-elastic-cloud-enterprise.md). This method is safer and preferred, as it avoids potential risks associated with upgrading the container engine or the operating system in place. -ECE supports Podman 5, regardless of your upgrade method. Refer always to the official [Support matrix](https://www.elastic.co/support/matrix#elastic-cloud-enterprise) for details on supported versions. +ECE supports Podman 5, regardless of your upgrade method. Refer to the official [Support matrix](https://www.elastic.co/support/matrix#elastic-cloud-enterprise) for details on supported versions. :::{important} -Podman versions `5.2.2-11` and `5.2.2-13` are affected by a known [memory leak issue](https://github.com/containers/podman/issues/25473). To avoid this issue, use a later podman version. +Podman versions `5.2.2-11` and `5.2.2-13` are affected by a known [memory leak issue](https://github.com/containers/podman/issues/25473). To avoid this issue, use a later Podman version. ::: The following table summarizes the supported upgrade paths to Podman 5 in ECE.