Skip to content
Snippets Groups Projects
Select Git revision
  • 24569b850a472b5ed2136c051ae3df6789ce2e0e
  • 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-automountkey.md

Blame
  • user avatar
    Rafael Guterres Jeffman authored
    ansible-freeipa roles do not work with Ansible 2.8 anymore, so the
    minimum supported version is changed to 2.15, the oldest supported
    Ansible version as of today.
    
    This patch includes the change to the version number in the collection
    and all plugin README files. The collection README was also update to
    remove text that related only to previous Ansible versions.
    7126dec0
    History

    Automountkey module

    Description

    The automountkey module allows management of keys within an automount map.

    It is desgined to follow the IPA api as closely as possible while ensuring ease of use.

    Features

    • Automount key management

    Supported FreeIPA Versions

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

    Requirements

    Controller

    • Ansible version: 2.15+

    Node

    • Supported FreeIPA version (see above)

    Usage

    Example inventory file

    [ipaserver]
    ipaserver.test.local

    Example playbook to ensure presence of an automount key:

    ---
    - name: Playbook to manage automount key
      hosts: ipaserver
    
      tasks:
      - name: ensure automount key TestKey is present
        ipaautomountkey:
          ipaadmin_password: SomeADMINpassword
          location: TestLocation
          mapname: TestMap
          key: TestKey
          info: 192.168.122.1:/exports
          state: present

    Example playbook to rename an automount map:

    ---
    - name: Playbook to add an automount map
      hosts: ipaserver
    
      tasks:
      - name: ensure aumount key TestKey is renamed to NewKeyName
        ipaautomountkey:
          ipaadmin_password: password01
          automountlocationcn: TestLocation
          automountmapname: TestMap
          automountkey: TestKey
          newname: NewKeyName
          state: renamed

    Example playbook to ensure an automount key is absent:

    ---
    - name: Playbook to manage an automount key
      hosts: ipaserver
    
      tasks:
      - name: ensure automount key TestKey is absent
        ipaautomountkey:
          ipaadmin_password: SomeADMINpassword
          location: TestLocation
          mapname: TestMap
          key: TestKey
          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
    location | automountlocationcn | automountlocation Location name. yes
    mapname | map | automountmapname | automountmap Map the key belongs to yes
    key | name | automountkey Automount key to manage yes
    rename | new_name | newautomountkey the name to change the key to if state is renamed yes when state is renamed
    info | information | automountinformation Mount information for the key yes when state is present
    state The state to ensure. It can be one of present, absent or renamed, default: present. no

    Authors

    Chris Procter