cloudera.cluster.cm_service_role module – Manage a Cloudera Manager Service role
Note
This module is part of the cloudera.cluster collection (version 5.0.0).
It is not included in ansible-core
.
To check whether it is installed, run ansible-galaxy collection list
.
To install it, use: ansible-galaxy collection install cloudera.cluster
.
You need further requirements to be able to use this module,
see Requirements for details.
To use it in a playbook, specify: cloudera.cluster.cm_service_role
.
New in cloudera.cluster 5.0.0
Synopsis
Manage a Cloudera Manager Service role.
Requirements
The below requirements are needed on the host that executes this module.
cm-client
Parameters
Parameter |
Comments |
---|---|
Set the HTTP user agent header when interacting with the CM API endpoint. Default: |
|
The host ID of an instance for the role. If the host ID is different that the existing host for the Mutually exclusive with |
|
The hostname of an instance for the role. If the hostname is different that the existing host for the Mutually exclusive with |
|
The role configuration to set, i.e. role overrides, for the instance. To unset a parameter, use |
|
Capture the HTTP interaction logs with the CM API endpoint. Choices:
|
|
Flag to force TLS during CM API endpoint discovery. If Choices:
|
|
Hostname of the CM API endpoint. If set, the Mutually exclusive with url. |
|
Flag for whether the role should be in maintenance mode. Choices:
|
|
Message to log for any changes to the entity. Default: |
|
Password for access to the CM API endpoint. This parameter is set to |
|
Port of the CM API endpoint. If set, CM API endpoint discovery will connect to the designated port first and will follow redirects. Default: |
|
Set the HTTP/S proxy server when interacting with the CM API endpoint. |
|
Flag for whether the declared role configurations should append or overwrite any existing configurations. To clear all role configurations, set Choices:
|
|
Path to SSL CA certificate to use for validation. |
|
The state of the role. Note, if the declared state is invalid for the role, the module will return an error. Note, Choices:
|
|
A role type for the role. |
|
The CM API endpoint URL and should include scheme, host, port, and API root path. Mutually exclusive with host. |
|
Username for access to the CM API endpoint. |
|
Verify the TLS certificates for the CM API endpoint. Choices:
|
|
API version of the CM API endpoint. Default: |
Attributes
Attribute |
Support |
Description |
---|---|---|
Support: full |
Can run in check_mode and return changed status prediction without modifying target, if not supported the action will be skipped. |
|
Support: full |
Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode |
|
Platforms: all |
Target OS/families that can be operated against |
See Also
See also
- cloudera.cluster.cm_service
Manage Cloudera Manager service.
- cloudera.cluster.cm_service_role_config_group
Manage a Cloudera Manager Service role config group.
Examples
- name: Establish a Cloudera Manager Service role
cloudera.cluster.cm_service_role:
host: example.cloudera.com
username: "jane_smith"
password: "S&peR4Ec*re"
type: HOSTMONITOR
cluster_hostname: worker-01.cloudera.internal
- name: Set a Cloudera Manager Service role to maintenance mode
cloudera.cluster.cm_service_role:
host: example.cloudera.com
username: "jane_smith"
password: "S&peR4Ec*re"
type: HOSTMONITOR
maintenance: true
- name: Update (append) role configurations to a Cloudera Manager Service role
cloudera.cluster.cm_service_role:
host: example.cloudera.com
username: "jane_smith"
password: "S&peR4Ec*re"
type: HOSTMONITOR
config:
some_config: value_one
another_config: value_two
- name: Set (purge) role configurations to a Cloudera Manager Service role
cloudera.cluster.cm_service_role:
host: example.cloudera.com
username: "jane_smith"
type: HOSTMONITOR
config:
yet_another_config: value_three
purge: true
- name: Remove all role configurations on a Cloudera Manager Service role
cloudera.cluster.cm_service_role:
host: example.cloudera.com
username: "jane_smith"
password: "S&peR4Ec*re"
type: HOSTMONITOR
purge: true
- name: Start a Cloudera Manager Service role
cloudera.cluster.cm_service_role:
host: example.cloudera.com
username: "jane_smith"
password: "S&peR4Ec*re"
type: HOSTMONITOR
state: started
- name: Force a restart to a Cloudera Manager Service role
cloudera.cluster.cm_service_role:
host: example.cloudera.com
username: "jane_smith"
password: "S&peR4Ec*re"
type: HOSTMONITOR
state: restarted
- name: Remove a Cloudera Manager Service role
cloudera.cluster.cm_service_role:
host: example.cloudera.com
username: "jane_smith"
password: "S&peR4Ec*re"
type: HOSTMONITOR
state: absent
Return Values
Common return values are documented here, the following are the fields unique to this module:
Key |
Description |
---|---|
Details about the Cloudera Manager service role. Returned: always |
|
Commission state of the Cloudera Manager service role. Returned: always Sample: |
|
Role override configuration for the Cloudera Manager service. Returned: optional |
|
Status of configuration staleness for the Cloudera Manager service role. Returned: always Sample: |
|
High-availability status for the Cloudera Manager service. Returned: optional Sample: |
|
List of all available health checks for Cloudera Manager service role. Returned: optional |
|
The explanation of this health check. Returned: optional |
|
Unique name of this health check. Returned: always |
|
The high-level health status of the health check. Returned: always Sample: |
|
Whether this health check is suppressed. A suppressed health check is not considered when computing the role’s overall health. Returned: optional |
|
The high-level health status of the Cloudera Manager service role. Returned: always Sample: |
|
The unique ID of the cluster host. Returned: always |
|
Whether the Cloudera Manager service role is in maintenance mode. Returned: always |
|
List of objects that trigger the Cloudera Manager service role to be in maintenance mode. Returned: optional Sample: |
|
The Cloudera Manager service role name. Note, this is an auto-generated name and cannot be changed. Returned: always |
|
The name of the Cloudera Manager Service role config group, which uniquely identifies it in a Cloudera Manager installation. Returned: always |
|
State of the Cloudera Manager service role. Returned: always Sample: |
|
The name of the Cloudera Manager service, which uniquely identifies it in a deployment. Returned: always |
|
Set of tags for the Cloudera Manager service role. Returned: optional |
|
The Cloudera Manager service role type. Returned: always Sample: |
|
The Zookeeper server mode for this Cloudera Manager service role. Note that for non-Zookeeper Server roles, this will be Returned: optional |