Skip to content

ECE 4.0.1 updates related to default stack packs #2434

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

Merged
merged 5 commits into from
Aug 7, 2025
Merged

ECE 4.0.1 updates related to default stack packs #2434

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
b21cec3
ECE 4.0.1 updates related to default stack packs
eedugon Aug 6, 2025
b3fac93
ECE 4.0.1 updates related to default stack packs
eedugon Aug 6, 2025
9c0d4a4
Merge branch 'main' into ece_offline_version_fix2
eedugon Aug 6, 2025
8a6245e
Merge branch 'main' into ece_offline_version_fix2
eedugon Aug 7, 2025
d40fd57
ece offline installation with registry updated to fix image versions
eedugon Aug 7, 2025
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
2 changes: 1 addition & 1 deletion deploy-manage/deploy/cloud-enterprise/default-system-deployment-versions.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ Note that since version 2.7.0, system deployments are automatically upgraded whe

| {{ece}} version | Admin cluster | Logging & Metrics cluster | Security cluster |
| --- | --- | --- | --- |
| 4.0.1 | 8.18.0 | 8.18.0 | 8.18.0 |
| 4.0.1 | 8.18.2 | 8.18.2 | 8.18.2 |
| 4.0.0 | 8.18.0 | 8.18.0 | 8.18.0 |
| 3.8.1 | 8.17.4 | 8.17.4 | 8.17.4 |
| 3.8.0 | 8.17.4 | 8.17.4 | 8.17.4 |
Expand Down
16 changes: 8 additions & 8 deletions deploy-manage/deploy/cloud-enterprise/ece-install-offline-images.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,18 +12,18 @@ products:

Versions of the {{stack}}, containing {{es}}, {{kib}}, and other products, are available as downloadable Docker images.

The first table contains the stack versions that shipped with the 4.0 version of {{ece}}. You can also check the [most recent stack packs and Docker images](#ece-recent-download-list), which might have released after the 4.0 version of ECE, as well as the [full list of available stack packs and Docker images](#ece-full-download-list).
The first table contains the stack versions shipped with the current {{version.ece}} version of {{ece}}. You can also check the [most recent stack packs and Docker images](#ece-recent-download-list), which might have released after the current version of ECE, as well as the [full list of available stack packs and Docker images](#ece-full-download-list).

| Docker images included with {{ece}} {{version.ece}} |
| --- |
| docker.elastic.co/cloud-enterprise/elastic-cloud-enterprise:{{version.ece}} |
| docker.elastic.co/cloud-release/elasticsearch-cloud-ess:8.18.0 |
| docker.elastic.co/cloud-release/kibana-cloud:8.18.0 |
| docker.elastic.co/cloud-release/elastic-agent-cloud:8.18.0 |
| docker.elastic.co/cloud-release/enterprise-search-cloud:8.18.0 |
| docker.elastic.co/cloud-release/elasticsearch-cloud-ess:9.0.0 |
| docker.elastic.co/cloud-release/kibana-cloud:9.0.0 |
| docker.elastic.co/cloud-release/elastic-agent-cloud:9.0.0 |
| docker.elastic.co/cloud-release/elasticsearch-cloud-ess:8.18.2 |
| docker.elastic.co/cloud-release/kibana-cloud:8.18.2 |
| docker.elastic.co/cloud-release/elastic-agent-cloud:8.18.2 |
| docker.elastic.co/cloud-release/enterprise-search-cloud:8.18.2 |
| docker.elastic.co/cloud-release/elasticsearch-cloud-ess:9.0.1 |
| docker.elastic.co/cloud-release/kibana-cloud:9.0.1 |
| docker.elastic.co/cloud-release/elastic-agent-cloud:9.0.1 |

$$$ece-all-stacks$$$Additional {{stack}} versions are available as Docker images that you can use with ECE. For offline installations, you need to download both the {{stack}} pack and the Docker images for the same version.

Expand Down
51 changes: 26 additions & 25 deletions deploy-manage/deploy/cloud-enterprise/ece-install-offline-no-registry.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,51 +11,52 @@ products:

# Air-gapped install without a private Docker registry [ece-install-offline-no-registry]

To perform an offline installation without a private Docker registry, you have to download the available Docker Images on each host.
To perform an offline installation without a private Docker registry, you have to download the required Docker images on each host.

1. On an internet-connected host that has Docker installed, download the [Available Docker Images](ece-install-offline-images.md). Note that for ECE version 4.0, if you want to use {{stack}} version 9.0 in your deployments, you need to download and make available both the version 8.x and version 9.x Docker images (the version 8.x images are required for system deployments).
1. On an internet-connected host with Docker installed, download the Docker images required by the {{ece}} version you want to install. Refer to [available docker images](ece-install-offline-images.md) for more information.

For example, for {{ece}} {{version.ece}} and the {{stack}} versions it includes, you need:

```sh subs=true
docker pull docker.elastic.co/cloud-enterprise/elastic-cloud-enterprise:{{version.ece}}
docker pull docker.elastic.co/cloud-release/elasticsearch-cloud-ess:8.18.2
docker pull docker.elastic.co/cloud-release/kibana-cloud:8.18.2
docker pull docker.elastic.co/cloud-release/elastic-agent-cloud:8.18.0
docker pull docker.elastic.co/cloud-release/enterprise-search-cloud:8.18.0
docker pull docker.elastic.co/cloud-release/elasticsearch-cloud-ess:9.0.0
docker pull docker.elastic.co/cloud-release/kibana-cloud:9.0.0
docker pull docker.elastic.co/cloud-release/elastic-agent-cloud:9.0.0
docker pull docker.elastic.co/cloud-release/elastic-agent-cloud:8.18.2
docker pull docker.elastic.co/cloud-release/enterprise-search-cloud:8.18.2
docker pull docker.elastic.co/cloud-release/elasticsearch-cloud-ess:9.0.1
docker pull docker.elastic.co/cloud-release/kibana-cloud:9.0.1
docker pull docker.elastic.co/cloud-release/elastic-agent-cloud:9.0.1
```

For example, for {{ece}} {{version.ece}} and the {{stack}} versions it shipped with, you need:

* {{ece}} {{version.ece}}
* {{es}} 9.0.0, {{kib}} 9.0.0, and APM 9.0.0
::::{note}
Version 8.x images are required for system deployments.
::::

2. Create .tar files of the images:

```sh subs=true
docker save -o ece.{{version.ece}}.tar docker.elastic.co/cloud-enterprise/elastic-cloud-enterprise:{{version.ece}}
docker save -o es.8.18.0.tar docker.elastic.co/cloud-release/elasticsearch-cloud-ess:8.18.2
docker save -o kibana.8.18.0.tar docker.elastic.co/cloud-release/kibana-cloud:8.18.2
docker save -o apm.8.18.0.tar docker.elastic.co/cloud-release/elastic-agent-cloud:8.18.0
docker save -o enterprise-search.8.18.0.tar docker.elastic.co/cloud-release/enterprise-search-cloud:8.18.0
docker save -o es.9.0.0.tar docker.elastic.co/cloud-release/elasticsearch-cloud-ess:9.0.0
docker save -o kibana.9.0.0.tar docker.elastic.co/cloud-release/kibana-cloud:9.0.0
docker save -o apm.9.0.0.tar docker.elastic.co/cloud-release/elastic-agent-cloud:9.0.0
docker save -o es.8.18.2.tar docker.elastic.co/cloud-release/elasticsearch-cloud-ess:8.18.2
docker save -o kibana.8.18.2.tar docker.elastic.co/cloud-release/kibana-cloud:8.18.2
docker save -o apm.8.18.2.tar docker.elastic.co/cloud-release/elastic-agent-cloud:8.18.2
docker save -o enterprise-search.8.18.2.tar docker.elastic.co/cloud-release/enterprise-search-cloud:8.18.2
docker save -o es.9.0.1.tar docker.elastic.co/cloud-release/elasticsearch-cloud-ess:9.0.1
docker save -o kibana.9.0.1.tar docker.elastic.co/cloud-release/kibana-cloud:9.0.1
docker save -o apm.9.0.1.tar docker.elastic.co/cloud-release/elastic-agent-cloud:9.0.1
```

3. Copy the .tar files to a location on your network where they are available to each host where you plan to install {{ece}}. Alternatively, you can copy the .tar files to each host directly.
4. On each host, load the images into Docker, replacing `FILE_PATH` with the correct path to the .tar files:

```sh subs=true
docker load < FILE_PATH/ece.{{version.ece}}.tar
docker load < FILE_PATH/es.8.18.0.tar
docker load < FILE_PATH/kibana.8.18.0.tar
docker load < FILE_PATH/apm.8.18.0.tar
docker load < FILE_PATH/enterprise-search.8.18.0.tar
docker load < FILE_PATH/es.9.0.0.tar
docker load < FILE_PATH/kibana.9.0.0.tar
docker load < FILE_PATH/apm.9.0.0.tar
docker load < FILE_PATH/es.8.18.2.tar
docker load < FILE_PATH/kibana.8.18.2.tar
docker load < FILE_PATH/apm.8.18.2.tar
docker load < FILE_PATH/enterprise-search.8.18.2.tar
docker load < FILE_PATH/es.9.0.1.tar
docker load < FILE_PATH/kibana.9.0.1.tar
docker load < FILE_PATH/apm.9.0.1.tar
```

5. Optional: Remove the .tar files after installation.
Expand Down
57 changes: 27 additions & 30 deletions deploy-manage/deploy/cloud-enterprise/ece-install-offline-with-registry.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -19,52 +19,49 @@ Installing ECE on multiple hosts with your own registry server is simpler, becau
As part of the ECE [high availability](ece-ha.md) strategy, it’s a good idea to make sure that your Docker registry server is available to all ECE allocators, so that it can continue to be accessed in the event of a network partition or zone outage. Allocators attempting to start instances requiring Docker images that have not yet been pulled from a custom Docker registry will fail to start if the registry is unavailable.
::::

2. On an internet-connected host that has Docker installed, download the [Available Docker Images](ece-install-offline-images.md) and push them to your private Docker registry. Note that for ECE version 4.0, if you want to use {{stack}} version 9.0 in your deployments, you need to download and make available both the version 8.x and version 9.x Docker images.
2. On an internet-connected host with Docker installed, download the Docker images required by the {{ece}} version you want to install. Refer to [available docker images](ece-install-offline-images.md) for more information.

For example, for {{ece}} {{version.ece}} and the {{stack}} versions it includes, you need:

```sh subs=true
docker pull docker.elastic.co/cloud-enterprise/elastic-cloud-enterprise:{{version.ece}}
docker pull docker.elastic.co/cloud-release/elasticsearch-cloud-ess:8.18.0
docker pull docker.elastic.co/cloud-release/kibana-cloud:8.18.0
docker pull docker.elastic.co/cloud-release/elastic-agent-cloud:8.18.0
docker pull docker.elastic.co/cloud-release/enterprise-search-cloud:8.18.0
docker pull docker.elastic.co/cloud-release/elasticsearch-cloud-ess:9.0.0
docker pull docker.elastic.co/cloud-release/kibana-cloud:9.0.0
docker pull docker.elastic.co/cloud-release/elastic-agent-cloud:9.0.0
docker pull docker.elastic.co/cloud-release/elasticsearch-cloud-ess:8.18.2
docker pull docker.elastic.co/cloud-release/kibana-cloud:8.18.2
docker pull docker.elastic.co/cloud-release/elastic-agent-cloud:8.18.2
docker pull docker.elastic.co/cloud-release/enterprise-search-cloud:8.18.2
docker pull docker.elastic.co/cloud-release/elasticsearch-cloud-ess:9.0.1
docker pull docker.elastic.co/cloud-release/kibana-cloud:9.0.1
docker pull docker.elastic.co/cloud-release/elastic-agent-cloud:9.0.1
```

For example, for {{ece}} {{version.ece}} and the {{stack}} versions it shipped with, you need:

* {{ece}} {{version.ece}}
* {{es}} 9.0.0, {{kib}} 9.0.0, APM 9.0.0

:::{important}
Enterprise Search is not available in versions 9.0+.
:::
::::{note}
Version 8.x images are required for system deployments.
::::

3. Tag the Docker images with your private registry URL by replacing `REGISTRY` with your actual registry address, for example `my.private.repo:5000`:

```sh subs=true
docker tag docker.elastic.co/cloud-enterprise/elastic-cloud-enterprise:{{version.ece}} REGISTRY/cloud-enterprise/elastic-cloud-enterprise:{{version.ece}}
docker tag docker.elastic.co/cloud-release/elasticsearch-cloud-ess:8.18.0 REGISTRY/cloud-release/elasticsearch-cloud-ess:8.18.0
docker tag docker.elastic.co/cloud-release/kibana-cloud:8.18.0 REGISTRY/cloud-release/kibana-cloud:8.18.0
docker tag docker.elastic.co/cloud-release/elastic-agent-cloud:8.18.0 REGISTRY/cloud-release/elastic-agent-cloud:8.18.0
docker tag docker.elastic.co/cloud-release/enterprise-search-cloud:8.18.0 REGISTRY/cloud-release/enterprise-search-cloud:8.18.0
docker tag docker.elastic.co/cloud-release/elasticsearch-cloud-ess:9.0.0 REGISTRY/cloud-release/elasticsearch-cloud-ess:9.0.0
docker tag docker.elastic.co/cloud-release/kibana-cloud:9.0.0 REGISTRY/cloud-release/kibana-cloud:9.0.0
docker tag docker.elastic.co/cloud-release/elastic-agent-cloud:9.0.0 REGISTRY/cloud-release/elastic-agent-cloud:9.0.0
docker tag docker.elastic.co/cloud-release/elasticsearch-cloud-ess:8.18.2 REGISTRY/cloud-release/elasticsearch-cloud-ess:8.18.2
docker tag docker.elastic.co/cloud-release/kibana-cloud:8.18.2 REGISTRY/cloud-release/kibana-cloud:8.18.2
docker tag docker.elastic.co/cloud-release/elastic-agent-cloud:8.18.2 REGISTRY/cloud-release/elastic-agent-cloud:8.18.2
docker tag docker.elastic.co/cloud-release/enterprise-search-cloud:8.18.2 REGISTRY/cloud-release/enterprise-search-cloud:8.18.2
docker tag docker.elastic.co/cloud-release/elasticsearch-cloud-ess:9.0.1 REGISTRY/cloud-release/elasticsearch-cloud-ess:9.0.1
docker tag docker.elastic.co/cloud-release/kibana-cloud:9.0.1 REGISTRY/cloud-release/kibana-cloud:9.0.1
docker tag docker.elastic.co/cloud-release/elastic-agent-cloud:9.0.1 REGISTRY/cloud-release/elastic-agent-cloud:9.0.1
```

4. Push the Docker images to your private Docker registry, using the same tags from the previous step. Replace `REGISTRY` with your actual registry URL, for example `my.private.repo:5000`:

```sh subs=true
docker push REGISTRY/cloud-enterprise/elastic-cloud-enterprise:{{version.ece}}
docker push REGISTRY/cloud-release/elasticsearch-cloud-ess:8.18.0
docker push REGISTRY/cloud-release/kibana-cloud:8.18.0
docker push REGISTRY/cloud-release/elastic-agent-cloud:8.18.0
docker push REGISTRY/cloud-release/enterprise-search-cloud:8.18.0
docker push REGISTRY/cloud-release/elasticsearch-cloud-ess:9.0.0
docker push REGISTRY/cloud-release/kibana-cloud:9.0.0
docker push REGISTRY/cloud-release/elastic-agent-cloud:9.0.0
docker push REGISTRY/cloud-release/elasticsearch-cloud-ess:8.18.2
docker push REGISTRY/cloud-release/kibana-cloud:8.18.2
docker push REGISTRY/cloud-release/elastic-agent-cloud:8.18.2
docker push REGISTRY/cloud-release/enterprise-search-cloud:8.18.2
docker push REGISTRY/cloud-release/elasticsearch-cloud-ess:9.0.1
docker push REGISTRY/cloud-release/kibana-cloud:9.0.1
docker push REGISTRY/cloud-release/elastic-agent-cloud:9.0.1
```

5. On an internet-connected host, download the installation script:
Expand Down
Loading