Added parameter master_api_password (#140)

* Added parameter master_api_password

module: proxmox_cluster
When joining a cluster, this parameter allows to
spcify an API password for authentication against
the master node, that is different from the one
used to authenticate against the joining node.

If not specified, the old behavior is used.

* Add changelog

* Add example for parameter master_api_password

* Update proxmox_cluster.py

* Update proxmox_cluster.py

---------

Co-authored-by: Daniel Marohn <[email protected]>
Co-authored-by: Jeffrey van Pelt <[email protected]>

Author: 3 people

changelogs/fragments/140-add-master-api-password.yml

@@ -0,0 +1,3 @@
+---
+minor_changes:
+  - proxmox_cluster -  Add master_api_password for authentication against master node (https://github.com/ansible-collections/community.proxmox/pull/140).

plugins/modules/proxmox_cluster.py

@@ -36,6 +36,12 @@
       - The IP address of the cluster master when joining the cluster.
     type: str
     required: false
+  master_api_password:
+    description:
+      - Specify the password to authenticate with the master node.
+      - Uses the api_password parameter if not specified.
+    type: str
+    required: false
   fingerprint:
     description:
       - The fingerprint of the cluster master when joining the cluster.
@@ -78,6 +84,16 @@
     master_ip: "{{ primary_node }}"
     fingerprint: "{{ cluster_fingerprint }}"
     cluster_name: "devcluster"
+
+- name: Join a Proxmox VE Cluster with different API password
+  community.proxmox.proxmox_cluster:
+    api_host: proxmoxhost
+    api_user: root@pam
+    api_password: "{{ joining_node_api_password }}"
+    master_api_password: "{{ master_node_api_password }}"
+    master_ip: "{{ primary_node }}"
+    fingerprint: "{{ cluster_fingerprint }}"
+    cluster_name: "devcluster"
 """
 
 RETURN = r"""
@@ -127,7 +143,7 @@ def cluster_create(self):
     def cluster_join(self):
         master_ip = self.module.params.get("master_ip")
         fingerprint = self.module.params.get("fingerprint")
-        api_password = self.module.params.get("api_password")
+        api_password = self.module.params.get("master_api_password") or self.module.params.get("api_password")
         cluster_name = self.module.params.get("cluster_name")
         is_in_cluster = True
 
@@ -180,6 +196,7 @@ def main():
         link0=dict(type='str'),
         link1=dict(type='str'),
         master_ip=dict(type='str'),
+        master_api_password=dict(type='str', no_log=True),
         fingerprint=dict(type='str'),
     )
     module_args.update(cluster_args)