Writing a new Ansible FreeIPA module

A ansible-freeipa module should have:

• Code:

  • A module file placed in plugins/modules/<ipa_module_name>.py

• Documentation:

  • README-<module_name>.md file in the root directory and linked from the main README.md
  • Example playbooks in playbooks/<module_name>/ directory

• Tests:

  • Test cases (also playbooks) defined in tests/<module_name>/test_<something>.yml. It's ok to have multiple files in this directory.

Use the script utils/new_module to create the stub files for a new module.