1
0
Fork 0
ansible-collection-uffd/README.md
Nis Wechselberg 694fd412c9
All checks were successful
ci/woodpecker/push/woodpecker Pipeline was successful
First version of the uffd collection
TODO: The build role should probably be replaced by some intragration as a .build quadlet.

Signed-off-by: Nis Wechselberg <enbewe@enbewe.de>
2025-05-07 23:53:34 +02:00

60 lines
2 KiB
Markdown

# Ansible Collection - enbewe.uffd
Collecion to deploy [uffd (**U**ser**F**erwaltungs**F**ronten**d**)](https://git.cccv.de/uffd/uffd) as OAuth/OIDC authentication service.
## Playbooks
### enbewe.uffd.build
Deploys the role `enbewe.uffd.build` to all hosts of the `uffd` group.
### enbewe.uffd.deploy
Deploys the role `enbewe.uffd.uffd` to all hosts of the `uffd` group.
## Roles
### enbewe.uffd.build
Creates the current image of uffd. The image is tagged with the current timestamp as well as 'latest'.
This role could probably replaced by some build- and publishing job.
#### Optional Variables
**build_uffd_tempdir** *(Default: '/tmp/podman-uffd-build')*
Path to use for building the uffd OCI container in. This path will be created as needed and removed again afterwards.
**build_uffd_debian_version** *(Default: 'bullseye')*
The debian version name to use for the uffd container.
**build_uffd_force_rebuild** *(Default: false)*
Flag to force the reduilding of the uffd container even if it already exists.
**build_uffd_tag_latest** *(Default: true)*
Flag to disable tagging the built image as `latest`.
### enbewe.uffd.uffd
Deploys uffd through a podman container.
Additionally deploys an nginx container as a HTTP server for static files as well as uWSGI proxy.
#### Required variables
**uffd_secret_key**
The secret key to use for uffd data.
**uffd_initial_admin_user**
Name of the initial admin user.
**uffd_initial_admin_pw**
Password of the initial admin user.
**uffd_initial_admin_mail**
E-Mail address of the initial admin user.
#### Optional Variables
**uffd_podman_network** *(Default: 'uffd-net')*
Name of the podman network to use for uffd container and the nginx server.
**uffd_conf_dir** *(Default: '/etc/uffd')*
The directory to use for config files.
**uffd_static_files_volume** *(Default: 'uffd-static-files')*
The name of the podman volume to use for the static files of the uffd.
**uffd_data_volume** *(Default: 'uffd-data')*
The name of the podman volume to use for the runtime data of uffd.