OpenSearch/docs/reference/commands
Jason Tedor 52ad5842a9
Introduce node.roles setting (#58512)
Today we have individual settings for configuring node roles such as
node.data and node.master. Additionally, roles are pluggable and we have
used this to introduce roles such as node.ml and node.voting_only. As
the number of roles is growing, managing these becomes harder for the
user. For example, to create a master-only node, today a user has to
configure:
 - node.data: false
 - node.ingest: false
 - node.remote_cluster_client: false
 - node.ml: false

at a minimum if they are relying on defaults, but also add:
 - node.master: true
 - node.transform: false
 - node.voting_only: false

If they want to be explicit. This is also challenging in cases where a
user wants to have configure a coordinating-only node which requires
disabling all roles, a list which we are adding to, requiring the user
to keep checking whether a node has acquired any of these roles.

This commit addresses this by adding a list setting node.roles for which
a user has explicit control over the list of roles that a node has. If
the setting is configured, the node has exactly the roles in the list,
and not any additional roles. This means to configure a master-only
node, the setting is merely 'node.roles: [master]', and to configure a
coordinating-only node, the setting is merely: 'node.roles: []'.

With this change we deprecate the existing 'node.*' settings such as
'node.data'.
2020-06-25 14:14:51 -04:00
..
certgen.asciidoc [DOCS] Escape depcreated[] note for Asciidoctor migration (#41608) 2019-04-30 15:19:43 -04:00
certutil.asciidoc [DOCS] Adds http to elasticsearch-certutil command reference (#51188) 2020-01-24 09:59:07 -08:00
croneval.asciidoc [DOCS] Extract the cron docs from Watcher docs and add to the API conventions. (#56313) (#56651) 2020-05-12 16:36:18 -07:00
index.asciidoc [DOCS] Adds elasticsearch-keystore command reference (#50872) 2020-01-13 13:08:21 -08:00
keystore.asciidoc Clarify the remove keystore command can handle many (#54244) 2020-03-26 08:49:43 -04:00
migrate-tool.asciidoc Deprecate the native realm migration tool (#42142) 2019-05-16 09:52:31 -04:00
node-tool.asciidoc Introduce node.roles setting (#58512) 2020-06-25 14:14:51 -04:00
saml-metadata.asciidoc Password-protected Keystore Feature Branch PR (#51123) (#51510) 2020-01-28 05:32:32 -05:00
setup-passwords.asciidoc Password-protected Keystore Feature Branch PR (#51123) (#51510) 2020-01-28 05:32:32 -05:00
shard-tool.asciidoc Allow truncation of clean translog (#47866) 2019-10-11 15:48:12 +01:00
syskeygen.asciidoc [DOCS] Moves Watcher content into Elasticsearch book (#47147) (#47255) 2019-09-30 10:18:50 -07:00
users-command.asciidoc [DOCS] Cleans up links to security content (#47610) (#47703) 2019-10-07 15:23:19 -07:00