Skip to content

Conversation

kunisen
Copy link
Contributor

@kunisen kunisen commented Jun 5, 2025

Description

Previously we specify Ubuntu (Operating system / OS) version directly like 20.04 or 22.04.
However, we later also 24.04, and maybe in the future we will have even more versions.

All the compatible and supported version could be found in our support matrix - https://www.elastic.co/support/matrix#elastic-cloud-enterprise.

But writing the version directly to public doc page other than support matrix seems to be easily forgotten to update, and thus we are left behind in public doc page that it does not mention 24.04 now.
=> This causes confusion on users, because it's telling different in between public ECE docs and support matrix.

This was brought up by @rheppe in an internal discussion here.

The rationale is that support matrix is the source of truth, per what we have confirmed with @Kushmaro. So we would like to update the public docs based on support matrix.

Additional Notes

  • We removed note Docker 25 and higher are not compatible with ECE 3.7. because the current branch of docs is for ECE 4.0, and we can see from support matrix, it's supported.
  • We also explicitly mentioned that, the command mentioned in sudo apt install -y docker-ce=5:24.0.* docker-ce-cli=5:24.0.* containerd.io is just an example of install Docker 24.0 on Ubuntu. We added this because per support matrix, ECE 4.0 also supports other docker versions, and we can see from the screenshots below, it's hard to make an exclusive list in the public doc page, thus it makes more logical sense to say "it's a command example".
image

Before / After PR merge

Before

image

After

No 20.04 or 22.04 version number present

image

kunisen added 3 commits June 4, 2025 18:03
## Description

Previously the latest version of podman 5.2.2 was 5.2.2-13. However, now the latest version is 5.2.2-15.

We have confirmed with that @matt-elastic in an [internal discussion here](https://elastic.slack.com/archives/CS5UH0E3T/p1748867788234029?thread_ts=1748577885.885639&cid=CS5UH0E3T) that it makes sense to make such change.

Thus, we need to update the public doc to reflect this.
Also, we want to avoid saying 5.2.2-15 and then later we need to update the public docs again, so we are using a more generic way to express it.
## Description

Previously we specify Ubuntu (Operating system / OS) version directly like 20.04 or 22.04.

However, we later also 24.04, and maybe in the future we will have even more versions.

All the compatible and supported version could be found in our support matrix - https://www.elastic.co/support/matrix#elastic-cloud-enterprise.

But writing the version directly to public doc page other than support matrix seems to be easily forgotten to update, and thus we are left behind in public doc page that it does not mention 24.04 now.
@kunisen kunisen self-assigned this Jun 5, 2025
@kunisen kunisen requested a review from a team as a code owner June 5, 2025 10:11
@kunisen kunisen added documentation Improvements or additions to documentation supportability ability enable self-service or support of product ece Elastic Cloud Enterprise labels Jun 5, 2025
@kunisen kunisen changed the title Kunisen docpr slack 20250605 [ECE] Clarify supported Ubuntu version Jun 5, 2025
@kunisen
Copy link
Contributor Author

kunisen commented Jun 5, 2025

It seems like this PR wrongly contains contents from other PRs / commits. I will close this one and file a new clean one. Sorry for the noise.

@kunisen kunisen closed this Jun 5, 2025
kunisen added a commit that referenced this pull request Jun 12, 2025
(This is the 2nd try of previously wrongly raised PR -
#1620)

## Description

Previously we specify Ubuntu (Operating system / OS) version directly
like 20.04 or 22.04.
However, we later also 24.04, and maybe in the future we will have even
more versions.

All the compatible and supported version could be found in our support
matrix - https://www.elastic.co/support/matrix#elastic-cloud-enterprise.

But writing the version directly to public doc page other than support
matrix seems to be easily forgotten to update, and thus we are left
behind in public doc page that it does not mention 24.04 now.
=> This causes confusion on users, because it's telling different in
between public ECE docs and support matrix.

This was brought up by @rheppe in an internal discussion
[here](https://elastic.slack.com/archives/C045W6699NH/p1748919036870519?thread_ts=1748559251.195289&cid=C045W6699NH).

The rationale is that support matrix is the source of truth, per what we
have confirmed with @Kushmaro. So we would like to update the public
docs based on support matrix.

## Additional Notes

- We removed note `Docker 25 and higher are not compatible with ECE
3.7.` because the current branch of docs is for ECE 4.0, and we can see
from support matrix, it's supported.
- We also explicitly mentioned that, the command mentioned in `sudo apt
install -y docker-ce=5:24.0.* docker-ce-cli=5:24.0.* containerd.io` is
just an example of install Docker 24.0 on Ubuntu. We added this because
per support matrix, ECE 4.0 also supports other docker versions, and we
can see from the screenshots below, it's hard to make an exclusive list
in the public doc page, thus it makes more logical sense to say "it's a
command example".

<img width="1728" alt="image"
src="https://github.com/user-attachments/assets/ca2f0c00-427c-46cf-b2fe-05e69a527e90"
/>


## Before / After PR merge

### Before

<img width="1225" alt="image"
src="https://github.com/user-attachments/assets/94ff5f0d-136d-4382-935c-0bba1252ef6d"
/>


### After

No 20.04 or 22.04 version number present

<img width="1359" alt="image"
src="https://github.com/user-attachments/assets/76ad92e3-a439-467a-8f19-75547c8910ba"
/>

---------

Co-authored-by: Edu González de la Herrán <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation ece Elastic Cloud Enterprise supportability ability enable self-service or support of product

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant