feat(pretix): add ansible role and playbook

playbooks/pretix.yml

@@ -0,0 +1,7 @@
+---
+- name: Install and configure pretix
+  hosts: "{{ pretix_hosts | default('pretix') }}"
+  become: "{{ pretix_become | default(true) }}"
+  gather_facts: "{{ pretix_gather_facts | default(false) }}"
+  roles:
+    - role: pretix

playbooks/unifi_controller.yml

@@ -1,7 +0,0 @@
----
-- name: Deploy unifi controller
-  hosts: "{{ unifi_controller_hosts | default('unifi_controller') }}"
-  become: "{{ unifi_controller_become | default(false) }}"
-  gather_facts: "{{ unifi_controller_gather_facts | default(false) }}"
-  roles:
-    - role: finallycoffee.services.unifi_controller

roles/authelia/defaults/main.yml

@@ -1,5 +1,5 @@
 ---
-authelia_version: "4.39.8"
+authelia_version: "4.39.9"
 authelia_user: authelia
 authelia_base_dir: /opt/authelia
 authelia_domain: authelia.example.org

roles/gitea/defaults/main.yml

@@ -1,5 +1,5 @@
 ---
-gitea_version: "1.24.5"
+gitea_version: "1.24.6"
 gitea_user: git
 gitea_run_user: "{{ gitea_user }}"
 gitea_base_path: "/opt/gitea"

roles/keycloak/defaults/main.yml

@@ -1,5 +1,5 @@
 ---
-keycloak_version: "26.3.4"
+keycloak_version: "26.3.3"
 keycloak_container_name: keycloak
 
 keycloak_container_image_upstream_registry: quay.io

roles/phpldapadmin/defaults/main/main.yml

@@ -1,5 +1,5 @@
 ---
-phpldapadmin_version: "2.3.0"
+phpldapadmin_version: "2.3.1"
 
 phpldapadmin_state: present
 phpldapadmin_deployment_method: docker

roles/pretix/README.md

@@ -0,0 +1,16 @@
+# `finallycoffee.services.pretix` ansible role
+
+
+## Troubleshooting
+
+### virtualenv
+
+By default, the virtualenv is located in `/var/lib/pretix/virtualenv`.
+This can be controlled by setting `pretix_virtualenv_dir`.
+
+NOTE: To fix a broken virtualenv, try setting `pretix_virtualenv_state` to `forcereinstall` (see
+[`ansible.builtin.pip` on docs.ansible.com](https://docs.ansible.com/ansible/latest/collections/ansible/builtin/pip_module.html)).
+
+NOTE: To install pip packages or execute migrations in the virtualenv, ansible
+needs to become the unprivilated `pretix_user` (default: `pretix`). This might
+require having the `acl` system package installed.

roles/pretix/defaults/main/main.yml

@@ -0,0 +1,14 @@
+---
+pretix_version: "2025.7.1"
+pretix_state: "present"
+pretix_deployment_method: "systemd"
+
+pretix_config_file: "/etc/pretix/pretix.cfg"
+pretix_config_file_owner: "{{ pretix_user_id }}"
+pretix_config_file_group: "{{ pretix_group_id }}"
+pretix_config_file_mode: "0640"
+pretix_config_dir: "{{ pretix_config_file | dirname }}"
+pretix_install_dir: "/var/lib/pretix"
+pretix_virtualenv_dir: "{{ pretix_install_dir }}/virtualenv"
+pretix_data_dir: "{{ pretix_install_dir }}/data"
+pretix_media_dir: "{{ pretix_data_dir }}/media"

roles/pretix/defaults/main/system_packages.yml

@@ -0,0 +1,21 @@
+---
+pretix_debian_packages:
+  - "git"
+  - "build-essential"
+  - "python3-dev"
+  - "python3-venv"
+  - "python3"
+  - "python3-pip"
+  - "libxml2-dev"
+  - "libxslt1-dev"
+  - "libffi-dev"
+  - "zlib1g-dev"
+  - "libssl-dev"
+  - "gettext"
+  - "libpq-dev"
+  - "libjpeg-dev"
+  - "libopenjp2-7-dev"
+
+pretix_packages:
+  "debian":
+    "12": "{{ pretix_debian_packages }}"

roles/pretix/defaults/main/systemd.yml

@@ -0,0 +1,19 @@
+---
+pretix_systemd_unit_description: "pretix web service"
+pretix_systemd_unit_after: "network.target"
+
+pretix_systemd_service_user: "{{ pretix_user }}"
+pretix_systemd_service_group: "{{ pretix_user }}"
+pretix_systemd_service_environment:
+  VIRTUAL_ENV: "{{ pretix_virtualenv_dir }}"
+pretix_systemd_service_working_directory: "{{ pretix_install_dir }}"
+pretix_systemd_service_exec_start: >-2
+  {{ pretix_virtualenv_dir }}/bin/gunicorn pretix.wsgi
+  --name pretix
+  --workers 5
+  --max-requests 100
+  --log-level=info
+  --bind=127.0.0.1:8345
+pretix_systemd_service_restart: "on-failure"
+
+pretix_systemd_install_wanted_by: "multi-user.target"

roles/pretix/defaults/main/user.yml

@@ -0,0 +1,7 @@
+---
+pretix_user: "pretix"
+pretix_user_system: true
+pretix_user_create_home: false
+
+pretix_user_id: "{{ pretix_user_info.uid | default(pretix_user) }}"
+pretix_group_id: "{{ pretix_user_info.group | default(pretix_user) }}"

roles/pretix/defaults/main/virtualenv.yml

@@ -0,0 +1,11 @@
+---
+pretix_virtualenv_state: "{{ pretix_state }}"
+pretix_virtualenv_packages:
+  - "pip"
+  - "setuptools"
+  - "wheel"
+  - "gunicorn"
+  - "pretix=={{ pretix_version }}"
+
+pretix_virtualenv_site_packages: false
+pretix_virtualenv_command: "virtualenv"

roles/pretix/meta/main.yml

@@ -0,0 +1,9 @@
+---
+allow_duplicates: true
+dependencies: []
+galaxy_info:
+  role_name: pretix
+  description: Ansible role to deploy pretix (https://pretix.eu)
+  galaxy_tags:
+    - pretix
+    - ticketing

roles/pretix/tasks/check.yml

@@ -0,0 +1,14 @@
+---
+- name: Ensure 'pretix_state' is valid
+  ansible.builtin.fail:
+    msg: >-2
+      Unsupported pretix_state '{{ pretix_state }}'.
+      Supported states are {{ pretix_states | join(', ') }}
+  when: pretix_state not in pretix_states
+
+- name: Ensure 'pretix_deployment_method' is valid
+  ansible.builtin.fail:
+    msg: >-2
+      Unsupported pretix_state '{{ pretix_deployment_method }}'.
+      Supported states are {{ pretix_deployment_methods | join(', ') }}
+  when: pretix_deployment_method not in pretix_deployment_methods

roles/pretix/tasks/configure.yml

@@ -0,0 +1,9 @@
+---
+- name: Ensure configuration file is written
+  ansible.builtin.copy:
+    path: "{{ pretix_config_file }}"
+    content: "{{ pretix_config_file_content }}"
+    owner: "{{ pretix_config_file_owner }}"
+    group: "{{ pretix_config_file_group }}"
+    mode: "{{ pretix_config_file_mode }}"
+  when: ansible_state == 'present'

roles/pretix/tasks/deploy-systemd.yml

@@ -0,0 +1,19 @@
+---
+- name: Ensure virtualenv in {{ pretix_virtualenv_dir }} is present
+  ansible.builtin.pip:
+    name: "{{ pretix_virtualenv_packages }}"
+    state: "{{ pretix_virtualenv_state }}"
+    chdir: "{{ pretix_install_dir }}"
+    virtualenv: "{{ pretix_virtualenv_dir }}"
+    virtualenv_command: "{{ pretix_virtualenv_command }}"
+    virtualenv_site_packages: "{{ pretix_virtualenv_site_packages }}"
+  become: true
+  become_user: "{{ pretix_user }}"
+
+# TODO: determine to only do this on a) upgrades or b) initial deployis
+- name: Ensure pretix static assets are built
+  ansible.builtin.command:
+    cmd: "{{ pretix_virtualenv_dir }}/bin/python -m pretix rebuild"
+    chdir: "{{ pretix_install_dir }}"
+  environment:
+    VIRTUAL_ENV: "{{ pretix_virtualenv_dir }}"

roles/pretix/tasks/deploy.yml

@@ -0,0 +1,5 @@
+---
+- name: Ensure pretix is deployed using {{ pretix_deployment_method }}
+  ansible.builtin.include_tasks:
+    file: "deploy-{{ pretix_deployment_method }}.yml"
+  when: pretix_state == 'present'

roles/pretix/tasks/main.yml

@@ -0,0 +1,16 @@
+---
+- name: Ensure preconditions are met
+  ansible.builtin.include_tasks:
+    file: "check.yml"
+
+- name: Ensure deployment preparations are done
+  ansible.builtin.include_tasks:
+    file: "prepare.yml"
+
+- name: Ensure pretix is configured
+  ansible.builtin.include_tasks:
+    file: "configure.yml"
+
+- name: Ensure pretix is deployed
+  ansible.builtin.include_tasks:
+    file: "deploy.yml"

roles/pretix/tasks/prepare-systemd.yml

@@ -0,0 +1,19 @@
+---
+- name: Ensure ansible facts are collected
+  ansible.builtin.setup:
+    gather_subset:
+      - "!all"
+      - "pkg_mgr"
+      - "distribution"
+      - "distribution_release"
+      - "distribution_version"
+      - "distribution_major_version"
+
+- name: Ensure system packages are present (apt)
+  ansible.builtin.apt:
+    name: "{{ package }}"
+    state: "{{ pretix_state }}"
+  loop: "{{ pretix_packages[ansible_distribution | lower] }}"
+  loop_control:
+    loop_var: "package"
+  when: ansible_facts['pkg_mgr'] == 'apt'

roles/pretix/tasks/prepare.yml

@@ -0,0 +1,29 @@
+---
+- name: Ensure pretix user '{{ pretix_user }}' is {{ pretix_state }}
+  ansible.builtin.user:
+    name: "{{ pretix_user }}"
+    state: "{{ pretix_state }}"
+    system: "{{ pretix_user_system }}"
+    create_home: "{{ pretix_user_create_home }}"
+  register: pretix_user_info
+
+- name: Ensure host directories are {{ pretix_state }}
+  ansible.builtin.file:
+    path: "{{ item.path }}"
+    owner: "{{ item.owner | default(pretix_user_id) }}"
+    group: "{{ item.group | default(pretix_group_id) }}"
+    mode: "{{ item.mode | default('0750') }}"
+    state: "directory"
+  loop:
+    - path: "{{ pretix_config_dir }}"
+    - path: "{{ pretix_virtualenv_dir }}"
+    - path: "{{ pretix_data_dir }}"
+    - path: "{{ pretix_media_dir }}"
+  when: pretix_state == 'present'
+
+- name: Ensure deployment-type specific preparations for '{{ pretix_deployment_method }}' are run
+  ansible.builtin.include_tasks:
+    file: "prepare-{{ pretix_deployment_method }}.yml"
+  when:
+    - pretix_state == 'present'
+    - pretix_deployment_method in ['systemd']

roles/pretix/templates/pretix.service.j2

@@ -0,0 +1,16 @@
+[Unit]
+Description={{ pretix_systemd_unit_description }}
+After={{ pretix_systemd_unit_after }}
+
+[Service]
+User={{ pretix_systemd_service_user }}
+Group={{ pretix_systemd_service_group }}
+{% for kv in pretix_systemd_service_environment | dict2items %}
+Environment="{{ kv.key }}={{ kv.value }}"
+{% endfor %}
+WorkingDirectory={{ pretix_systemd_service_working_directory }}
+ExecStart={{ pretix_systemd_service_exec_start }}
+Restart={{ pretix_systemd_service_restart }}
+
+[Install]
+WantedBy={{ pretix_systemd_install_wanted_by }}

roles/pretix/vars/main.yml

@@ -0,0 +1,7 @@
+---
+pretix_states:
+  - "present"
+  - "absent"
+
+pretix_deployment_methods:
+  - "systemd"

roles/unifi_controller/README.md

@@ -1,16 +0,0 @@
-# `finallycoffee.services.unifi_controller` ansible role
-
-Deploy [`jacobalberty/unifi-docker`](https://github.com/jacobalberty/unifi-docker)
-using either `docker` or `podman` (configure using
-`unifi_controller_deployment_method`).
-
-## Configuration
-
-Change the default bind IP of `::` by setting
-`unifi_controller_bind_ip`. By default, the ports
-`1900/udp` (SSDP), `3478/udp` (STUN), `10001/udp`,
-`8080/tcp` (HTTP), `8443/tcp` (HTTPS) and `6789/tcp`
-are exposed.
-
-For more information on which ports are needed when, see
-[Unifi's required ports reference](https://help.ui.com/hc/en-us/articles/218506997-Required-Ports-Reference).

roles/unifi_controller/defaults/main/container.yml

@@ -1,41 +0,0 @@
----
-unifi_controller_container_name: "unifi-controller"
-unifi_controller_container_image_registry: "docker.io"
-unifi_controller_container_image_namespace: "jacobalberty"
-unifi_controller_container_image_repository: "unifi"
-unifi_controller_container_image_tag: ~
-unifi_controller_container_image_name: >-2
-  {{ [
-    unifi_controller_container_image_registry | default([]),
-    unifi_controller_container_image_namespace | default([]),
-    unifi_controller_container_image_repository
-  ] | flatten | join('/') }}
-unifi_controller_container_image: >-2
-  {{ [
-    unifi_controller_container_image_name,
-    unifi_controller_container_image_tag | default('v' + unifi_controller_version, true)
-  ] | join(':') }}
-unifi_controller_container_image_source: "pull"
-unifi_controller_container_image_force_source: >-2
-  {{ unifi_controller_container_image_tag | default(false, true) | bool }}
-unifi_controller_container_image_pull: >-2
-  {{ unifi_controller_container_image_source == 'pull' }}
-unifi_controller_container_image_force_pull: >-2
-  {{ unifi_controller_container_image_pull and unifi_controller_container_image_force_source }}
-unifi_controller_container_ports:
-  - "{{ unifi_controller_bind_ip }}:8080:8080/tcp" # HTTP: device + app communication
-  - "{{ unifi_controller_bind_ip }}:8443:8443/tcp" # HTTPS: app web page + API
-  - "{{ unifi_controller_bind_ip }}:1900:1900/udp" # SSDP: layer 2 discovery
-  - "{{ unifi_controller_bind_ip }}:3478:3478/udp" # STUN: device adoption and communication
-  - "{{ unifi_controller_bind_ip }}:10001:10001/udp" # device discovery (during adoption)
-unifi_controller_container_user: >-2
-  {{ unifi_controller_run_uid }}:{{ unifi_controller_run_gid }}
-unifi_controller_container_restart_policy: "on-failure"
-unifi_controller_container_default_volumes:
-  - "{{ unifi_controller_base_path }}:/unifi:rw"
-unifi_controller_container_volumes: []
-unifi_controller_container_merged_volumes: >-2
-  {{ unifi_controller_container_default_volumes | default([])
-  + unifi_controller_container_volumes | default([]) }}
-unifi_controller_container_state: >-2
-  {{ (unifi_controller_state == 'present') | ternary('started', 'absent') }}

roles/unifi_controller/defaults/main/main.yml

@@ -1,9 +0,0 @@
----
-unifi_controller_version: "9.4.19"
-unifi_controller_base_path: "/var/lib/unifi-controller"
-unifi_controller_log_path: "{{ unifi_controller_base_path }}/log"
-unifi_controller_data_path: "{{ unifi_controller_base_path }}/data"
-unifi_controller_bind_ip: "::"
-
-unifi_controller_state: "present"
-unifi_controller_deployment_method: "docker"

roles/unifi_controller/defaults/main/user.yml

@@ -1,8 +0,0 @@
----
-unifi_controller_user: unifi
-unifi_controller_user_create_home: false
-unifi_controller_user_system: true
-unifi_controller_run_uid: >-2
-  {{ unifi_controller_user_info.uid | default(unifi_controller_user) }}
-unifi_controller_run_gid: >-2
-  {{ unifi_controller_user_info.group | default(unifi_controller_user) }}

roles/unifi_controller/meta/main.yml

@@ -1,11 +0,0 @@
----
-allow_duplicates: true
-dependencies: []
-galaxy_info:
-  role_name: unifi_controller
-  description: Ansible role to deploy unifi (network) controller in a container
-  galaxy_tags:
-    - unifi
-    - unifi_controller
-    - docker
-    - podman

roles/unifi_controller/tasks/deploy-docker.yml

@@ -1,17 +0,0 @@
----
-- name: Ensure container image '{{ unifi_controller_container_image }}' is {{ unifi_controller_state }}
-  community.docker.docker_image:
-    name: "{{ unifi_controller_container_image }}"
-    state: "{{ unifi_controller_state }}"
-    source: "{{ unifi_controller_container_image_source }}"
-    force_source: "{{ unifi_controller_container_image_force_source }}"
-
-- name: Ensure container '{{ unifi_controller_container_name }}' is {{ unifi_controller_container_state }}
-  community.docker.docker_container:
-    name: "{{ unifi_controller_container_name }}"
-    image: "{{ unifi_controller_container_image }}"
-    user: "{{ unifi_controller_container_user }}"
-    ports: "{{ unifi_controller_container_ports }}"
-    volumes: "{{ unifi_controller_container_merged_volumes }}"
-    restart_policy: "{{ unifi_controller_container_restart_policy }}"
-    state: "{{ unifi_controller_container_state }}"

roles/unifi_controller/tasks/deploy-podman.yml

@@ -1,17 +0,0 @@
----
-- name: Ensure container image '{{ unifi_controller_container_image }}' is {{ unifi_controller_state }}
-  containers.podman.podman_image:
-    name: "{{ unifi_controller_container_image }}"
-    state: "{{ unifi_controller_state }}"
-    pull: "{{ unifi_controller_container_image_pull }}"
-    force: "{{ unifi_controller_container_image_force_pull }}"
-
-- name: Ensure container '{{ unifi_controller_container_name }}' is {{ unifi_controller_container_state }}
-  containers.podman.podman_container:
-    name: "{{ unifi_controller_container_name }}"
-    image: "{{ unifi_controller_container_image }}"
-    user: "{{ unifi_controller_container_user }}"
-    ports: "{{ unifi_controller_container_ports }}"
-    volumes: "{{ unifi_controller_container_merged_volumes }}"
-    restart_policy: "{{ unifi_controller_container_restart_policy }}"
-    state: "{{ unifi_controller_container_state }}"

roles/unifi_controller/tasks/main.yml

@@ -1,18 +0,0 @@
----
-- name: Ensure unifi controller run user '{{ unifi_controller_user }}' is {{ unifi_controller_state }}
-  ansible.builtin.user:
-    name: "{{ unifi_controller_user }}"
-    state: "{{ unifi_controller_state }}"
-  register: unifi_controller_user_info
-
-- name: Ensure unifi controller base path '{{ unifi_controller_base_path }}' is {{ unifi_controller_state }}
-  ansible.builtin.file:
-    path: "{{ unifi_controller_base_path }}"
-    state: "{{ (unifi_controller_state == 'present') | ternary('directory', 'absent') }}"
-    owner: "{{ unifi_controller_run_uid }}"
-    group: "{{ unifi_controller_run_gid }}"
-    mode: "0755"
-
-- name: Deploy unifi controller with {{ unifi_controller_deployment_method }}
-  ansible.builtin.include_tasks:
-    file: "deploy-{{ unifi_controller_deployment_method }}.yml"

roles/unifi_controller/vars/main.yml

@@ -1,7 +0,0 @@
----
-unifi_controller_states:
-  - "present"
-  - "absent"
-unifi_controller_deployment_methods:
-  - "docker"
-  - "podman"