Skip to content

[ECK-3.3] Update supported versions #4669

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
naemono wants to merge 1 commit into
base: eck-3.3.0
Choose a base branch
from
Open

[ECK-3.3] Update supported versions #4669

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
64 changes: 45 additions & 19 deletions deploy-manage/deploy/cloud-on-k8s.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,11 +14,11 @@ products:

# {{eck}} [k8s-overview]

Built on the Kubernetes Operator pattern, {{eck}} (ECK) extends the basic Kubernetes orchestration capabilities to support the setup and management of {{eck_resources_list}} on Kubernetes.
Built on the {{k8s}} Operator pattern, {{eck}} (ECK) extends the basic {{k8s}} orchestration capabilities to support the setup and management of {{eck_resources_list}} on {{k8s}}.

:::{admonition} Use cloud services in your ECK environment with Cloud Connect
With [Cloud Connect](/deploy-manage/cloud-connect.md), you can use Elastic-managed cloud services in your ECK environment without having to install and manage their infrastructure yourself. In this way, you can get faster access to new features without adding to your operational overhead.
::::
:::

## ECK overview

Expand All @@ -32,9 +32,9 @@ With {{eck}}, you can streamline critical operations, such as:

This section provides everything you need to install, configure, and manage {{stack}} applications with ECK, including:

- [](./cloud-on-k8s/deploy-an-orchestrator.md): ECK installation methods and configuration options. Deploy ECK on managed Kubernetes platforms like GKE, AKS, and EKS, on self-managed Kubernetes clusters, on OpenShift, and even in air-gapped environments.
- [](./cloud-on-k8s/deploy-an-orchestrator.md): ECK installation methods and configuration options. Deploy ECK on managed {{k8s}} platforms like GKE, AKS, and EKS, on self-managed {{k8s}} clusters, on OpenShift, and even in air-gapped environments.
- [](./cloud-on-k8s/manage-deployments.md): Handle {{es}} clusters and {{kib}} instances through ECK.
- [](./cloud-on-k8s/orchestrate-other-elastic-applications.md): Run {{eck_resources_list_short}} on Kubernetes.
- [](./cloud-on-k8s/orchestrate-other-elastic-applications.md): Run {{eck_resources_list_short}} on {{k8s}}.
- [](./cloud-on-k8s/tools-apis.md): A collection of tools and APIs available in ECK based environments.

Other sections of the documentation include the following important topics around ECK:
Expand Down Expand Up @@ -67,57 +67,83 @@ Afterwards, you can:

## Supported versions [k8s-supported]

This section outlines the supported Kubernetes and {{stack}} versions for ECK. Check the full [Elastic support matrix](https://www.elastic.co/support/matrix#matrix_kubernetes) for more information.
This section outlines the supported {{k8s}} and {{stack}} versions for ECK. Check the full [Elastic support matrix](https://www.elastic.co/support/matrix#matrix_kubernetes) for more information.

### Kubernetes compatibility
### {{k8s}} compatibility

ECK is compatible with the following Kubernetes distributions and related technologies:
ECK is compatible with the following {{k8s}} distributions and related technologies:

::::{applies-switch}

:::{applies-item} eck: ga 3.2+
* Kubernetes 1.30-1.34
:::{applies-item} eck: ga 3.3+

* {{k8s}} 1.31-1.35
* OpenShift 4.16-4.20
* Google {{k8s}} Engine (GKE), Azure {{k8s}} Service (AKS), and Amazon Elastic {{k8s}} Service (EKS)
* Helm: {{eck_helm_minimum_version}}+
:::

:::{applies-item} eck: ga =3.2

* {{k8s}} 1.30-1.34
* OpenShift 4.15-4.20
* Google Kubernetes Engine (GKE), Azure Kubernetes Service (AKS), and Amazon Elastic Kubernetes Service (EKS)
* Google {{k8s}} Engine (GKE), Azure {{k8s}} Service (AKS), and Amazon Elastic {{k8s}} Service (EKS)
* Helm: {{eck_helm_minimum_version}}+
:::

:::{applies-item} eck: ga =3.1
* Kubernetes 1.29-1.33

* {{k8s}} 1.29-1.33
* OpenShift 4.15-4.19
* Google Kubernetes Engine (GKE), Azure Kubernetes Service (AKS), and Amazon Elastic Kubernetes Service (EKS)
* Google {{k8s}} Engine (GKE), Azure {{k8s}} Service (AKS), and Amazon Elastic {{k8s}} Service (EKS)
* Helm: {{eck_helm_minimum_version}}+
:::

:::{applies-item} eck: ga =3.0
* Kubernetes 1.28-1.32

* {{k8s}} 1.28-1.32
* OpenShift 4.14-4.18
* Google Kubernetes Engine (GKE), Azure Kubernetes Service (AKS), and Amazon Elastic Kubernetes Service (EKS)
* Google {{k8s}} Engine (GKE), Azure {{k8s}} Service (AKS), and Amazon Elastic {{k8s}} Service (EKS)
* Helm: {{eck_helm_minimum_version}}+
:::

::::

ECK should work with all conformant **installers** listed in these [FAQs](https://github.com/cncf/k8s-conformance/blob/master/faq.md#what-is-a-distribution-hosted-platform-and-an-installer). Distributions include source patches and so may not work as-is with ECK.

Alpha, beta, and stable API versions follow the same [conventions used by Kubernetes](https://kubernetes.io/docs/concepts/overview/kubernetes-api/#api-versioning).
Alpha, beta, and stable API versions follow the same [conventions used by {{k8s}}](https://kubernetes.io/docs/concepts/overview/kubernetes-api/#api-versioning).

### {{stack}} compatibility [stack-compatibility]

ECK is compatible with the following {{stack}} applications:

* {{es}}, {{kib}}, APM Server: 7.17+, 8+, 9+
::::{applies-switch}

:::{applies-item} eck: ga 3.3+
* {{es}}, {{kib}}, APM Server: 8+, 9+
* Enterprise Search: 7.17+, 8+
* Beats: 8+, 9+
* Elastic Agent: 8+, 9+ (Fleet, standalone)
* Elastic Maps Server: 8+, 9+
* Logstash: 8.12+, 9+
:::

:::{applies-item} eck: ga =3.2
Copy link
Collaborator

@shainaraskas shainaraskas Jan 19, 2026 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

if this applicability is relevant to 3.0 to 3.2 (which I suspect given how often / why this area has changed in the past), we can use a range:

Suggested change
:::{applies-item} eck: ga =3.2
:::{applies-item} eck: ga 3.0-3.2

HOWEVER, if you're dropping 7.17 support due to the sunset, then we don't support it for previous eck versions anymore either and we should just use a single compatibility list.

* {{es}}, {{kib}}, APM Server: 7.17+, 8+, 9+
* Enterprise Search: 7.7+, 8+
* Beats: 7.17+, 8+, 9+
* Elastic Agent: 7.10+ (standalone), 7.17+ (Fleet), 8+, 9+
* Elastic Maps Server: 7.17+, 8+, 9+
* Logstash: 8.7+, 9+
* Logstash: 8.12+, 9+
Copy link
Contributor Author

@naemono naemono Jan 15, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think this was a typo, as in our (cloud-on-k8s) 3.2 branch, I see we support Logstash 8.12+, not 8.7+

:::

Copy link

Copilot AI Jan 15, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The Stack compatibility section is missing entries for ECK versions 3.1 and 3.0, while the Kubernetes compatibility section above includes these versions (lines 94-108). For consistency and completeness, the Stack compatibility section should also include applies-item blocks for ECK versions 3.1 and 3.0 with their respective supported Stack application versions.

Suggested change
:::{applies-item} eck: ga =3.1
* {{es}}, {{kib}}, APM Server: 7.17+, 8+, 9+
* Enterprise Search: 7.7+, 8+
* Beats: 7.17+, 8+, 9+
* Elastic Agent: 7.10+ (standalone), 7.17+ (Fleet), 8+, 9+
* Elastic Maps Server: 7.17+, 8+, 9+
* Logstash: 8.12+, 9+
:::
:::{applies-item} eck: ga =3.0
* {{es}}, {{kib}}, APM Server: 7.17+, 8+, 9+
* Enterprise Search: 7.7+, 8+
* Beats: 7.17+, 8+, 9+
* Elastic Agent: 7.10+ (standalone), 7.17+ (Fleet), 8+, 9+
* Elastic Maps Server: 7.17+, 8+, 9+
* Logstash: 8.12+, 9+
:::

Copilot uses AI. Check for mistakes.
Copy link
Collaborator

@shainaraskas shainaraskas Jan 19, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

see my other comment for guidance

::::

{{stack}} application images for the OpenShift-certified {{es}} (ECK) Operator are only available from version 7.10 and later.

## Learn more about ECK [k8s_learn_more_about_eck]

* [Orchestrate {{es}} on Kubernetes](https://www.elastic.co/elasticsearch-kubernetes)
* [Orchestrate {{es}} on {{k8s}}](https://www.elastic.co/elasticsearch-kubernetes)
* [ECK post on the Elastic Blog](https://www.elastic.co/blog/introducing-elastic-cloud-on-kubernetes-the-elasticsearch-operator-and-beyond?elektra=products&storm=sub1)
* [Getting Started With {{eck}} (ECK)](https://www.youtube.com/watch?v=PIJmlYBIFXM)
* [Running the {{stack}} on Kubernetes with ECK](https://www.youtube.com/watch?v=Wf6E3vkvEFM)
* [Running the {{stack}} on {{k8s}} with ECK](https://www.youtube.com/watch?v=Wf6E3vkvEFM)