README-netgroup.md

Netgroup module

Description

The netgroup module allows to ensure presence and absence of netgroups.

Features

• Netgroup management

Supported FreeIPA Versions

FreeIPA versions 4.4.0 and up are supported by the ipanetgroup 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 netgroup "my_netgroup1" is present:

---
- name: Playbook to manage IPA netgroup.
  hosts: ipaserver
  become: no

  tasks:
  - name: Ensure netgroup my_netgroup1 is present
    ipanetgroup:
      ipaadmin_password: SomeADMINpassword
      name: my_netgroup1
      description: My netgroup 1

Example playbook to make sure netgroup "my_netgroup1" is absent:

---
- name: Playbook to manage IPA netgroup.
  hosts: ipaserver
  become: no

  tasks:
  - name: Ensure netgroup my_netgroup1 is absent
    ipanetgroup:
      ipaadmin_password: SomeADMINpassword
      name: my_netgroup1
      state: absent

Example playbook to make sure netgroup is present with user "user1"