Skip to content
Snippets Groups Projects
Select Git revision
  • bed8bf666117e32911a7b5b6b3fb2cf20f1fe416
  • master default protected
  • v1.14.7
  • v1.14.6
  • v1.14.5
  • v1.14.4
  • v1.14.3
  • v1.14.2
  • v1.14.1
  • v1.14.0
  • v1.13.2
  • v1.13.1
  • v1.13.0
  • v1.12.1
  • v1.12.0
  • v1.11.1
  • v1.11.0
  • v1.10.0
  • v1.9.2
  • v1.9.1
  • v1.9.0
  • v1.8.4
22 results

README-location.md

Blame
  • user avatar
    Thomas Woerner authored
    The Variables and also the Return Variables sections contained an extra
    header with the module name. This is only needed if there are more than
    one module in the README.
    65937ed8
    History

    Location module

    Description

    The location module allows to ensure presence and absence of locations.

    Features

    • Location management

    Supported FreeIPA Versions

    FreeIPA versions 4.4.0 and up are supported by the ipalocation module.

    Requirements

    Controller

    • Ansible version: 2.8+

    Node

    • Supported FreeIPA version (see above)

    Usage

    Example inventory file

    [ipaserver]
    ipaserver.test.local

    Example playbook to make sure location "my_location1" is present:

    ---
    - name: Playbook to manage IPA location.
      hosts: ipaserver
      become: yes
    
      tasks:
      - ipalocation:
          ipaadmin_password: SomeADMINpassword
          name: my_location1
          description: My Location 1

    Example playbook to make sure location "my_location1" is absent:

    ---
    - name: Playbook to manage IPA location.
      hosts: ipaserver
      become: yes
    
      tasks:
      - ipalocation:
          ipaadmin_password: SomeADMINpassword
          name: my_location1
          state: absent

    Variables

    Variable Description Required
    ipaadmin_principal The admin principal is a string and defaults to admin no
    ipaadmin_password The admin password is a string and is required if there is no admin ticket available on the node no
    ipaapi_context The context in which the module will execute. Executing in a server context is preferred. If not provided context will be determined by the execution environment. Valid values are server and client. no
    ipaapi_ldap_cache Use LDAP cache for IPA connection. The bool setting defaults to yes. (bool) no
    name | idnsname The list of location name strings. yes
    description The IPA location string false
    state The state to ensure. It can be one of present, absent, default: present. no

    Authors

    Thomas Woerner