From 7019fc0fcdbb4222fccb8889fac94eb3be143519 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Edu=20Gonz=C3=A1lez=20de=20la=20Herr=C3=A1n?= <25320357+eedugon@users.noreply.github.com> Date: Wed, 12 Feb 2025 13:36:45 +0100 Subject: [PATCH 01/19] intro docs deleted from raw and added to overview --- deploy-manage/deploy/cloud-enterprise.md | 50 ++++++++++++++++++- .../Elastic-Cloud-Enterprise-overview.md | 30 ----------- .../cloud-enterprise/ece-administering-ece.md | 13 ----- raw-migrated-files/toc.yml | 2 - 4 files changed, 49 insertions(+), 46 deletions(-) delete mode 100644 raw-migrated-files/cloud/cloud-enterprise/Elastic-Cloud-Enterprise-overview.md delete mode 100644 raw-migrated-files/cloud/cloud-enterprise/ece-administering-ece.md diff --git a/deploy-manage/deploy/cloud-enterprise.md b/deploy-manage/deploy/cloud-enterprise.md index 18419a8852..7505431b6c 100644 --- a/deploy-manage/deploy/cloud-enterprise.md +++ b/deploy-manage/deploy/cloud-enterprise.md @@ -17,4 +17,52 @@ mapped_urls: % - [ ] ./raw-migrated-files/cloud/cloud-enterprise/Elastic-Cloud-Enterprise-overview.md % Notes: 2 child docs % - [ ] ./raw-migrated-files/cloud/cloud-enterprise/ece-administering-ece.md -% Notes: redirect only \ No newline at end of file +% Notes: redirect only + + +# Introducing Elastic Cloud Enterprise [Elastic-Cloud-Enterprise-overview] + +This page provides a high-level introduction to Elastic Cloud Enterprise (ECE). + +::::{note} +Try one of the [getting started guides](https://www.elastic.co/guide/en/starting-with-the-elasticsearch-platform-and-its-solutions/current/getting-started-guides.html) to discover the core concepts of the Elastic Stack and understand how Elastic can help you. +:::: + + +**What is ECE?** + +ECE evolves from the Elastic hosted Cloud SaaS offering into a standalone product. You can deploy ECE on public or private clouds, virtual machines, or your own premises. + +**Why ECE?** + +* Host your regulated or sensitive data on your internal network. +* Reuse your existing investment in on-premise infrastructure and reduce total cost. +* Maximize the hardware utilization for the various clusters. +* Centralize the management of multiple Elastic deployments across teams or geographies. + +**ECE features** + +* All services are containerized through Docker. +* High Availability through multiple Availability Zones. +* Deployment state coordination using ZooKeeper. +* Easy access for admins through the Cloud UI and API. +* Support for off-line installations. +* Automated restore and snapshot. + +Check the [glossary](https://www.elastic.co/guide/en/elastic-stack-glossary/current/terms.html) to get familiar with the terminology for ECE as well as other Elastic products and solutions. + +% this should go to deploy ECE for example, not in the intro +# Administering your installation [ece-administering-ece] + +Now that you have Elastic Cloud Enterprise up and running, take a look at the things you can do to keep your installation humming along, from adding more capacity to dealing with hosts that require maintenance or have failed: + +* [Scale Out Your Installation](../../../deploy-manage/maintenance/ece/scale-out-installation.md) - Need to add more capacity? Here’s how. +* [Assign Roles to Hosts](../../../deploy-manage/deploy/cloud-enterprise/assign-roles-to-hosts.md) - Make sure new hosts can be used for their intended purpose after you install ECE on them. +* [Enable Maintenance Mode](../../../deploy-manage/maintenance/ece/enable-maintenance-mode.md) - Perform administrative actions on allocators safely by putting them into maintenance mode first. +* [Move Nodes From Allocators](../../../deploy-manage/maintenance/ece/move-nodes-instances-from-allocators.md) - Moves all Elasticsearch clusters and Kibana instances to another allocator, so that the allocator is no longer used for handling user requests. +* [Delete Hosts](../../../deploy-manage/maintenance/ece/delete-ece-hosts.md) - Remove a host from your ECE installation, either because it is no longer needed or because it is faulty. +* [Perform Host Maintenance](../../../deploy-manage/maintenance/ece/perform-ece-hosts-maintenance.md) - Apply operating system patches and other maintenance to hosts safely without removing them from your ECE installation. +* [Manage Elastic Stack Versions](../../../deploy-manage/deploy/cloud-enterprise/manage-elastic-stack-versions.md) - View, add, or update versions of the Elastic Stack that are available on your ECE installation. +* [Upgrade Your Installation](../../../deploy-manage/upgrade/orchestrator/upgrade-cloud-enterprise.md) - A new version of Elastic Cloud Enterprise is available and you want to upgrade. Here’s how. + + diff --git a/raw-migrated-files/cloud/cloud-enterprise/Elastic-Cloud-Enterprise-overview.md b/raw-migrated-files/cloud/cloud-enterprise/Elastic-Cloud-Enterprise-overview.md deleted file mode 100644 index ee863ff5d7..0000000000 --- a/raw-migrated-files/cloud/cloud-enterprise/Elastic-Cloud-Enterprise-overview.md +++ /dev/null @@ -1,30 +0,0 @@ -# Introducing Elastic Cloud Enterprise [Elastic-Cloud-Enterprise-overview] - -This page provides a high-level introduction to Elastic Cloud Enterprise (ECE). - -::::{note} -Try one of the [getting started guides](https://www.elastic.co/guide/en/starting-with-the-elasticsearch-platform-and-its-solutions/current/getting-started-guides.html) to discover the core concepts of the Elastic Stack and understand how Elastic can help you. -:::: - - -**What is ECE?** - -ECE evolves from the Elastic hosted Cloud SaaS offering into a standalone product. You can deploy ECE on public or private clouds, virtual machines, or your own premises. - -**Why ECE?** - -* Host your regulated or sensitive data on your internal network. -* Reuse your existing investment in on-premise infrastructure and reduce total cost. -* Maximize the hardware utilization for the various clusters. -* Centralize the management of multiple Elastic deployments across teams or geographies. - -**ECE features** - -* All services are containerized through Docker. -* High Availability through multiple Availability Zones. -* Deployment state coordination using ZooKeeper. -* Easy access for admins through the Cloud UI and API. -* Support for off-line installations. -* Automated restore and snapshot. - -Check the [glossary](https://www.elastic.co/guide/en/elastic-stack-glossary/current/terms.html) to get familiar with the terminology for ECE as well as other Elastic products and solutions. diff --git a/raw-migrated-files/cloud/cloud-enterprise/ece-administering-ece.md b/raw-migrated-files/cloud/cloud-enterprise/ece-administering-ece.md deleted file mode 100644 index 7ab3fd8a69..0000000000 --- a/raw-migrated-files/cloud/cloud-enterprise/ece-administering-ece.md +++ /dev/null @@ -1,13 +0,0 @@ -# Administering your installation [ece-administering-ece] - -Now that you have Elastic Cloud Enterprise up and running, take a look at the things you can do to keep your installation humming along, from adding more capacity to dealing with hosts that require maintenance or have failed: - -* [Scale Out Your Installation](../../../deploy-manage/maintenance/ece/scale-out-installation.md) - Need to add more capacity? Here’s how. -* [Assign Roles to Hosts](../../../deploy-manage/deploy/cloud-enterprise/assign-roles-to-hosts.md) - Make sure new hosts can be used for their intended purpose after you install ECE on them. -* [Enable Maintenance Mode](../../../deploy-manage/maintenance/ece/enable-maintenance-mode.md) - Perform administrative actions on allocators safely by putting them into maintenance mode first. -* [Move Nodes From Allocators](../../../deploy-manage/maintenance/ece/move-nodes-instances-from-allocators.md) - Moves all Elasticsearch clusters and Kibana instances to another allocator, so that the allocator is no longer used for handling user requests. -* [Delete Hosts](../../../deploy-manage/maintenance/ece/delete-ece-hosts.md) - Remove a host from your ECE installation, either because it is no longer needed or because it is faulty. -* [Perform Host Maintenance](../../../deploy-manage/maintenance/ece/perform-ece-hosts-maintenance.md) - Apply operating system patches and other maintenance to hosts safely without removing them from your ECE installation. -* [Manage Elastic Stack Versions](../../../deploy-manage/deploy/cloud-enterprise/manage-elastic-stack-versions.md) - View, add, or update versions of the Elastic Stack that are available on your ECE installation. -* [Upgrade Your Installation](../../../deploy-manage/upgrade/orchestrator/upgrade-cloud-enterprise.md) - A new version of Elastic Cloud Enterprise is available and you want to upgrade. Here’s how. - diff --git a/raw-migrated-files/toc.yml b/raw-migrated-files/toc.yml index 60707228e9..52c5e73f98 100644 --- a/raw-migrated-files/toc.yml +++ b/raw-migrated-files/toc.yml @@ -46,7 +46,6 @@ toc: - file: cloud/cloud-enterprise/ece-add-custom-bundle-plugin.md - file: cloud/cloud-enterprise/ece-add-user-settings.md - file: cloud/cloud-enterprise/ece-administering-deployments.md - - file: cloud/cloud-enterprise/ece-administering-ece.md - file: cloud/cloud-enterprise/ece-api-console.md - file: cloud/cloud-enterprise/ece-autoscaling.md - file: cloud/cloud-enterprise/ece-change-deployment.md @@ -101,7 +100,6 @@ toc: - file: cloud/cloud-enterprise/ece-upgrade.md - file: cloud/cloud-enterprise/ece-working-with-elasticsearch.md - file: cloud/cloud-enterprise/editing-user-settings.md - - file: cloud/cloud-enterprise/Elastic-Cloud-Enterprise-overview.md - file: cloud/cloud-heroku/index.md children: - file: cloud/cloud-heroku/ech-about.md From 3c37e2ab1063d0ca18bc20d120211104cffc1bf4 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Edu=20Gonz=C3=A1lez=20de=20la=20Herr=C3=A1n?= <25320357+eedugon@users.noreply.github.com> Date: Wed, 12 Feb 2025 13:38:32 +0100 Subject: [PATCH 02/19] ECE prepare environment added under deploy --- deploy-manage/toc.yml | 26 +++++++++++++------------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/deploy-manage/toc.yml b/deploy-manage/toc.yml index c6bd71ff42..3517aa4aaa 100644 --- a/deploy-manage/toc.yml +++ b/deploy-manage/toc.yml @@ -122,21 +122,21 @@ toc: children: - file: deploy/cloud-enterprise/ece-architecture.md - file: deploy/cloud-enterprise/ece-containerization.md - - file: deploy/cloud-enterprise/prepare-environment.md - children: - - file: deploy/cloud-enterprise/ece-hardware-prereq.md - - file: deploy/cloud-enterprise/ece-software-prereq.md - - file: deploy/cloud-enterprise/ece-sysconfig.md - - file: deploy/cloud-enterprise/ece-networking-prereq.md - - file: deploy/cloud-enterprise/ece-ha.md - - file: deploy/cloud-enterprise/ece-roles.md - - file: deploy/cloud-enterprise/ece-load-balancers.md - - file: deploy/cloud-enterprise/ece-users-permissions.md - - file: deploy/cloud-enterprise/ece-jvm.md - - file: deploy/cloud-enterprise/ece-wildcard-dns.md - - file: deploy/cloud-enterprise/ece-manage-capacity.md - file: deploy/cloud-enterprise/deploy-an-orchestrator.md children: + - file: deploy/cloud-enterprise/prepare-environment.md + children: + - file: deploy/cloud-enterprise/ece-hardware-prereq.md + - file: deploy/cloud-enterprise/ece-software-prereq.md + - file: deploy/cloud-enterprise/ece-sysconfig.md + - file: deploy/cloud-enterprise/ece-networking-prereq.md + - file: deploy/cloud-enterprise/ece-ha.md + - file: deploy/cloud-enterprise/ece-roles.md + - file: deploy/cloud-enterprise/ece-load-balancers.md + - file: deploy/cloud-enterprise/ece-users-permissions.md + - file: deploy/cloud-enterprise/ece-jvm.md + - file: deploy/cloud-enterprise/ece-wildcard-dns.md + - file: deploy/cloud-enterprise/ece-manage-capacity.md - file: deploy/cloud-enterprise/install.md children: - file: deploy/cloud-enterprise/identify-deployment-scenario.md From 320ab54cfb9ed86c4f6763afcf09df63d93d8aac Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Edu=20Gonz=C3=A1lez=20de=20la=20Herr=C3=A1n?= <25320357+eedugon@users.noreply.github.com> Date: Wed, 12 Feb 2025 14:51:12 +0100 Subject: [PATCH 03/19] overview and deploy pages refined, WIP --- deploy-manage/deploy/cloud-enterprise.md | 45 +++++++++---------- .../deploy/cloud-enterprise/configure.md | 15 +++++++ .../deploy-an-orchestrator.md | 16 ++++++- 3 files changed, 50 insertions(+), 26 deletions(-) diff --git a/deploy-manage/deploy/cloud-enterprise.md b/deploy-manage/deploy/cloud-enterprise.md index 7505431b6c..8f631feaeb 100644 --- a/deploy-manage/deploy/cloud-enterprise.md +++ b/deploy-manage/deploy/cloud-enterprise.md @@ -1,10 +1,9 @@ --- mapped_urls: - https://www.elastic.co/guide/en/cloud-enterprise/current/Elastic-Cloud-Enterprise-overview.html - - https://www.elastic.co/guide/en/cloud-enterprise/current/ece-administering-ece.html --- -# Elastic Cloud Enterprise +# Elastic Cloud Enterprise [Elastic-Cloud-Enterprise-overview] % What needs to be done: Refine @@ -14,23 +13,22 @@ mapped_urls: % Use migrated content from existing pages that map to this page: +% already deleted % - [ ] ./raw-migrated-files/cloud/cloud-enterprise/Elastic-Cloud-Enterprise-overview.md % Notes: 2 child docs % - [ ] ./raw-migrated-files/cloud/cloud-enterprise/ece-administering-ece.md % Notes: redirect only - -# Introducing Elastic Cloud Enterprise [Elastic-Cloud-Enterprise-overview] - -This page provides a high-level introduction to Elastic Cloud Enterprise (ECE). +This page provides a high-level overview of Elastic Cloud Enterprise (ECE). ::::{note} Try one of the [getting started guides](https://www.elastic.co/guide/en/starting-with-the-elasticsearch-platform-and-its-solutions/current/getting-started-guides.html) to discover the core concepts of the Elastic Stack and understand how Elastic can help you. :::: - **What is ECE?** +ECE is an Elastic's on-premises and self-managed solution for deploying, orchestrating, and managing Elasticsearch clusters at scale. It provides a centralized platform that allows organizations to run Elasticsearch, Kibana, and other Elastic Stack components across multiple machines. + ECE evolves from the Elastic hosted Cloud SaaS offering into a standalone product. You can deploy ECE on public or private clouds, virtual machines, or your own premises. **Why ECE?** @@ -42,27 +40,24 @@ ECE evolves from the Elastic hosted Cloud SaaS offering into a standalone produc **ECE features** -* All services are containerized through Docker. -* High Availability through multiple Availability Zones. -* Deployment state coordination using ZooKeeper. -* Easy access for admins through the Cloud UI and API. -* Support for off-line installations. -* Automated restore and snapshot. +- [**Microservices**](./cloud-enterprise/ece-containerization.md) - All services are containerized through Docker. +- [**Services oriented architecture**](./cloud-enterprise/ece-architecture.md) - Deployment state coordination using ZooKeeper. +- **High Availability & Resilience** – Ensures uptime through multiple Availability Zones, data replication, and automated restore and snapshot. +- **Automated Scaling & Orchestration** – Handles cluster provisioning, scaling, and upgrades automatically. +- **Centralized Monitoring & Logging** – Provides insights into cluster performance, resource usage, and logs. +- **Role-Based Access Control (RBAC)** – Allows organizations to manage access and security policies. +- **API & UI Management** – Offers a web interface and API to create and manage clusters easily. +- **Air gapped installations** - Support for off-line installations. Check the [glossary](https://www.elastic.co/guide/en/elastic-stack-glossary/current/terms.html) to get familiar with the terminology for ECE as well as other Elastic products and solutions. -% this should go to deploy ECE for example, not in the intro -# Administering your installation [ece-administering-ece] - -Now that you have Elastic Cloud Enterprise up and running, take a look at the things you can do to keep your installation humming along, from adding more capacity to dealing with hosts that require maintenance or have failed: +**Use cases** -* [Scale Out Your Installation](../../../deploy-manage/maintenance/ece/scale-out-installation.md) - Need to add more capacity? Here’s how. -* [Assign Roles to Hosts](../../../deploy-manage/deploy/cloud-enterprise/assign-roles-to-hosts.md) - Make sure new hosts can be used for their intended purpose after you install ECE on them. -* [Enable Maintenance Mode](../../../deploy-manage/maintenance/ece/enable-maintenance-mode.md) - Perform administrative actions on allocators safely by putting them into maintenance mode first. -* [Move Nodes From Allocators](../../../deploy-manage/maintenance/ece/move-nodes-instances-from-allocators.md) - Moves all Elasticsearch clusters and Kibana instances to another allocator, so that the allocator is no longer used for handling user requests. -* [Delete Hosts](../../../deploy-manage/maintenance/ece/delete-ece-hosts.md) - Remove a host from your ECE installation, either because it is no longer needed or because it is faulty. -* [Perform Host Maintenance](../../../deploy-manage/maintenance/ece/perform-ece-hosts-maintenance.md) - Apply operating system patches and other maintenance to hosts safely without removing them from your ECE installation. -* [Manage Elastic Stack Versions](../../../deploy-manage/deploy/cloud-enterprise/manage-elastic-stack-versions.md) - View, add, or update versions of the Elastic Stack that are available on your ECE installation. -* [Upgrade Your Installation](../../../deploy-manage/upgrade/orchestrator/upgrade-cloud-enterprise.md) - A new version of Elastic Cloud Enterprise is available and you want to upgrade. Here’s how. +- Organizations that need **full control over their Elastic Stack** while benefiting from cloud-like automation. +- Enterprises managing **multiple Elasticsearch clusters** across different teams or environments. +- Businesses looking for **a self-hosted alternative to Elastic Cloud** but with centralized administration. +## How it Differs from Elastic Cloud and other orchestrators +- **Elastic Cloud** (hosted by Elastic) is fully managed and runs on AWS, GCP, and Azure. +- **ECE** is for organizations that **want to self-host and manage their own Elastic Stack** deployments across their infrastructure. diff --git a/deploy-manage/deploy/cloud-enterprise/configure.md b/deploy-manage/deploy/cloud-enterprise/configure.md index 2ad081b96a..9fca278326 100644 --- a/deploy-manage/deploy/cloud-enterprise/configure.md +++ b/deploy-manage/deploy/cloud-enterprise/configure.md @@ -1,6 +1,7 @@ --- mapped_pages: - https://www.elastic.co/guide/en/cloud-enterprise/current/ece-configuring-ece.html + - https://www.elastic.co/guide/en/cloud-enterprise/current/ece-administering-ece.html --- # Configure [ece-configuring-ece] @@ -16,3 +17,17 @@ Now that you have Elastic Cloud Enterprise up and running, take a look at some o * [Change allocator disconnect timeout](change-allocator-disconnect-timeout.md) - Configure how long ECE waits before considering allocators to be disconnected. * [Migrate ECE on Podman hosts to SELinux in enforcing mode](migrate-ece-on-podman-hosts-to-selinux-enforce.md) - Migrate ECE to SELinux in `enforcing` mode using Podman. +# Administering your installation [ece-administering-ece] + +Now that you have Elastic Cloud Enterprise up and running, take a look at the things you can do to keep your installation humming along, from adding more capacity to dealing with hosts that require maintenance or have failed: + +* [Scale Out Your Installation](../../../deploy-manage/maintenance/ece/scale-out-installation.md) - Need to add more capacity? Here’s how. +* [Assign Roles to Hosts](../../../deploy-manage/deploy/cloud-enterprise/assign-roles-to-hosts.md) - Make sure new hosts can be used for their intended purpose after you install ECE on them. +* [Enable Maintenance Mode](../../../deploy-manage/maintenance/ece/enable-maintenance-mode.md) - Perform administrative actions on allocators safely by putting them into maintenance mode first. +* [Move Nodes From Allocators](../../../deploy-manage/maintenance/ece/move-nodes-instances-from-allocators.md) - Moves all Elasticsearch clusters and Kibana instances to another allocator, so that the allocator is no longer used for handling user requests. +* [Delete Hosts](../../../deploy-manage/maintenance/ece/delete-ece-hosts.md) - Remove a host from your ECE installation, either because it is no longer needed or because it is faulty. +* [Perform Host Maintenance](../../../deploy-manage/maintenance/ece/perform-ece-hosts-maintenance.md) - Apply operating system patches and other maintenance to hosts safely without removing them from your ECE installation. +* [Manage Elastic Stack Versions](../../../deploy-manage/deploy/cloud-enterprise/manage-elastic-stack-versions.md) - View, add, or update versions of the Elastic Stack that are available on your ECE installation. +* [Upgrade Your Installation](../../../deploy-manage/upgrade/orchestrator/upgrade-cloud-enterprise.md) - A new version of Elastic Cloud Enterprise is available and you want to upgrade. Here’s how. + + diff --git a/deploy-manage/deploy/cloud-enterprise/deploy-an-orchestrator.md b/deploy-manage/deploy/cloud-enterprise/deploy-an-orchestrator.md index 3fc28c1286..79b9dc9cbb 100644 --- a/deploy-manage/deploy/cloud-enterprise/deploy-an-orchestrator.md +++ b/deploy-manage/deploy/cloud-enterprise/deploy-an-orchestrator.md @@ -4,4 +4,18 @@ % GitHub issue: https://github.com/elastic/docs-projects/issues/339 -% Scope notes: Introduction about the content of this big section (which covers install and configuration possibilities of the orchestrator) \ No newline at end of file +% Scope notes: Introduction about the content of this big section (which covers install and configuration possibilities of the orchestrator) + +Elastic Cloud Enterprise (ECE) provides a centralized platform that allows organizations to run **Elasticsearch, Kibana, and other Elastic Stack components** across multiple machines, whether in a private or public cloud, virtual machines, or your own premises. + +If you need to manage multiple Elastic deployments across teams or geographies, you can leverage Elastic Cloud Enterprise to centralize cluster management for: +* Provisioning +* Monitoring +* Scaling +* Replication +* Upgrades +* Backup and restore + +Centralizing the management of clusters with Elastic Cloud Enterprise enforces uniform versioning, data governance, backup, and user policies. Increased hardware utilization through better management can also reduce total cost. + +This section covers the planning, installation, and configuration of ECE. From 4e7432a9911a7123b07ea532348b53db572553ed Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Edu=20Gonz=C3=A1lez=20de=20la=20Herr=C3=A1n?= <25320357+eedugon@users.noreply.github.com> Date: Wed, 12 Feb 2025 22:08:45 +0100 Subject: [PATCH 04/19] ece overview and deploy updated --- deploy-manage/deploy/cloud-enterprise.md | 46 +++++++++---------- .../deploy-an-orchestrator.md | 14 ++---- 2 files changed, 27 insertions(+), 33 deletions(-) diff --git a/deploy-manage/deploy/cloud-enterprise.md b/deploy-manage/deploy/cloud-enterprise.md index 8f631feaeb..4effe869f4 100644 --- a/deploy-manage/deploy/cloud-enterprise.md +++ b/deploy-manage/deploy/cloud-enterprise.md @@ -5,20 +5,6 @@ mapped_urls: # Elastic Cloud Enterprise [Elastic-Cloud-Enterprise-overview] -% What needs to be done: Refine - -% GitHub issue: https://github.com/elastic/docs-projects/issues/339 - -% Scope notes: Ensure the landing page makes sense and its aligned with the section overview and the overview about orchestators. What content should be in deployment types overview or in the main overview and what in the ECE landing page... - -% Use migrated content from existing pages that map to this page: - -% already deleted -% - [ ] ./raw-migrated-files/cloud/cloud-enterprise/Elastic-Cloud-Enterprise-overview.md -% Notes: 2 child docs -% - [ ] ./raw-migrated-files/cloud/cloud-enterprise/ece-administering-ece.md -% Notes: redirect only - This page provides a high-level overview of Elastic Cloud Enterprise (ECE). ::::{note} @@ -27,9 +13,15 @@ Try one of the [getting started guides](https://www.elastic.co/guide/en/starting **What is ECE?** -ECE is an Elastic's on-premises and self-managed solution for deploying, orchestrating, and managing Elasticsearch clusters at scale. It provides a centralized platform that allows organizations to run Elasticsearch, Kibana, and other Elastic Stack components across multiple machines. +Elastic Cloud Enterprise (ECE) is an on-premises and self-managed solution for deploying, orchestrating, and managing {{es}} clusters at scale. It provides a centralized platform that allows organizations to run {{es}}, {{kib}}, and other {{stack}} components across multiple machines. + +ECE evolves from the Elastic hosted Cloud SaaS offering into a standalone product. You can deploy ECE on public or private clouds, virtual machines, or on-premises. -ECE evolves from the Elastic hosted Cloud SaaS offering into a standalone product. You can deploy ECE on public or private clouds, virtual machines, or your own premises. +For an overview of ECE architecture refer to [](./cloud-enterprise/ece-architecture.md). + +::::{tip} +If you are looking for a solution to orchestrate and manage {{es}} clusters natively on Kubernetes, consider using [Elastic Cloud on Kubernetes (ECK)](./cloud-on-k8s.md) instead of ECE. ECK enables you to orchestrate Elastic Stack applications seamlessly on Kubernetes, leveraging it as the underlying platform for deployment, scaling, and lifecycle management. +:::: **Why ECE?** @@ -40,14 +32,13 @@ ECE evolves from the Elastic hosted Cloud SaaS offering into a standalone produc **ECE features** -- [**Microservices**](./cloud-enterprise/ece-containerization.md) - All services are containerized through Docker. -- [**Services oriented architecture**](./cloud-enterprise/ece-architecture.md) - Deployment state coordination using ZooKeeper. -- **High Availability & Resilience** – Ensures uptime through multiple Availability Zones, data replication, and automated restore and snapshot. - **Automated Scaling & Orchestration** – Handles cluster provisioning, scaling, and upgrades automatically. +- **High Availability & Resilience** – Ensures uptime through multiple Availability Zones, data replication, and automated restore and snapshot. - **Centralized Monitoring & Logging** – Provides insights into cluster performance, resource usage, and logs. -- **Role-Based Access Control (RBAC)** – Allows organizations to manage access and security policies. +- **Single Sign-On (SSO) & Role-Based Access Control (RBAC)** – Allows organizations to manage access and security policies. - **API & UI Management** – Offers a web interface and API to create and manage clusters easily. - **Air gapped installations** - Support for off-line installations. +- **Microservices** - All services are containerized through Docker. See [](./cloud-enterprise/ece-containerization.md) for more details. Check the [glossary](https://www.elastic.co/guide/en/elastic-stack-glossary/current/terms.html) to get familiar with the terminology for ECE as well as other Elastic products and solutions. @@ -55,9 +46,16 @@ Check the [glossary](https://www.elastic.co/guide/en/elastic-stack-glossary/curr - Organizations that need **full control over their Elastic Stack** while benefiting from cloud-like automation. - Enterprises managing **multiple Elasticsearch clusters** across different teams or environments. -- Businesses looking for **a self-hosted alternative to Elastic Cloud** but with centralized administration. +- Businesses looking for **a self-hosted alternative to Elastic Cloud** with centralized administration. + +## How it differs from Elastic Cloud and other orchestrators + +For information about other deployment options, refer to [](../deploy.md). + +% - **Elastic Cloud** (hosted by Elastic) is fully managed and runs on AWS, GCP, and Azure. +% - **ECE** is for organizations that **want to self-host and manage their own Elastic Stack** deployments across their infrastructure. +% - **ECK** is for organizations that want to run on Kubernetes. -## How it Differs from Elastic Cloud and other orchestrators +## Supported versions -- **Elastic Cloud** (hosted by Elastic) is fully managed and runs on AWS, GCP, and Azure. -- **ECE** is for organizations that **want to self-host and manage their own Elastic Stack** deployments across their infrastructure. +Refer to [Elastic Support Matrix](https://www.elastic.co/support/matrix#elastic-cloud-enterprise) for more information about supported Operating Systems, Docker, and Podman versions. \ No newline at end of file diff --git a/deploy-manage/deploy/cloud-enterprise/deploy-an-orchestrator.md b/deploy-manage/deploy/cloud-enterprise/deploy-an-orchestrator.md index 79b9dc9cbb..2a35b86bf2 100644 --- a/deploy-manage/deploy/cloud-enterprise/deploy-an-orchestrator.md +++ b/deploy-manage/deploy/cloud-enterprise/deploy-an-orchestrator.md @@ -8,14 +8,10 @@ Elastic Cloud Enterprise (ECE) provides a centralized platform that allows organizations to run **Elasticsearch, Kibana, and other Elastic Stack components** across multiple machines, whether in a private or public cloud, virtual machines, or your own premises. -If you need to manage multiple Elastic deployments across teams or geographies, you can leverage Elastic Cloud Enterprise to centralize cluster management for: -* Provisioning -* Monitoring -* Scaling -* Replication -* Upgrades -* Backup and restore +This section provides step-by-step guidance on: -Centralizing the management of clusters with Elastic Cloud Enterprise enforces uniform versioning, data governance, backup, and user policies. Increased hardware utilization through better management can also reduce total cost. +* [**Installing ECE**](./install.md) → Installation pre-requisites and multiple installation methods for all supported Operating Systems. +* [**Configuring ECE**](./configure.md) → (TBD) + +If you're looking to deploy {{es}}, {{kib}} or other {{stack}} applications on ECE, refer to [](./working-with-deployments.md). -This section covers the planning, installation, and configuration of ECE. From 3c13d4136708066b718e65fbd6feea04bc53d389 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Edu=20Gonz=C3=A1lez=20de=20la=20Herr=C3=A1n?= <25320357+eedugon@users.noreply.github.com> Date: Wed, 19 Feb 2025 08:14:30 +0100 Subject: [PATCH 05/19] small changes to intro docs --- deploy-manage/deploy/cloud-enterprise.md | 16 ++++++++++------ .../cloud-enterprise/deploy-an-orchestrator.md | 10 ++++------ .../deploy/cloud-enterprise/ece-architecture.md | 2 ++ 3 files changed, 16 insertions(+), 12 deletions(-) diff --git a/deploy-manage/deploy/cloud-enterprise.md b/deploy-manage/deploy/cloud-enterprise.md index eca86875d1..9d55fffa29 100644 --- a/deploy-manage/deploy/cloud-enterprise.md +++ b/deploy-manage/deploy/cloud-enterprise.md @@ -1,17 +1,21 @@ --- +applies: + ece: all mapped_urls: - https://www.elastic.co/guide/en/cloud-enterprise/current/Elastic-Cloud-Enterprise-overview.html --- +% we still need to determine what to do with /raw-migrated-files/cloud/cloud-enterprise/ece-administering-ece.md + # Elastic Cloud Enterprise [Elastic-Cloud-Enterprise-overview] -This page provides a high-level overview of Elastic Cloud Enterprise (ECE). +This page provides a high-level introduction to {{ece}} (ECE). ::::{note} Try one of the [getting started guides](https://www.elastic.co/guide/en/starting-with-the-elasticsearch-platform-and-its-solutions/current/getting-started-guides.html) to discover the core concepts of the Elastic Stack and understand how Elastic can help you. :::: -**What is ECE?** +## ECE Overview Elastic Cloud Enterprise (ECE) is an on-premises and self-managed solution for deploying, orchestrating, and managing {{es}} clusters at scale. It provides a centralized platform that allows organizations to run {{es}}, {{kib}}, and other {{stack}} components across multiple machines. @@ -23,14 +27,14 @@ For an overview of ECE architecture refer to [](./cloud-enterprise/ece-architect If you are looking for a solution to orchestrate and manage {{es}} clusters natively on Kubernetes, consider using [Elastic Cloud on Kubernetes (ECK)](./cloud-on-k8s.md) instead of ECE. ECK enables you to orchestrate Elastic Stack applications seamlessly on Kubernetes, leveraging it as the underlying platform for deployment, scaling, and lifecycle management. :::: -**Why ECE?** +### Why ECE? * Host your regulated or sensitive data on your internal network. * Reuse your existing investment in on-premise infrastructure and reduce total cost. * Maximize the hardware utilization for the various clusters. * Centralize the management of multiple Elastic deployments across teams or geographies. -**ECE features** +### ECE features - **Automated Scaling & Orchestration** – Handles cluster provisioning, scaling, and upgrades automatically. - **High Availability & Resilience** – Ensures uptime through multiple Availability Zones, data replication, and automated restore and snapshot. @@ -42,7 +46,7 @@ If you are looking for a solution to orchestrate and manage {{es}} clusters nati Check the [glossary](https://www.elastic.co/guide/en/elastic-stack-glossary/current/terms.html) to get familiar with the terminology for ECE as well as other Elastic products and solutions. -**Use cases** +### Use cases - Organizations that need **full control over their Elastic Stack** while benefiting from cloud-like automation. - Enterprises managing **multiple Elasticsearch clusters** across different teams or environments. @@ -56,6 +60,6 @@ For information about other deployment options, refer to [](../deploy.md). % - **ECE** is for organizations that **want to self-host and manage their own Elastic Stack** deployments across their infrastructure. % - **ECK** is for organizations that want to run on Kubernetes. -## Supported versions +## Supported versions [ece-supported-versions] Refer to [Elastic Support Matrix](https://www.elastic.co/support/matrix#elastic-cloud-enterprise) for more information about supported Operating Systems, Docker, and Podman versions. diff --git a/deploy-manage/deploy/cloud-enterprise/deploy-an-orchestrator.md b/deploy-manage/deploy/cloud-enterprise/deploy-an-orchestrator.md index a470bb0351..969a0109c7 100644 --- a/deploy-manage/deploy/cloud-enterprise/deploy-an-orchestrator.md +++ b/deploy-manage/deploy/cloud-enterprise/deploy-an-orchestrator.md @@ -1,11 +1,9 @@ +--- +applies: + ece: all +--- # Deploy an orchestrator -% What needs to be done: Write from scratch - -% GitHub issue: https://github.com/elastic/docs-projects/issues/339 - -% Scope notes: Introduction about the content of this big section (which covers install and configuration possibilities of the orchestrator) - Elastic Cloud Enterprise (ECE) provides a centralized platform that allows organizations to run **Elasticsearch, Kibana, and other Elastic Stack components** across multiple machines, whether in a private or public cloud, virtual machines, or your own premises. This section provides step-by-step guidance on: diff --git a/deploy-manage/deploy/cloud-enterprise/ece-architecture.md b/deploy-manage/deploy/cloud-enterprise/ece-architecture.md index 6aa1d3256f..5463797e6e 100644 --- a/deploy-manage/deploy/cloud-enterprise/ece-architecture.md +++ b/deploy-manage/deploy/cloud-enterprise/ece-architecture.md @@ -1,4 +1,6 @@ --- +applies: + ece: all mapped_pages: - https://www.elastic.co/guide/en/cloud-enterprise/current/ece-architecture.html --- From 220938d4cc98b7f4060201ad411fad0d11dd869c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Edu=20Gonz=C3=A1lez=20de=20la=20Herr=C3=A1n?= <25320357+eedugon@users.noreply.github.com> Date: Wed, 19 Feb 2025 10:39:44 +0100 Subject: [PATCH 06/19] overview and main landing pages created --- deploy-manage/deploy/cloud-enterprise.md | 63 ++++++++----------- .../deploy/cloud-enterprise/configure.md | 8 ++- .../deploy-an-orchestrator.md | 35 +++++++++-- .../deploy/cloud-enterprise/ece-overview.md | 44 +++++++++++++ deploy-manage/toc.yml | 6 +- 5 files changed, 111 insertions(+), 45 deletions(-) create mode 100644 deploy-manage/deploy/cloud-enterprise/ece-overview.md diff --git a/deploy-manage/deploy/cloud-enterprise.md b/deploy-manage/deploy/cloud-enterprise.md index 9d55fffa29..1fe8e8e902 100644 --- a/deploy-manage/deploy/cloud-enterprise.md +++ b/deploy-manage/deploy/cloud-enterprise.md @@ -1,58 +1,49 @@ --- applies: ece: all -mapped_urls: - - https://www.elastic.co/guide/en/cloud-enterprise/current/Elastic-Cloud-Enterprise-overview.html --- -% we still need to determine what to do with /raw-migrated-files/cloud/cloud-enterprise/ece-administering-ece.md - # Elastic Cloud Enterprise [Elastic-Cloud-Enterprise-overview] -This page provides a high-level introduction to {{ece}} (ECE). - -::::{note} -Try one of the [getting started guides](https://www.elastic.co/guide/en/starting-with-the-elasticsearch-platform-and-its-solutions/current/getting-started-guides.html) to discover the core concepts of the Elastic Stack and understand how Elastic can help you. -:::: - -## ECE Overview +{{ece}} (ECE) is an Elastic self-managed solution for deploying, orchestrating, and managing {{es}} clusters at scale. It provides a centralized platform that allows organizations to run {{es}}, {{kib}}, and other {{stack}} components across multiple machines. -Elastic Cloud Enterprise (ECE) is an on-premises and self-managed solution for deploying, orchestrating, and managing {{es}} clusters at scale. It provides a centralized platform that allows organizations to run {{es}}, {{kib}}, and other {{stack}} components across multiple machines. - -ECE evolves from the Elastic hosted Cloud SaaS offering into a standalone product. You can deploy ECE on public or private clouds, virtual machines, or on-premises. - -For an overview of ECE architecture refer to [](./cloud-enterprise/ece-architecture.md). +Refer to [](./cloud-enterprise/ece-overview.md) for a detailed introduction to ECE, including its features, use cases, and architecture. ::::{tip} If you are looking for a solution to orchestrate and manage {{es}} clusters natively on Kubernetes, consider using [Elastic Cloud on Kubernetes (ECK)](./cloud-on-k8s.md) instead of ECE. ECK enables you to orchestrate Elastic Stack applications seamlessly on Kubernetes, leveraging it as the underlying platform for deployment, scaling, and lifecycle management. :::: -### Why ECE? +% should we use a L2 heading here or just continue? +## Section overview + +This section focuses on deploying ECE and the orchestrating and configuring {{es}} clusters, also referred to as `deployments`. + +In ECE, a deployment is a managed {{stack}} environment that provides users with an {{es}} cluster along with supporting components such as {{kib}} and other optional services like APM and Fleet. -* Host your regulated or sensitive data on your internal network. -* Reuse your existing investment in on-premise infrastructure and reduce total cost. -* Maximize the hardware utilization for the various clusters. -* Centralize the management of multiple Elastic deployments across teams or geographies. +This section covers the following tasks: -### ECE features +* [Deploy ECE](./cloud-enterprise/deploy-an-orchestrator.md) + - [Prepare the environment](./cloud-enterprise/prepare-environment.md) + - [Install ECE](./cloud-enterprise/install.md) + - [Air gapped installations](./cloud-enterprise/air-gapped-install.md) + - [Configure ECE](./cloud-enterprise/configure.md) -- **Automated Scaling & Orchestration** – Handles cluster provisioning, scaling, and upgrades automatically. -- **High Availability & Resilience** – Ensures uptime through multiple Availability Zones, data replication, and automated restore and snapshot. -- **Centralized Monitoring & Logging** – Provides insights into cluster performance, resource usage, and logs. -- **Single Sign-On (SSO) & Role-Based Access Control (RBAC)** – Allows organizations to manage access and security policies. -- **API & UI Management** – Offers a web interface and API to create and manage clusters easily. -- **Air gapped installations** - Support for off-line installations. -- **Microservices** - All services are containerized through Docker. See [](./cloud-enterprise/ece-containerization.md) for more details. +* [Work with deployments](./cloud-enterprise/working-with-deployments.md) + - Use [](./cloud-enterprise/deployment-templates.md) to [](./cloud-enterprise/create-deployment.md) + - [](./cloud-enterprise/customize-deployment.md) + - Use the deployment [Cloud ID](./cloud-enterprise/find-cloud-id.md) and [Endpoint URLs](./cloud-enterprise/find-endpoint-url.md) for clients connection -Check the [glossary](https://www.elastic.co/guide/en/elastic-stack-glossary/current/terms.html) to get familiar with the terminology for ECE as well as other Elastic products and solutions. +* Learn how to use the multiple [](./cloud-enterprise/tools-apis.md) available -### Use cases +Other sections of the documentation also include important tasks related with ECE: -- Organizations that need **full control over their Elastic Stack** while benefiting from cloud-like automation. -- Enterprises managing **multiple Elasticsearch clusters** across different teams or environments. -- Businesses looking for **a self-hosted alternative to Elastic Cloud** with centralized administration. +* [Secure your ECE installation](../security/secure-your-elastic-cloud-enterprise-installation.md) +* [Users and roles](../users-roles/cloud-enterprise-orchestrator.md) +* [Manage snapshot repositories](../tools/snapshot-and-restore.md) +* [Manage licenses](../license/manage-your-license-in-ece.md) +* [ECE platform maintenance operations](../maintenance/ece.md) -## How it differs from Elastic Cloud and other orchestrators +## How ECE differs from Elastic Cloud and other orchestrators For information about other deployment options, refer to [](../deploy.md). @@ -62,4 +53,4 @@ For information about other deployment options, refer to [](../deploy.md). ## Supported versions [ece-supported-versions] -Refer to [Elastic Support Matrix](https://www.elastic.co/support/matrix#elastic-cloud-enterprise) for more information about supported Operating Systems, Docker, and Podman versions. +Refer to [Elastic Support Matrix](https://www.elastic.co/support/matrix#elastic-cloud-enterprise) for more information about supported Operating Systems, Docker, and Podman versions. \ No newline at end of file diff --git a/deploy-manage/deploy/cloud-enterprise/configure.md b/deploy-manage/deploy/cloud-enterprise/configure.md index 9fca278326..757b9c7021 100644 --- a/deploy-manage/deploy/cloud-enterprise/configure.md +++ b/deploy-manage/deploy/cloud-enterprise/configure.md @@ -1,10 +1,12 @@ --- +applies: + ece: all mapped_pages: - https://www.elastic.co/guide/en/cloud-enterprise/current/ece-configuring-ece.html - https://www.elastic.co/guide/en/cloud-enterprise/current/ece-administering-ece.html --- -# Configure [ece-configuring-ece] +# Configure ECE [ece-configuring-ece] Now that you have Elastic Cloud Enterprise up and running, take a look at some of the additional features that you can configure: @@ -17,9 +19,9 @@ Now that you have Elastic Cloud Enterprise up and running, take a look at some o * [Change allocator disconnect timeout](change-allocator-disconnect-timeout.md) - Configure how long ECE waits before considering allocators to be disconnected. * [Migrate ECE on Podman hosts to SELinux in enforcing mode](migrate-ece-on-podman-hosts-to-selinux-enforce.md) - Migrate ECE to SELinux in `enforcing` mode using Podman. -# Administering your installation [ece-administering-ece] +## Administering your installation [ece-administering-ece] -Now that you have Elastic Cloud Enterprise up and running, take a look at the things you can do to keep your installation humming along, from adding more capacity to dealing with hosts that require maintenance or have failed: +Now that you have Elastic Cloud Enterprise up and running, take a look at the things you can do to keep your installation humming along, from adding more capacity to dealing with hosts that require maintenance or have failed. They are all presented in the [](../../maintenance.md) section. * [Scale Out Your Installation](../../../deploy-manage/maintenance/ece/scale-out-installation.md) - Need to add more capacity? Here’s how. * [Assign Roles to Hosts](../../../deploy-manage/deploy/cloud-enterprise/assign-roles-to-hosts.md) - Make sure new hosts can be used for their intended purpose after you install ECE on them. diff --git a/deploy-manage/deploy/cloud-enterprise/deploy-an-orchestrator.md b/deploy-manage/deploy/cloud-enterprise/deploy-an-orchestrator.md index 969a0109c7..16081bdc0a 100644 --- a/deploy-manage/deploy/cloud-enterprise/deploy-an-orchestrator.md +++ b/deploy-manage/deploy/cloud-enterprise/deploy-an-orchestrator.md @@ -4,11 +4,38 @@ applies: --- # Deploy an orchestrator -Elastic Cloud Enterprise (ECE) provides a centralized platform that allows organizations to run **Elasticsearch, Kibana, and other Elastic Stack components** across multiple machines, whether in a private or public cloud, virtual machines, or your own premises. +Elastic Cloud Enterprise (ECE) provides a centralized platform that allows organizations to run Elasticsearch, Kibana, and other Elastic Stack components across multiple machines, whether in a private or public cloud, virtual machines, or your own premises. + +::::{note} +This section focuses on deploying the ECE orchestrator. If you want to deploy {{es}}, {{kib}} or other {{stack}} applications on ECE, refer to [](./working-with-deployments.md). +:::: + +## Deployment tasks This section provides step-by-step guidance on: -* [**Installing ECE**](./install.md) → Installation pre-requisites and multiple installation methods for all supported Operating Systems. -* [**Configuring ECE**](./configure.md) → (TBD) +* [Prepare the environment](./prepare-environment.md): Follow the hardware, software, and networking prerequisites before the installation, and check the list of supported Operating Systems. + +* [Install ECE](./install.md): Identify the deployment scenario that best fits your needs, choose an installation method, and complete the setup. + * [Install ECE on a public cloud](./install-ece-on-public-cloud.md) + * [Install ECE on your own premises](./install-ece-on-own-premises.md) + * [Alternative: install ECE with Ansible](./alternative-install-ece-with-ansible.md) + +* [Air gapped installations](./air-gapped-install.md): Review the different options for air-gapped environments. + * [With your private Docker registry](./ece-install-offline-with-registry.md) + * [Without any Docker registry](./ece-install-offline-no-registry.md) + +* [Configure ECE](./configure.md) + * [System deployments configuration]() + * [Configure deployment templates]() + * [Change endpoint URLs]() + +## Additional topics + +Once ECE is deployed, you may need to configure security, manage snapshots, or perform maintenance tasks. Refer to the following sections for more details: -If you're looking to deploy {{es}}, {{kib}} or other {{stack}} applications on ECE, refer to [](./working-with-deployments.md). +* [Secure your ECE installation](../../security/secure-your-elastic-cloud-enterprise-installation.md) +* [Manage snapshot repositories](../../tools/snapshot-and-restore.md) +* [Manage licenses](../../license/manage-your-license-in-ece.md) +* [ECE platform maintenance operations](../../maintenance/ece.md) +* [Users and roles](../../users-roles/cloud-enterprise-orchestrator.md) \ No newline at end of file diff --git a/deploy-manage/deploy/cloud-enterprise/ece-overview.md b/deploy-manage/deploy/cloud-enterprise/ece-overview.md new file mode 100644 index 0000000000..62004c8549 --- /dev/null +++ b/deploy-manage/deploy/cloud-enterprise/ece-overview.md @@ -0,0 +1,44 @@ +--- +navigation_title: ECE Overview +applies: + ece: all +mapped_urls: + - https://www.elastic.co/guide/en/cloud-enterprise/current/Elastic-Cloud-Enterprise-overview.html +--- + +# Elastic Cloud Enterprise overview [Elastic-Cloud-Enterprise-overview] + +This page provides a high-level introduction to {{ece}} (ECE), including it's [](./ece-architecture.md) and [Containerized design](./ece-containerization.md) + +::::{note} +Try one of the [getting started guides](https://www.elastic.co/guide/en/starting-with-the-elasticsearch-platform-and-its-solutions/current/getting-started-guides.html) to discover the core concepts of the Elastic Stack and understand how Elastic can help you. +:::: + +### What is ECE? + +ECE evolves from the Elastic hosted Cloud SaaS offering into a standalone product. You can deploy ECE on public or private clouds, virtual machines, or your own premises. + +### Why ECE? + +* Host your regulated or sensitive data on your internal network. +* Reuse your existing investment in on-premise infrastructure and reduce total cost. +* Maximize the hardware utilization for the various clusters. +* Centralize the management of multiple Elastic deployments across teams or geographies. + +### ECE features + +- **Automated Scaling & Orchestration** – Handles cluster provisioning, scaling, and upgrades automatically. +- **High Availability & Resilience** – Ensures uptime through multiple Availability Zones, data replication, and automated restore and snapshot. +- **Centralized Monitoring & Logging** – Provides insights into cluster performance, resource usage, and logs. +- **Single Sign-On (SSO) & Role-Based Access Control (RBAC)** – Allows organizations to manage access and security policies. +- **API & UI Management** – Offers a web interface and API to create and manage clusters easily. +- **Air gapped installations** - Support for off-line installations. +- **Microservices** - All services are containerized through Docker. Refer to [](./ece-containerization.md) for more details. + +Check the [glossary](https://www.elastic.co/guide/en/elastic-stack-glossary/current/terms.html) to get familiar with the terminology for ECE as well as other Elastic products and solutions. + +### Use cases + +- Organizations that need full control over their Elastic Stack while benefiting from cloud-like automation. +- Enterprises managing multiple Elasticsearch clusters across different teams or environments. +- Businesses looking for a self-hosted alternative to Elastic Cloud with centralized administration. \ No newline at end of file diff --git a/deploy-manage/toc.yml b/deploy-manage/toc.yml index 1db12ecc74..7dd55ea489 100644 --- a/deploy-manage/toc.yml +++ b/deploy-manage/toc.yml @@ -120,8 +120,10 @@ toc: - file: deploy/elastic-cloud/restrictions-known-problems.md - file: deploy/cloud-enterprise.md children: - - file: deploy/cloud-enterprise/ece-architecture.md - - file: deploy/cloud-enterprise/ece-containerization.md + - file: deploy/cloud-enterprise/ece-overview.md + children: + - file: deploy/cloud-enterprise/ece-architecture.md + - file: deploy/cloud-enterprise/ece-containerization.md - file: deploy/cloud-enterprise/deploy-an-orchestrator.md children: - file: deploy/cloud-enterprise/prepare-environment.md From e9743cdc773002ba9c61756ccc0c5540bae8f041 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Edu=20Gonz=C3=A1lez=20de=20la=20Herr=C3=A1n?= <25320357+eedugon@users.noreply.github.com> Date: Wed, 19 Feb 2025 16:21:31 +0100 Subject: [PATCH 07/19] Update deploy-manage/deploy/cloud-enterprise/ece-overview.md Co-authored-by: kosabogi <105062005+kosabogi@users.noreply.github.com> --- deploy-manage/deploy/cloud-enterprise/ece-overview.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/deploy-manage/deploy/cloud-enterprise/ece-overview.md b/deploy-manage/deploy/cloud-enterprise/ece-overview.md index 62004c8549..3a19e27de2 100644 --- a/deploy-manage/deploy/cloud-enterprise/ece-overview.md +++ b/deploy-manage/deploy/cloud-enterprise/ece-overview.md @@ -8,7 +8,7 @@ mapped_urls: # Elastic Cloud Enterprise overview [Elastic-Cloud-Enterprise-overview] -This page provides a high-level introduction to {{ece}} (ECE), including it's [](./ece-architecture.md) and [Containerized design](./ece-containerization.md) +This page provides a high-level introduction to {{ece}} (ECE), including its [](./ece-architecture.md) and [Containerized design](./ece-containerization.md). ::::{note} Try one of the [getting started guides](https://www.elastic.co/guide/en/starting-with-the-elasticsearch-platform-and-its-solutions/current/getting-started-guides.html) to discover the core concepts of the Elastic Stack and understand how Elastic can help you. From 2d97e8f37d96479b0ca5a360608e8330212740ca Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Edu=20Gonz=C3=A1lez=20de=20la=20Herr=C3=A1n?= <25320357+eedugon@users.noreply.github.com> Date: Wed, 19 Feb 2025 16:21:42 +0100 Subject: [PATCH 08/19] Update deploy-manage/deploy/cloud-enterprise.md Co-authored-by: kosabogi <105062005+kosabogi@users.noreply.github.com> --- deploy-manage/deploy/cloud-enterprise.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/deploy-manage/deploy/cloud-enterprise.md b/deploy-manage/deploy/cloud-enterprise.md index 1fe8e8e902..a6c3788b89 100644 --- a/deploy-manage/deploy/cloud-enterprise.md +++ b/deploy-manage/deploy/cloud-enterprise.md @@ -35,7 +35,7 @@ This section covers the following tasks: * Learn how to use the multiple [](./cloud-enterprise/tools-apis.md) available -Other sections of the documentation also include important tasks related with ECE: +Other sections of the documentation also include important tasks related to ECE: * [Secure your ECE installation](../security/secure-your-elastic-cloud-enterprise-installation.md) * [Users and roles](../users-roles/cloud-enterprise-orchestrator.md) From 639409ef95caf98c604b7c6dfb7993e16c25baa1 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Edu=20Gonz=C3=A1lez=20de=20la=20Herr=C3=A1n?= <25320357+eedugon@users.noreply.github.com> Date: Wed, 19 Feb 2025 16:21:52 +0100 Subject: [PATCH 09/19] Update deploy-manage/deploy/cloud-enterprise/deploy-an-orchestrator.md Co-authored-by: kosabogi <105062005+kosabogi@users.noreply.github.com> --- deploy-manage/deploy/cloud-enterprise/deploy-an-orchestrator.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/deploy-manage/deploy/cloud-enterprise/deploy-an-orchestrator.md b/deploy-manage/deploy/cloud-enterprise/deploy-an-orchestrator.md index 16081bdc0a..7eb605adbc 100644 --- a/deploy-manage/deploy/cloud-enterprise/deploy-an-orchestrator.md +++ b/deploy-manage/deploy/cloud-enterprise/deploy-an-orchestrator.md @@ -21,7 +21,7 @@ This section provides step-by-step guidance on: * [Install ECE on your own premises](./install-ece-on-own-premises.md) * [Alternative: install ECE with Ansible](./alternative-install-ece-with-ansible.md) -* [Air gapped installations](./air-gapped-install.md): Review the different options for air-gapped environments. +* [Air-gapped installations](./air-gapped-install.md): Review the different options for air-gapped environments. * [With your private Docker registry](./ece-install-offline-with-registry.md) * [Without any Docker registry](./ece-install-offline-no-registry.md) From be9c9097bfd097d16d66896782c8e0e3cbc8af7f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Edu=20Gonz=C3=A1lez=20de=20la=20Herr=C3=A1n?= <25320357+eedugon@users.noreply.github.com> Date: Thu, 20 Feb 2025 09:03:29 +0100 Subject: [PATCH 10/19] small change --- .../deploy/cloud-enterprise/deploy-an-orchestrator.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/deploy-manage/deploy/cloud-enterprise/deploy-an-orchestrator.md b/deploy-manage/deploy/cloud-enterprise/deploy-an-orchestrator.md index 7eb605adbc..c103002dd1 100644 --- a/deploy-manage/deploy/cloud-enterprise/deploy-an-orchestrator.md +++ b/deploy-manage/deploy/cloud-enterprise/deploy-an-orchestrator.md @@ -25,17 +25,17 @@ This section provides step-by-step guidance on: * [With your private Docker registry](./ece-install-offline-with-registry.md) * [Without any Docker registry](./ece-install-offline-no-registry.md) -* [Configure ECE](./configure.md) - * [System deployments configuration]() - * [Configure deployment templates]() - * [Change endpoint URLs]() +* [Configure ECE](./configure.md): Explore the most common tasks to configure your ECE platform. + * [System deployments configuration](./system-deployments-configuration.md) + * [Configure deployment templates](./deployment-templates.md) + * [Change endpoint URLs](./change-endpoint-urls.md) ## Additional topics Once ECE is deployed, you may need to configure security, manage snapshots, or perform maintenance tasks. Refer to the following sections for more details: * [Secure your ECE installation](../../security/secure-your-elastic-cloud-enterprise-installation.md) +* [Users and roles](../../users-roles/cloud-enterprise-orchestrator.md) * [Manage snapshot repositories](../../tools/snapshot-and-restore.md) * [Manage licenses](../../license/manage-your-license-in-ece.md) * [ECE platform maintenance operations](../../maintenance/ece.md) -* [Users and roles](../../users-roles/cloud-enterprise-orchestrator.md) \ No newline at end of file From 39a499c3fb71a3be0853ef7df5e9f6f5d8363bc7 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Edu=20Gonz=C3=A1lez=20de=20la=20Herr=C3=A1n?= <25320357+eedugon@users.noreply.github.com> Date: Thu, 20 Feb 2025 17:17:30 +0100 Subject: [PATCH 11/19] Update deploy-manage/deploy/cloud-enterprise.md Co-authored-by: shainaraskas <58563081+shainaraskas@users.noreply.github.com> --- deploy-manage/deploy/cloud-enterprise.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/deploy-manage/deploy/cloud-enterprise.md b/deploy-manage/deploy/cloud-enterprise.md index a6c3788b89..11af674ecf 100644 --- a/deploy-manage/deploy/cloud-enterprise.md +++ b/deploy-manage/deploy/cloud-enterprise.md @@ -16,7 +16,7 @@ If you are looking for a solution to orchestrate and manage {{es}} clusters nati % should we use a L2 heading here or just continue? ## Section overview -This section focuses on deploying ECE and the orchestrating and configuring {{es}} clusters, also referred to as `deployments`. +This section focuses on deploying ECE and orchestrating and configuring {{es}} clusters, also referred to as `deployments`. In ECE, a deployment is a managed {{stack}} environment that provides users with an {{es}} cluster along with supporting components such as {{kib}} and other optional services like APM and Fleet. From 31ed45b69893ea6f36c9f7f0afc0a66697a0c27c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Edu=20Gonz=C3=A1lez=20de=20la=20Herr=C3=A1n?= <25320357+eedugon@users.noreply.github.com> Date: Thu, 20 Feb 2025 17:18:02 +0100 Subject: [PATCH 12/19] Update deploy-manage/deploy/cloud-enterprise.md Co-authored-by: shainaraskas <58563081+shainaraskas@users.noreply.github.com> --- deploy-manage/deploy/cloud-enterprise.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/deploy-manage/deploy/cloud-enterprise.md b/deploy-manage/deploy/cloud-enterprise.md index 11af674ecf..8ca6814ee1 100644 --- a/deploy-manage/deploy/cloud-enterprise.md +++ b/deploy-manage/deploy/cloud-enterprise.md @@ -33,7 +33,7 @@ This section covers the following tasks: - [](./cloud-enterprise/customize-deployment.md) - Use the deployment [Cloud ID](./cloud-enterprise/find-cloud-id.md) and [Endpoint URLs](./cloud-enterprise/find-endpoint-url.md) for clients connection -* Learn how to use the multiple [](./cloud-enterprise/tools-apis.md) available +* Learn about [](./cloud-enterprise/tools-apis.md) that you can use with ECE Other sections of the documentation also include important tasks related to ECE: From 0c403c995cc3be6909768d191ff4a8157fcfe2e2 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Edu=20Gonz=C3=A1lez=20de=20la=20Herr=C3=A1n?= <25320357+eedugon@users.noreply.github.com> Date: Thu, 20 Feb 2025 17:25:39 +0100 Subject: [PATCH 13/19] Update deploy-manage/deploy/cloud-enterprise.md Co-authored-by: shainaraskas <58563081+shainaraskas@users.noreply.github.com> --- deploy-manage/deploy/cloud-enterprise.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/deploy-manage/deploy/cloud-enterprise.md b/deploy-manage/deploy/cloud-enterprise.md index 8ca6814ee1..f0932d5390 100644 --- a/deploy-manage/deploy/cloud-enterprise.md +++ b/deploy-manage/deploy/cloud-enterprise.md @@ -53,4 +53,4 @@ For information about other deployment options, refer to [](../deploy.md). ## Supported versions [ece-supported-versions] -Refer to [Elastic Support Matrix](https://www.elastic.co/support/matrix#elastic-cloud-enterprise) for more information about supported Operating Systems, Docker, and Podman versions. \ No newline at end of file +Refer to the [Elastic Support Matrix](https://www.elastic.co/support/matrix#elastic-cloud-enterprise) for more information about supported Operating Systems, Docker, and Podman versions. \ No newline at end of file From a68cf7d6c57787938d08749ecbfd0705b8a0a5c8 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Edu=20Gonz=C3=A1lez=20de=20la=20Herr=C3=A1n?= <25320357+eedugon@users.noreply.github.com> Date: Thu, 20 Feb 2025 20:58:33 +0100 Subject: [PATCH 14/19] updating overview - WIP --- deploy-manage/deploy/cloud-enterprise.md | 43 +++++++++++++++++-- .../deploy/cloud-enterprise/ece-overview.md | 8 ++-- 2 files changed, 43 insertions(+), 8 deletions(-) diff --git a/deploy-manage/deploy/cloud-enterprise.md b/deploy-manage/deploy/cloud-enterprise.md index f0932d5390..0a66e61dba 100644 --- a/deploy-manage/deploy/cloud-enterprise.md +++ b/deploy-manage/deploy/cloud-enterprise.md @@ -7,13 +7,49 @@ applies: {{ece}} (ECE) is an Elastic self-managed solution for deploying, orchestrating, and managing {{es}} clusters at scale. It provides a centralized platform that allows organizations to run {{es}}, {{kib}}, and other {{stack}} components across multiple machines. -Refer to [](./cloud-enterprise/ece-overview.md) for a detailed introduction to ECE, including its features, use cases, and architecture. - ::::{tip} If you are looking for a solution to orchestrate and manage {{es}} clusters natively on Kubernetes, consider using [Elastic Cloud on Kubernetes (ECK)](./cloud-on-k8s.md) instead of ECE. ECK enables you to orchestrate Elastic Stack applications seamlessly on Kubernetes, leveraging it as the underlying platform for deployment, scaling, and lifecycle management. :::: -% should we use a L2 heading here or just continue? +ECE evolves from the Elastic hosted Cloud SaaS offering into a standalone product. You can deploy ECE on public or private clouds, virtual machines, or your own premises. + +With {{ece}}, you can: + +* Host your regulated or sensitive data on your internal network. +* Reuse your existing investment in on-premise infrastructure and reduce total cost. +* Maximize the hardware utilization for the various clusters. +* Centralize the management of multiple Elastic deployments across teams or geographies. + +Refer to [](./cloud-enterprise/ece-architecture.md) and [Containerized design](./cloud-enterprise/ece-containerization.md) for details about the ECE platform architecture and technologies used. + +## ECE features + +- **Automated Scaling & Orchestration**: Handles cluster provisioning, scaling, and upgrades automatically. +- **High Availability & Resilience**: Ensures uptime through multiple Availability Zones, data replication, and automated restore and snapshot. +- **Centralized Monitoring & Logging**: Provides insights into cluster performance, resource usage, and logs. +- **Single Sign-On (SSO) & Role-Based Access Control (RBAC)**: Allows organizations to manage access and security policies. +- **API & UI Management**: Offers a web interface and API to create and manage clusters easily. +- **Air-gapped installations**: Support for off-line installations. +- **Microservices**: All services are containerized through Docker. Refer to [](./ece-containerization.md) for more details. + +## ECE features + +* All services are containerized through Docker. +* High Availability through multiple Availability Zones. +* Deployment state coordination using ZooKeeper. +* Easy access for admins through the Cloud UI and API. +* Support for off-line installations. +* Automated restore and snapshot. + +Check the [glossary](https://www.elastic.co/guide/en/elastic-stack-glossary/current/terms.html) to get familiar with the terminology for ECE as well as other Elastic products and solutions. + +% delete or keep. this wasn't part of the original content +%### Use cases +% +%- Organizations that need full control over their Elastic Stack while benefiting from cloud-like automation. +%- Enterprises managing multiple Elasticsearch clusters across different teams or environments. +%- Businesses looking for a self-hosted alternative to Elastic Cloud with centralized administration. + ## Section overview This section focuses on deploying ECE and orchestrating and configuring {{es}} clusters, also referred to as `deployments`. @@ -39,6 +75,7 @@ Other sections of the documentation also include important tasks related to ECE: * [Secure your ECE installation](../security/secure-your-elastic-cloud-enterprise-installation.md) * [Users and roles](../users-roles/cloud-enterprise-orchestrator.md) +* [Secure your deployments](../security/secure-your-cluster-deployment.md) * [Manage snapshot repositories](../tools/snapshot-and-restore.md) * [Manage licenses](../license/manage-your-license-in-ece.md) * [ECE platform maintenance operations](../maintenance/ece.md) diff --git a/deploy-manage/deploy/cloud-enterprise/ece-overview.md b/deploy-manage/deploy/cloud-enterprise/ece-overview.md index 3a19e27de2..143213babe 100644 --- a/deploy-manage/deploy/cloud-enterprise/ece-overview.md +++ b/deploy-manage/deploy/cloud-enterprise/ece-overview.md @@ -14,18 +14,16 @@ This page provides a high-level introduction to {{ece}} (ECE), including its []( Try one of the [getting started guides](https://www.elastic.co/guide/en/starting-with-the-elasticsearch-platform-and-its-solutions/current/getting-started-guides.html) to discover the core concepts of the Elastic Stack and understand how Elastic can help you. :::: -### What is ECE? - ECE evolves from the Elastic hosted Cloud SaaS offering into a standalone product. You can deploy ECE on public or private clouds, virtual machines, or your own premises. -### Why ECE? +With {{ece}}, you can: * Host your regulated or sensitive data on your internal network. * Reuse your existing investment in on-premise infrastructure and reduce total cost. * Maximize the hardware utilization for the various clusters. * Centralize the management of multiple Elastic deployments across teams or geographies. -### ECE features +## ECE features - **Automated Scaling & Orchestration** – Handles cluster provisioning, scaling, and upgrades automatically. - **High Availability & Resilience** – Ensures uptime through multiple Availability Zones, data replication, and automated restore and snapshot. @@ -37,7 +35,7 @@ ECE evolves from the Elastic hosted Cloud SaaS offering into a standalone produc Check the [glossary](https://www.elastic.co/guide/en/elastic-stack-glossary/current/terms.html) to get familiar with the terminology for ECE as well as other Elastic products and solutions. -### Use cases +## Use cases - Organizations that need full control over their Elastic Stack while benefiting from cloud-like automation. - Enterprises managing multiple Elasticsearch clusters across different teams or environments. From 1cfc83616e79203c3ed23c4e9b8ef9597fa6cc79 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Edu=20Gonz=C3=A1lez=20de=20la=20Herr=C3=A1n?= <25320357+eedugon@users.noreply.github.com> Date: Fri, 21 Feb 2025 18:39:16 +0100 Subject: [PATCH 15/19] changes from pr review --- deploy-manage/deploy/cloud-enterprise.md | 54 ++++++++----------- .../deploy/cloud-enterprise/configure.md | 7 ++- .../deploy-an-orchestrator.md | 17 ++++-- .../cloud-enterprise/ece-architecture.md | 23 ++++++-- .../cloud-enterprise/ece-containerization.md | 20 ------- .../deploy/cloud-enterprise/ece-overview.md | 42 --------------- deploy-manage/toc.yml | 5 +- 7 files changed, 61 insertions(+), 107 deletions(-) delete mode 100644 deploy-manage/deploy/cloud-enterprise/ece-containerization.md delete mode 100644 deploy-manage/deploy/cloud-enterprise/ece-overview.md diff --git a/deploy-manage/deploy/cloud-enterprise.md b/deploy-manage/deploy/cloud-enterprise.md index 0a66e61dba..cddae020ba 100644 --- a/deploy-manage/deploy/cloud-enterprise.md +++ b/deploy-manage/deploy/cloud-enterprise.md @@ -1,6 +1,7 @@ --- -applies: - ece: all +applies_to: + deployment: + ece: all --- # Elastic Cloud Enterprise [Elastic-Cloud-Enterprise-overview] @@ -20,45 +21,29 @@ With {{ece}}, you can: * Maximize the hardware utilization for the various clusters. * Centralize the management of multiple Elastic deployments across teams or geographies. -Refer to [](./cloud-enterprise/ece-architecture.md) and [Containerized design](./cloud-enterprise/ece-containerization.md) for details about the ECE platform architecture and technologies used. +Refer to [](./cloud-enterprise/ece-architecture.md) for details about the ECE platform architecture and the technologies used. ## ECE features -- **Automated Scaling & Orchestration**: Handles cluster provisioning, scaling, and upgrades automatically. -- **High Availability & Resilience**: Ensures uptime through multiple Availability Zones, data replication, and automated restore and snapshot. -- **Centralized Monitoring & Logging**: Provides insights into cluster performance, resource usage, and logs. -- **Single Sign-On (SSO) & Role-Based Access Control (RBAC)**: Allows organizations to manage access and security policies. -- **API & UI Management**: Offers a web interface and API to create and manage clusters easily. +- **Automated scaling & orchestration**: Handles cluster provisioning, scaling, and upgrades automatically. +- **High availability & resilience**: Ensures uptime through multiple Availability Zones, data replication, and automated restore and snapshot. +- **Centralized monitoring & logging**: Provides insights into cluster performance, resource usage, and logs. +- **Single Sign-On (SSO) & role-based access aontrol (RBAC)**: Allows organizations to manage access and security policies. +- **API & UI management**: Offers a web interface and API to create and manage clusters easily. - **Air-gapped installations**: Support for off-line installations. -- **Microservices**: All services are containerized through Docker. Refer to [](./ece-containerization.md) for more details. - -## ECE features - -* All services are containerized through Docker. -* High Availability through multiple Availability Zones. -* Deployment state coordination using ZooKeeper. -* Easy access for admins through the Cloud UI and API. -* Support for off-line installations. -* Automated restore and snapshot. +- **Microservices architecture**: All services are containerized through Docker. Check the [glossary](https://www.elastic.co/guide/en/elastic-stack-glossary/current/terms.html) to get familiar with the terminology for ECE as well as other Elastic products and solutions. -% delete or keep. this wasn't part of the original content -%### Use cases -% -%- Organizations that need full control over their Elastic Stack while benefiting from cloud-like automation. -%- Enterprises managing multiple Elasticsearch clusters across different teams or environments. -%- Businesses looking for a self-hosted alternative to Elastic Cloud with centralized administration. - ## Section overview This section focuses on deploying ECE and orchestrating and configuring {{es}} clusters, also referred to as `deployments`. -In ECE, a deployment is a managed {{stack}} environment that provides users with an {{es}} cluster along with supporting components such as {{kib}} and other optional services like APM and Fleet. +In ECE, a deployment is a managed {{stack}} environment that provides users with an {{es}} cluster along with supporting components such as {{kib}} and other optional services like APM and {{fleet}}. This section covers the following tasks: -* [Deploy ECE](./cloud-enterprise/deploy-an-orchestrator.md) +* [Deploy ECE orchestrator](./cloud-enterprise/deploy-an-orchestrator.md) - [Prepare the environment](./cloud-enterprise/prepare-environment.md) - [Install ECE](./cloud-enterprise/install.md) - [Air gapped installations](./cloud-enterprise/air-gapped-install.md) @@ -73,12 +58,15 @@ This section covers the following tasks: Other sections of the documentation also include important tasks related to ECE: -* [Secure your ECE installation](../security/secure-your-elastic-cloud-enterprise-installation.md) -* [Users and roles](../users-roles/cloud-enterprise-orchestrator.md) -* [Secure your deployments](../security/secure-your-cluster-deployment.md) -* [Manage snapshot repositories](../tools/snapshot-and-restore.md) -* [Manage licenses](../license/manage-your-license-in-ece.md) -* [ECE platform maintenance operations](../maintenance/ece.md) +* Platform security and management: + * [Secure your ECE installation](../security/secure-your-elastic-cloud-enterprise-installation.md) + * [Users and roles](../users-roles/cloud-enterprise-orchestrator.md) + * [ECE platform maintenance operations](../maintenance/ece.md) + * [Manage licenses](../license/manage-your-license-in-ece.md) + +* Deployments security and management: + * [Secure your deployments](../security/secure-your-cluster-deployment.md) + * [Manage snapshot repositories](../tools/snapshot-and-restore.md) ## How ECE differs from Elastic Cloud and other orchestrators diff --git a/deploy-manage/deploy/cloud-enterprise/configure.md b/deploy-manage/deploy/cloud-enterprise/configure.md index 757b9c7021..7a71714ea5 100644 --- a/deploy-manage/deploy/cloud-enterprise/configure.md +++ b/deploy-manage/deploy/cloud-enterprise/configure.md @@ -1,6 +1,7 @@ --- -applies: - ece: all +applies_to: + deployment: + ece: all mapped_pages: - https://www.elastic.co/guide/en/cloud-enterprise/current/ece-configuring-ece.html - https://www.elastic.co/guide/en/cloud-enterprise/current/ece-administering-ece.html @@ -8,6 +9,8 @@ mapped_pages: # Configure ECE [ece-configuring-ece] +⚠️ **This page is a work in progress.** ⚠️ + Now that you have Elastic Cloud Enterprise up and running, take a look at some of the additional features that you can configure: * [System deployment configuration](system-deployments-configuration.md) - Best practices for ECE system deployments to ensure a highly available and resilient setup. diff --git a/deploy-manage/deploy/cloud-enterprise/deploy-an-orchestrator.md b/deploy-manage/deploy/cloud-enterprise/deploy-an-orchestrator.md index c103002dd1..b600bcf6de 100644 --- a/deploy-manage/deploy/cloud-enterprise/deploy-an-orchestrator.md +++ b/deploy-manage/deploy/cloud-enterprise/deploy-an-orchestrator.md @@ -1,6 +1,7 @@ --- -applies: - ece: all +applies_to: + deployment: + ece: all --- # Deploy an orchestrator @@ -32,10 +33,20 @@ This section provides step-by-step guidance on: ## Additional topics -Once ECE is deployed, you may need to configure security, manage snapshots, or perform maintenance tasks. Refer to the following sections for more details: +After deploying ECE platform, you may need to configure your own proxy certificates, security, snapshot repositories, or perform maintenance tasks. Refer to the following sections for more details: * [Secure your ECE installation](../../security/secure-your-elastic-cloud-enterprise-installation.md) * [Users and roles](../../users-roles/cloud-enterprise-orchestrator.md) * [Manage snapshot repositories](../../tools/snapshot-and-restore.md) * [Manage licenses](../../license/manage-your-license-in-ece.md) * [ECE platform maintenance operations](../../maintenance/ece.md) + +To start orchestrating your {{es}} clusters, refer to [](./working-with-deployments.md). + +## Advanced tasks + +The following tasks are only needed on certain circumstances: + +* Migrate ECE to Podman hosts +* Migrate ECE on Podman hosts to SELinux enforce +* Change allocator disconnect timeout diff --git a/deploy-manage/deploy/cloud-enterprise/ece-architecture.md b/deploy-manage/deploy/cloud-enterprise/ece-architecture.md index 5463797e6e..cb3235be09 100644 --- a/deploy-manage/deploy/cloud-enterprise/ece-architecture.md +++ b/deploy-manage/deploy/cloud-enterprise/ece-architecture.md @@ -1,8 +1,10 @@ --- -applies: - ece: all +applies_to: + deployment: + ece: all mapped_pages: - https://www.elastic.co/guide/en/cloud-enterprise/current/ece-architecture.html + - https://www.elastic.co/guide/en/cloud-enterprise/current/ece-containerization.html --- # Service-oriented architecture [ece-architecture] @@ -17,7 +19,6 @@ Elastic Cloud Enterprise has a service-oriented architecture that lets you: :alt: Elastic Cloud Enterprise high level architecture ::: - ## Control plane [ece_control_plane] The *control plane* of ECE include the following management services: @@ -67,3 +68,19 @@ Provide web and API access for administrators to manage and monitor the ECE inst * Advertise the memory capacity of the underlying host machine to ZooKeeper so that the Constructor can make an informed decision on where to deploy. +## Services as Docker containers [ece-containerization] + +Services are deployed as Docker containers, which simplifies the operational effort and makes it easy to provision similar environments for development and staging. Using Docker containers has the following advantages: + +* **Shares of resources** + + Each cluster node is run within a Docker container to make sure that all of the nodes have access to a guaranteed share of host resources. This mitigates the *noisy neighbor effect* where one busy deployment can overwhelm the entire host. The CPU resources are relative to the size of the Elasticsearch cluster they get assigned to. For example, a cluster with 32GB of RAM gets assigned twice as many CPU resources as a cluster with 16GB of RAM. + +* **Better security** + + On the assumption that any cluster can be compromised, containers are given no access to the platform. The same is true for the services: each service can read or write only those parts of the system state that are relevant to it. Even if some services are compromised, the attacker won’t get hold of the keys to the rest of them and will not compromise the whole platform. + +* **Secure communication through Stunnel** + + Docker containers communicate securely with one another through Transport Layer Security, provided by [Stunnel](https://www.stunnel.org/) (as not all of the services or components support TLS natively). Tunneling all traffic between containers makes sure that it is not possible to eavesdrop, even when someone else has access to the underlying cloud or network infrastructure. + diff --git a/deploy-manage/deploy/cloud-enterprise/ece-containerization.md b/deploy-manage/deploy/cloud-enterprise/ece-containerization.md deleted file mode 100644 index d17e19ea32..0000000000 --- a/deploy-manage/deploy/cloud-enterprise/ece-containerization.md +++ /dev/null @@ -1,20 +0,0 @@ ---- -mapped_pages: - - https://www.elastic.co/guide/en/cloud-enterprise/current/ece-containerization.html ---- - -# Services as Docker containers [ece-containerization] - -Services are deployed as Docker containers, which simplifies the operational effort and makes it easy to provision similar environments for development and staging. Using Docker containers has the following advantages: - -* **Shares of resources** - - Each cluster node is run within a Docker container to make sure that all of the nodes have access to a guaranteed share of host resources. This mitigates the *noisy neighbor effect* where one busy deployment can overwhelm the entire host. The CPU resources are relative to the size of the Elasticsearch cluster they get assigned to. For example, a cluster with 32GB of RAM gets assigned twice as many CPU resources as a cluster with 16GB of RAM. - -* **Better security** - - On the assumption that any cluster can be compromised, containers are given no access to the platform. The same is true for the services: each service can read or write only those parts of the system state that are relevant to it. Even if some services are compromised, the attacker won’t get hold of the keys to the rest of them and will not compromise the whole platform. - -* **Secure communication through Stunnel** - - Docker containers communicate securely with one another through Transport Layer Security, provided by [Stunnel](https://www.stunnel.org/) (as not all of the services or components support TLS natively). Tunneling all traffic between containers makes sure that it is not possible to eavesdrop, even when someone else has access to the underlying cloud or network infrastructure. diff --git a/deploy-manage/deploy/cloud-enterprise/ece-overview.md b/deploy-manage/deploy/cloud-enterprise/ece-overview.md deleted file mode 100644 index 143213babe..0000000000 --- a/deploy-manage/deploy/cloud-enterprise/ece-overview.md +++ /dev/null @@ -1,42 +0,0 @@ ---- -navigation_title: ECE Overview -applies: - ece: all -mapped_urls: - - https://www.elastic.co/guide/en/cloud-enterprise/current/Elastic-Cloud-Enterprise-overview.html ---- - -# Elastic Cloud Enterprise overview [Elastic-Cloud-Enterprise-overview] - -This page provides a high-level introduction to {{ece}} (ECE), including its [](./ece-architecture.md) and [Containerized design](./ece-containerization.md). - -::::{note} -Try one of the [getting started guides](https://www.elastic.co/guide/en/starting-with-the-elasticsearch-platform-and-its-solutions/current/getting-started-guides.html) to discover the core concepts of the Elastic Stack and understand how Elastic can help you. -:::: - -ECE evolves from the Elastic hosted Cloud SaaS offering into a standalone product. You can deploy ECE on public or private clouds, virtual machines, or your own premises. - -With {{ece}}, you can: - -* Host your regulated or sensitive data on your internal network. -* Reuse your existing investment in on-premise infrastructure and reduce total cost. -* Maximize the hardware utilization for the various clusters. -* Centralize the management of multiple Elastic deployments across teams or geographies. - -## ECE features - -- **Automated Scaling & Orchestration** – Handles cluster provisioning, scaling, and upgrades automatically. -- **High Availability & Resilience** – Ensures uptime through multiple Availability Zones, data replication, and automated restore and snapshot. -- **Centralized Monitoring & Logging** – Provides insights into cluster performance, resource usage, and logs. -- **Single Sign-On (SSO) & Role-Based Access Control (RBAC)** – Allows organizations to manage access and security policies. -- **API & UI Management** – Offers a web interface and API to create and manage clusters easily. -- **Air gapped installations** - Support for off-line installations. -- **Microservices** - All services are containerized through Docker. Refer to [](./ece-containerization.md) for more details. - -Check the [glossary](https://www.elastic.co/guide/en/elastic-stack-glossary/current/terms.html) to get familiar with the terminology for ECE as well as other Elastic products and solutions. - -## Use cases - -- Organizations that need full control over their Elastic Stack while benefiting from cloud-like automation. -- Enterprises managing multiple Elasticsearch clusters across different teams or environments. -- Businesses looking for a self-hosted alternative to Elastic Cloud with centralized administration. \ No newline at end of file diff --git a/deploy-manage/toc.yml b/deploy-manage/toc.yml index 7dd55ea489..4a6313bb27 100644 --- a/deploy-manage/toc.yml +++ b/deploy-manage/toc.yml @@ -120,10 +120,7 @@ toc: - file: deploy/elastic-cloud/restrictions-known-problems.md - file: deploy/cloud-enterprise.md children: - - file: deploy/cloud-enterprise/ece-overview.md - children: - - file: deploy/cloud-enterprise/ece-architecture.md - - file: deploy/cloud-enterprise/ece-containerization.md + - file: deploy/cloud-enterprise/ece-architecture.md - file: deploy/cloud-enterprise/deploy-an-orchestrator.md children: - file: deploy/cloud-enterprise/prepare-environment.md From 372607d96865a590e5a1eb14ff4ab0ff99e51fe6 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Edu=20Gonz=C3=A1lez=20de=20la=20Herr=C3=A1n?= <25320357+eedugon@users.noreply.github.com> Date: Sat, 22 Feb 2025 11:30:39 +0100 Subject: [PATCH 16/19] links and landing pages updated --- deploy-manage/deploy/cloud-enterprise.md | 12 +----------- .../cloud-enterprise/deploy-an-orchestrator.md | 13 +++++++------ 2 files changed, 8 insertions(+), 17 deletions(-) diff --git a/deploy-manage/deploy/cloud-enterprise.md b/deploy-manage/deploy/cloud-enterprise.md index 5c96c83ae9..8cb115b1e4 100644 --- a/deploy-manage/deploy/cloud-enterprise.md +++ b/deploy-manage/deploy/cloud-enterprise.md @@ -11,10 +11,6 @@ mapped_urls: {{ece}} (ECE) is an Elastic self-managed solution for deploying, orchestrating, and managing {{es}} clusters at scale. It provides a centralized platform that allows organizations to run {{es}}, {{kib}}, and other {{stack}} components across multiple machines. -::::{tip} -If you are looking for a solution to orchestrate and manage {{es}} clusters natively on Kubernetes, consider using [Elastic Cloud on Kubernetes (ECK)](./cloud-on-k8s.md) instead of ECE. ECK enables you to orchestrate Elastic Stack applications seamlessly on Kubernetes, leveraging it as the underlying platform for deployment, scaling, and lifecycle management. -:::: - ECE evolves from the Elastic hosted Cloud SaaS offering into a standalone product. You can deploy ECE on public or private clouds, virtual machines, or your own premises. With {{ece}}, you can: @@ -71,13 +67,7 @@ Other sections of the documentation also include important tasks related to ECE: * [Secure your deployments](../security/secure-your-cluster-deployment.md) * [Manage snapshot repositories](../tools/snapshot-and-restore.md) -## How ECE differs from Elastic Cloud and other orchestrators - -For information about other deployment options, refer to [](../deploy.md). - -% - **Elastic Cloud** (hosted by Elastic) is fully managed and runs on AWS, GCP, and Azure. -% - **ECE** is for organizations that **want to self-host and manage their own Elastic Stack** deployments across their infrastructure. -% - **ECK** is for organizations that want to run on Kubernetes. +To learn about other deployment options, refer to [](../deploy.md). ## Supported versions [ece-supported-versions] diff --git a/deploy-manage/deploy/cloud-enterprise/deploy-an-orchestrator.md b/deploy-manage/deploy/cloud-enterprise/deploy-an-orchestrator.md index b600bcf6de..adc1bed954 100644 --- a/deploy-manage/deploy/cloud-enterprise/deploy-an-orchestrator.md +++ b/deploy-manage/deploy/cloud-enterprise/deploy-an-orchestrator.md @@ -15,7 +15,7 @@ This section focuses on deploying the ECE orchestrator. If you want to deploy {{ This section provides step-by-step guidance on: -* [Prepare the environment](./prepare-environment.md): Follow the hardware, software, and networking prerequisites before the installation, and check the list of supported Operating Systems. +* [Prepare the environment](./prepare-environment.md): Follow the hardware, software, and networking prerequisites before the installation. * [Install ECE](./install.md): Identify the deployment scenario that best fits your needs, choose an installation method, and complete the setup. * [Install ECE on a public cloud](./install-ece-on-public-cloud.md) @@ -29,11 +29,12 @@ This section provides step-by-step guidance on: * [Configure ECE](./configure.md): Explore the most common tasks to configure your ECE platform. * [System deployments configuration](./system-deployments-configuration.md) * [Configure deployment templates](./deployment-templates.md) - * [Change endpoint URLs](./change-endpoint-urls.md) + * [Configure endpoint URLs](./change-endpoint-urls.md) + * [Manage {{stack}} versions](./manage-elastic-stack-versions.md) ## Additional topics -After deploying ECE platform, you may need to configure your own proxy certificates, security, snapshot repositories, or perform maintenance tasks. Refer to the following sections for more details: +After deploying ECE platform, you may need to configure your own proxy certificates, security, snapshot repositories, or perform maintenance tasks. Refer to the following sections for more details: * [Secure your ECE installation](../../security/secure-your-elastic-cloud-enterprise-installation.md) * [Users and roles](../../users-roles/cloud-enterprise-orchestrator.md) @@ -47,6 +48,6 @@ To start orchestrating your {{es}} clusters, refer to [](./working-with-deployme The following tasks are only needed on certain circumstances: -* Migrate ECE to Podman hosts -* Migrate ECE on Podman hosts to SELinux enforce -* Change allocator disconnect timeout +* [Migrate ECE to Podman hosts](./migrate-ece-to-podman-hosts.md) +* [Migrate ECE on Podman hosts to SELinux enforce](./migrate-ece-on-podman-hosts-to-selinux-enforce.md) +* [Change allocator disconnect timeout](./change-allocator-disconnect-timeout.md) From ea05aa6877ffd7a0c1cdfaa1f46f59637cf3e828 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Edu=20Gonz=C3=A1lez=20de=20la=20Herr=C3=A1n?= <25320357+eedugon@users.noreply.github.com> Date: Sun, 23 Feb 2025 11:18:16 +0100 Subject: [PATCH 17/19] minor changes on landing pages --- deploy-manage/deploy/cloud-enterprise.md | 6 +++--- .../deploy/cloud-enterprise/deploy-an-orchestrator.md | 2 +- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/deploy-manage/deploy/cloud-enterprise.md b/deploy-manage/deploy/cloud-enterprise.md index 8cb115b1e4..775a52e3ae 100644 --- a/deploy-manage/deploy/cloud-enterprise.md +++ b/deploy-manage/deploy/cloud-enterprise.md @@ -36,11 +36,11 @@ Check the [glossary](https://www.elastic.co/guide/en/elastic-stack-glossary/curr ## Section overview -This section focuses on deploying ECE and orchestrating and configuring {{es}} clusters, also referred to as `deployments`. +This section focuses on deploying the ECE platform, as well as orchestrating and configuring {{es}} clusters, referred to as deployments. In ECE, a deployment is a managed {{stack}} environment that provides users with an {{es}} cluster along with supporting components such as {{kib}} and other optional services like APM and {{fleet}}. -This section covers the following tasks: +The section covers the following tasks: * [Deploy ECE orchestrator](./cloud-enterprise/deploy-an-orchestrator.md) - [Prepare the environment](./cloud-enterprise/prepare-environment.md) @@ -55,7 +55,7 @@ This section covers the following tasks: * Learn about [](./cloud-enterprise/tools-apis.md) that you can use with ECE -Other sections of the documentation also include important tasks related to ECE: +Other sections of the documentation provide guidance on additional important tasks related to ECE: * Platform security and management: * [Secure your ECE installation](../security/secure-your-elastic-cloud-enterprise-installation.md) diff --git a/deploy-manage/deploy/cloud-enterprise/deploy-an-orchestrator.md b/deploy-manage/deploy/cloud-enterprise/deploy-an-orchestrator.md index adc1bed954..c5ca0389ec 100644 --- a/deploy-manage/deploy/cloud-enterprise/deploy-an-orchestrator.md +++ b/deploy-manage/deploy/cloud-enterprise/deploy-an-orchestrator.md @@ -34,7 +34,7 @@ This section provides step-by-step guidance on: ## Additional topics -After deploying ECE platform, you may need to configure your own proxy certificates, security, snapshot repositories, or perform maintenance tasks. Refer to the following sections for more details: +After deploying the ECE platform, you may need to configure custom proxy certificates, manage snapshot repositories, or perform maintenance operations, among other tasks. Refer to the following sections for more details: * [Secure your ECE installation](../../security/secure-your-elastic-cloud-enterprise-installation.md) * [Users and roles](../../users-roles/cloud-enterprise-orchestrator.md) From 0954830a31da27f4c78e41ee54ade2ebc9ea1fe7 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Edu=20Gonz=C3=A1lez=20de=20la=20Herr=C3=A1n?= <25320357+eedugon@users.noreply.github.com> Date: Tue, 25 Feb 2025 07:57:28 +0100 Subject: [PATCH 18/19] Update deploy-manage/deploy/cloud-enterprise.md Co-authored-by: shainaraskas <58563081+shainaraskas@users.noreply.github.com> --- deploy-manage/deploy/cloud-enterprise.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/deploy-manage/deploy/cloud-enterprise.md b/deploy-manage/deploy/cloud-enterprise.md index 775a52e3ae..56e1eeb9fc 100644 --- a/deploy-manage/deploy/cloud-enterprise.md +++ b/deploy-manage/deploy/cloud-enterprise.md @@ -32,7 +32,7 @@ Refer to [](./cloud-enterprise/ece-architecture.md) for details about the ECE pl - **Air-gapped installations**: Support for off-line installations. - **Microservices architecture**: All services are containerized through Docker. -Check the [glossary](https://www.elastic.co/guide/en/elastic-stack-glossary/current/terms.html) to get familiar with the terminology for ECE as well as other Elastic products and solutions. +Check the [glossary](asciidocalypse:///docs-content/docs/reference/glossary.md) to get familiar with the terminology for ECE as well as other Elastic products and solutions. ## Section overview From 8a3cedad2714fcdd7a5709669a1c65ad15524ab2 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Edu=20Gonz=C3=A1lez=20de=20la=20Herr=C3=A1n?= <25320357+eedugon@users.noreply.github.com> Date: Tue, 25 Feb 2025 07:57:38 +0100 Subject: [PATCH 19/19] Update deploy-manage/deploy/cloud-enterprise/deploy-an-orchestrator.md Co-authored-by: shainaraskas <58563081+shainaraskas@users.noreply.github.com> --- deploy-manage/deploy/cloud-enterprise/deploy-an-orchestrator.md | 1 + 1 file changed, 1 insertion(+) diff --git a/deploy-manage/deploy/cloud-enterprise/deploy-an-orchestrator.md b/deploy-manage/deploy/cloud-enterprise/deploy-an-orchestrator.md index c5ca0389ec..a23a4873d6 100644 --- a/deploy-manage/deploy/cloud-enterprise/deploy-an-orchestrator.md +++ b/deploy-manage/deploy/cloud-enterprise/deploy-an-orchestrator.md @@ -37,6 +37,7 @@ This section provides step-by-step guidance on: After deploying the ECE platform, you may need to configure custom proxy certificates, manage snapshot repositories, or perform maintenance operations, among other tasks. Refer to the following sections for more details: * [Secure your ECE installation](../../security/secure-your-elastic-cloud-enterprise-installation.md) +*[](/deploy-manage/security/secure-your-cluster-deployment.md) * [Users and roles](../../users-roles/cloud-enterprise-orchestrator.md) * [Manage snapshot repositories](../../tools/snapshot-and-restore.md) * [Manage licenses](../../license/manage-your-license-in-ece.md)