Skip to content

[Feature]: Move single-role variables out of the elasticstack meta role #485

Open

Description

@afeefghannam89

Describe the feature request

Following the naming-convention discussion in #159, role variables should be prefixed with
the role name and live in that role's defaults. Several elasticstack_* variables sit in
the elasticstack meta role but are read by only one role. Decide per variable: if it also
has no stack-wide meaning, move it to the consuming role (and drop the elasticstack_
prefix); if it is single-consumer but conceptually stack-wide, keep it central.

1. Move to the consuming role (single-role, no stack-wide meaning)

2. Single-consumer but stack-wide — keep central (elasticstack_)

Only the elasticsearch role reads these, but they describe stack-wide concepts, so splitting
them out would be inconsistent and confusing:

  • CA settings (elasticsearch manages the CA, but it secures the whole stack): elasticstack_ca_name, elasticstack_ca_validity_period, elasticstack_ca_expiration_buffer, elasticstack_ca_will_expire_soon
  • elasticstack_kibana_group_name (part of the stack topology, like the other group names)

3. Shared (read by ≥2 roles) — keep central

variant, release, full_stack, ca_dir / ca_host / ca_pass, elasticsearch_group_name,
logstash_group_name, elasticsearch_http_port, no_log, initial_passwords, beats_port,
override_beats_tls, security, cert_pass (elasticsearch + kibana), version (all roles).

The single-role vs. shared classification was verified against the code during the elasticstack
documentation work (#475).

Renaming variables users may already set is a breaking change.

Activity

  1. added this to the 2.0.0 milestone on Jul 2, 2026
  2. added a commit that references this issue on Jul 13, 2026
  3. afeefghannam89 commented on Aug 20, 2026

    @afeefghannam89
    MemberAuthor

    When the variables in section 1 are moved, please pick the new names according to the naming
    schema in #542 instead of only dropping the elasticstack_ prefix. That affects the word order
    in particular:

    current after the move
    elasticstack_enable_repos repos_enable (rule 6: <prefix>_<subject>_<attribute>, and rule 5: _enable)
    elasticstack_repo_url repos_url
    elasticstack_repo_key repos_key
    elasticstack_rpm_workaround repos_rpm_workaround
    elasticstack_kibana_port kibana_port
    elasticstack_kibana_host kibana_host
    elasticstack_temperature elasticsearch_temperature

    These renames stay in this issue and are explicitly out of scope in #544, so no variable gets
    renamed twice. Part of #545.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    breaking-changeChanges behaviour or variables so users must adaptcomponent:elasticstackroles/elasticstack - meta role, shared variablesfeatureNew capability or new variable for users

    Type

    No type

    Projects

    No projects

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions