Blame plugins/modules/ipalocation.py

Packit Service a166ed
# -*- coding: utf-8 -*-
Packit Service a166ed
Packit Service a166ed
# Authors:
Packit Service a166ed
#   Thomas Woerner <twoerner@redhat.com>
Packit Service a166ed
#
Packit Service a166ed
# Copyright (C) 2020 Red Hat
Packit Service a166ed
# see file 'COPYING' for use and warranty information
Packit Service a166ed
#
Packit Service a166ed
# This program is free software; you can redistribute it and/or modify
Packit Service a166ed
# it under the terms of the GNU General Public License as published by
Packit Service a166ed
# the Free Software Foundation, either version 3 of the License, or
Packit Service a166ed
# (at your option) any later version.
Packit Service a166ed
#
Packit Service a166ed
# This program is distributed in the hope that it will be useful,
Packit Service a166ed
# but WITHOUT ANY WARRANTY; without even the implied warranty of
Packit Service a166ed
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
Packit Service a166ed
# GNU General Public License for more details.
Packit Service a166ed
#
Packit Service a166ed
# You should have received a copy of the GNU General Public License
Packit Service a166ed
# along with this program.  If not, see <http://www.gnu.org/licenses/>.
Packit Service a166ed
Packit Service a166ed
ANSIBLE_METADATA = {
Packit Service a166ed
    "metadata_version": "1.0",
Packit Service a166ed
    "supported_by": "community",
Packit Service a166ed
    "status": ["preview"],
Packit Service a166ed
}
Packit Service a166ed
Packit Service a166ed
DOCUMENTATION = """
Packit Service a166ed
---
Packit Service a166ed
module: ipalocation
Packit Service a166ed
short description: Manage FreeIPA location
Packit Service a166ed
description: Manage FreeIPA location
Packit Service a166ed
options:
Packit Service a166ed
  ipaadmin_principal:
Packit Service a166ed
    description: The admin principal.
Packit Service a166ed
    default: admin
Packit Service a166ed
  ipaadmin_password:
Packit Service a166ed
    description: The admin password.
Packit Service a166ed
    required: false
Packit Service a166ed
  name:
Packit Service a166ed
    description: The list of location name strings.
Packit Service a166ed
    required: true
Packit Service a166ed
    aliases: ["idnsname"]
Packit Service a166ed
  description:
Packit Service a166ed
    description: The IPA location string
Packit Service a166ed
    required: false
Packit Service a166ed
  state:
Packit Service a166ed
    description: The state to ensure.
Packit Service a166ed
    choices: ["present", "absent"]
Packit Service a166ed
    default: present
Packit Service a166ed
    required: true
Packit Service a166ed
"""
Packit Service a166ed
Packit Service a166ed
EXAMPLES = """
Packit Service a166ed
# Ensure location my_location1 is present
Packit Service a166ed
- ipalocation:
Packit Service a166ed
    ipaadmin_password: SomeADMINpassword
Packit Service a166ed
    name: my_location1
Packit Service a166ed
    description: My location 1
Packit Service a166ed
Packit Service a166ed
# Ensure location my_location1 is absent
Packit Service a166ed
- ipalocation:
Packit Service a166ed
    ipaadmin_password: SomeADMINpassword
Packit Service a166ed
    name: my_location1
Packit Service a166ed
    state: absent
Packit Service a166ed
"""
Packit Service a166ed
Packit Service a166ed
RETURN = """
Packit Service a166ed
"""
Packit Service a166ed
Packit Service a166ed
Packit Service a166ed
from ansible.module_utils.basic import AnsibleModule
Packit Service a166ed
from ansible.module_utils.ansible_freeipa_module import \
Packit Service a166ed
    temp_kinit, temp_kdestroy, valid_creds, api_connect, api_command, \
Packit Service a166ed
    compare_args_ipa, module_params_get
Packit Service a166ed
import six
Packit Service a166ed
Packit Service a166ed
if six.PY3:
Packit Service a166ed
    unicode = str
Packit Service a166ed
Packit Service a166ed
Packit Service a166ed
def find_location(module, name):
Packit Service a166ed
    """Find if a location with the given name already exist."""
Packit Service a166ed
    try:
Packit Service a166ed
        _result = api_command(module, "location_show", name, {"all": True})
Packit Service a166ed
    except Exception:  # pylint: disable=broad-except
Packit Service a166ed
        # An exception is raised if location name is not found.
Packit Service a166ed
        return None
Packit Service a166ed
    else:
Packit Service a166ed
        return _result["result"]
Packit Service a166ed
Packit Service a166ed
Packit Service a166ed
def gen_args(description):
Packit Service a166ed
    _args = {}
Packit Service a166ed
    if description is not None:
Packit Service a166ed
        _args["description"] = description
Packit Service a166ed
    return _args
Packit Service a166ed
Packit Service a166ed
Packit Service a166ed
def main():
Packit Service a166ed
    ansible_module = AnsibleModule(
Packit Service a166ed
        argument_spec=dict(
Packit Service a166ed
            # general
Packit Service a166ed
            ipaadmin_principal=dict(type="str", default="admin"),
Packit Service a166ed
            ipaadmin_password=dict(type="str", required=False, no_log=True),
Packit Service a166ed
Packit Service a166ed
            name=dict(type="list", aliases=["idnsname"],
Packit Service a166ed
                      default=None, required=True),
Packit Service a166ed
            # present
Packit Service a166ed
            description=dict(required=False, type='str', default=None),
Packit Service a166ed
            # state
Packit Service a166ed
            state=dict(type="str", default="present",
Packit Service a166ed
                       choices=["present", "absent"]),
Packit Service a166ed
        ),
Packit Service a166ed
        supports_check_mode=True,
Packit Service a166ed
    )
Packit Service a166ed
Packit Service a166ed
    ansible_module._ansible_debug = True
Packit Service a166ed
Packit Service a166ed
    # Get parameters
Packit Service a166ed
Packit Service a166ed
    # general
Packit Service a166ed
    ipaadmin_principal = module_params_get(ansible_module,
Packit Service a166ed
                                           "ipaadmin_principal")
Packit Service a166ed
    ipaadmin_password = module_params_get(ansible_module, "ipaadmin_password")
Packit Service a166ed
    names = module_params_get(ansible_module, "name")
Packit Service a166ed
Packit Service a166ed
    # present
Packit Service a166ed
    description = module_params_get(ansible_module, "description")
Packit Service a166ed
Packit Service a166ed
    # state
Packit Service a166ed
    state = module_params_get(ansible_module, "state")
Packit Service a166ed
Packit Service a166ed
    # Check parameters
Packit Service a166ed
Packit Service a166ed
    if state == "present":
Packit Service a166ed
        if len(names) != 1:
Packit Service a166ed
            ansible_module.fail_json(
Packit Service a166ed
                msg="Only one location be added at a time.")
Packit Service a166ed
Packit Service a166ed
    if state == "absent":
Packit Service a166ed
        if len(names) < 1:
Packit Service a166ed
            ansible_module.fail_json(msg="No name given.")
Packit Service a166ed
        invalid = ["description"]
Packit Service a166ed
        for x in invalid:
Packit Service a166ed
            if vars()[x] is not None:
Packit Service a166ed
                ansible_module.fail_json(
Packit Service a166ed
                    msg="Argument '%s' can not be used with state '%s'" %
Packit Service a166ed
                    (x, state))
Packit Service a166ed
Packit Service a166ed
    # Init
Packit Service a166ed
Packit Service a166ed
    changed = False
Packit Service a166ed
    exit_args = {}
Packit Service a166ed
    ccache_dir = None
Packit Service a166ed
    ccache_name = None
Packit Service a166ed
    try:
Packit Service a166ed
        if not valid_creds(ansible_module, ipaadmin_principal):
Packit Service a166ed
            ccache_dir, ccache_name = temp_kinit(ipaadmin_principal,
Packit Service a166ed
                                                 ipaadmin_password)
Packit Service a166ed
        api_connect()
Packit Service a166ed
Packit Service a166ed
        commands = []
Packit Service a166ed
        for name in names:
Packit Service a166ed
            # Make sure location exists
Packit Service a166ed
            res_find = find_location(ansible_module, name)
Packit Service a166ed
Packit Service a166ed
            # Create command
Packit Service a166ed
            if state == "present":
Packit Service a166ed
Packit Service a166ed
                # Generate args
Packit Service a166ed
                args = gen_args(description)
Packit Service a166ed
Packit Service a166ed
                # Found the location
Packit Service a166ed
                if res_find is not None:
Packit Service a166ed
                    # For all settings is args, check if there are
Packit Service a166ed
                    # different settings in the find result.
Packit Service a166ed
                    # If yes: modify
Packit Service a166ed
                    if not compare_args_ipa(ansible_module, args,
Packit Service a166ed
                                            res_find):
Packit Service a166ed
                        commands.append([name, "location_mod", args])
Packit Service a166ed
                else:
Packit Service a166ed
                    commands.append([name, "location_add", args])
Packit Service a166ed
Packit Service a166ed
            elif state == "absent":
Packit Service a166ed
                if res_find is not None:
Packit Service a166ed
                    commands.append([name, "location_del", {}])
Packit Service a166ed
Packit Service a166ed
            else:
Packit Service a166ed
                ansible_module.fail_json(msg="Unkown state '%s'" % state)
Packit Service a166ed
Packit Service a166ed
        # Execute commands
Packit Service a166ed
Packit Service a166ed
        for name, command, args in commands:
Packit Service a166ed
            try:
Packit Service a166ed
                result = api_command(ansible_module, command, name,
Packit Service a166ed
                                     args)
Packit Service a166ed
                if "completed" in result:
Packit Service a166ed
                    if result["completed"] > 0:
Packit Service a166ed
                        changed = True
Packit Service a166ed
                else:
Packit Service a166ed
                    changed = True
Packit Service a166ed
            except Exception as e:
Packit Service a166ed
                ansible_module.fail_json(msg="%s: %s: %s" % (command, name,
Packit Service a166ed
                                                             str(e)))
Packit Service a166ed
Packit Service a166ed
    except Exception as e:
Packit Service a166ed
        ansible_module.fail_json(msg=str(e))
Packit Service a166ed
Packit Service a166ed
    finally:
Packit Service a166ed
        temp_kdestroy(ccache_dir, ccache_name)
Packit Service a166ed
Packit Service a166ed
    # Done
Packit Service a166ed
Packit Service a166ed
    ansible_module.exit_json(changed=changed, **exit_args)
Packit Service a166ed
Packit Service a166ed
Packit Service a166ed
if __name__ == "__main__":
Packit Service a166ed
    main()