community.cassandra.cassandra_schema (1.3.3) — module

Install collection

Install with ansible-galaxy collection install community.cassandra:==1.3.3

Add to requirements.yml

  collections:
    - name: community.cassandra
      version: 1.3.3

Description

Validates the schema version as seen from the node.

Ensure that all nodes are have the same schema version.

Can poll multiple times to wait for the schema version to converge.

Can also specify a schema version if required.

Schema version is obtained through the usage of the nodetool describecluster command.

Requirements

• nodetool

Usage examples

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Ensure all Cassandra nodes are in schema agreement.
  community.cassandra.cassandra_schema:

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Ensure all Cassandra nodes have the expected schema version
  community.cassandra.cassandra_schema:
    is: 1176b7ac-8993-395d-85fd-41b89ef49fbb

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Poll schema version a max of 5 times with a 30 second interval
  community.cassandra.cassandra_schema:
    poll: 5
    interval: 30

Inputs

    
host:
    aliases:
    - login_host
    default: 127.0.0.1
    description:
    - The hostname.
    type: str

poll:
    default: 1
    description:
    - The maximum number of times to call nodetool describecluster.
    type: int

port:
    aliases:
    - login_port
    default: 7199
    description:
    - The Cassandra TCP port.
    type: int

uuid:
    aliases:
    - is
    description:
    - The expected schema version.
    type: str

debug:
    default: false
    description:
    - Enable additional debug output.
    type: bool

interval:
    default: 30
    description:
    - The number of seconds to wait between poll executions.
    type: int

password:
    aliases:
    - login_password
    description:
    - The password to authenticate with.
    type: str

username:
    aliases:
    - login_user
    description:
    - The username to authenticate with.
    type: str

nodetool_path:
    description:
    - The path to nodetool.
    type: str

password_file:
    aliases:
    - login_password_file
    description:
    - Path to a file containing the password.
    type: str

nodetool_flags:
    default: -Dcom.sun.jndi.rmiURLParsing=legacy
    description:
    - Flags to pass to nodetool.
    type: str

Outputs

msg:
  description: A message indicating what has happened.
  returned: on success
  type: bool
rc:
  description: Return code of the last executed command.
  returned: always
  type: int