Add CM agent provisioning role

Signed-off-by: Webster Mudge <[email protected]>

Author: wmudge

roles/cm_agent/README.md

@@ -0,0 +1,55 @@
+# cm_agent
+
+Install Cloudera Manager agent packages.
+
+This role installs the Cloudera Manager agent packages on a target host and configures it to connect to a specified Cloudera Manager server. The management of the agent's version is handled implicitly through the configured package repository profile, ensuring compatibility with the Cloudera Manager server.
+
+The role will:
+- Install the necessary Cloudera Manager agent packages.
+- Configure the agent to point to the `cloudera_manager_host`.
+- Enable and start the Cloudera Manager agent service.
+
+# Requirements
+
+- A valid Java JDK is required on the target host.
+- A valid Cloudera Manager package repository must be configured and accessible on the target host.
+
+# Dependencies
+
+None.
+
+# Parameters
+
+| Variable | Type | Required | Default | Description |
+| --- | --- | --- | --- | --- |
+| `cloudera_manager_host` | `str` | `True` | | Hostname of the Cloudera Manager server (e.g., `cm.example.com`). |
+
+# Example Playbook
+
+```yaml
+- hosts: cm_agents
+  tasks:
+    - name: Install Cloudera Manager agent on hosts
+      ansible.builtin.import_role:
+        name: cm_agent
+      vars:
+        cloudera_manager_host: cm.mycluster.internal
+```
+
+# License
+
+```
+Copyright 2025 Cloudera, Inc.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    https://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+```

roles/cm_agent/defaults/main.yml

@@ -0,0 +1,15 @@
+# Copyright 2025 Cloudera, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# cloudera_manager_host:

roles/cm_agent/handlers/main.yml

@@ -0,0 +1,18 @@
+# Copyright 2025 Cloudera, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+- name: Restart CM agent
+  ansible.builtin.service:
+    name: cloudera-scm-agent
+    state: restarted

roles/cm_agent/meta/argument_specs.yml

@@ -0,0 +1,28 @@
+# Copyright 2025 Cloudera, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+argument_specs:
+  main:
+    short_description: Install Cloudera Manager agent packages.
+    description:
+      - Install the Cloudera Manager agent packages and configure the C(server_host).
+      - Version management is via the package repository profile.
+      - Requires a valid JDK.
+      - Requires a valid Cloudera Manager package repository.
+    author: Cloudera Labs
+    version_added: 5.0.0
+    options:
+      cloudera_manager_host:
+        description: Cloudera Manager hostname
+        required: true

roles/cm_agent/molecule/default/converge.yml

@@ -0,0 +1,22 @@
+# Copyright 2024 Cloudera, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+- name: Converge
+  hosts: all
+  gather_facts: true
+  become: true
+  tasks:
+    - name: Install Cloudere Manager agent
+      ansible.builtin.import_role:
+        name: cm_agent