From 75c5b0698efecde621146188b5cd05c9dfe8fa14 Mon Sep 17 00:00:00 2001 From: Roberto Seldner Date: Mon, 5 May 2025 18:29:20 -0700 Subject: [PATCH 1/4] Update ece-architecture.md Proposing we document the actual service container names in a container-to-role mapping table --- .../cloud-enterprise/ece-architecture.md | 23 +++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/deploy-manage/deploy/cloud-enterprise/ece-architecture.md b/deploy-manage/deploy/cloud-enterprise/ece-architecture.md index 82c9d7915..2dcc52c5a 100644 --- a/deploy-manage/deploy/cloud-enterprise/ece-architecture.md +++ b/deploy-manage/deploy/cloud-enterprise/ece-architecture.md @@ -84,3 +84,26 @@ Services are deployed as Docker containers, which simplifies the operational eff 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. +## ECE service containers per host role(s) [ece-service-containers] + +Each Elastic Cloud Enterprise service runs as a dedicated Docker container. These containers are automatically deployed based on the roles assigned to each ECE host. + +| Container | Roles | Description | +|---|---|---| +| `frc-admin-consoles-admin-console` | Controller | Backend service for the ECE UI; handles API requests and coordinates with ZooKeeper, Elasticsearch, logging, and security services. | +| `frc-allocator-metricbeats-allocator-metricbeat` | Allocator | Collects allocator metrics via Beats. | +| `frc-allocators-allocator` | Allocator | Manages container lifecycle for Elasticsearch and Kibana; reports host capacity to ZooKeeper. | +| `frc-beats-runners-beats-runner` | All roles | Collects metrics from local containers for monitoring and health checks. | +| `frc-blueprints-blueprint` | Director | Coordinates container startup by providing configuration data to runners based on their role and token. | +| `frc-client-forwarders-client-forwarder` | All roles | Manages communication between nodes and ZooKeeper. | +| `frc-cloud-uis-cloud-ui` | Controller | Web frontend for the ECE UI, served to users in the browser. | +| `frc-constructors-constructor` | Controller | Schedules changes via ZooKeeper; assigns clusters to allocators and balances zones. | +| `frc-container-task-services-container-task-service`| Allocator | Supports autoscaling and tracks feature usage. | +| `frc-directors-director` | Director | Manages ZooKeeper and internal certificates; maintains Stunnel and quorum. | +| `frc-proxies-proxyv2` | Proxy | Routes user traffic; uses ZooKeeper to map deployment IDs to cluster nodes. | +| `frc-proxies-route-server` | Proxy | Manages internal routing and port mapping for cluster access. | +| `frc-runners-runner` | All roles | Deploys containers locally per host role definitions. | +| `frc-services-forwarders-services-forwarder` | All roles | Routes internal service data across the ECE platform. | +| `frc-zookeeper-servers-zookeeper` | Director | Consistent distributed store used to track ECE state and coordinate communication between services. | + + From 8a80b1af3981c399bdc5740c3282d0850e4984b4 Mon Sep 17 00:00:00 2001 From: Roberto Seldner Date: Tue, 20 May 2025 19:27:01 -0700 Subject: [PATCH 2/4] Update deploy-manage/deploy/cloud-enterprise/ece-architecture.md thanks! Co-authored-by: Jakob Reiter --- deploy-manage/deploy/cloud-enterprise/ece-architecture.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/deploy-manage/deploy/cloud-enterprise/ece-architecture.md b/deploy-manage/deploy/cloud-enterprise/ece-architecture.md index 2dcc52c5a..3af317772 100644 --- a/deploy-manage/deploy/cloud-enterprise/ece-architecture.md +++ b/deploy-manage/deploy/cloud-enterprise/ece-architecture.md @@ -95,7 +95,7 @@ Each Elastic Cloud Enterprise service runs as a dedicated Docker container. Thes | `frc-allocators-allocator` | Allocator | Manages container lifecycle for Elasticsearch and Kibana; reports host capacity to ZooKeeper. | | `frc-beats-runners-beats-runner` | All roles | Collects metrics from local containers for monitoring and health checks. | | `frc-blueprints-blueprint` | Director | Coordinates container startup by providing configuration data to runners based on their role and token. | -| `frc-client-forwarders-client-forwarder` | All roles | Manages communication between nodes and ZooKeeper. | +| `frc-client-forwarders-client-forwarder` | All roles | Manages communication between hosts and ZooKeeper. | | `frc-cloud-uis-cloud-ui` | Controller | Web frontend for the ECE UI, served to users in the browser. | | `frc-constructors-constructor` | Controller | Schedules changes via ZooKeeper; assigns clusters to allocators and balances zones. | | `frc-container-task-services-container-task-service`| Allocator | Supports autoscaling and tracks feature usage. | From 59b3724edcde7710d4521996e70ba48848bb034e Mon Sep 17 00:00:00 2001 From: Roberto Seldner Date: Tue, 20 May 2025 19:27:30 -0700 Subject: [PATCH 3/4] Update deploy-manage/deploy/cloud-enterprise/ece-architecture.md Thanks! Co-authored-by: Jakob Reiter --- deploy-manage/deploy/cloud-enterprise/ece-architecture.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/deploy-manage/deploy/cloud-enterprise/ece-architecture.md b/deploy-manage/deploy/cloud-enterprise/ece-architecture.md index 3af317772..6678ef837 100644 --- a/deploy-manage/deploy/cloud-enterprise/ece-architecture.md +++ b/deploy-manage/deploy/cloud-enterprise/ece-architecture.md @@ -102,7 +102,7 @@ Each Elastic Cloud Enterprise service runs as a dedicated Docker container. Thes | `frc-directors-director` | Director | Manages ZooKeeper and internal certificates; maintains Stunnel and quorum. | | `frc-proxies-proxyv2` | Proxy | Routes user traffic; uses ZooKeeper to map deployment IDs to cluster nodes. | | `frc-proxies-route-server` | Proxy | Manages internal routing and port mapping for cluster access. | -| `frc-runners-runner` | All roles | Deploys containers locally per host role definitions. | +| `frc-runners-runner` | All roles | Runs on every ECE host and provides a supervisor service to deploy and manage containers according to their defined roles, ensuring they are online and healthy. | | `frc-services-forwarders-services-forwarder` | All roles | Routes internal service data across the ECE platform. | | `frc-zookeeper-servers-zookeeper` | Director | Consistent distributed store used to track ECE state and coordinate communication between services. | From 5433df3f43c6da2be9fa4c36af987e346a6e334d Mon Sep 17 00:00:00 2001 From: Roberto Seldner Date: Tue, 20 May 2025 19:28:15 -0700 Subject: [PATCH 4/4] Update deploy-manage/deploy/cloud-enterprise/ece-architecture.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit thanks! Co-authored-by: Edu González de la Herrán <25320357+eedugon@users.noreply.github.com> --- deploy-manage/deploy/cloud-enterprise/ece-architecture.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/deploy-manage/deploy/cloud-enterprise/ece-architecture.md b/deploy-manage/deploy/cloud-enterprise/ece-architecture.md index 6678ef837..46a090bec 100644 --- a/deploy-manage/deploy/cloud-enterprise/ece-architecture.md +++ b/deploy-manage/deploy/cloud-enterprise/ece-architecture.md @@ -97,7 +97,7 @@ Each Elastic Cloud Enterprise service runs as a dedicated Docker container. Thes | `frc-blueprints-blueprint` | Director | Coordinates container startup by providing configuration data to runners based on their role and token. | | `frc-client-forwarders-client-forwarder` | All roles | Manages communication between hosts and ZooKeeper. | | `frc-cloud-uis-cloud-ui` | Controller | Web frontend for the ECE UI, served to users in the browser. | -| `frc-constructors-constructor` | Controller | Schedules changes via ZooKeeper; assigns clusters to allocators and balances zones. | +| `frc-constructors-constructor` | Controller | Schedules and coordinates deployment changes through ZooKeeper; assigns instances to allocators and balances zones. | | `frc-container-task-services-container-task-service`| Allocator | Supports autoscaling and tracks feature usage. | | `frc-directors-director` | Director | Manages ZooKeeper and internal certificates; maintains Stunnel and quorum. | | `frc-proxies-proxyv2` | Proxy | Routes user traffic; uses ZooKeeper to map deployment IDs to cluster nodes. |