Assigning roles might be required after you install Elastic Cloud Enterprise on hosts to make sure the new hosts (runners) can be used for their intended purpose and to remove roles from the initial host to implement a recommended ECE installation. Similarly, if you need more processing capacity for Elasticsearch nodes in your deployment, change the role of a new runner to
allocator to add its capacity to your installation.
These steps describe how to assign roles from the Cloud UI. For automation purposes, assigning roles with a token you generate is preferred.
Each Elastic Cloud Enterprise runner can take on several roles:
- Allocates the available computing resources to Elasticsearch nodes or Kibana instances. In larger installations, a majority of the machines will be allocators.
- Serves as a distributed coordination system and resource scheduler.
- Manages communication between a user and an Elasticsearch or Kibana instance.
- Manages the ZooKeeper datastore. This role is typically shared with the coordinator role. In production deployments it can be separated from a coordinator.
director role is assigned to a runner, the Zookeeper service starts on that host. The Zookeeper service continues even after the director role is removed from the runner. Therefore, if you remove the
director role from any host that has ever had it, we highly recommend also deleting the runner and re-installing it.
Each role is associated with a set of Docker containers that provide the specific functionality.
To assign roles to runners:
- Log into the Cloud UI.
From the Platform menu, select Runners.
The roles for each runner are shown.
Narrow the list by name, ID, or choose from several other filters. To further define the list, use a combination of filters.
- To update the roles, click the runner IP address and then select Update roles from the menu.
- Select the role assignments for that runner and click Update roles.
Elastic Cloud Enterprise automatically starts managing the node in its new role and makes it available for use.
To learn more about how you should assign roles, see deployment recommendations.