mirror of https://github.com/freeipa/ansible-freeipa.git synced 2026-03-26 21:33:05 +00:00

Files

chrisp 0d47429000 New automount map management module.

There is a new server management module placed in the plugins folder:

    plugins/modules/ipaautomountmap.py

The server module allows to ensure presence and absence of automount
maps. The module requires an existing automount location to place the
map within. It does not create any automount keys with in the map.

Here is the documentation for the module:

    README-automountmap.md

New example playbooks have been added:

    playbooks/automount/automount-map-absent.yaml
    playbooks/automount/automount-map-present.yaml

New tests for the module:

    tests/automount/test_automountmap.yml

2022-01-05 18:49:27 -03:00

2.0 KiB

Raw Blame History

Automountmap module

Description

The automountmap module allows the addition and removal of maps within automount locations.

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

Features

Automount map management

Supported FreeIPA Versions

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

Requirements

Controller

Ansible version: 2.8+

Node

Supported FreeIPA version (see above)

Usage

Example inventory file

[ipaserver]
ipaserver.test.local

Example playbook to ensure presence of an automount map:

---
- name: Playbook to add an automount map
  hosts: ipaserver
  become: true

  tasks:
  - name: ensure map named auto.DMZ in location DMZ is created
    ipaautomountmap:
      ipaadmin_password: SomeADMINpassword
      name: auto.DMZ
      location: DMZ
      desc: "this is a map for servers in the DMZ"

Example playbook to ensure auto.DMZi does not exist

---
- name: Playbook to remove an automount map
  hosts: ipaserver
  become: true

  tasks:
  - name: ensure map auto.DMZ has been removed
    ipaautomountmap:
      ipaadmin_password: SomeADMINpassword
      name: auto.DMZ
      location: DMX
      state: absent

Variables

ipaautomountmap

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
`name` \| `mapname` \| `map` \| `automountmapname`	Name of the map to manage	yes
`location` \| `automountlocation` \| `automountlocationcn`	Location name.	yes
`desc` \| `description`	Description of the map	yes
`state`	The state to ensure. It can be one of `present`, or `absent`, default: `present`.	no

Authors

Chris Procter

2.0 KiB Raw Blame History