bodsch.glauth

Ansible Role: `glauth`

This Ansible role helps you install and set up glauth.

If you set glauth_version to latest, the role will attempt to install the most recent version.
Be cautious, as there might be compatibility issues between different versions!

The software is installed in /usr/local/bin/glauth/${glauth_version} and then linked to /usr/bin. This allows you to downgrade if needed.

The downloaded files are kept on the Ansible controller, unpacked, and then copied to the target machine. You can specify a different cache directory by setting the CUSTOM_LOCAL_TMP_DIRECTORY environment variable. By default, it uses ${HOME}/.cache/ansible/glauth. If you prefer to download directly to the target system, you can turn this on by setting glauth_direct_download to true.

Requirements & Dependencies

Ansible Collections needed:

You can install these using:

ansible-galaxy collection install bodsch.core
ansible-galaxy collection install bodsch.scm

or, you can use a requirements file:

ansible-galaxy collection install --requirements-file collections.yml

Operating Systems

This role has been tested on:

Arch Linux
Debian-based systems
- Debian 10 / 11
- Ubuntu 20.10

Contribution

For contributions, please read the Contribution document.

Development and Branches (Git Tags)

The master branch is my Working Horse and may contain unstable features!

If you want a reliable version, please use a Tagged Version!

Configuration

glauth_version: 2.1.0

glauth_release_download_url: https://github.com/glauth/glauth/releases
glauth_release_api_url: https://api.github.com/repos/glauth/glauth/releases

glauth_system_user: glauth
glauth_system_group: glauth
glauth_config_dir: /etc/glauth
glauth_data_dir: /var/lib/glauth

glauth_direct_download: false

glauth_service: {}

glauth_config: {}

glauth_backends: {}

glauth_users: {}

glauth_groups: {}

glauth_behaviors: {}

glauth_api: {}

Config for this role

Parameter	Type	Default	Description
`glauth_version`	`string`	`2.1.0`	Version of glauth to install. Use `latest` for the newest version, but be careful.
`glauth_system_user`	`string`	`glauth`	User under which glauth will run
`glauth_system_group`	`string`	`glauth`	Group under which glauth will run
`glauth_config_dir`	`string`	`/etc/glauth`	Directory for glauth configuration
`glauth_data_dir`	`string`	`/var/lib/glauth`	Directory where plugins will be installed
`glauth_install_path`	`string`	`/usr/local/bin/glauth/{{ glauth_version }}`	Installation location for glauth, linked to `/usr/bin/glauth`
`glauth_direct_download`	`bool`	`false`	Download on local machine (`false`) or directly on target host (`true`)
`glauth_local_tmp_directory`	`string`	Environment variable `CUSTOM_LOCAL_TMP_DIRECTORY` or `~/.cache/ansible/glauth/{{ glauth_version }}`	Local path for downloading glauth