Add proxmox action group (#8334)

Add proxmox module defaults group.

changelogs/fragments/8334-proxmox-action-group.yml

@@ -0,0 +1,2 @@
+minor_changes:
+  - "proxmox* modules - there is now a ``community.general.proxmox`` module defaults group that can be used to set default options for all Proxmox modules (https://github.com/ansible-collections/community.general/pull/8334)."

meta/runtime.yml

@@ -12,6 +12,23 @@ action_groups:
     - consul_role
     - consul_session
     - consul_token
+  proxmox:
+    - proxmox
+    - proxmox_disk
+    - proxmox_domain_info
+    - proxmox_group_info
+    - proxmox_kvm
+    - proxmox_nic
+    - proxmox_node_info
+    - proxmox_pool
+    - proxmox_pool_member
+    - proxmox_snap
+    - proxmox_storage_contents_info
+    - proxmox_storage_info
+    - proxmox_tasks_info
+    - proxmox_template
+    - proxmox_user_info
+    - proxmox_vm_info
 plugin_routing:
   callback:
     actionable:

plugins/doc_fragments/proxmox.py

@@ -65,3 +65,13 @@ options:
       - Add the new VM to the specified pool.
     type: str
 '''
+
+    ACTIONGROUP_PROXMOX = r"""
+options: {}
+attributes:
+  action_group:
+    description: Use C(group/community.general.proxmox) in C(module_defaults) to set defaults for this module.
+    support: full
+    membership:
+      - community.general.proxmox
+"""

plugins/modules/proxmox.py

@@ -21,6 +21,8 @@ attributes:
     support: none
   diff_mode:
     support: none
+  action_group:
+    version_added: 9.0.0
 options:
   password:
     description:
@@ -216,6 +218,7 @@ author: Sergei Antipov (@UnderGreen)
 seealso:
   - module: community.general.proxmox_vm_info
 extends_documentation_fragment:
+  - community.general.proxmox.actiongroup_proxmox
   - community.general.proxmox.documentation
   - community.general.proxmox.selection
   - community.general.attributes

plugins/modules/proxmox_disk.py

@@ -21,6 +21,8 @@ attributes:
     support: none
   diff_mode:
     support: none
+  action_group:
+    version_added: 9.0.0
 options:
   name:
     description:
@@ -325,6 +327,7 @@ options:
       - The drive's worldwide name, encoded as 16 bytes hex string, prefixed by V(0x).
     type: str
 extends_documentation_fragment:
+  - community.general.proxmox.actiongroup_proxmox
   - community.general.proxmox.documentation
   - community.general.attributes
 '''

plugins/modules/proxmox_domain_info.py

@@ -16,6 +16,9 @@ short_description: Retrieve information about one or more Proxmox VE domains
 version_added: 1.3.0
 description:
   - Retrieve information about one or more Proxmox VE domains.
+attributes:
+  action_group:
+    version_added: 9.0.0
 options:
   domain:
     description:
@@ -24,6 +27,7 @@ options:
     type: str
 author: Tristan Le Guern (@tleguern)
 extends_documentation_fragment:
+  - community.general.proxmox.actiongroup_proxmox
   - community.general.proxmox.documentation
   - community.general.attributes
   - community.general.attributes.info_module

plugins/modules/proxmox_group_info.py

@@ -16,6 +16,9 @@ short_description: Retrieve information about one or more Proxmox VE groups
 version_added: 1.3.0
 description:
   - Retrieve information about one or more Proxmox VE groups
+attributes:
+  action_group:
+    version_added: 9.0.0
 options:
   group:
     description:
@@ -24,6 +27,7 @@ options:
     type: str
 author: Tristan Le Guern (@tleguern)
 extends_documentation_fragment:
+  - community.general.proxmox.actiongroup_proxmox
   - community.general.proxmox.documentation
   - community.general.attributes
   - community.general.attributes.info_module

plugins/modules/proxmox_kvm.py

@@ -21,6 +21,8 @@ attributes:
     support: none
   diff_mode:
     support: none
+  action_group:
+    version_added: 9.0.0
 options:
   archive:
     description:
@@ -579,6 +581,7 @@ options:
 seealso:
   - module: community.general.proxmox_vm_info
 extends_documentation_fragment:
+  - community.general.proxmox.actiongroup_proxmox
   - community.general.proxmox.documentation
   - community.general.proxmox.selection
   - community.general.attributes

plugins/modules/proxmox_nic.py

@@ -21,6 +21,8 @@ attributes:
     support: full
   diff_mode:
     support: none
+  action_group:
+    version_added: 9.0.0
 options:
   bridge:
     description:
@@ -94,6 +96,7 @@ options:
       - Specifies the instance ID.
     type: int
 extends_documentation_fragment:
+  - community.general.proxmox.actiongroup_proxmox
   - community.general.proxmox.documentation
   - community.general.attributes
 '''

plugins/modules/proxmox_node_info.py

@@ -17,7 +17,11 @@ version_added: 8.2.0
 description:
   - Retrieve information about one or more Proxmox VE nodes.
 author: John Berninger (@jwbernin)
+attributes:
+  action_group:
+    version_added: 9.0.0
 extends_documentation_fragment:
+  - community.general.proxmox.actiongroup_proxmox
   - community.general.proxmox.documentation
   - community.general.attributes
   - community.general.attributes.info_module

plugins/modules/proxmox_pool.py

@@ -21,6 +21,8 @@ attributes:
     support: full
   diff_mode:
     support: none
+  action_group:
+    version_added: 9.0.0
 options:
   poolid:
     description:
@@ -42,8 +44,9 @@ options:
     type: str
 
 extends_documentation_fragment:
-    - community.general.proxmox.documentation
+  - community.general.proxmox.actiongroup_proxmox
-    - community.general.attributes
+  - community.general.proxmox.documentation
+  - community.general.attributes
 """
 
 EXAMPLES = """

plugins/modules/proxmox_pool_member.py

@@ -20,6 +20,8 @@ attributes:
     support: full
   diff_mode:
     support: full
+  action_group:
+    version_added: 9.0.0
 options:
   poolid:
     description:
@@ -48,8 +50,9 @@ options:
     type: str
 
 extends_documentation_fragment:
-    - community.general.proxmox.documentation
+  - community.general.proxmox.actiongroup_proxmox
-    - community.general.attributes
+  - community.general.proxmox.documentation
+  - community.general.attributes
 """
 
 EXAMPLES = """

plugins/modules/proxmox_snap.py

@@ -21,6 +21,8 @@ attributes:
     support: full
   diff_mode:
     support: none
+  action_group:
+    version_added: 9.0.0
 options:
   hostname:
     description:
@@ -89,8 +91,9 @@ notes:
 requirements: [ "proxmoxer", "requests" ]
 author: Jeffrey van Pelt (@Thulium-Drake)
 extends_documentation_fragment:
-    - community.general.proxmox.documentation
+  - community.general.proxmox.actiongroup_proxmox
-    - community.general.attributes
+  - community.general.proxmox.documentation
+  - community.general.attributes
 '''
 
 EXAMPLES = r'''

plugins/modules/proxmox_storage_contents_info.py

@@ -17,6 +17,9 @@ short_description: List content from a Proxmox VE storage
 version_added: 8.2.0
 description:
   - Retrieves information about stored objects on a specific storage attached to a node.
+attributes:
+  action_group:
+    version_added: 9.0.0
 options:
   storage:
     description:
@@ -41,6 +44,7 @@ options:
     type: int
 author: Julian Vanden Broeck (@l00ptr)
 extends_documentation_fragment:
+  - community.general.proxmox.actiongroup_proxmox
   - community.general.proxmox.documentation
   - community.general.attributes
   - community.general.attributes.info_module

plugins/modules/proxmox_storage_info.py

@@ -16,6 +16,9 @@ short_description: Retrieve information about one or more Proxmox VE storages
 version_added: 2.2.0
 description:
   - Retrieve information about one or more Proxmox VE storages.
+attributes:
+  action_group:
+    version_added: 9.0.0
 options:
   storage:
     description:
@@ -28,6 +31,7 @@ options:
     type: str
 author: Tristan Le Guern (@tleguern)
 extends_documentation_fragment:
+  - community.general.proxmox.actiongroup_proxmox
   - community.general.proxmox.documentation
   - community.general.attributes
   - community.general.attributes.info_module

plugins/modules/proxmox_tasks_info.py

@@ -17,6 +17,9 @@ version_added: 3.8.0
 description:
   - Retrieve information about one or more Proxmox VE tasks.
 author: 'Andreas Botzner (@paginabianca) <andreas at botzner dot com>'
+attributes:
+  action_group:
+    version_added: 9.0.0
 options:
   node:
     description:
@@ -29,9 +32,10 @@ options:
     aliases: ['upid', 'name']
     type: str
 extends_documentation_fragment:
-    - community.general.proxmox.documentation
+  - community.general.proxmox.actiongroup_proxmox
-    - community.general.attributes
+  - community.general.proxmox.documentation
-    - community.general.attributes.info_module
+  - community.general.attributes
+  - community.general.attributes.info_module
 '''
 
 

plugins/modules/proxmox_template.py

@@ -20,6 +20,8 @@ attributes:
     support: none
   diff_mode:
     support: none
+  action_group:
+    version_added: 9.0.0
 options:
   node:
     description:
@@ -69,6 +71,7 @@ notes:
   - C(proxmoxer) >= 1.2.0 requires C(requests_toolbelt) to upload files larger than 256 MB.
 author: Sergei Antipov (@UnderGreen)
 extends_documentation_fragment:
+  - community.general.proxmox.actiongroup_proxmox
   - community.general.proxmox.documentation
   - community.general.attributes
 '''

plugins/modules/proxmox_user_info.py

@@ -16,6 +16,9 @@ short_description: Retrieve information about one or more Proxmox VE users
 version_added: 1.3.0
 description:
   - Retrieve information about one or more Proxmox VE users
+attributes:
+  action_group:
+    version_added: 9.0.0
 options:
   domain:
     description:
@@ -33,6 +36,7 @@ options:
     type: str
 author: Tristan Le Guern (@tleguern)
 extends_documentation_fragment:
+  - community.general.proxmox.actiongroup_proxmox
   - community.general.proxmox.documentation
   - community.general.attributes
   - community.general.attributes.info_module

plugins/modules/proxmox_vm_info.py

@@ -17,6 +17,9 @@ version_added: 7.2.0
 description:
   - Retrieve information about one or more Proxmox VE virtual machines.
 author: 'Sergei Antipov (@UnderGreen) <greendayonfire at gmail dot com>'
+attributes:
+  action_group:
+    version_added: 9.0.0
 options:
   node:
     description:
@@ -55,9 +58,10 @@ options:
     default: none
     version_added: 8.1.0
 extends_documentation_fragment:
-    - community.general.proxmox.documentation
+  - community.general.proxmox.actiongroup_proxmox
-    - community.general.attributes
+  - community.general.proxmox.documentation
-    - community.general.attributes.info_module
+  - community.general.attributes
+  - community.general.attributes.info_module
 """
 
 EXAMPLES = """