Major architectural change from rootless user services to system-level (rootful) containers to enable group-based Unix socket access for containerized applications. Infrastructure Changes: - PostgreSQL: Export postgres-clients group GID as Ansible fact - Valkey: Export valkey-clients group GID as Ansible fact - Valkey: Add socket-fix service to maintain correct socket group ownership - Both: Set socket directories to 770 with client group ownership Authentik Role Refactoring: - Remove rootless container configuration (subuid/subgid, lingering, user systemd) - Deploy Quadlet files to /etc/containers/systemd/ (system-level) - Use dynamic GID facts in container PodmanArgs (--group-add) - Simplify user creation to system user with infrastructure group membership - Update handlers for system scope service management - Remove unnecessary container security options (no user namespace isolation) Container Template Changes: - Pod: Remove --userns args, change WantedBy to multi-user.target - Containers: Replace Annotation with PodmanArgs using dynamic GIDs - Remove /dev/shm mounts and SecurityLabelDisable (not needed for rootful) - Change WantedBy to multi-user.target for system services Documentation Updates: - Add ADR-005: Rootful Containers with Infrastructure Fact Pattern - Update ADR-003: Podman + systemd for system-level deployment - Update authentik-deployment-guide.md for system scope commands - Update service-integration-guide.md with rootful pattern examples - Document discarded rootless approach and rationale Why Rootful Succeeds: - Direct UID/GID mapping preserves supplementary groups - Container process groups match host socket group ownership - No user namespace remapping breaking permissions Why Rootless Failed (Discarded): - User namespace UID/GID remapping broke group-based socket access - Supplementary groups remapped into subgid range didn't match socket ownership - Even with --userns=host and keep_original_groups, permissions failed Pattern Established: - Infrastructure roles create client groups and export GID facts - Application roles validate facts and consume in container templates - Rootful containers run as dedicated users with --group-add for socket access - System-level deployment provides standard systemd service management Deployment Validated: - Services in /system.slice/ ✓ - Process groups: 961 (valkey-clients), 962 (postgres-clients), 966 (authentik) ✓ - Socket permissions: 770 with client groups ✓ - HTTP endpoint responding ✓
150 lines
4.0 KiB
YAML
150 lines
4.0 KiB
YAML
---
|
|
# Authentik Authentication Role - Main Tasks
|
|
# Self-contained deployment with Podman and Unix sockets
|
|
|
|
- name: Validate infrastructure facts are available
|
|
assert:
|
|
that:
|
|
- postgresql_client_group_gid is defined
|
|
- valkey_client_group_gid is defined
|
|
fail_msg: |
|
|
Required infrastructure facts are not available.
|
|
Ensure PostgreSQL and Valkey roles have run and exported client group GIDs.
|
|
tags: [validation]
|
|
|
|
- name: Setup authentik user and container namespaces
|
|
include_tasks: user.yml
|
|
tags: [user, setup]
|
|
|
|
- name: Setup database access and permissions
|
|
include_tasks: database.yml
|
|
tags: [database, setup]
|
|
|
|
- name: Setup cache access and permissions
|
|
include_tasks: cache.yml
|
|
tags: [cache, setup]
|
|
|
|
- name: Pull authentik container image
|
|
containers.podman.podman_image:
|
|
name: "{{ authentik_image }}:{{ authentik_version }}"
|
|
state: present
|
|
tags: [containers, image-pull]
|
|
|
|
- name: Create media directory structure
|
|
file:
|
|
path: "{{ authentik_media_dir }}/{{ item }}"
|
|
state: directory
|
|
owner: "{{ authentik_user }}"
|
|
group: "{{ authentik_group }}"
|
|
mode: '0755'
|
|
loop:
|
|
- public
|
|
- private
|
|
tags: [setup, media]
|
|
|
|
- name: Deploy environment configuration
|
|
template:
|
|
src: authentik.env.j2
|
|
dest: "{{ authentik_home }}/.env"
|
|
owner: "{{ authentik_user }}"
|
|
group: "{{ authentik_group }}"
|
|
mode: '0600'
|
|
backup: true
|
|
notify:
|
|
- restart authentik pod
|
|
- restart authentik server
|
|
- restart authentik worker
|
|
tags: [config]
|
|
|
|
- name: Create Quadlet systemd directory (system scope)
|
|
file:
|
|
path: /etc/containers/systemd
|
|
state: directory
|
|
mode: '0755'
|
|
|
|
- name: Deploy Quadlet pod and container files (system scope)
|
|
template:
|
|
src: "{{ item.src }}"
|
|
dest: "/etc/containers/systemd/{{ item.dest }}"
|
|
mode: '0644'
|
|
loop:
|
|
- { src: 'authentik.pod', dest: 'authentik.pod' }
|
|
- { src: 'authentik-server.container', dest: 'authentik-server.container' }
|
|
- { src: 'authentik-worker.container', dest: 'authentik-worker.container' }
|
|
notify:
|
|
- reload systemd
|
|
- restart authentik pod
|
|
- restart authentik server
|
|
- restart authentik worker
|
|
tags: [containers, deployment]
|
|
|
|
- name: Deploy Caddy configuration
|
|
template:
|
|
src: authentik.caddy.j2
|
|
dest: "{{ caddy_sites_enabled_dir }}/authentik.caddy"
|
|
owner: root
|
|
group: "{{ caddy_user }}"
|
|
mode: '0644'
|
|
backup: true
|
|
notify: reload caddy
|
|
tags: [caddy, reverse-proxy]
|
|
|
|
- name: Ensure system dependencies are running
|
|
systemd:
|
|
name: "{{ item }}"
|
|
state: started
|
|
loop:
|
|
- postgresql
|
|
- valkey
|
|
register: system_deps
|
|
|
|
- name: Wait for PostgreSQL socket to be ready
|
|
wait_for:
|
|
path: "{{ postgresql_unix_socket_directories }}/.s.PGSQL.{{ postgresql_port }}"
|
|
timeout: 30
|
|
when: postgresql_unix_socket_enabled
|
|
|
|
- name: Wait for Valkey socket to be ready
|
|
wait_for:
|
|
path: "{{ valkey_unix_socket_path }}"
|
|
timeout: 30
|
|
when: valkey_unix_socket_enabled
|
|
|
|
- name: Enable and start Authentik pod (system scope)
|
|
systemd:
|
|
name: "authentik-pod"
|
|
enabled: "{{ authentik_service_enabled }}"
|
|
state: "{{ authentik_service_state }}"
|
|
daemon_reload: true
|
|
tags: [containers, service]
|
|
|
|
- name: Wait for Authentik to be ready
|
|
uri:
|
|
url: "http://127.0.0.1:{{ authentik_http_port }}/"
|
|
method: GET
|
|
status_code: [200, 302]
|
|
timeout: 30
|
|
retries: 10
|
|
delay: 15
|
|
register: authentik_health_check
|
|
tags: [verification, health-check]
|
|
|
|
- name: Display Authentik deployment status
|
|
debug:
|
|
msg: |
|
|
✅ Authentik Authentication deployed successfully!
|
|
|
|
🌐 Domain: {{ authentik_domain }}
|
|
🗄️ Database: {{ authentik_db_name }} (Unix socket)
|
|
🗄️ Cache: Valkey DB {{ authentik_valkey_db }} (Unix socket)
|
|
🐳 Containers: Pod with server + worker
|
|
🔒 Admin: {{ authentik_default_admin_email }}
|
|
|
|
🚀 Ready for SSO configuration!
|
|
|
|
📋 Next Steps:
|
|
- Access {{ authentik_domain }} to complete setup
|
|
- Configure applications and providers
|
|
- Set up SSO for services
|
|
tags: [verification]
|