mirror of
https://github.com/ansible-collections/community.general.git
synced 2024-09-14 20:13:21 +02:00
51a08ea398
* proxmox: create a common base
Add a doc_fragment to share the documentation regarding authentication
parameters (api_host, api_user, api_password, api_token_id,
api_token_secret as well as the lone validate_certs).
Add a module_utils to hold common code such as the argument spec (again
related to authentication paramters), a helper function to convert from
Proxmox boolean representation to python and the base class
ProxmoxAnsible.
For now it only handles the connection to Proxmox VE API but more can be
added in the future.
To check if everything is well in place add three new modules:
proxmox_{domain,group,user}_info.
And finaly tests these new modules.
* Apply suggestions from code review
Co-authored-by: Felix Fontein <felix@fontein.de>
* Add tests/integration/targets/proxmox/aliases
Co-authored-by: Felix Fontein <felix@fontein.de>
133 lines
3.6 KiB
Python
133 lines
3.6 KiB
Python
#!/usr/bin/python
|
|
# -*- coding: utf-8 -*-
|
|
#
|
|
# Copyright: Tristan Le Guern (@Aversiste) <tleguern at bouledef.eu>
|
|
# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
|
|
|
|
from __future__ import absolute_import, division, print_function
|
|
__metaclass__ = type
|
|
|
|
|
|
DOCUMENTATION = '''
|
|
---
|
|
module: proxmox_domain_info
|
|
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.
|
|
options:
|
|
domain:
|
|
description:
|
|
- Restrict results to a specific authentication realm.
|
|
aliases: ['realm', 'name']
|
|
type: str
|
|
author: Tristan Le Guern (@Aversiste)
|
|
extends_documentation_fragment: community.general.proxmox.documentation
|
|
'''
|
|
|
|
|
|
EXAMPLES = '''
|
|
- name: List existing domains
|
|
community.general.proxmox_domain_info:
|
|
api_host: helldorado
|
|
api_user: root@pam
|
|
api_password: "{{ password | default(omit) }}"
|
|
api_token_id: "{{ token_id | default(omit) }}"
|
|
api_token_secret: "{{ token_secret | default(omit) }}"
|
|
register: proxmox_domains
|
|
|
|
- name: Retrieve information about the pve domain
|
|
community.general.proxmox_domain_info:
|
|
api_host: helldorado
|
|
api_user: root@pam
|
|
api_password: "{{ password | default(omit) }}"
|
|
api_token_id: "{{ token_id | default(omit) }}"
|
|
api_token_secret: "{{ token_secret | default(omit) }}"
|
|
domain: pve
|
|
register: proxmox_domain_pve
|
|
'''
|
|
|
|
|
|
RETURN = '''
|
|
proxmox_domains:
|
|
description: List of authentication domains.
|
|
returned: always, but can be empty
|
|
type: list
|
|
elements: dict
|
|
contains:
|
|
comment:
|
|
description: Short description of the realm.
|
|
returned: on success
|
|
type: str
|
|
realm:
|
|
description: Realm name.
|
|
returned: on success
|
|
type: str
|
|
type:
|
|
description: Realm type.
|
|
returned: on success
|
|
type: str
|
|
digest:
|
|
description: Realm hash.
|
|
returned: on success, can be absent
|
|
type: str
|
|
'''
|
|
|
|
|
|
from ansible.module_utils.basic import AnsibleModule, missing_required_lib
|
|
from ansible_collections.community.general.plugins.module_utils.proxmox import (
|
|
proxmox_auth_argument_spec, ProxmoxAnsible, HAS_PROXMOXER, PROXMOXER_IMP_ERR)
|
|
|
|
|
|
class ProxmoxDomainInfoAnsible(ProxmoxAnsible):
|
|
def get_domain(self, realm):
|
|
try:
|
|
domain = self.proxmox_api.access.domains.get(realm)
|
|
except Exception:
|
|
self.module.fail_json(msg="Domain '%s' does not exist" % realm)
|
|
domain['realm'] = realm
|
|
return domain
|
|
|
|
def get_domains(self):
|
|
domains = self.proxmox_api.access.domains.get()
|
|
return domains
|
|
|
|
|
|
def proxmox_domain_info_argument_spec():
|
|
return dict(
|
|
domain=dict(type='str', aliases=['realm', 'name']),
|
|
)
|
|
|
|
|
|
def main():
|
|
module_args = proxmox_auth_argument_spec()
|
|
domain_info_args = proxmox_domain_info_argument_spec()
|
|
module_args.update(domain_info_args)
|
|
|
|
module = AnsibleModule(
|
|
argument_spec=module_args,
|
|
required_one_of=[('api_password', 'api_token_id')],
|
|
required_together=[('api_token_id', 'api_token_secret')],
|
|
supports_check_mode=True
|
|
)
|
|
result = dict(
|
|
changed=False
|
|
)
|
|
|
|
if not HAS_PROXMOXER:
|
|
module.fail_json(msg=missing_required_lib('proxmoxer'), exception=PROXMOXER_IMP_ERR)
|
|
|
|
proxmox = ProxmoxDomainInfoAnsible(module)
|
|
domain = module.params['domain']
|
|
|
|
if domain:
|
|
domains = [proxmox.get_domain(realm=domain)]
|
|
else:
|
|
domains = proxmox.get_domains()
|
|
result['proxmox_domains'] = domains
|
|
|
|
module.exit_json(**result)
|
|
|
|
|
|
if __name__ == '__main__':
|
|
main()
|