Skip to content

Commit 1cfc836

Browse files
committed
changes from pr review
1 parent a68cf7d commit 1cfc836

File tree

7 files changed

+61
-107
lines changed

7 files changed

+61
-107
lines changed

deploy-manage/deploy/cloud-enterprise.md

Lines changed: 21 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
---
2-
applies:
3-
ece: all
2+
applies_to:
3+
deployment:
4+
ece: all
45
---
56

67
# Elastic Cloud Enterprise [Elastic-Cloud-Enterprise-overview]
@@ -20,45 +21,29 @@ With {{ece}}, you can:
2021
* Maximize the hardware utilization for the various clusters.
2122
* Centralize the management of multiple Elastic deployments across teams or geographies.
2223

23-
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.
24+
Refer to [](./cloud-enterprise/ece-architecture.md) for details about the ECE platform architecture and the technologies used.
2425

2526
## ECE features
2627

27-
- **Automated Scaling & Orchestration**: Handles cluster provisioning, scaling, and upgrades automatically.
28-
- **High Availability & Resilience**: Ensures uptime through multiple Availability Zones, data replication, and automated restore and snapshot.
29-
- **Centralized Monitoring & Logging**: Provides insights into cluster performance, resource usage, and logs.
30-
- **Single Sign-On (SSO) & Role-Based Access Control (RBAC)**: Allows organizations to manage access and security policies.
31-
- **API & UI Management**: Offers a web interface and API to create and manage clusters easily.
28+
- **Automated scaling & orchestration**: Handles cluster provisioning, scaling, and upgrades automatically.
29+
- **High availability & resilience**: Ensures uptime through multiple Availability Zones, data replication, and automated restore and snapshot.
30+
- **Centralized monitoring & logging**: Provides insights into cluster performance, resource usage, and logs.
31+
- **Single Sign-On (SSO) & role-based access aontrol (RBAC)**: Allows organizations to manage access and security policies.
32+
- **API & UI management**: Offers a web interface and API to create and manage clusters easily.
3233
- **Air-gapped installations**: Support for off-line installations.
33-
- **Microservices**: All services are containerized through Docker. Refer to [](./ece-containerization.md) for more details.
34-
35-
## ECE features
36-
37-
* All services are containerized through Docker.
38-
* High Availability through multiple Availability Zones.
39-
* Deployment state coordination using ZooKeeper.
40-
* Easy access for admins through the Cloud UI and API.
41-
* Support for off-line installations.
42-
* Automated restore and snapshot.
34+
- **Microservices architecture**: All services are containerized through Docker.
4335

4436
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.
4537

46-
% delete or keep. this wasn't part of the original content
47-
%### Use cases
48-
%
49-
%- Organizations that need full control over their Elastic Stack while benefiting from cloud-like automation.
50-
%- Enterprises managing multiple Elasticsearch clusters across different teams or environments.
51-
%- Businesses looking for a self-hosted alternative to Elastic Cloud with centralized administration.
52-
5338
## Section overview
5439

5540
This section focuses on deploying ECE and orchestrating and configuring {{es}} clusters, also referred to as `deployments`.
5641

57-
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.
42+
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}}.
5843

5944
This section covers the following tasks:
6045

61-
* [Deploy ECE](./cloud-enterprise/deploy-an-orchestrator.md)
46+
* [Deploy ECE orchestrator](./cloud-enterprise/deploy-an-orchestrator.md)
6247
- [Prepare the environment](./cloud-enterprise/prepare-environment.md)
6348
- [Install ECE](./cloud-enterprise/install.md)
6449
- [Air gapped installations](./cloud-enterprise/air-gapped-install.md)
@@ -73,12 +58,15 @@ This section covers the following tasks:
7358

7459
Other sections of the documentation also include important tasks related to ECE:
7560

76-
* [Secure your ECE installation](../security/secure-your-elastic-cloud-enterprise-installation.md)
77-
* [Users and roles](../users-roles/cloud-enterprise-orchestrator.md)
78-
* [Secure your deployments](../security/secure-your-cluster-deployment.md)
79-
* [Manage snapshot repositories](../tools/snapshot-and-restore.md)
80-
* [Manage licenses](../license/manage-your-license-in-ece.md)
81-
* [ECE platform maintenance operations](../maintenance/ece.md)
61+
* Platform security and management:
62+
* [Secure your ECE installation](../security/secure-your-elastic-cloud-enterprise-installation.md)
63+
* [Users and roles](../users-roles/cloud-enterprise-orchestrator.md)
64+
* [ECE platform maintenance operations](../maintenance/ece.md)
65+
* [Manage licenses](../license/manage-your-license-in-ece.md)
66+
67+
* Deployments security and management:
68+
* [Secure your deployments](../security/secure-your-cluster-deployment.md)
69+
* [Manage snapshot repositories](../tools/snapshot-and-restore.md)
8270

8371
## How ECE differs from Elastic Cloud and other orchestrators
8472

deploy-manage/deploy/cloud-enterprise/configure.md

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,16 @@
11
---
2-
applies:
3-
ece: all
2+
applies_to:
3+
deployment:
4+
ece: all
45
mapped_pages:
56
- https://www.elastic.co/guide/en/cloud-enterprise/current/ece-configuring-ece.html
67
- https://www.elastic.co/guide/en/cloud-enterprise/current/ece-administering-ece.html
78
---
89

910
# Configure ECE [ece-configuring-ece]
1011

12+
⚠️ **This page is a work in progress.** ⚠️
13+
1114
Now that you have Elastic Cloud Enterprise up and running, take a look at some of the additional features that you can configure:
1215

1316
* [System deployment configuration](system-deployments-configuration.md) - Best practices for ECE system deployments to ensure a highly available and resilient setup.

deploy-manage/deploy/cloud-enterprise/deploy-an-orchestrator.md

Lines changed: 14 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
---
2-
applies:
3-
ece: all
2+
applies_to:
3+
deployment:
4+
ece: all
45
---
56
# Deploy an orchestrator
67

@@ -32,10 +33,20 @@ This section provides step-by-step guidance on:
3233

3334
## Additional topics
3435

35-
Once ECE is deployed, you may need to configure security, manage snapshots, or perform maintenance tasks. Refer to the following sections for more details:
36+
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:
3637

3738
* [Secure your ECE installation](../../security/secure-your-elastic-cloud-enterprise-installation.md)
3839
* [Users and roles](../../users-roles/cloud-enterprise-orchestrator.md)
3940
* [Manage snapshot repositories](../../tools/snapshot-and-restore.md)
4041
* [Manage licenses](../../license/manage-your-license-in-ece.md)
4142
* [ECE platform maintenance operations](../../maintenance/ece.md)
43+
44+
To start orchestrating your {{es}} clusters, refer to [](./working-with-deployments.md).
45+
46+
## Advanced tasks
47+
48+
The following tasks are only needed on certain circumstances:
49+
50+
* Migrate ECE to Podman hosts
51+
* Migrate ECE on Podman hosts to SELinux enforce
52+
* Change allocator disconnect timeout

deploy-manage/deploy/cloud-enterprise/ece-architecture.md

Lines changed: 20 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,10 @@
11
---
2-
applies:
3-
ece: all
2+
applies_to:
3+
deployment:
4+
ece: all
45
mapped_pages:
56
- https://www.elastic.co/guide/en/cloud-enterprise/current/ece-architecture.html
7+
- https://www.elastic.co/guide/en/cloud-enterprise/current/ece-containerization.html
68
---
79

810
# Service-oriented architecture [ece-architecture]
@@ -17,7 +19,6 @@ Elastic Cloud Enterprise has a service-oriented architecture that lets you:
1719
:alt: Elastic Cloud Enterprise high level architecture
1820
:::
1921

20-
2122
## Control plane [ece_control_plane]
2223

2324
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
6768

6869
* Advertise the memory capacity of the underlying host machine to ZooKeeper so that the Constructor can make an informed decision on where to deploy.
6970

71+
## Services as Docker containers [ece-containerization]
72+
73+
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:
74+
75+
* **Shares of resources**
76+
77+
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.
78+
79+
* **Better security**
80+
81+
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.
82+
83+
* **Secure communication through Stunnel**
84+
85+
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.
86+

deploy-manage/deploy/cloud-enterprise/ece-containerization.md

Lines changed: 0 additions & 20 deletions
This file was deleted.

deploy-manage/deploy/cloud-enterprise/ece-overview.md

Lines changed: 0 additions & 42 deletions
This file was deleted.

deploy-manage/toc.yml

Lines changed: 1 addition & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -120,10 +120,7 @@ toc:
120120
- file: deploy/elastic-cloud/restrictions-known-problems.md
121121
- file: deploy/cloud-enterprise.md
122122
children:
123-
- file: deploy/cloud-enterprise/ece-overview.md
124-
children:
125-
- file: deploy/cloud-enterprise/ece-architecture.md
126-
- file: deploy/cloud-enterprise/ece-containerization.md
123+
- file: deploy/cloud-enterprise/ece-architecture.md
127124
- file: deploy/cloud-enterprise/deploy-an-orchestrator.md
128125
children:
129126
- file: deploy/cloud-enterprise/prepare-environment.md

0 commit comments

Comments
 (0)