ansible-role-freeipa-client

This is an Ansible role for installing the prerequisites for a FreeIPA client.

Users of this role are responsible for pushing the freeipa credentials to the server via cloud-init. See the freeipa-creds.tpl.yml file for an example of how to do this.

Requirements

None.

Role Variables

None.

Dependencies

• cisagov/ansible-role-backports: On Debian Bullseye the freeipa-client package is only available from the backports package repo.

Installation

This role can be installed via the command:

ansible-galaxy install --role-file path/to/requirements.yml

where requirements.yml looks like:

---
- name: freeipa_client
  src: https://github.com/cisagov/ansible-role-freeipa-client

and may contain other roles as well.

For more information about installing Ansible roles via a YAML file, please see the ansible-galaxy documentation.

Example Playbook

Here's how to use it in a playbook:

- hosts: freeipa_clients
  become: true
  become_method: sudo
  tasks:
    - name: Install FreeIPA client
      ansible.builtin.include_role:
        name: freeipa_client

Contributing

We welcome contributions! Please see CONTRIBUTING.md for details.

License

This project is in the worldwide public domain.

This project is in the public domain within the United States, and copyright and related rights in the work worldwide are waived through the CC0 1.0 Universal public domain dedication.

All contributions to this project will be released under the CC0 dedication. By submitting a pull request, you are agreeing to comply with this waiver of copyright interest.

Author Information

Shane Frasier - [email protected]