Compare commits
	
		
			2 Commits
		
	
	
		
			main
			...
			transcaffe
		
	
	| Author | SHA1 | Date | |
|---|---|---|---|
| 
						
						
							
						
						fb13bd55bf
	
				 | 
					
					
						|||
| 
						
						
							
						
						c31e13a975
	
				 | 
					
					
						
							
								
								
									
										19
									
								
								README.md
									
									
									
									
									
								
							
							
						
						
									
										19
									
								
								README.md
									
									
									
									
									
								
							@@ -5,25 +5,6 @@
 | 
				
			|||||||
This ansible collection provides various roles for installing
 | 
					This ansible collection provides various roles for installing
 | 
				
			||||||
and configuring basic system utilities like gnupg, ssh etc
 | 
					and configuring basic system utilities like gnupg, ssh etc
 | 
				
			||||||
 | 
					
 | 
				
			||||||
- [`git`](roles/git/README.md): configures git on the target system
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- [`gnupg`](roles/gnupg/README.md): configures gnupg on the target system
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- [`lego`](roles/lego/README.md): runs [lego (LetsEncrypt Go)](https://github.com/go-acme/lego),
 | 
					 | 
				
			||||||
  a ACME client written in go, using systemd (timers). Multi-instance capable.
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- [`minio`](roles/minio/README.md): Deploy [min.io](https://min.io), an
 | 
					 | 
				
			||||||
  s3-compatible object storage server, using docker containers.
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- [`nginx`](roles/nginx/README.md): [nginx](https://www.nginx.com/),
 | 
					 | 
				
			||||||
  an advanced load balancer, webserver and reverse proxy.
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- [`restic`](roles/restic/README.md): Manage backups using restic
 | 
					 | 
				
			||||||
  and persist them to a configurable backend.
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- [`powerdns_tsig_key`](roles/powerdns_tsig_key/README.md): Simple ansible role
 | 
					 | 
				
			||||||
  for generating TSIG keys in PowerDNS.
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
## License
 | 
					## License
 | 
				
			||||||
 | 
					
 | 
				
			||||||
[CNPLv7+](LICENSE.md): Cooperative Nonviolent Public License
 | 
					[CNPLv7+](LICENSE.md): Cooperative Nonviolent Public License
 | 
				
			||||||
 
 | 
				
			|||||||
							
								
								
									
										28
									
								
								galaxy.yml
									
									
									
									
									
								
							
							
						
						
									
										28
									
								
								galaxy.yml
									
									
									
									
									
								
							@@ -1,29 +1,13 @@
 | 
				
			|||||||
namespace: finallycoffee
 | 
					namespace: finallycoffee
 | 
				
			||||||
name: base
 | 
					name: base
 | 
				
			||||||
version: 0.4.0
 | 
					version: 0.0.1
 | 
				
			||||||
readme: README.md
 | 
					readme: README.md
 | 
				
			||||||
authors:
 | 
					authors:
 | 
				
			||||||
- transcaffeine <transcaffeine@finally.coffee>
 | 
					- Johanna Dorothea Reichmann <transcaffeine@finally.coffee>
 | 
				
			||||||
description: >-2
 | 
					description: Roles for bootstrapping tools like gpg, ssh and git
 | 
				
			||||||
  Roles for base services which are core functionality like managing packages
 | 
					license:
 | 
				
			||||||
  and ssh or common dependencies other services like databases
 | 
					- CNPLv7+
 | 
				
			||||||
dependencies:
 | 
					 | 
				
			||||||
  "community.docker": "^4.7.0"
 | 
					 | 
				
			||||||
  "community.general": "^11.1.2"
 | 
					 | 
				
			||||||
  "containers.podman": "^1.17.0"
 | 
					 | 
				
			||||||
license_file: LICENSE.md
 | 
					 | 
				
			||||||
build_ignore:
 | 
					build_ignore:
 | 
				
			||||||
- '*.tar.gz'
 | 
					- '*.tar.gz'
 | 
				
			||||||
repository: https://git.finally.coffee/finallycoffee/base
 | 
					repository: https://git.finally.coffee/finallycoffee/base
 | 
				
			||||||
issues: https://codeberg.org/finallycoffee/ansible-collection-base/issues
 | 
					issues: https://git.finally.coffee/finallycoffee/base/issues
 | 
				
			||||||
tags:
 | 
					 | 
				
			||||||
  - bootstrap
 | 
					 | 
				
			||||||
  - ssh
 | 
					 | 
				
			||||||
  - mosh
 | 
					 | 
				
			||||||
  - docker
 | 
					 | 
				
			||||||
  - lego
 | 
					 | 
				
			||||||
  - minio
 | 
					 | 
				
			||||||
  - nginx
 | 
					 | 
				
			||||||
  - restic
 | 
					 | 
				
			||||||
  - user_management
 | 
					 | 
				
			||||||
  - openldap
 | 
					 | 
				
			||||||
 
 | 
				
			|||||||
@@ -1,3 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
requires_ansible: ">=2.15"
 | 
					 | 
				
			||||||
@@ -1,78 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
- name: Bootstrap everything needed for an ansible connection
 | 
					 | 
				
			||||||
  hosts: "{{ target_hosts | default('all', true) }}"
 | 
					 | 
				
			||||||
  become: "{{ target_host_become | default(true, false) }}"
 | 
					 | 
				
			||||||
  gather_facts: false
 | 
					 | 
				
			||||||
  pre_tasks:
 | 
					 | 
				
			||||||
    - name: Gather information about the target system id
 | 
					 | 
				
			||||||
      ansible.builtin.raw: "cat /etc/os-release | grep '^ID=' | cut -d '=' -f2"
 | 
					 | 
				
			||||||
      register: target_host_os_info
 | 
					 | 
				
			||||||
      check_mode: false
 | 
					 | 
				
			||||||
      changed_when: false
 | 
					 | 
				
			||||||
    - name: Set /etc/os-release system id
 | 
					 | 
				
			||||||
      ansible.builtin.set_fact:
 | 
					 | 
				
			||||||
        target_host_system_id: "{{ target_host_os_info.stdout_lines | first | trim }}"
 | 
					 | 
				
			||||||
      delegate_to: localhost
 | 
					 | 
				
			||||||
    - name: Gather information about the target system version
 | 
					 | 
				
			||||||
      ansible.builtin.raw: "cat /etc/os-release | grep '^VERSION_ID=' | cut -d '=' -f2"
 | 
					 | 
				
			||||||
      register: target_host_os_info_version
 | 
					 | 
				
			||||||
      check_mode: false
 | 
					 | 
				
			||||||
      changed_when: false
 | 
					 | 
				
			||||||
    - name: Set /etc/os-release system version id
 | 
					 | 
				
			||||||
      ansible.builtin.set_fact:
 | 
					 | 
				
			||||||
        target_host_system_version_id: "{{ target_host_os_info_version.stdout_lines | first | trim }}"
 | 
					 | 
				
			||||||
      delegate_to: localhost
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
  tasks:
 | 
					 | 
				
			||||||
    - name: Ensure apt bootstrap packages are installed
 | 
					 | 
				
			||||||
      ansible.builtin.raw: "apt install {{ apt_bootstrap_packages | join(' ') }}"
 | 
					 | 
				
			||||||
      register: target_host_apt_info
 | 
					 | 
				
			||||||
      when: target_host_system_id in targets_using_apt
 | 
					 | 
				
			||||||
      changed_when:
 | 
					 | 
				
			||||||
        - "'0 upgraded' not in target_host_apt_info.stdout_lines | last"
 | 
					 | 
				
			||||||
        - "'0 newly installed' not in target_host_apt_info.stdout_lines | last"
 | 
					 | 
				
			||||||
    - name: Ensure dnf < 4 bootstrap packages are installed
 | 
					 | 
				
			||||||
      ansible.builtin.raw: "dnf install --assumeyes {{ dnf4_bootstrap_packages | join(' ') }}"
 | 
					 | 
				
			||||||
      register: target_host_dnf_info
 | 
					 | 
				
			||||||
      when:
 | 
					 | 
				
			||||||
        - target_host_system_id in targets_using_dnf4.keys()
 | 
					 | 
				
			||||||
        - target_host_system_version_id | int < targets_using_dnf4[target_host_system_id]
 | 
					 | 
				
			||||||
      changed_when:
 | 
					 | 
				
			||||||
        - "(target_host_dnf_info.stdout_lines | last) != 'Nothing to do.'"
 | 
					 | 
				
			||||||
    - name: Ensure dnf5 bootstrap packages are installed
 | 
					 | 
				
			||||||
      ansible.builtin.raw: "dnf install --assumeyes {{ dnf5_bootstrap_packages | join(' ') }}"
 | 
					 | 
				
			||||||
      register: target_host_dnf_info
 | 
					 | 
				
			||||||
      when:
 | 
					 | 
				
			||||||
        - target_host_system_id in targets_using_dnf5.keys()
 | 
					 | 
				
			||||||
        - target_host_system_version_id | int >= targets_using_dnf5[target_host_system_id]
 | 
					 | 
				
			||||||
      changed_when:
 | 
					 | 
				
			||||||
        - "(target_host_dnf_info.stdout_lines | last) != 'Nothing to do.'"
 | 
					 | 
				
			||||||
    - name: Sort hosts into os-specific groups
 | 
					 | 
				
			||||||
      ansible.builtin.group_by:
 | 
					 | 
				
			||||||
        key: >-2
 | 
					 | 
				
			||||||
          {{ (os_group_prefix
 | 
					 | 
				
			||||||
             | default(false, true)
 | 
					 | 
				
			||||||
             | ternary(os_group_prefix | default('') + (os_group_seperator | default('_')), ''))
 | 
					 | 
				
			||||||
             + target_host_system_id }}
 | 
					 | 
				
			||||||
      when: target_hosts_sort_into_system_ids | default(false, true)
 | 
					 | 
				
			||||||
      changed_when: false
 | 
					 | 
				
			||||||
      delegate_to: localhost
 | 
					 | 
				
			||||||
  vars:
 | 
					 | 
				
			||||||
    targets_using_apt:
 | 
					 | 
				
			||||||
      - debian
 | 
					 | 
				
			||||||
      - ubuntu
 | 
					 | 
				
			||||||
    apt_bootstrap_packages:
 | 
					 | 
				
			||||||
      - python3
 | 
					 | 
				
			||||||
      - python3-apt
 | 
					 | 
				
			||||||
    # default package manager is dnf5 since fedora 41
 | 
					 | 
				
			||||||
    # https://fedoraproject.org/wiki/Changes/SwitchToDnf5#Current_status
 | 
					 | 
				
			||||||
    targets_using_dnf4:
 | 
					 | 
				
			||||||
      fedora: 41
 | 
					 | 
				
			||||||
    targets_using_dnf5:
 | 
					 | 
				
			||||||
      fedora: 41
 | 
					 | 
				
			||||||
    dnf4_bootstrap_packages:
 | 
					 | 
				
			||||||
      - python3
 | 
					 | 
				
			||||||
      - python3-dnf
 | 
					 | 
				
			||||||
      - python3-libdnf
 | 
					 | 
				
			||||||
    dnf5_bootstrap_packages:
 | 
					 | 
				
			||||||
      - python3-libdnf5
 | 
					 | 
				
			||||||
@@ -1,6 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
- name: Install and configure docker daemon
 | 
					 | 
				
			||||||
  hosts: "{{ docker_hosts | default('docker', true) }}"
 | 
					 | 
				
			||||||
  become: "{{ docker_become | default(false, true) }}"
 | 
					 | 
				
			||||||
  roles:
 | 
					 | 
				
			||||||
    - role: finallycoffee.base.docker
 | 
					 | 
				
			||||||
@@ -1,16 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
- name: Manage docker registry credentials
 | 
					 | 
				
			||||||
  hosts: "{{ docker_hosts | default('docker', true) }}"
 | 
					 | 
				
			||||||
  become: "{{ docker_become | default(false) }}"
 | 
					 | 
				
			||||||
  gather_facts: "{{ docker_registry_gather_facts | default(true) }}"
 | 
					 | 
				
			||||||
  tasks:
 | 
					 | 
				
			||||||
    - name: Manage docker registry credentials
 | 
					 | 
				
			||||||
      community.docker.docker_login:
 | 
					 | 
				
			||||||
        registry_url: "{{ docker_registry.registry }}"
 | 
					 | 
				
			||||||
        username: "{{ docker_registry.username | default(omit) }}"
 | 
					 | 
				
			||||||
        password: "{{ docker_registry.password | default(omit) }}"
 | 
					 | 
				
			||||||
        state: "{{ docker_registry.state | default('present') }}"
 | 
					 | 
				
			||||||
      loop: "{{ docker_registries | default([], true) }}"
 | 
					 | 
				
			||||||
      loop_control:
 | 
					 | 
				
			||||||
        loop_var: "docker_registry"
 | 
					 | 
				
			||||||
        label: "{{ docker_registry.username}}@{{ docker_registry.registry }}"
 | 
					 | 
				
			||||||
@@ -1,109 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
- name: Configure LDAP directory information tree
 | 
					 | 
				
			||||||
  hosts: "{{ ldap_hosts | default('ldap') }}"
 | 
					 | 
				
			||||||
  become: "{{ ldap_become | default(false) }}"
 | 
					 | 
				
			||||||
  gather_facts: "{{ ldap_gather_facts | default(false) }}"
 | 
					 | 
				
			||||||
  vars:
 | 
					 | 
				
			||||||
    _state: "{{ ldap_state | default('present') }}"
 | 
					 | 
				
			||||||
    _ldap_bind_info: &ldap_bind_info
 | 
					 | 
				
			||||||
      server_uri: "{{ ldap_server_uri }}"
 | 
					 | 
				
			||||||
      bind_dn: "{{ ldap_bind_dn }}"
 | 
					 | 
				
			||||||
      bind_pw: "{{ ldap_bind_pw }}"
 | 
					 | 
				
			||||||
  roles:
 | 
					 | 
				
			||||||
    # Ensure all defaults from openldap role are in scope
 | 
					 | 
				
			||||||
    - role: finallycoffee.base.openldap
 | 
					 | 
				
			||||||
      when: false
 | 
					 | 
				
			||||||
  tasks:
 | 
					 | 
				
			||||||
    - name: Ensure org units in '{{ ldap_base_dn }}' are {{ _state }}
 | 
					 | 
				
			||||||
      community.general.ldap_entry:
 | 
					 | 
				
			||||||
        <<: *ldap_bind_info
 | 
					 | 
				
			||||||
        dn: "ou={{ org_unit }},{{ ldap_base_dn }}"
 | 
					 | 
				
			||||||
        objectClass: "organizationalUnit"
 | 
					 | 
				
			||||||
        state: "{{ _state }}"
 | 
					 | 
				
			||||||
      loop: "{{ ldap_org_units | default([], true) }}"
 | 
					 | 
				
			||||||
      loop_control:
 | 
					 | 
				
			||||||
        loop_var: org_unit
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
    - name: Ensure admin user is {{ _state }}
 | 
					 | 
				
			||||||
      community.general.ldap_entry:
 | 
					 | 
				
			||||||
        <<: *ldap_bind_info
 | 
					 | 
				
			||||||
        dn: "uid={{ ldap_admin_user_rdn }},{{ ldap_admin_user_base }}"
 | 
					 | 
				
			||||||
        objectClass: "{{ ldap_admin_user_object_classes }}"
 | 
					 | 
				
			||||||
        attributes: "{{ ldap_admin_user_attributes }}"
 | 
					 | 
				
			||||||
        state: "{{ _state }}"
 | 
					 | 
				
			||||||
      vars:
 | 
					 | 
				
			||||||
        ldap_admin_user_base: >-2
 | 
					 | 
				
			||||||
          {{ ldap_admin_user_base_dn | default(ldap_base_dn, true) }}
 | 
					 | 
				
			||||||
      when: ldap_admin_user_rdn is defined
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
    - name: Ensure admin user attributes are correct
 | 
					 | 
				
			||||||
      community.general.ldap_attrs:
 | 
					 | 
				
			||||||
        <<: *ldap_bind_info
 | 
					 | 
				
			||||||
        dn: "uid={{ ldap_admin_user_rdn }},{{ ldap_admin_user_base }}"
 | 
					 | 
				
			||||||
        attributes: "{{ ldap_admin_user_attributes }}"
 | 
					 | 
				
			||||||
        state: "{{ _state }}"
 | 
					 | 
				
			||||||
      vars:
 | 
					 | 
				
			||||||
        ldap_admin_user_base: >-2
 | 
					 | 
				
			||||||
          {{ ldap_admin_user_base_dn | default(ldap_base_dn, true) }}
 | 
					 | 
				
			||||||
      when:
 | 
					 | 
				
			||||||
        - ldap_admin_user_rdn is defined
 | 
					 | 
				
			||||||
        - _state == 'present'
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
    - name: Ensure ldap groups are {{ _state }}
 | 
					 | 
				
			||||||
      community.general.ldap_entry:
 | 
					 | 
				
			||||||
        <<: *ldap_bind_info
 | 
					 | 
				
			||||||
        dn: "{{ _ldap_group_dn }}"
 | 
					 | 
				
			||||||
        objectClass: "{{ _ldap_group_object_classes }}"
 | 
					 | 
				
			||||||
        attributes: "{{ _ldap_group_attributes }}"
 | 
					 | 
				
			||||||
        state: "{{ _state }}"
 | 
					 | 
				
			||||||
      vars:
 | 
					 | 
				
			||||||
        _ldap_group_dn: >-2
 | 
					 | 
				
			||||||
          cn={{ _ldap_group.name }},{{ ldap_group_base_dn }}
 | 
					 | 
				
			||||||
        _ldap_group_object_classes:
 | 
					 | 
				
			||||||
          - "groupOfNames"
 | 
					 | 
				
			||||||
        _ldap_group_attributes:
 | 
					 | 
				
			||||||
          cn: "{{ _ldap_group.name }}"
 | 
					 | 
				
			||||||
          member: >-2
 | 
					 | 
				
			||||||
            {{ _ldap_group.members | default([]) }}
 | 
					 | 
				
			||||||
      loop: "{{ ldap_groups | default([], true) }}"
 | 
					 | 
				
			||||||
      loop_control:
 | 
					 | 
				
			||||||
        loop_var: _ldap_group
 | 
					 | 
				
			||||||
        label: "{{ _ldap_group.name }}"
 | 
					 | 
				
			||||||
      when:
 | 
					 | 
				
			||||||
        - ldap_groups is defined
 | 
					 | 
				
			||||||
        - ldap_group_base_dn is defined
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
    - name: Ensure service accounts are {{ _state }}
 | 
					 | 
				
			||||||
      community.general.ldap_entry:
 | 
					 | 
				
			||||||
        <<: *ldap_bind_info
 | 
					 | 
				
			||||||
        dn: "{{ _ldap_service_account_dn }}"
 | 
					 | 
				
			||||||
        objectClass: "{{ _ldap_service_account_object_classes }}"
 | 
					 | 
				
			||||||
        attributes: "{{ _ldap_service_account_attributes }}"
 | 
					 | 
				
			||||||
        state: "{{ _state }}"
 | 
					 | 
				
			||||||
      loop: &ldap_service_account_loop "{{ ldap_service_accounts | default([]) }}"
 | 
					 | 
				
			||||||
      loop_control: &ldap_service_account_loop_control
 | 
					 | 
				
			||||||
        loop_var: "_ldap_service_account"
 | 
					 | 
				
			||||||
        label: "{{ _ldap_service_account.name }}"
 | 
					 | 
				
			||||||
      vars: &ldap_service_account_vars
 | 
					 | 
				
			||||||
        _ldap_service_account_dn: >-2
 | 
					 | 
				
			||||||
          uid={{ _ldap_service_account.name }},{{ ldap_service_account_base_dn }}
 | 
					 | 
				
			||||||
        _ldap_service_account_object_classes:
 | 
					 | 
				
			||||||
          - "account"
 | 
					 | 
				
			||||||
          - "simpleSecurityObject"
 | 
					 | 
				
			||||||
        _ldap_service_account_attributes:
 | 
					 | 
				
			||||||
          uid: "{{ _ldap_service_account.name }}"
 | 
					 | 
				
			||||||
          userPassword: "{{ _ldap_service_account.password }}"
 | 
					 | 
				
			||||||
      when: &ldap_service_account_when
 | 
					 | 
				
			||||||
        - ldap_service_accounts is defined
 | 
					 | 
				
			||||||
        - ldap_service_account_base_dn is defined
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
    - name: Ensure service accounts attributes are correct
 | 
					 | 
				
			||||||
      community.general.ldap_attrs:
 | 
					 | 
				
			||||||
        <<: *ldap_bind_info
 | 
					 | 
				
			||||||
        dn: "{{ _ldap_service_account_dn }}"
 | 
					 | 
				
			||||||
        attributes: "{{ _ldap_service_account_attributes }}"
 | 
					 | 
				
			||||||
        state: exact
 | 
					 | 
				
			||||||
      loop: *ldap_service_account_loop
 | 
					 | 
				
			||||||
      loop_control: *ldap_service_account_loop_control
 | 
					 | 
				
			||||||
      vars: *ldap_service_account_vars
 | 
					 | 
				
			||||||
      when: *ldap_service_account_when
 | 
					 | 
				
			||||||
@@ -1,85 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
- name: Populate DNS, acquire TSIG key and obtain certificate
 | 
					 | 
				
			||||||
  hosts: "{{ target_hosts | default('all') }}"
 | 
					 | 
				
			||||||
  become: "{{ target_become | default(true) }}"
 | 
					 | 
				
			||||||
  gather_facts: "{{ target_gather_facts | default(false) }}"
 | 
					 | 
				
			||||||
  pre_tasks:
 | 
					 | 
				
			||||||
    - name: Build target dns records
 | 
					 | 
				
			||||||
      ansible.builtin.set_fact:
 | 
					 | 
				
			||||||
        target_dns_records: "{{ target_dns_records + [ _dns_record ] }}"
 | 
					 | 
				
			||||||
      vars:
 | 
					 | 
				
			||||||
        _dns_record:
 | 
					 | 
				
			||||||
          type: "CNAME"
 | 
					 | 
				
			||||||
          name: "_acme-challenge.{{ _domain }}."
 | 
					 | 
				
			||||||
          content: "{{ target_tsig_key_name }}.{{ target_acme_zone }}."
 | 
					 | 
				
			||||||
      loop: "{{ target_domains }}"
 | 
					 | 
				
			||||||
      loop_control:
 | 
					 | 
				
			||||||
        loop_var: "_domain"
 | 
					 | 
				
			||||||
    - name: Populate dns_server if not given
 | 
					 | 
				
			||||||
      ansible.builtin.set_fact:
 | 
					 | 
				
			||||||
        dns_server: "{{ target_dns_server }}"
 | 
					 | 
				
			||||||
      when: dns_server is not defined
 | 
					 | 
				
			||||||
  roles:
 | 
					 | 
				
			||||||
    - role: finallycoffee.base.dns
 | 
					 | 
				
			||||||
      vars:
 | 
					 | 
				
			||||||
        dns_records: "{{ target_dns_records + target_dns_additional_records }}"
 | 
					 | 
				
			||||||
        dns_tsig_name: "{{ target_dns_tsig_key.name }}"
 | 
					 | 
				
			||||||
        dns_tsig_algo: "{{ target_dns_tsig_key.algorithm }}"
 | 
					 | 
				
			||||||
        dns_tsig_key: "{{target_dns_tsig_key.key }}"
 | 
					 | 
				
			||||||
      delegate_to: localhost
 | 
					 | 
				
			||||||
    - role: finallycoffee.base.powerdns_tsig_key
 | 
					 | 
				
			||||||
      vars:
 | 
					 | 
				
			||||||
        powerdns_tsig_key_algo: "{{ target_powerdns_tsig_key_algo }}"
 | 
					 | 
				
			||||||
        powerdns_tsig_key_name: "{{ target_tsig_key_name }}"
 | 
					 | 
				
			||||||
        powerdns_tsig_key_path: "{{ target_tsig_key_path }}"
 | 
					 | 
				
			||||||
        powerdns_tsig_key_path_owner: "{{ target_acme_user }}"
 | 
					 | 
				
			||||||
        powerdns_tsig_key_path_group: "{{ target_acme_group }}"
 | 
					 | 
				
			||||||
    - role: finallycoffee.base.lego
 | 
					 | 
				
			||||||
      vars:
 | 
					 | 
				
			||||||
        lego_instance: "{{ target_lego_instance }}"
 | 
					 | 
				
			||||||
        lego_instance_base_path: "{{ target_lego_instance_base_path }}"
 | 
					 | 
				
			||||||
        lego_environment: "{{ target_lego_environment }}"
 | 
					 | 
				
			||||||
        lego_cert_domains: "{{ target_lego_domains }}"
 | 
					 | 
				
			||||||
        lego_acme_account_email: "{{ target_acme_account_email }}"
 | 
					 | 
				
			||||||
        lego_acme_challenge_type: "{{ target_lego_acme_challenge_type }}"
 | 
					 | 
				
			||||||
        lego_acme_challenge_provider: "{{ target_lego_acme_challenge_provider }}"
 | 
					 | 
				
			||||||
        lego_acme_server_url: "{{ target_lego_acme_server_url }}"
 | 
					 | 
				
			||||||
  vars:
 | 
					 | 
				
			||||||
    target_domains: []
 | 
					 | 
				
			||||||
    target_acme_zone: ~
 | 
					 | 
				
			||||||
    target_acme_account_email: ~
 | 
					 | 
				
			||||||
    target_dns_server: ~
 | 
					 | 
				
			||||||
    target_dns_additional_records: []
 | 
					 | 
				
			||||||
    target_dns_tsig_key: {}
 | 
					 | 
				
			||||||
    target_lego_instance: "{{ target_domains | first }}"
 | 
					 | 
				
			||||||
    target_lego_instance_base_path: "/opt/acme"
 | 
					 | 
				
			||||||
    target_lego_domains: "{{ target_domains }}"
 | 
					 | 
				
			||||||
    target_lego_acme_challenge_type: "dns"
 | 
					 | 
				
			||||||
    target_lego_acme_challenge_provider: "rfc2136"
 | 
					 | 
				
			||||||
    target_lego_acme_server_url: >-2
 | 
					 | 
				
			||||||
      {{ lego_letsencrypt_server_urls.prod }}
 | 
					 | 
				
			||||||
    target_lego_environment:
 | 
					 | 
				
			||||||
      RFC2136_TSIG_KEY: "{{ target_tsig_key_name }}"
 | 
					 | 
				
			||||||
      RFC2136_TSIG_SECRET_FILE: "{{ target_tsig_key_path }}"
 | 
					 | 
				
			||||||
      RFC2136_TSIG_ALGORITHM: "{{ target_powerdns_tsig_key_algo }}"
 | 
					 | 
				
			||||||
      RFC2136_NAMESERVER: "{{ target_dns_server }}"
 | 
					 | 
				
			||||||
      RFC2136_DNS_TIMEOUT: 15
 | 
					 | 
				
			||||||
      RFC2136_TTL: 60
 | 
					 | 
				
			||||||
      RFC2136_SEQUENCE_INTERVAL: 5
 | 
					 | 
				
			||||||
      RFC2136_POLLING_INTERVAL: 10
 | 
					 | 
				
			||||||
      RFC2136_PROPAGATION_TIMEOUT: >-2
 | 
					 | 
				
			||||||
        {{ (target_lego_domains | length * 120) | int }}
 | 
					 | 
				
			||||||
      LEGO_EXPERIMENTAL_CNAME_SUPPORT: "true"
 | 
					 | 
				
			||||||
    target_tsig_key_name: "{{ target_lego_instance | hash('sha1') }}"
 | 
					 | 
				
			||||||
    target_tsig_key_path: >-2
 | 
					 | 
				
			||||||
      {{ target_lego_instance_base_path }}/{{ target_lego_instance }}/secrets/rfc2136_tsig.key
 | 
					 | 
				
			||||||
    target_tsig_key_path_owner:
 | 
					 | 
				
			||||||
    target_tsig_key_path_group:
 | 
					 | 
				
			||||||
    target_acme_user: "acme-{{ target_lego_instance }}"
 | 
					 | 
				
			||||||
    target_acme_user_id: >-2
 | 
					 | 
				
			||||||
      {{ powerdns_tsig_key_path_owner_info.uid }}
 | 
					 | 
				
			||||||
    target_acme_group: "acme-{{ target_lego_instance }}"
 | 
					 | 
				
			||||||
    target_acme_group_id: >-2
 | 
					 | 
				
			||||||
      {{ powerdns_tsig_key_path_owner_info.gid }}
 | 
					 | 
				
			||||||
    target_powerdns_tsig_key_algo: "hmac-sha256"
 | 
					 | 
				
			||||||
    target_dns_records: []
 | 
					 | 
				
			||||||
@@ -1,6 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
- name: Manage and configure mosh
 | 
					 | 
				
			||||||
  hosts: "{{ mosh_hosts | default('mosh', true) }}"
 | 
					 | 
				
			||||||
  become: "{{ mosh_become | default(true) }}"
 | 
					 | 
				
			||||||
  roles:
 | 
					 | 
				
			||||||
    - role: finallycoffee.base.mosh
 | 
					 | 
				
			||||||
@@ -1,7 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
- name: Deploy and configure openLDAP
 | 
					 | 
				
			||||||
  hosts: "{{ openldap_hosts | default('openldap', true) }}"
 | 
					 | 
				
			||||||
  become: "{{ openldap_become | default(true) }}"
 | 
					 | 
				
			||||||
  gather_facts: "{{ openldap_playbook_gather_facts | default(false) }}"
 | 
					 | 
				
			||||||
  roles:
 | 
					 | 
				
			||||||
    - role: finallycoffee.base.openldap
 | 
					 | 
				
			||||||
@@ -1,7 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
- name: Ensure openssh is installed and configured
 | 
					 | 
				
			||||||
  hosts: "{{ openssh_target | default('openssh') }}"
 | 
					 | 
				
			||||||
  become: "{{ openssh_become | default(true) }}"
 | 
					 | 
				
			||||||
  gather_facts: "{{ openssh_gather_facts | default(true) }}"
 | 
					 | 
				
			||||||
  roles:
 | 
					 | 
				
			||||||
    - role: finallycoffee.base.openssh
 | 
					 | 
				
			||||||
@@ -1,24 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
- name: Install system packages on the remote
 | 
					 | 
				
			||||||
  hosts: "{{ target_hosts | default('all', true) }}"
 | 
					 | 
				
			||||||
  become: "{{ target_host_become | default(true, true) }}"
 | 
					 | 
				
			||||||
  gather_facts: "{{ target_host_gather_facts | default(true, true) }}"
 | 
					 | 
				
			||||||
  tasks:
 | 
					 | 
				
			||||||
    - name: Install packages (apt)
 | 
					 | 
				
			||||||
      ansible.builtin.apt:
 | 
					 | 
				
			||||||
        package: "{{ package.name }}"
 | 
					 | 
				
			||||||
        state: "{{ package.state | default('present') }}"
 | 
					 | 
				
			||||||
      loop: "{{ system_packages | default([], true) }}"
 | 
					 | 
				
			||||||
      loop_control:
 | 
					 | 
				
			||||||
        loop_var: package
 | 
					 | 
				
			||||||
        label: "{{ package.name }}"
 | 
					 | 
				
			||||||
      when: ansible_facts['pkg_mgr'] == 'apt'
 | 
					 | 
				
			||||||
    - name: Install packages (dnf)
 | 
					 | 
				
			||||||
      ansible.builtin.dnf:
 | 
					 | 
				
			||||||
        name: "{{ package.name }}"
 | 
					 | 
				
			||||||
        state: "{{ package.state | default('present') }}"
 | 
					 | 
				
			||||||
      loop: "{{ system_packages | default([], true) }}"
 | 
					 | 
				
			||||||
      loop_control:
 | 
					 | 
				
			||||||
        loop_var: package
 | 
					 | 
				
			||||||
        label: "{{ package.name }}"
 | 
					 | 
				
			||||||
      when: ansible_facts['pkg_mgr'] in ['dnf', 'dnf5', 'yum']
 | 
					 | 
				
			||||||
@@ -1,7 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
- name: Configure user accounts
 | 
					 | 
				
			||||||
  hosts: "{{ user_hosts | default('all', true) }}"
 | 
					 | 
				
			||||||
  become: "{{ user_role_become | default(false, true) }}"
 | 
					 | 
				
			||||||
  gather_facts: "{{ user_role_gather_facts | default(false, true) }}"
 | 
					 | 
				
			||||||
  roles:
 | 
					 | 
				
			||||||
    - role: finallycoffee.base.user
 | 
					 | 
				
			||||||
@@ -1,33 +0,0 @@
 | 
				
			|||||||
# `finallycoffee.base.dns` ansible role
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
Simple role for wrapping around the
 | 
					 | 
				
			||||||
[`famedly.dns.update`](https://github.com/famedly/ansible-collection-dns/blob/main/plugins/modules/update.py)
 | 
					 | 
				
			||||||
ansible module.
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
## Usage
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
### Example playbook
 | 
					 | 
				
			||||||
```yaml
 | 
					 | 
				
			||||||
- target: "{{ target_hosts }}"
 | 
					 | 
				
			||||||
  roles:
 | 
					 | 
				
			||||||
    - role: finallycoffee.base.dns
 | 
					 | 
				
			||||||
      vars:
 | 
					 | 
				
			||||||
        dns_server: "dns.example.org"
 | 
					 | 
				
			||||||
        dns_zone: "zone.example.org"
 | 
					 | 
				
			||||||
        dns_records: "{{ dns_records }}"
 | 
					 | 
				
			||||||
        dns_record_state: exact
 | 
					 | 
				
			||||||
        dns_tsig_name: "mykeyname"
 | 
					 | 
				
			||||||
        dns_tsig_algo: "hmac-sha256"
 | 
					 | 
				
			||||||
        dns_tsig_key: "mykeycontent"
 | 
					 | 
				
			||||||
  vars:
 | 
					 | 
				
			||||||
    dns_records:
 | 
					 | 
				
			||||||
      - type: A
 | 
					 | 
				
			||||||
        name: gitea
 | 
					 | 
				
			||||||
        content: "127.0.0.1"
 | 
					 | 
				
			||||||
      - type: AAAA
 | 
					 | 
				
			||||||
        name: gitea
 | 
					 | 
				
			||||||
        content: "fe80::1"
 | 
					 | 
				
			||||||
      - type: CNAME
 | 
					 | 
				
			||||||
        name: "_acme_challenge.gitea"
 | 
					 | 
				
			||||||
        content: "delegated-cname.challenge.example.org"
 | 
					 | 
				
			||||||
```
 | 
					 | 
				
			||||||
@@ -1,2 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
dns_record_state: present
 | 
					 | 
				
			||||||
@@ -1,11 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Ensure DNS records in '{{ dns_zone }}' are up to date
 | 
					 | 
				
			||||||
  famedly.dns.update:
 | 
					 | 
				
			||||||
    primary_master: "{{ dns_server }}"
 | 
					 | 
				
			||||||
    zone: "{{ dns_zone }}"
 | 
					 | 
				
			||||||
    tsig_name: "{{ dns_tsig_name }}"
 | 
					 | 
				
			||||||
    tsig_algo: "{{ dns_tsig_algo }}"
 | 
					 | 
				
			||||||
    tsig_key: "{{ dns_tsig_key }}"
 | 
					 | 
				
			||||||
    rr_set: "{{ dns_records }}"
 | 
					 | 
				
			||||||
    state: "{{ dns_record_state }}"
 | 
					 | 
				
			||||||
@@ -1,13 +0,0 @@
 | 
				
			|||||||
# `finallycoffee.base.docker` ansible role
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
Install and configure the docker daemon.
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
## Configuration
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- `docker_daemon_config` - configuration for the docker daemon
 | 
					 | 
				
			||||||
- `docker_remove_legacy_packages` - clean up old versions of docker (see https://docs.docker.com/engine/install/debian/#uninstall-old-versions)
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
## Plugins
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- `docker_plugin_buildx_enable` - enable the buildx plugin
 | 
					 | 
				
			||||||
- `docker_plugin_compose_enable` - enable docker compose
 | 
					 | 
				
			||||||
@@ -1,31 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
docker_apt_key_url: "https://download.docker.com/linux/debian/gpg"
 | 
					 | 
				
			||||||
docker_apt_key_id: "9DC858229FC7DD38854AE2D88D81803C0EBFCD88"
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
docker_apt_arch: amd64
 | 
					 | 
				
			||||||
docker_apt_release_channel: stable
 | 
					 | 
				
			||||||
docker_apt_repository_url: "https://download.docker.com/linux/debian"
 | 
					 | 
				
			||||||
docker_apt_repository: >-2
 | 
					 | 
				
			||||||
  deb [arch={{ docker_apt_arch }}] {{ docker_apt_repository_url }} {{ ansible_distribution_release }} {{ docker_apt_release_channel }}
 | 
					 | 
				
			||||||
docker_apt_cli_package: "docker-ce-cli"
 | 
					 | 
				
			||||||
docker_apt_plugin_buildx_package: "docker-buildx-plugin"
 | 
					 | 
				
			||||||
docker_apt_plugin_compose_package: "docker-compose-plugin"
 | 
					 | 
				
			||||||
docker_apt_base_packages:
 | 
					 | 
				
			||||||
  - "docker-ce"
 | 
					 | 
				
			||||||
  - "docker-ce-cli"
 | 
					 | 
				
			||||||
  - "containerd.io"
 | 
					 | 
				
			||||||
docker_apt_packages: >-2
 | 
					 | 
				
			||||||
  {{
 | 
					 | 
				
			||||||
    docker_apt_base_packages
 | 
					 | 
				
			||||||
    + (docker_plugin_buildx_enable | default(false)
 | 
					 | 
				
			||||||
      | ternary([ docker_apt_plugin_buildx_package ], []))
 | 
					 | 
				
			||||||
    + (docker_plugin_compose_enable | default(false)
 | 
					 | 
				
			||||||
      | ternary([ docker_apt_plugin_compose_package ], []))
 | 
					 | 
				
			||||||
  }}
 | 
					 | 
				
			||||||
docker_apt_legacy_packages:
 | 
					 | 
				
			||||||
  - "docker.io"
 | 
					 | 
				
			||||||
  - "docker-compose"
 | 
					 | 
				
			||||||
  - "docker-doc"
 | 
					 | 
				
			||||||
  - "podman-docker"
 | 
					 | 
				
			||||||
  - "containerd"
 | 
					 | 
				
			||||||
  - "runc"
 | 
					 | 
				
			||||||
@@ -1,34 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
docker_fedora_repo_name: "docker-ce-stable"
 | 
					 | 
				
			||||||
docker_fedora_repo_description: "Docker CE Stable - $basearch"
 | 
					 | 
				
			||||||
docker_fedora_repo_url: "https://download.docker.com/linux/fedora/$releasever/$basearch/stable"
 | 
					 | 
				
			||||||
docker_fedora_repo_validate_certs: true
 | 
					 | 
				
			||||||
docker_fedora_repo_gpg_check: true
 | 
					 | 
				
			||||||
docker_fedora_repo_gpg_key: "https://download.docker.com/linux/fedora/gpg"
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
docker_fedora_cli_package: "docker-ce-cli"
 | 
					 | 
				
			||||||
docker_fedora_plugin_buildx_package: "docker-buildx-plugin"
 | 
					 | 
				
			||||||
docker_fedora_plugin_compose_package: "docker-compose-plugin"
 | 
					 | 
				
			||||||
docker_fedora_base_packages:
 | 
					 | 
				
			||||||
  - "docker-ce"
 | 
					 | 
				
			||||||
  - "docker-ce-cli"
 | 
					 | 
				
			||||||
  - "containerd.io"
 | 
					 | 
				
			||||||
docker_fedora_packages: >-2
 | 
					 | 
				
			||||||
  {{
 | 
					 | 
				
			||||||
    docker_fedora_base_packages
 | 
					 | 
				
			||||||
    + (docker_plugin_buildx_enable | default(false)
 | 
					 | 
				
			||||||
      | ternary([ docker_fedora_plugin_buildx_package ], []))
 | 
					 | 
				
			||||||
    + (docker_plugin_compose_enable | default(false)
 | 
					 | 
				
			||||||
      | ternary([ docker_fedora_plugin_compose_package ], []))
 | 
					 | 
				
			||||||
  }}
 | 
					 | 
				
			||||||
docker_fedora_legacy_packages:
 | 
					 | 
				
			||||||
  - "docker"
 | 
					 | 
				
			||||||
  - "docker-client"
 | 
					 | 
				
			||||||
  - "docker-client-latest"
 | 
					 | 
				
			||||||
  - "docker-common"
 | 
					 | 
				
			||||||
  - "docker-latest"
 | 
					 | 
				
			||||||
  - "docker-latest-logrotate"
 | 
					 | 
				
			||||||
  - "docker-logrotate"
 | 
					 | 
				
			||||||
  - "docker-selinux"
 | 
					 | 
				
			||||||
  - "docker-engine-selinux"
 | 
					 | 
				
			||||||
  - "docker-engine"
 | 
					 | 
				
			||||||
@@ -1,13 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
docker_state: "present"
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
docker_daemon_config: {}
 | 
					 | 
				
			||||||
docker_daemon_config_file: "/etc/docker/daemon.json"
 | 
					 | 
				
			||||||
docker_daemon_config_file_mode: "0644"
 | 
					 | 
				
			||||||
docker_daemon_config_owner: root
 | 
					 | 
				
			||||||
docker_daemon_config_group: "{{ docker_daemon_config_owner }}"
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
docker_plugin_buildx_enable: false
 | 
					 | 
				
			||||||
docker_plugin_compose_enable: false
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
docker_remove_legacy_packages: true
 | 
					 | 
				
			||||||
@@ -1,5 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
docker_systemd_service_name: "docker.service"
 | 
					 | 
				
			||||||
docker_systemd_service_state: >-2
 | 
					 | 
				
			||||||
  {{ (docker_state == 'present') | ternary('started', 'stopped') }}
 | 
					 | 
				
			||||||
docker_systemd_service_enabled: "{{ (docker_state == 'present') }}"
 | 
					 | 
				
			||||||
@@ -1,6 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
- name: Restart docker daemon
 | 
					 | 
				
			||||||
  ansible.builtin.systemd_service:
 | 
					 | 
				
			||||||
    name: "{{ docker_systemd_service_name }}"
 | 
					 | 
				
			||||||
    state: "restarted"
 | 
					 | 
				
			||||||
  listen: "docker-restart"
 | 
					 | 
				
			||||||
@@ -1,18 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
- name: Ensure config directory '{{ docker_daemon_config_file | dirname }}' is present
 | 
					 | 
				
			||||||
  ansible.builtin.file:
 | 
					 | 
				
			||||||
    path: "{{ docker_daemon_config_file | dirname }}"
 | 
					 | 
				
			||||||
    state: "directory"
 | 
					 | 
				
			||||||
    mode: "0755"
 | 
					 | 
				
			||||||
    owner: "{{ docker_daemon_config_owner }}"
 | 
					 | 
				
			||||||
    group: "{{ docker_daemon_config_group }}"
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Configure docker daemon using '{{ docker_daemon_config_file }}'
 | 
					 | 
				
			||||||
  ansible.builtin.copy:
 | 
					 | 
				
			||||||
    content: "{{ docker_daemon_config | to_nice_json }}"
 | 
					 | 
				
			||||||
    dest: "{{ docker_daemon_config_file }}"
 | 
					 | 
				
			||||||
    mode: "{{ docker_daemon_config_file_mode }}"
 | 
					 | 
				
			||||||
    owner: "{{ docker_daemon_config_owner }}"
 | 
					 | 
				
			||||||
    group: "{{ docker_daemon_config_group }}"
 | 
					 | 
				
			||||||
  when: docker_daemon_config | string | length > 0
 | 
					 | 
				
			||||||
  notify: docker-restart
 | 
					 | 
				
			||||||
@@ -1,30 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
- name: Ensure legacy docker packages are removed
 | 
					 | 
				
			||||||
  ansible.builtin.apt:
 | 
					 | 
				
			||||||
    name: "{{ docker_apt_legacy_packages }}"
 | 
					 | 
				
			||||||
    state: absent
 | 
					 | 
				
			||||||
  when: docker_remove_legacy_packages
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Add apt key for docker repository
 | 
					 | 
				
			||||||
  ansible.builtin.apt_key:
 | 
					 | 
				
			||||||
    id: "{{ docker_apt_key_id }}"
 | 
					 | 
				
			||||||
    url: "{{ docker_apt_key_url }}"
 | 
					 | 
				
			||||||
    state: "{{ docker_state }}"
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Add apt repository for docker
 | 
					 | 
				
			||||||
  ansible.builtin.apt_repository:
 | 
					 | 
				
			||||||
    repo: "{{ docker_apt_repository }}"
 | 
					 | 
				
			||||||
    state: "{{ docker_state }}"
 | 
					 | 
				
			||||||
  register: docker_apt_repository_info
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Update apt cache if repository was newly added
 | 
					 | 
				
			||||||
  ansible.builtin.apt:
 | 
					 | 
				
			||||||
    update_cache: true
 | 
					 | 
				
			||||||
  when:
 | 
					 | 
				
			||||||
    - docker_state == 'present'
 | 
					 | 
				
			||||||
    - docker_apt_repository_info.changed
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Install apt packages for docker
 | 
					 | 
				
			||||||
  ansible.builtin.apt:
 | 
					 | 
				
			||||||
    name: "{{ docker_apt_packages }}"
 | 
					 | 
				
			||||||
    state: "{{ docker_state }}"
 | 
					 | 
				
			||||||
@@ -1,21 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
- name: Ensure legacy docker packages are removed
 | 
					 | 
				
			||||||
  ansible.builtin.dnf:
 | 
					 | 
				
			||||||
    name: "{{ docker_fedora_legacy_packages }}"
 | 
					 | 
				
			||||||
    state: "removed"
 | 
					 | 
				
			||||||
  when: docker_remove_legacy_packages
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Ensure dnf repository for docker is {{ docker_state }}
 | 
					 | 
				
			||||||
  ansible.builtin.yum_repository:
 | 
					 | 
				
			||||||
    name: "{{ docker_fedora_repo_name }}"
 | 
					 | 
				
			||||||
    description: "{{ docker_fedora_repo_description }}"
 | 
					 | 
				
			||||||
    baseurl: "{{ docker_fedora_repo_url }}"
 | 
					 | 
				
			||||||
    validate_certs: "{{ docker_fedora_repo_validate_certs }}" 
 | 
					 | 
				
			||||||
    gpgkey: "{{ docker_fedora_repo_gpg_key }}"
 | 
					 | 
				
			||||||
    gpgcheck: "{{ docker_fedora_repo_gpg_check }}"
 | 
					 | 
				
			||||||
    state: "{{ docker_state }}"
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Install dnf packages for docker
 | 
					 | 
				
			||||||
  ansible.builtin.dnf:
 | 
					 | 
				
			||||||
    name: "{{ docker_fedora_packages }}"
 | 
					 | 
				
			||||||
    state: "{{ docker_state }}"
 | 
					 | 
				
			||||||
@@ -1,29 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
- name: Check if target OS is supported
 | 
					 | 
				
			||||||
  ansible.builtin.fail:
 | 
					 | 
				
			||||||
    msg: >-2
 | 
					 | 
				
			||||||
      OS '{{ docker_os }}' is not supported!
 | 
					 | 
				
			||||||
  when: docker_os not in docker_supported_oses
 | 
					 | 
				
			||||||
  vars:
 | 
					 | 
				
			||||||
    docker_os: "{{ ansible_distribution | lower }}"
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Ensure docker is {{ docker_state }} on {{ ansible_distribution }}
 | 
					 | 
				
			||||||
  ansible.builtin.include_tasks:
 | 
					 | 
				
			||||||
    file: "install-{{ ansible_distribution | lower }}.yml"
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Configure docker daemon
 | 
					 | 
				
			||||||
  ansible.builtin.include_tasks:
 | 
					 | 
				
			||||||
    file: "configure.yml"
 | 
					 | 
				
			||||||
  when: docker_state == 'present'
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Ensure docker daemon is {{ docker_systemd_service_enabled | ternary('enabled', 'disabled') }}
 | 
					 | 
				
			||||||
  ansible.builtin.systemd_service:
 | 
					 | 
				
			||||||
    name: "{{ docker_systemd_service_name }}"
 | 
					 | 
				
			||||||
    enabled: "{{ docker_systemd_service_enabled }}"
 | 
					 | 
				
			||||||
  when: ansible_facts['service_mgr'] == 'systemd'
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Ensure docker daemon is {{ docker_systemd_service_state }}
 | 
					 | 
				
			||||||
  ansible.builtin.systemd_service:
 | 
					 | 
				
			||||||
    name: "{{ docker_systemd_service_name }}"
 | 
					 | 
				
			||||||
    state: "{{ docker_systemd_service_state }}"
 | 
					 | 
				
			||||||
  when: ansible_facts['service_mgr'] == 'systemd'
 | 
					 | 
				
			||||||
@@ -1,4 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
docker_supported_oses:
 | 
					 | 
				
			||||||
  - 'debian'
 | 
					 | 
				
			||||||
  - 'fedora'
 | 
					 | 
				
			||||||
@@ -1,19 +0,0 @@
 | 
				
			|||||||
# `finallycoffee.base.git` ansible role
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
This role configures git for the `ansible_user` and can be used
 | 
					 | 
				
			||||||
to (pre)-configure git.
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
## Examples
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
```yaml
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
git_config_user_name: # user name to use for git
 | 
					 | 
				
			||||||
git_config_user_email: # email to use for git
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
git_config_core_editor: vim # editor to use
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
git_config_credentials:
 | 
					 | 
				
			||||||
  - remote_url: https://github.com
 | 
					 | 
				
			||||||
    config:
 | 
					 | 
				
			||||||
      username: my_github_username
 | 
					 | 
				
			||||||
```
 | 
					 | 
				
			||||||
@@ -1,4 +0,0 @@
 | 
				
			|||||||
# `finallycoffee.base.gnupg` ansible role
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
Configures GnuPG on the target system, including a Smart-Card (SC) daemon
 | 
					 | 
				
			||||||
and can set up gpg-agent as an SSH-agent.
 | 
					 | 
				
			||||||
@@ -1,46 +0,0 @@
 | 
				
			|||||||
# `finallycoffee.base.lego` ansible role
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
This role can be used to retrieve ACME certificates on the target host. It uses `lego` for that, and with systemd template units provides an easy way to configure and monitor the status for each certificate.
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
## Requirements
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- `systemd`
 | 
					 | 
				
			||||||
- write access to /tmp to unpack the lego release tarball during installation
 | 
					 | 
				
			||||||
- write access to /opt/lego (or whatever `lego_base_path` is set to) for configuration and certificate data
 | 
					 | 
				
			||||||
- `become` privileges of the `ansible_user` on the target
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
## Usage
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
### Required configuration
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- `lego_instance` - used for allowing multiple lego jobs to run with systemd template units. recommended to be set to the CN / first SAN of the certificate.
 | 
					 | 
				
			||||||
- `lego_cert_domains` - list of FQDNs to request a certificate for
 | 
					 | 
				
			||||||
- `lego_acme_account_email` - when using letsencrypt, a contact email is mandatory
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
### Proxies / Registries
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
The role ensure `lego` is downloaded from the github release page. If you are behind a proxy or use a registry like Nexus3, set `lego_release_archive_server`.
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
### ACME server
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
Per default, the Letsencrypt Staging ACME server is configured. Set `lego_acme_server_url` from `lego_letsencrypt_server_urls.{qa,prod}` or configure your own ACME v2 server directly.
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
### Certificate
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
To set for which domains to request a certificate for, set them as a list of SANs in `lego_cert_domains`. The default key type is EC256 and can be overridden using `lego_cert_key_type`.
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
Set the type of challenge in `lego_acme_challenge_type` (to either `http` or `dns`), and `lego_acme_challenge_provider` to, for example, `rfc2136` for DNS challenges using the DNSUPDATE mechanism. If your challenge needs additional data, set that in `lego_command_config` as a dictionary analog to `lego_base_command_config` (see [defaults](defaults/main.yml)).
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
## Trivia
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
### Architecture
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
By default, the lego distribution for `linux` on `amd64` is downloaded. If your target needs a different architecture or target OS, adjust this in `lego_os` and `lego_architecture`, cross-checking with the [lego GitHub release page](https://github.com/go-acme/lego/releases/tag/v4.17.4) for upstream availability.
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
### User management
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
The role will attempt to create user+group for each seperate lego instance for data isolation (i.e. to avoid leaking a TSIG key from one lego instance to other services). The user and group are of the form `acme-{{ lego_instance }}`. Beware that changing this in `lego_cert_{user,group}` also requires `lego_systemd_{user,group}` to be adjusted!
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
### Binding to ports < 1024 (HTTP-01 challenge)
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
Set `lego_binary_allow_net_bind_service: true` to allow the lego binary to bind to ports in the 'privileged' (< 1024) port range.
 | 
					 | 
				
			||||||
@@ -1,71 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
lego_user: "lego"
 | 
					 | 
				
			||||||
lego_version: "4.28.0"
 | 
					 | 
				
			||||||
lego_instance: default
 | 
					 | 
				
			||||||
lego_base_path: "/opt/lego"
 | 
					 | 
				
			||||||
lego_cert_user: "acme-{{ lego_instance }}"
 | 
					 | 
				
			||||||
lego_cert_group: "{{ lego_cert_user }}"
 | 
					 | 
				
			||||||
lego_cert_mode: "0640" # rw-r-----
 | 
					 | 
				
			||||||
lego_systemd_user: "acme-%i"
 | 
					 | 
				
			||||||
lego_systemd_group: "{{ lego_systemd_user }}"
 | 
					 | 
				
			||||||
lego_instance_base_path: "{{ lego_base_path }}/instances"
 | 
					 | 
				
			||||||
lego_instance_path: "{{ lego_instance_base_path }}/{{ lego_instance }}"
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
lego_cert_domains: []
 | 
					 | 
				
			||||||
lego_cert_key_type: ec256
 | 
					 | 
				
			||||||
lego_cert_days_to_renew: 30
 | 
					 | 
				
			||||||
lego_acme_account_email: ~
 | 
					 | 
				
			||||||
lego_acme_challenge_type: http
 | 
					 | 
				
			||||||
lego_acme_challenge_provider: ~
 | 
					 | 
				
			||||||
lego_letsencrypt_server_urls:
 | 
					 | 
				
			||||||
  qa: "https://acme-staging-v02.api.letsencrypt.org/directory"
 | 
					 | 
				
			||||||
  prod: "https://acme-v02.api.letsencrypt.org/directory"
 | 
					 | 
				
			||||||
lego_acme_server_url: "{{ lego_letsencrypt_server_urls.qa }}"
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
lego_base_environment:
 | 
					 | 
				
			||||||
  LEGO_CERT_USER: "{{ lego_cert_user }}"
 | 
					 | 
				
			||||||
  LEGO_CERT_GROUP: "{{ lego_cert_group }}"
 | 
					 | 
				
			||||||
  LEGO_CERT_MODE: "{{ lego_cert_mode }}"
 | 
					 | 
				
			||||||
  LEGO_CERT_STORE_PATH: "{{ lego_instance_path }}"
 | 
					 | 
				
			||||||
  LEGO_CERT_DAYS_TO_RENEW: "{{ lego_cert_days_to_renew }}"
 | 
					 | 
				
			||||||
  LEGO_KEY_TYPE: "{{ lego_cert_key_type }}"
 | 
					 | 
				
			||||||
  LEGO_ACME_CHALLENGE_TYPE: "{{ lego_acme_challenge_type }}"
 | 
					 | 
				
			||||||
  LEGO_ACME_SERVER: "{{ lego_acme_server_url }}"
 | 
					 | 
				
			||||||
  LEGO_COMMAND_ARGS: "{{ lego_command_args }}"
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
lego_base_command_config:
 | 
					 | 
				
			||||||
  server: "{{ lego_acme_server_url }}"
 | 
					 | 
				
			||||||
  accept_tos: true
 | 
					 | 
				
			||||||
  email: "{{ lego_acme_account_email }}"
 | 
					 | 
				
			||||||
  path: "{{ lego_instance_path }}"
 | 
					 | 
				
			||||||
  key_type: "{{ lego_cert_key_type }}"
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
lego_acme_challenge_config: >-
 | 
					 | 
				
			||||||
  {{ {lego_acme_challenge_type: lego_acme_challenge_provider} }}
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
lego_systemd_unit_path: "/etc/systemd/system"
 | 
					 | 
				
			||||||
lego_systemd_template_unit_name: "lego@.service"
 | 
					 | 
				
			||||||
lego_systemd_template_unit_file: "{{ lego_systemd_template_unit_name }}.j2"
 | 
					 | 
				
			||||||
lego_systemd_service_name: "lego@{{ lego_instance }}.service"
 | 
					 | 
				
			||||||
lego_systemd_environment: >-
 | 
					 | 
				
			||||||
  {{ lego_base_environment | combine(lego_environment | default({})) }}
 | 
					 | 
				
			||||||
lego_full_command_config: >-
 | 
					 | 
				
			||||||
  {{ lego_base_command_config
 | 
					 | 
				
			||||||
  | combine(lego_acme_challenge_config)
 | 
					 | 
				
			||||||
  | combine(lego_command_config | default({})) }}
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
lego_systemd_timer_name: "lego-{{ lego_instance }}.timer"
 | 
					 | 
				
			||||||
lego_systemd_timer_template: lego.timer.j2
 | 
					 | 
				
			||||||
lego_systemd_timer_calendar: "*-*-* *:00/15:00"
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
lego_architecture: "{{ 'arm64' if ansible_architecture == 'aarch64' else 'amd64' }}"
 | 
					 | 
				
			||||||
lego_os: "linux"
 | 
					 | 
				
			||||||
lego_binary_allow_net_bind_service: false
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
lego_release_archive_server: "https://github.com"
 | 
					 | 
				
			||||||
lego_release_archive_filename: >-
 | 
					 | 
				
			||||||
  lego_v{{ lego_version }}_{{ lego_os }}_{{ lego_architecture }}.tar.gz
 | 
					 | 
				
			||||||
lego_release_archive_url: >-
 | 
					 | 
				
			||||||
  {{ lego_release_archive_server }}/go-acme/lego/releases/download/v{{ lego_version }}/{{ lego_release_archive_filename }}
 | 
					 | 
				
			||||||
lego_release_archive_file_path: "/tmp/{{ lego_release_archive_filename }}"
 | 
					 | 
				
			||||||
lego_release_archive_path: "/tmp/lego_v{{ lego_version }}_{{ lego_os }}_{{ lego_architecture }}"
 | 
					 | 
				
			||||||
@@ -1,35 +0,0 @@
 | 
				
			|||||||
#!/usr/bin/env bash
 | 
					 | 
				
			||||||
set -euo pipefail
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
LEGO_BINARY=$(/usr/bin/env which lego)
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
if [[ -n "${LEGO_HTTP_FALLBACK_PORT:-}" ]]; then
 | 
					 | 
				
			||||||
  if ! nc_binary="$(type -p 'nc')" || [[ -z $nc_binary ]]; then
 | 
					 | 
				
			||||||
    echo "nc not found (in PATH), exiting"
 | 
					 | 
				
			||||||
    exit 1
 | 
					 | 
				
			||||||
  fi
 | 
					 | 
				
			||||||
  nc -z 127.0.0.1 $LEGO_HTTP_PORT;
 | 
					 | 
				
			||||||
  if [[ $? -eq 0 ]]; then
 | 
					 | 
				
			||||||
      LEGO_HTTP_PORT=$LEGO_HTTP_FALLBACK_PORT
 | 
					 | 
				
			||||||
  fi
 | 
					 | 
				
			||||||
fi
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
if [[ -n "${LEGO_PRE_RENEWAL_HOOK:-}" ]]; then
 | 
					 | 
				
			||||||
  $LEGO_PRE_RENEWAL_HOOK
 | 
					 | 
				
			||||||
fi
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
LEGO_COMMAND_ARGS_EXPANDED=$(bash -c "echo $LEGO_COMMAND_ARGS") # This is a bit icky
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
FILES_IN_DIR=$(find "$LEGO_CERT_STORE_PATH/certificates" -type f | wc -l)
 | 
					 | 
				
			||||||
if [[ $FILES_IN_DIR -gt 2 ]]; then
 | 
					 | 
				
			||||||
        $LEGO_BINARY $LEGO_COMMAND_ARGS_EXPANDED renew --days=$LEGO_CERT_DAYS_TO_RENEW
 | 
					 | 
				
			||||||
else
 | 
					 | 
				
			||||||
        $LEGO_BINARY $LEGO_COMMAND_ARGS_EXPANDED run
 | 
					 | 
				
			||||||
fi
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
find "$LEGO_CERT_STORE_PATH/certificates" -type f | xargs -I{} -n 1 chmod "$LEGO_CERT_MODE" "{}"
 | 
					 | 
				
			||||||
find "$LEGO_CERT_STORE_PATH/certificates" -type f | xargs -I{} -n 1 chown "${LEGO_CERT_USER}:${LEGO_CERT_GROUP}" "{}"
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
if [[ -n "${LEGO_POST_RENEWAL_HOOK:-}" ]]; then
 | 
					 | 
				
			||||||
  $LEGO_POST_RENEWAL_HOOK
 | 
					 | 
				
			||||||
fi
 | 
					 | 
				
			||||||
@@ -1,5 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
- name: Ensure systemd daemon is reloaded
 | 
					 | 
				
			||||||
  ansible.builtin.systemd:
 | 
					 | 
				
			||||||
    daemon_reload: true
 | 
					 | 
				
			||||||
  listen: systemd_reload
 | 
					 | 
				
			||||||
@@ -1,178 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
- name: Ensure lego cert group is created
 | 
					 | 
				
			||||||
  ansible.builtin.group:
 | 
					 | 
				
			||||||
    name: "{{ lego_cert_group }}"
 | 
					 | 
				
			||||||
    state: present
 | 
					 | 
				
			||||||
    system: true
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Ensure lego cert user is created
 | 
					 | 
				
			||||||
  ansible.builtin.user:
 | 
					 | 
				
			||||||
    name: "{{ lego_cert_user }}"
 | 
					 | 
				
			||||||
    state: present
 | 
					 | 
				
			||||||
    system: true
 | 
					 | 
				
			||||||
    create_home: false
 | 
					 | 
				
			||||||
    groups:
 | 
					 | 
				
			||||||
      - "{{ lego_cert_group }}"
 | 
					 | 
				
			||||||
    append: true
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Ensure lego user is created
 | 
					 | 
				
			||||||
  ansible.builtin.user:
 | 
					 | 
				
			||||||
    name: "{{ lego_user }}"
 | 
					 | 
				
			||||||
    state: present
 | 
					 | 
				
			||||||
    system: true
 | 
					 | 
				
			||||||
    create_home: false
 | 
					 | 
				
			||||||
    groups:
 | 
					 | 
				
			||||||
      - "{{ lego_cert_group }}"
 | 
					 | 
				
			||||||
    append: true
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Check if lego is present
 | 
					 | 
				
			||||||
  ansible.builtin.command:
 | 
					 | 
				
			||||||
    cmd: which lego
 | 
					 | 
				
			||||||
  changed_when: false
 | 
					 | 
				
			||||||
  failed_when: false
 | 
					 | 
				
			||||||
  register: lego_binary_info
 | 
					 | 
				
			||||||
  check_mode: false
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Check which version of lego is present
 | 
					 | 
				
			||||||
  ansible.builtin.command:
 | 
					 | 
				
			||||||
    cmd: "lego --version"
 | 
					 | 
				
			||||||
  changed_when: false
 | 
					 | 
				
			||||||
  failed_when: false
 | 
					 | 
				
			||||||
  register: lego_binary_version_info
 | 
					 | 
				
			||||||
  when: lego_binary_info.rc == 0
 | 
					 | 
				
			||||||
  check_mode: false
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Ensure lego is installed
 | 
					 | 
				
			||||||
  when: (lego_binary_info.rc != 0) or (lego_version not in lego_binary_version_info.stdout)
 | 
					 | 
				
			||||||
  block:
 | 
					 | 
				
			||||||
    - name: Download lego from source
 | 
					 | 
				
			||||||
      ansible.builtin.get_url:
 | 
					 | 
				
			||||||
        url: "{{ lego_release_archive_url }}"
 | 
					 | 
				
			||||||
        url_username: "{{ lego_release_archive_url_username | default(omit) }}"
 | 
					 | 
				
			||||||
        url_password: "{{ lego_release_archive_url_password | default(omit) }}"
 | 
					 | 
				
			||||||
        dest: "{{ lego_release_archive_file_path }}"
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
    - name: Create folder to uncompress into
 | 
					 | 
				
			||||||
      ansible.builtin.file:
 | 
					 | 
				
			||||||
        dest: "{{ lego_release_archive_path }}"
 | 
					 | 
				
			||||||
        state: directory
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
    - name: Uncompress lego source archive
 | 
					 | 
				
			||||||
      ansible.builtin.unarchive:
 | 
					 | 
				
			||||||
        src: "{{ lego_release_archive_file_path }}"
 | 
					 | 
				
			||||||
        dest: "{{ lego_release_archive_path }}"
 | 
					 | 
				
			||||||
        remote_src: true
 | 
					 | 
				
			||||||
      ignore_errors: "{{ ansible_check_mode }}"
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
    - name: Ensure lego binary is present in PATH
 | 
					 | 
				
			||||||
      ansible.builtin.copy:
 | 
					 | 
				
			||||||
        src: "{{ lego_release_archive_path }}/lego"
 | 
					 | 
				
			||||||
        dest: "/usr/local/bin/lego"
 | 
					 | 
				
			||||||
        mode: "u+rwx,g+rx,o+rx"
 | 
					 | 
				
			||||||
        remote_src: true
 | 
					 | 
				
			||||||
      ignore_errors: "{{ ansible_check_mode }}"
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
    - name: Ensure intermediate data is gone
 | 
					 | 
				
			||||||
      ansible.builtin.file:
 | 
					 | 
				
			||||||
        path: "{{ item }}"
 | 
					 | 
				
			||||||
        state: absent
 | 
					 | 
				
			||||||
      loop:
 | 
					 | 
				
			||||||
        - "{{ lego_release_archive_path }}"
 | 
					 | 
				
			||||||
        - "{{ lego_release_archive_file_path }}"
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
    - name: Ensure lego is allowed to bind to ports < 1024
 | 
					 | 
				
			||||||
      community.general.capabilities:
 | 
					 | 
				
			||||||
        path: "/usr/local/bin/lego"
 | 
					 | 
				
			||||||
        capability: "cap_net_bind_service+ep"
 | 
					 | 
				
			||||||
        state: present
 | 
					 | 
				
			||||||
      when: lego_binary_allow_net_bind_service
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Ensure lego base path exists
 | 
					 | 
				
			||||||
  ansible.builtin.file:
 | 
					 | 
				
			||||||
    path: "{{ lego_base_path }}"
 | 
					 | 
				
			||||||
    state: directory
 | 
					 | 
				
			||||||
    mode: "0755"
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Ensure template unit file is present
 | 
					 | 
				
			||||||
  ansible.builtin.template:
 | 
					 | 
				
			||||||
    src: "{{ lego_systemd_template_unit_file }}"
 | 
					 | 
				
			||||||
    dest: "{{ lego_systemd_unit_path }}/{{ lego_systemd_template_unit_name }}"
 | 
					 | 
				
			||||||
  notify:
 | 
					 | 
				
			||||||
    - systemd_reload
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Ensure env file is templated
 | 
					 | 
				
			||||||
  ansible.builtin.copy:
 | 
					 | 
				
			||||||
    content: |+
 | 
					 | 
				
			||||||
      {% for entry in lego_systemd_environment | dict2items %}
 | 
					 | 
				
			||||||
      {{ entry.key }}={{ entry.value }}
 | 
					 | 
				
			||||||
      {% endfor %}
 | 
					 | 
				
			||||||
    dest: "{{ lego_base_path }}/{{ lego_instance }}.conf"
 | 
					 | 
				
			||||||
  register: lego_env_file_info
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Ensure timer unit is templated
 | 
					 | 
				
			||||||
  ansible.builtin.template:
 | 
					 | 
				
			||||||
    src: "{{ lego_systemd_timer_template }}"
 | 
					 | 
				
			||||||
    dest: "{{ lego_systemd_unit_path }}/{{ lego_systemd_timer_name }}"
 | 
					 | 
				
			||||||
  notify:
 | 
					 | 
				
			||||||
    - systemd_reload
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Ensure handling script is templated
 | 
					 | 
				
			||||||
  ansible.builtin.copy:
 | 
					 | 
				
			||||||
    src: "lego_run.sh"
 | 
					 | 
				
			||||||
    dest: "{{ lego_base_path }}/run.sh"
 | 
					 | 
				
			||||||
    mode: "0755"
 | 
					 | 
				
			||||||
  register: lego_handler_script_info
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Ensure per-instance base path is created
 | 
					 | 
				
			||||||
  ansible.builtin.file:
 | 
					 | 
				
			||||||
    path: "{{ lego_instance_path }}"
 | 
					 | 
				
			||||||
    state: directory
 | 
					 | 
				
			||||||
    owner: "{{ lego_cert_user }}"
 | 
					 | 
				
			||||||
    group: "{{ lego_cert_group }}"
 | 
					 | 
				
			||||||
    mode: "0755"
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Ensure per-instance sub folders are created with correct permissions
 | 
					 | 
				
			||||||
  ansible.builtin.file:
 | 
					 | 
				
			||||||
    path: "{{ item.path }}"
 | 
					 | 
				
			||||||
    state: directory
 | 
					 | 
				
			||||||
    owner: "{{ item.owner | default(lego_cert_user) }}"
 | 
					 | 
				
			||||||
    group: "{{ item.group | default(lego_cert_group) }}"
 | 
					 | 
				
			||||||
    mode: "{{ item.mode }}"
 | 
					 | 
				
			||||||
  loop:
 | 
					 | 
				
			||||||
    - path: "{{ lego_instance_path }}/secrets"
 | 
					 | 
				
			||||||
      mode: "0750"
 | 
					 | 
				
			||||||
    - path: "{{ lego_instance_path }}/accounts"
 | 
					 | 
				
			||||||
      mode: "0770"
 | 
					 | 
				
			||||||
    - path: "{{ lego_instance_path }}/certificates"
 | 
					 | 
				
			||||||
      mode: "0775"
 | 
					 | 
				
			||||||
  loop_control:
 | 
					 | 
				
			||||||
    label: "{{ item.path }}"
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Ensure systemd daemon is reloaded
 | 
					 | 
				
			||||||
  meta: flush_handlers
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Ensure systemd timer is enabled
 | 
					 | 
				
			||||||
  ansible.builtin.systemd_service:
 | 
					 | 
				
			||||||
    name: "{{ lego_systemd_timer_name }}"
 | 
					 | 
				
			||||||
    enabled: true
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Ensure systemd timer is started
 | 
					 | 
				
			||||||
  ansible.builtin.systemd_service:
 | 
					 | 
				
			||||||
    name: "{{ lego_systemd_timer_name }}"
 | 
					 | 
				
			||||||
    state: "started"
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Check if certificates are present
 | 
					 | 
				
			||||||
  ansible.builtin.find:
 | 
					 | 
				
			||||||
    path: "{{ lego_instance_path }}/certificates"
 | 
					 | 
				
			||||||
    recurse: false
 | 
					 | 
				
			||||||
    file_type: "file"
 | 
					 | 
				
			||||||
  register: lego_certificate_info
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Ensure systemd service is started once to obtain the certificate
 | 
					 | 
				
			||||||
  ansible.builtin.systemd_service:
 | 
					 | 
				
			||||||
    name: "{{ lego_systemd_service_name }}"
 | 
					 | 
				
			||||||
    state: "started"
 | 
					 | 
				
			||||||
  when: >-2
 | 
					 | 
				
			||||||
    lego_handler_script_info.changed
 | 
					 | 
				
			||||||
    or lego_env_file_info.changed
 | 
					 | 
				
			||||||
    or lego_certificate_info.files | default([]) | length == 0
 | 
					 | 
				
			||||||
@@ -1,9 +0,0 @@
 | 
				
			|||||||
[Unit]
 | 
					 | 
				
			||||||
Description=Run lego@{{ lego_instance}}.service
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
[Timer]
 | 
					 | 
				
			||||||
OnCalendar={{ lego_systemd_timer_calendar }}
 | 
					 | 
				
			||||||
Unit=lego@{{ lego_instance }}.service
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
[Install]
 | 
					 | 
				
			||||||
WantedBy=timers.target
 | 
					 | 
				
			||||||
@@ -1,14 +0,0 @@
 | 
				
			|||||||
[Unit]
 | 
					 | 
				
			||||||
Description=Run lego (letsencrypt client in go)
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
[Service]
 | 
					 | 
				
			||||||
Type=oneshot
 | 
					 | 
				
			||||||
EnvironmentFile={{ lego_base_path }}/%i.conf
 | 
					 | 
				
			||||||
User={{ lego_systemd_user }}
 | 
					 | 
				
			||||||
Group={{ lego_systemd_group }}
 | 
					 | 
				
			||||||
ExecStart={{ lego_base_path }}/run.sh
 | 
					 | 
				
			||||||
AmbientCapabilities=CAP_NET_BIND_SERVICE
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
[Install]
 | 
					 | 
				
			||||||
WantedBy=basic.target
 | 
					 | 
				
			||||||
DefaultInstance=default
 | 
					 | 
				
			||||||
@@ -1,16 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
lego_domain_command_args: >-
 | 
					 | 
				
			||||||
  {% for domain in lego_cert_domains %}
 | 
					 | 
				
			||||||
   --domains={{ domain }}
 | 
					 | 
				
			||||||
  {%- endfor %}
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
lego_config_command_args: >-
 | 
					 | 
				
			||||||
  {% for key in lego_full_command_config %}
 | 
					 | 
				
			||||||
   --{{ key | replace("_", "-") }}
 | 
					 | 
				
			||||||
  {%- if lego_full_command_config[key] != None and lego_full_command_config[key] != '' -%}
 | 
					 | 
				
			||||||
  ={{ lego_full_command_config[key] }}
 | 
					 | 
				
			||||||
  {%- endif -%}
 | 
					 | 
				
			||||||
  {%- endfor -%}
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
lego_command_args: "{{ lego_domain_command_args }} {{ lego_config_command_args }}"
 | 
					 | 
				
			||||||
@@ -1,29 +0,0 @@
 | 
				
			|||||||
# `finallycoffee.base.minio` ansible role
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
## Overview
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
This role deploys a [min.io](https://min.io) server (s3-compatible object storage server)
 | 
					 | 
				
			||||||
using the official docker container image.
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
## Configuration
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
The role requires setting the password for the `root` user (name can be changed by
 | 
					 | 
				
			||||||
setting `minio_root_username`) in `minio_root_password`. That user has full control
 | 
					 | 
				
			||||||
over the minio-server instance.
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
### Useful config hints
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
Most configuration is done by setting environment variables in
 | 
					 | 
				
			||||||
`minio_container_extra_env`, for example:
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
```yaml
 | 
					 | 
				
			||||||
minio_container_extra_env:
 | 
					 | 
				
			||||||
  # disable the "console" web browser UI
 | 
					 | 
				
			||||||
  MINIO_BROWSER: off
 | 
					 | 
				
			||||||
  # enable public prometheus metrics on `/minio/v2/metrics/cluster`
 | 
					 | 
				
			||||||
  MINIO_PROMETHEUS_AUTH_TYPE: public
 | 
					 | 
				
			||||||
```
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
When serving minio (or any s3-compatible server) on a "subfolder",
 | 
					 | 
				
			||||||
see https://docs.aws.amazon.com/AmazonS3/latest/userguide/RESTRedirect.html
 | 
					 | 
				
			||||||
and https://docs.aws.amazon.com/AmazonS3/latest/userguide/VirtualHosting.html
 | 
					 | 
				
			||||||
@@ -1,33 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
minio_container_name: minio
 | 
					 | 
				
			||||||
minio_container_image_name: "docker.io/minio/minio"
 | 
					 | 
				
			||||||
minio_container_image_tag: "RELEASE.2025-09-07T16-13-09Z"
 | 
					 | 
				
			||||||
minio_container_image: "{{ minio_container_image_name }}:{{ minio_container_image_tag }}"
 | 
					 | 
				
			||||||
minio_container_networks: []
 | 
					 | 
				
			||||||
minio_container_ports: []
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
minio_container_base_volumes:
 | 
					 | 
				
			||||||
  - "{{ minio_data_path }}:{{ minio_container_data_path }}:z"
 | 
					 | 
				
			||||||
minio_container_extra_volumes: []
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
minio_container_base_env:
 | 
					 | 
				
			||||||
  MINIO_ROOT_USER: "{{ minio_root_username }}"
 | 
					 | 
				
			||||||
  MINIO_ROOT_PASSWORD: "{{ minio_root_password }}"
 | 
					 | 
				
			||||||
minio_container_extra_env: {}
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
minio_container_labels: {}
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
minio_container_command:
 | 
					 | 
				
			||||||
  - "server"
 | 
					 | 
				
			||||||
  - "{{ minio_container_data_path }}"
 | 
					 | 
				
			||||||
  - "--console-address"
 | 
					 | 
				
			||||||
  - ":{{ minio_container_listen_port_console }}"
 | 
					 | 
				
			||||||
minio_container_restart_policy: "unless-stopped"
 | 
					 | 
				
			||||||
minio_container_image_force_source: "{{ (minio_container_image_tag == 'latest')|bool }}"
 | 
					 | 
				
			||||||
minio_container_state: >-2
 | 
					 | 
				
			||||||
  {{ (minio_state == 'present') | ternary('started', 'absent') }}
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
minio_container_listen_port_api: 9000
 | 
					 | 
				
			||||||
minio_container_listen_port_console: 8900
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
minio_container_data_path: /storage
 | 
					 | 
				
			||||||
@@ -1,12 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
minio_user: ~
 | 
					 | 
				
			||||||
minio_data_path: /opt/minio
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
minio_create_user: false
 | 
					 | 
				
			||||||
minio_manage_host_filesystem: false
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
minio_root_username: root
 | 
					 | 
				
			||||||
minio_root_password: ~
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
minio_state: present
 | 
					 | 
				
			||||||
minio_deployment_method: docker
 | 
					 | 
				
			||||||
@@ -1,29 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
- name: Ensure filesystem mounts ({{ minio_data_path }}) for container volumes are present
 | 
					 | 
				
			||||||
  ansible.builtin.file:
 | 
					 | 
				
			||||||
    path: "{{ minio_data_path }}"
 | 
					 | 
				
			||||||
    state: directory
 | 
					 | 
				
			||||||
    user: "{{ minio_user|default(omit, True) }}"
 | 
					 | 
				
			||||||
    group: "{{ minio_user|default(omit, True) }}"
 | 
					 | 
				
			||||||
  when: minio_manage_host_filesystem
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Ensure container image '{{ minio_container_image }}' is {{ minio_state }}
 | 
					 | 
				
			||||||
  community.docker.docker_image:
 | 
					 | 
				
			||||||
    name: "{{ minio_container_image }}"
 | 
					 | 
				
			||||||
    state: "{{ minio_state }}"
 | 
					 | 
				
			||||||
    source: pull
 | 
					 | 
				
			||||||
    force_source: "{{ minio_container_image_force_source }}"
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Ensure container '{{ minio_container_name }}' is {{ minio_container_state }}
 | 
					 | 
				
			||||||
  community.docker.docker_container:
 | 
					 | 
				
			||||||
    name: "{{ minio_container_name }}"
 | 
					 | 
				
			||||||
    image: "{{ minio_container_image }}"
 | 
					 | 
				
			||||||
    volumes: "{{ minio_container_volumes }}"
 | 
					 | 
				
			||||||
    env: "{{ minio_container_env }}"
 | 
					 | 
				
			||||||
    labels: "{{ minio_container_labels }}"
 | 
					 | 
				
			||||||
    networks: "{{ minio_container_networks }}"
 | 
					 | 
				
			||||||
    ports: "{{ minio_container_ports }}"
 | 
					 | 
				
			||||||
    user: "{{ minio_user|default(omit, True) }}"
 | 
					 | 
				
			||||||
    command: "{{ minio_container_command }}"
 | 
					 | 
				
			||||||
    restart_policy: "{{ minio_container_restart_policy }}"
 | 
					 | 
				
			||||||
    state: "{{ minio_container_state }}"
 | 
					 | 
				
			||||||
@@ -1,25 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
- name: Ensure 'minio_state' is valid
 | 
					 | 
				
			||||||
  ansible.builtin.fail:
 | 
					 | 
				
			||||||
    msg: >-
 | 
					 | 
				
			||||||
      Unsupported state '{{ minio_state }}'!
 | 
					 | 
				
			||||||
      Supported states are {{ minio_states | join(', ') }}.
 | 
					 | 
				
			||||||
  when: minio_state not in minio_states
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Ensure 'minio_deployment_method' is valid
 | 
					 | 
				
			||||||
  ansible.builtin.fail:
 | 
					 | 
				
			||||||
    msg: >-
 | 
					 | 
				
			||||||
      Unsupported state '{{ minio_deployment_method }}'!
 | 
					 | 
				
			||||||
      Supported states are {{ minio_deployment_methods | join(', ') }}.
 | 
					 | 
				
			||||||
  when: minio_deployment_method not in minio_deployment_methods
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Ensure minio run user is {{ minio_state }}
 | 
					 | 
				
			||||||
  ansible.builtin.user:
 | 
					 | 
				
			||||||
    name: "{{ minio_user }}"
 | 
					 | 
				
			||||||
    state: "{{ minio_state }}"
 | 
					 | 
				
			||||||
    system: true
 | 
					 | 
				
			||||||
  when: minio_create_user
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Deploy minio using {{ minio_deployment_method }}
 | 
					 | 
				
			||||||
  ansible.builtin.include_tasks:
 | 
					 | 
				
			||||||
    file: "deploy-{{ minio_deployment_method }}.yml"
 | 
					 | 
				
			||||||
@@ -1,9 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
minio_states:
 | 
					 | 
				
			||||||
  - present
 | 
					 | 
				
			||||||
  - absent
 | 
					 | 
				
			||||||
minio_deployment_methods:
 | 
					 | 
				
			||||||
  - docker
 | 
					 | 
				
			||||||
minio_container_volumes: "{{ minio_container_base_volumes + minio_container_extra_volumes }}"
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
minio_container_env: "{{ minio_container_base_env | combine(minio_container_extra_env) }}"
 | 
					 | 
				
			||||||
@@ -1,4 +0,0 @@
 | 
				
			|||||||
# `finallycoffee.base.mosh`
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
Installs [`mosh`](https://mosh.org/#), a remote 'mobile shell' which supports
 | 
					 | 
				
			||||||
roaming and re-uses SSH for the authentication layer.
 | 
					 | 
				
			||||||
@@ -1,2 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
mosh_state: present
 | 
					 | 
				
			||||||
@@ -1,15 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
mosh_debian_packages:
 | 
					 | 
				
			||||||
  - "mosh"
 | 
					 | 
				
			||||||
  - "openssh-server"
 | 
					 | 
				
			||||||
mosh_fedora_packages:
 | 
					 | 
				
			||||||
  - "mosh"
 | 
					 | 
				
			||||||
  - "openssh-server"
 | 
					 | 
				
			||||||
mosh_archlinux_packages:
 | 
					 | 
				
			||||||
  - "mosh"
 | 
					 | 
				
			||||||
  - "openssh"
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
mosh_packages:
 | 
					 | 
				
			||||||
  debian: "{{ mosh_debian_packages }}"
 | 
					 | 
				
			||||||
  fedora: "{{ mosh_fedora_packages }}"
 | 
					 | 
				
			||||||
  archlinux: "{{ mosh_archlinux_packages }}"
 | 
					 | 
				
			||||||
@@ -1,30 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
- name: Ensure mosh is {{ mosh_state }} (dnf)
 | 
					 | 
				
			||||||
  ansible.builtin.dnf:
 | 
					 | 
				
			||||||
    name: "{{ mosh_packages[_key] }}"
 | 
					 | 
				
			||||||
    state: "{{ mosh_state }}"
 | 
					 | 
				
			||||||
  when:
 | 
					 | 
				
			||||||
    - ansible_facts['pkg_mgr'] in ['dnf', 'dnf5']
 | 
					 | 
				
			||||||
    - _key in mosh_packages.keys()
 | 
					 | 
				
			||||||
  vars:
 | 
					 | 
				
			||||||
    _key: "{{ ansible_distribution | lower }}"
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Ensure mosh is {{ mosh_state }} (apt)
 | 
					 | 
				
			||||||
  ansible.builtin.apt:
 | 
					 | 
				
			||||||
    package: "{{ mosh_packages[_key] }}"
 | 
					 | 
				
			||||||
    state: "{{ mosh_state }}"
 | 
					 | 
				
			||||||
  when:
 | 
					 | 
				
			||||||
    - ansible_facts['pkg_mgr'] in ['apt']
 | 
					 | 
				
			||||||
    - _key in mosh_packages.keys()
 | 
					 | 
				
			||||||
  vars:
 | 
					 | 
				
			||||||
    _key: "{{ ansible_distribution | lower }}"
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Ensure mosh is {{ mosh_state }} (pacman)
 | 
					 | 
				
			||||||
  community.general.pacman:
 | 
					 | 
				
			||||||
    name: "{{ mosh_packages[_key] }}"
 | 
					 | 
				
			||||||
    state: "{{ mosh_state }}"
 | 
					 | 
				
			||||||
  when:
 | 
					 | 
				
			||||||
    - ansible_facts['pkg_mgr'] in ['pacman']
 | 
					 | 
				
			||||||
    - _key in mosh_packages.keys()
 | 
					 | 
				
			||||||
  vars:
 | 
					 | 
				
			||||||
    _key: "{{ ansible_distribution | lower }}"
 | 
					 | 
				
			||||||
@@ -1,11 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
- name: Ensure 'mosh_state' is valid
 | 
					 | 
				
			||||||
  ansible.builtin.fail:
 | 
					 | 
				
			||||||
    msg: >-2
 | 
					 | 
				
			||||||
      Invalid state '{{ mosh_state }}' for 'mosh_state'!
 | 
					 | 
				
			||||||
      Allowed states are {{ mosh_states | join(', ') }}.
 | 
					 | 
				
			||||||
  when: mosh_state not in mosh_states
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Ensure mosh is {{ mosh_state }}
 | 
					 | 
				
			||||||
  ansible.builtin.include_tasks:
 | 
					 | 
				
			||||||
    file: "install.yml"
 | 
					 | 
				
			||||||
@@ -1,4 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
mosh_states:
 | 
					 | 
				
			||||||
  - "present"
 | 
					 | 
				
			||||||
  - "absent"
 | 
					 | 
				
			||||||
@@ -1,33 +0,0 @@
 | 
				
			|||||||
# `finallycoffee.services.nginx` ansible role
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
## Description
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
Runs `nginx`, a HTTP reverse proxy, in a docker container.
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
## Usage
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
For the role to do anything, `nginx_config` needs to be populated with the configuration for nginx.
 | 
					 | 
				
			||||||
An example would be:
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
```yaml
 | 
					 | 
				
			||||||
nginx_config: |+
 | 
					 | 
				
			||||||
  server {
 | 
					 | 
				
			||||||
    listen 80 default_server;
 | 
					 | 
				
			||||||
    server_name my.server.fqdn;
 | 
					 | 
				
			||||||
    location / { return 200; }
 | 
					 | 
				
			||||||
  }
 | 
					 | 
				
			||||||
```
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
The container is named `nginx` by default, this can be overridden in `nginx_container_name`.
 | 
					 | 
				
			||||||
When running this role multiple times, `nginx_base_path` should also be changed for each run,
 | 
					 | 
				
			||||||
otherwise the configuration files collide in the filesystem.
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
For exposing this server to the host and/or internet, the `nginx_container_ports` (port forwarding host
 | 
					 | 
				
			||||||
from host to container), `nginx_container_networks` (docker networking) or `nginx_container_labels`
 | 
					 | 
				
			||||||
(for label-based routing discovery like traefik) can be used. The options correspond to the arguments
 | 
					 | 
				
			||||||
of the `community.docker.docker_container` module.
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
## Deployment methods
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
Set `nginx_deployment_method` to either `docker` or `podman` to use the respective ansible modules for
 | 
					 | 
				
			||||||
creating and managing the container and its image. See all supported methods in `nginx_deployment_methods`.
 | 
					 | 
				
			||||||
@@ -1,37 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
nginx_version: "1.29.3"
 | 
					 | 
				
			||||||
nginx_flavour: alpine
 | 
					 | 
				
			||||||
nginx_base_path: /opt/nginx
 | 
					 | 
				
			||||||
nginx_config_file: "{{ nginx_base_path }}/nginx.conf"
 | 
					 | 
				
			||||||
nginx_state: present
 | 
					 | 
				
			||||||
nginx_deployment_method: docker
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
nginx_container_name: nginx
 | 
					 | 
				
			||||||
nginx_container_image_reference: >-
 | 
					 | 
				
			||||||
  {{
 | 
					 | 
				
			||||||
    nginx_container_image_repository
 | 
					 | 
				
			||||||
    + ':' + (nginx_container_image_tag
 | 
					 | 
				
			||||||
      | default(nginx_version
 | 
					 | 
				
			||||||
      + (('-' + nginx_flavour) if nginx_flavour is defined else ''), true))
 | 
					 | 
				
			||||||
  }}
 | 
					 | 
				
			||||||
nginx_container_image_repository: >-
 | 
					 | 
				
			||||||
  {{
 | 
					 | 
				
			||||||
    (
 | 
					 | 
				
			||||||
      container_registries[nginx_container_image_registry]
 | 
					 | 
				
			||||||
      | default(nginx_container_image_registry)
 | 
					 | 
				
			||||||
    )
 | 
					 | 
				
			||||||
    + '/'
 | 
					 | 
				
			||||||
    + nginx_container_image_namespace | default('')
 | 
					 | 
				
			||||||
    + nginx_container_image_name
 | 
					 | 
				
			||||||
  }}
 | 
					 | 
				
			||||||
nginx_container_image_registry: "docker.io"
 | 
					 | 
				
			||||||
nginx_container_image_name: "nginx"
 | 
					 | 
				
			||||||
nginx_container_image_tag: ~
 | 
					 | 
				
			||||||
nginx_container_image_source: pull
 | 
					 | 
				
			||||||
nginx_container_state: >-2
 | 
					 | 
				
			||||||
  {{ (nginx_state == 'present') | ternary('started', 'absent') }}
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
nginx_container_restart_policy: "unless-stopped"
 | 
					 | 
				
			||||||
nginx_container_volumes:
 | 
					 | 
				
			||||||
  - "{{ nginx_config_file }}:/etc/nginx/conf.d/nginx.conf:ro"
 | 
					 | 
				
			||||||
 
 | 
					 | 
				
			||||||
@@ -1,8 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Ensure nginx container '{{ nginx_container_name }}' is restarted
 | 
					 | 
				
			||||||
  community.docker.docker_container:
 | 
					 | 
				
			||||||
    name: "{{ nginx_container_name }}"
 | 
					 | 
				
			||||||
    state: started
 | 
					 | 
				
			||||||
    restart: true
 | 
					 | 
				
			||||||
  listen: restart-nginx
 | 
					 | 
				
			||||||
@@ -1,12 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
allow_duplicates: true
 | 
					 | 
				
			||||||
dependencies: []
 | 
					 | 
				
			||||||
galaxy_info:
 | 
					 | 
				
			||||||
  role_name: nginx
 | 
					 | 
				
			||||||
  description: Deploy nginx, a webserver
 | 
					 | 
				
			||||||
  galaxy_tags:
 | 
					 | 
				
			||||||
    - nginx
 | 
					 | 
				
			||||||
    - http
 | 
					 | 
				
			||||||
    - webserver
 | 
					 | 
				
			||||||
    - docker
 | 
					 | 
				
			||||||
    - podman
 | 
					 | 
				
			||||||
@@ -1,28 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
- name: Ensure docker container image '{{ nginx_container_image_reference }}' is {{ nginx_state }}
 | 
					 | 
				
			||||||
  community.docker.docker_image:
 | 
					 | 
				
			||||||
    name: "{{ nginx_container_image_reference }}"
 | 
					 | 
				
			||||||
    state: "{{ nginx_state }}"
 | 
					 | 
				
			||||||
    source: "{{ nginx_container_image_source }}"
 | 
					 | 
				
			||||||
    force_source: >-2
 | 
					 | 
				
			||||||
      {{ nginx_container_image_force_source
 | 
					 | 
				
			||||||
        | default(nginx_container_image_tag | default(false, true)) }}
 | 
					 | 
				
			||||||
  register: nginx_container_image_info
 | 
					 | 
				
			||||||
  until: nginx_container_image_info is success
 | 
					 | 
				
			||||||
  retries: 5
 | 
					 | 
				
			||||||
  delay: 3
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Ensure docker container '{{ nginx_container_name }}' is {{ nginx_container_state }}
 | 
					 | 
				
			||||||
  community.docker.docker_container:
 | 
					 | 
				
			||||||
    name: "{{ nginx_container_name }}"
 | 
					 | 
				
			||||||
    image: "{{ nginx_container_image_reference }}"
 | 
					 | 
				
			||||||
    env: "{{ nginx_container_env | default(omit, true) }}"
 | 
					 | 
				
			||||||
    user: "{{ nginx_container_user | default(omit, true) }}"
 | 
					 | 
				
			||||||
    ports: "{{ nginx_container_ports | default(omit, true) }}"
 | 
					 | 
				
			||||||
    labels: "{{ nginx_container_labels | default(omit, true) }}"
 | 
					 | 
				
			||||||
    volumes: "{{ nginx_container_volumes | default(omit, true) }}"
 | 
					 | 
				
			||||||
    etc_hosts: "{{ nginx_container_etc_hosts | default(omit, true) }}"
 | 
					 | 
				
			||||||
    networks: "{{ nginx_container_networks | default(omit, true) }}"
 | 
					 | 
				
			||||||
    purge_networks: "{{ nginx_container_purge_networks | default(omit, true) }}"
 | 
					 | 
				
			||||||
    restart_policy: "{{ nginx_container_restart_policy }}"
 | 
					 | 
				
			||||||
    state: "{{ nginx_container_state }}"
 | 
					 | 
				
			||||||
@@ -1,27 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
- name: Ensure container image '{{ nginx_container_image_reference }}' is {{ nginx_state }}
 | 
					 | 
				
			||||||
  containers.podman.podman_image:
 | 
					 | 
				
			||||||
    name: "{{ nginx_container_image_reference }}"
 | 
					 | 
				
			||||||
    state: "{{ nginx_state }}"
 | 
					 | 
				
			||||||
    pull: "{{ nginx_container_image_source == 'pull' }}"
 | 
					 | 
				
			||||||
    force: >-2
 | 
					 | 
				
			||||||
      {{ nginx_container_image_force_source
 | 
					 | 
				
			||||||
        | default(nginx_container_image_tag | default(false, true)) }}
 | 
					 | 
				
			||||||
  register: nginx_container_image_info
 | 
					 | 
				
			||||||
  until: nginx_container_image_info is success
 | 
					 | 
				
			||||||
  retries: 5
 | 
					 | 
				
			||||||
  delay: 3
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Ensure container '{{ nginx_container_name }}' is {{ nginx_container_state }}
 | 
					 | 
				
			||||||
  containers.podman.podman_container:
 | 
					 | 
				
			||||||
    name: "{{ nginx_container_name }}"
 | 
					 | 
				
			||||||
    image: "{{ nginx_container_image_reference }}"
 | 
					 | 
				
			||||||
    env: "{{ nginx_container_env | default(omit, true) }}"
 | 
					 | 
				
			||||||
    user: "{{ nginx_container_user | default(omit, true) }}"
 | 
					 | 
				
			||||||
    ports: "{{ nginx_container_ports | default(omit, true) }}"
 | 
					 | 
				
			||||||
    labels: "{{ nginx_container_labels | default(omit, true) }}"
 | 
					 | 
				
			||||||
    volumes: "{{ nginx_container_volumes | default(omit, true) }}"
 | 
					 | 
				
			||||||
    etc_hosts: "{{ nginx_container_etc_hosts | default(omit, true) }}"
 | 
					 | 
				
			||||||
    network: "{{ nginx_container_networks | default(omit, true) }}"
 | 
					 | 
				
			||||||
    restart_policy: "{{ nginx_container_restart_policy }}"
 | 
					 | 
				
			||||||
    state: "{{ nginx_container_state }}"
 | 
					 | 
				
			||||||
@@ -1,40 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
- name: Check if state is supported
 | 
					 | 
				
			||||||
  ansible.builtin.fail:
 | 
					 | 
				
			||||||
    msg: >-2
 | 
					 | 
				
			||||||
      Unsupported state '{{ nginx_state }}'. Supported
 | 
					 | 
				
			||||||
      states are {{ nginx_states | join(', ') }}.
 | 
					 | 
				
			||||||
  when: nginx_state not in nginx_states
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Check if deployment_method is supported
 | 
					 | 
				
			||||||
  ansible.builtin.fail:
 | 
					 | 
				
			||||||
    msg: >-2
 | 
					 | 
				
			||||||
      Unsupported state '{{ nginx_deployment_method }}'. Supported
 | 
					 | 
				
			||||||
      states are {{ nginx_deployment_methods | join(', ') }}.
 | 
					 | 
				
			||||||
  when: nginx_deployment_method not in nginx_deployment_methods
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Ensure nginx config file is {{ nginx_state }}
 | 
					 | 
				
			||||||
  ansible.builtin.file:
 | 
					 | 
				
			||||||
    path: "{{ nginx_config_file }}"
 | 
					 | 
				
			||||||
    state: "{{ nginx_state }}"
 | 
					 | 
				
			||||||
  when: nginx_state == 'absent'
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Ensure base path '{{ nginx_base_path }}' is {{ nginx_state }}
 | 
					 | 
				
			||||||
  ansible.builtin.file:
 | 
					 | 
				
			||||||
    path: "{{ nginx_base_path }}"
 | 
					 | 
				
			||||||
    mode: "0755"
 | 
					 | 
				
			||||||
    state: >-2
 | 
					 | 
				
			||||||
      {{ (nginx_state == 'present') | ternary('directory', 'absent') }}
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Ensure nginx config file is templated
 | 
					 | 
				
			||||||
  ansible.builtin.copy:
 | 
					 | 
				
			||||||
    dest: "{{ nginx_config_file }}"
 | 
					 | 
				
			||||||
    content: "{{ nginx_config }}"
 | 
					 | 
				
			||||||
    mode: 0640
 | 
					 | 
				
			||||||
  notify:
 | 
					 | 
				
			||||||
    - restart-nginx
 | 
					 | 
				
			||||||
  when: nginx_state == 'present'
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Deploy using {{ nginx_deployment_method }}
 | 
					 | 
				
			||||||
  ansible.builtin.include_tasks:
 | 
					 | 
				
			||||||
    file: "deploy-{{ nginx_deployment_method }}.yml"
 | 
					 | 
				
			||||||
@@ -1,7 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
nginx_states:
 | 
					 | 
				
			||||||
  - present
 | 
					 | 
				
			||||||
  - absent
 | 
					 | 
				
			||||||
nginx_deployment_methods:
 | 
					 | 
				
			||||||
  - docker
 | 
					 | 
				
			||||||
  - podman
 | 
					 | 
				
			||||||
							
								
								
									
										41
									
								
								roles/nscd/defaults/main.yml
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										41
									
								
								roles/nscd/defaults/main.yml
									
									
									
									
									
										Normal file
									
								
							@@ -0,0 +1,41 @@
 | 
				
			|||||||
 | 
					---
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					nscd_config_file: /etc/nscd.conf
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					nscd_config_password_enable_cache: true
 | 
				
			||||||
 | 
					nscd_config_password_positive_ttl_seconds: 300
 | 
				
			||||||
 | 
					nscd_config_password_negative_ttl_seconds: 10
 | 
				
			||||||
 | 
					nscd_config_password_suggested_size: 221
 | 
				
			||||||
 | 
					nscd_config_password_check_files: true
 | 
				
			||||||
 | 
					nscd_config_password_persistent: true
 | 
				
			||||||
 | 
					nscd_config_password_shared: true
 | 
				
			||||||
 | 
					nscd_config_password_max_db_size_bytes: 33554432
 | 
				
			||||||
 | 
					nscd_config_password_auto_propagate: yes
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					nscd_config_group_enable_cache: true
 | 
				
			||||||
 | 
					nscd_config_group_positive_ttl_seconds: 900
 | 
				
			||||||
 | 
					nscd_config_group_negative_ttl_seconds: 30
 | 
				
			||||||
 | 
					nscd_config_group_suggested_size: 221
 | 
				
			||||||
 | 
					nscd_config_group_check_files: true
 | 
				
			||||||
 | 
					nscd_config_group_persistent: true
 | 
				
			||||||
 | 
					nscd_config_group_shared: true
 | 
				
			||||||
 | 
					nscd_config_group_max_db_size_bytes: 33554432
 | 
				
			||||||
 | 
					nscd_config_group_auto_propagate: yes
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					nscd_config_hosts_enable_cache: true
 | 
				
			||||||
 | 
					nscd_config_hosts_positive_ttl_seconds: 1800
 | 
				
			||||||
 | 
					nscd_config_hosts_negative_ttl_seconds: 60
 | 
				
			||||||
 | 
					nscd_config_hosts_suggested_size: 221
 | 
				
			||||||
 | 
					nscd_config_hosts_check_files: true
 | 
				
			||||||
 | 
					nscd_config_hosts_persistent: true
 | 
				
			||||||
 | 
					nscd_config_hosts_shared: true
 | 
				
			||||||
 | 
					nscd_config_hosts_max_db_size_bytes: 33554432
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					nscd_config_services_enable_cache: true
 | 
				
			||||||
 | 
					nscd_config_services_positive_ttl_seconds: 28800
 | 
				
			||||||
 | 
					nscd_config_services_negative_ttl_seconds: 20
 | 
				
			||||||
 | 
					nscd_config_services_suggested_size: 221
 | 
				
			||||||
 | 
					nscd_config_services_check_files: true
 | 
				
			||||||
 | 
					nscd_config_services_persistent: true
 | 
				
			||||||
 | 
					nscd_config_services_shared: true
 | 
				
			||||||
 | 
					nscd_config_services_max_db_size_bytes: 33554432
 | 
				
			||||||
							
								
								
									
										27
									
								
								roles/nscd/tasks/main.yml
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										27
									
								
								roles/nscd/tasks/main.yml
									
									
									
									
									
										Normal file
									
								
							@@ -0,0 +1,27 @@
 | 
				
			|||||||
 | 
					---
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					- name: Make sure nscd is installed
 | 
				
			||||||
 | 
					  apt:
 | 
				
			||||||
 | 
					    name: "{{ nscd_apt_package_name }}"
 | 
				
			||||||
 | 
					    state: present
 | 
				
			||||||
 | 
					  when: ansible_facts['pkg_mgr'] == 'apt'
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					- name: Ensure nscd is configured
 | 
				
			||||||
 | 
					  template:
 | 
				
			||||||
 | 
					    src: nscd.conf.j2
 | 
				
			||||||
 | 
					    dest: "{{ nscd_config_file }}"
 | 
				
			||||||
 | 
					    owner: root
 | 
				
			||||||
 | 
					    group: root
 | 
				
			||||||
 | 
					    mode: "0640"
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					- name: Ensure systemd service is enabled
 | 
				
			||||||
 | 
					  systemd:
 | 
				
			||||||
 | 
					    service: "{{ nscd_systemd_service_name }}"
 | 
				
			||||||
 | 
					    enabled: true
 | 
				
			||||||
 | 
					  when: ansible_facts['service_mgr'] == 'systemd'
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					- name: Ensure systemd service is started
 | 
				
			||||||
 | 
					  systemd:
 | 
				
			||||||
 | 
					    service: "{{ nscd_systemd_service_name }}"
 | 
				
			||||||
 | 
					    state: started
 | 
				
			||||||
 | 
					  when: ansible_facts['service_mgr'] == 'systemd'
 | 
				
			||||||
							
								
								
									
										41
									
								
								roles/nscd/templates/nscd.conf.j2
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										41
									
								
								roles/nscd/templates/nscd.conf.j2
									
									
									
									
									
										Normal file
									
								
							@@ -0,0 +1,41 @@
 | 
				
			|||||||
 | 
					#logfile	/var/log/nscd.log
 | 
				
			||||||
 | 
					#threads	4
 | 
				
			||||||
 | 
					#max-threads	32
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					enable-cache		passwd	{{ nscd_config_passwd_auto_propagate | ternary('yes', 'no') }}
 | 
				
			||||||
 | 
					positive-time-to-live	passwd	{{ nscd_config_passwd_positive_ttl_seconds }}
 | 
				
			||||||
 | 
					negative-time-to-live	passwd	{{ nscd_config_passwd_negative_ttl_seconds }}
 | 
				
			||||||
 | 
					suggested-size		passwd	{{ nscd_config_passwd_suggested_size }}
 | 
				
			||||||
 | 
					check-files		passwd	{{ nscd_config_passwd_check_files | ternary('yes', 'no') }}
 | 
				
			||||||
 | 
					persistent		passwd	{{ nscd_config_passwd_persistent | ternary('yes', 'no') }}
 | 
				
			||||||
 | 
					shared			passwd	{{ nscd_config_passwd_shared | ternary('yes', 'no') }}
 | 
				
			||||||
 | 
					max-db-size		passwd	{{ nscd_config_passwd_max_db_size_bytes }}
 | 
				
			||||||
 | 
					auto-propagate		passwd	{{ nscd_config_passwd_auto_propagate | ternary('yes', 'no') }}
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					enable-cache		group	{{ nscd_config_group_auto_propagate | ternary('yes', 'no') }}
 | 
				
			||||||
 | 
					positive-time-to-live	group	{{ nscd_config_group_positive_ttl_seconds }}
 | 
				
			||||||
 | 
					negative-time-to-live	group	{{ nscd_config_group_negative_ttl_seconds }}
 | 
				
			||||||
 | 
					suggested-size		group	{{ nscd_config_group_suggested_size }}
 | 
				
			||||||
 | 
					check-files		group	{{ nscd_config_group_check_files | ternary('yes', 'no') }}
 | 
				
			||||||
 | 
					persistent		group	{{ nscd_config_group_persistent | ternary('yes', 'no') }}
 | 
				
			||||||
 | 
					shared			group	{{ nscd_config_group_shared | ternary('yes', 'no') }}
 | 
				
			||||||
 | 
					max-db-size		group	{{ nscd_config_group_max_db_size_bytes }}
 | 
				
			||||||
 | 
					auto-propagate		group	{{ nscd_config_group_auto_propagate | ternary('yes', 'no') }}
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					enable-cache		hosts	{{ nscd_config_hosts_auto_propagate | ternary('yes', 'no') }}
 | 
				
			||||||
 | 
					positive-time-to-live	hosts	{{ nscd_config_hosts_positive_ttl_seconds }}
 | 
				
			||||||
 | 
					negative-time-to-live	hosts	{{ nscd_config_hosts_negative_ttl_seconds }}
 | 
				
			||||||
 | 
					suggested-size		hosts	{{ nscd_config_hosts_suggested_size }}
 | 
				
			||||||
 | 
					check-files		hosts	{{ nscd_config_hosts_check_files | ternary('yes', 'no') }}
 | 
				
			||||||
 | 
					persistent		hosts	{{ nscd_config_hosts_persistent | ternary('yes', 'no') }}
 | 
				
			||||||
 | 
					shared			hosts	{{ nscd_config_hosts_shared | ternary('yes', 'no') }}
 | 
				
			||||||
 | 
					max-db-size		hosts	{{ nscd_config_hosts_max_db_size_bytes }}
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					enable-cache		services	{{ nscd_config_services_auto_propagate | ternary('yes', 'no') }}
 | 
				
			||||||
 | 
					positive-time-to-live	services	{{ nscd_config_services_positive_ttl_seconds }}
 | 
				
			||||||
 | 
					negative-time-to-live	services	{{ nscd_config_services_negative_ttl_seconds }}
 | 
				
			||||||
 | 
					suggested-size		services	{{ nscd_config_services_suggested_size }}
 | 
				
			||||||
 | 
					check-files		services	{{ nscd_config_services_check_files | ternary('yes', 'no') }}
 | 
				
			||||||
 | 
					persistent		services	{{ nscd_config_services_persistent | ternary('yes', 'no') }}
 | 
				
			||||||
 | 
					shared			services	{{ nscd_config_services_shared | ternary('yes', 'no') }}
 | 
				
			||||||
 | 
					max-db-size		services	{{ nscd_config_services_max_db_size_bytes }}
 | 
				
			||||||
							
								
								
									
										4
									
								
								roles/nscd/vars/main.yml
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										4
									
								
								roles/nscd/vars/main.yml
									
									
									
									
									
										Normal file
									
								
							@@ -0,0 +1,4 @@
 | 
				
			|||||||
 | 
					---
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					nscd_apt_package_name: nscd
 | 
				
			||||||
 | 
					nscd_systemd_service_name: nscd.service
 | 
				
			||||||
							
								
								
									
										20
									
								
								roles/nslcd/defaults/main.yml
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										20
									
								
								roles/nslcd/defaults/main.yml
									
									
									
									
									
										Normal file
									
								
							@@ -0,0 +1,20 @@
 | 
				
			|||||||
 | 
					---
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					nslcd_config_uid: nslcd
 | 
				
			||||||
 | 
					nslcd_config_gid: nslcd
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					nslcd_config_ldap_uri: ldaps://127.0.0.1
 | 
				
			||||||
 | 
					nslcd_config_ldap_base: ~
 | 
				
			||||||
 | 
					nslcd_config_ldap_scope: sub
 | 
				
			||||||
 | 
					nslcd_config_ldap_version: 3
 | 
				
			||||||
 | 
					nslcd_config_ldap_bind_dn: ~
 | 
				
			||||||
 | 
					nslcd_config_ldap_bind_pw: ~
 | 
				
			||||||
 | 
					nslcd_config_ldap_root_pw_mod_dn: ~
 | 
				
			||||||
 | 
					nslcd_config_ldap_ssl: on
 | 
				
			||||||
 | 
					nslcd_config_ldap_tls_reqcert: always
 | 
				
			||||||
 | 
					nslcd_config_ldap_tls_cacertfile: /etc/ssl/certs/ca-certificates.crt
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					nslcd_config_pam_authz_search: >-2
 | 
				
			||||||
 | 
					  (&(objectClass=posixAccount)(uid=$username)(|
 | 
				
			||||||
 | 
					    (host=$hostname)(host=$fqdn)
 | 
				
			||||||
 | 
					  ))
 | 
				
			||||||
							
								
								
									
										27
									
								
								roles/nslcd/tasks/main.yml
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										27
									
								
								roles/nslcd/tasks/main.yml
									
									
									
									
									
										Normal file
									
								
							@@ -0,0 +1,27 @@
 | 
				
			|||||||
 | 
					---
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					- name: Ensure nslcd is installed
 | 
				
			||||||
 | 
					  apt:
 | 
				
			||||||
 | 
					    name: "{{ nslcd_apt_package_name }}"
 | 
				
			||||||
 | 
					    state: present
 | 
				
			||||||
 | 
					  when: ansible_facts['pkg_mgr'] == 'apt'
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					- name: Ensure config is templated
 | 
				
			||||||
 | 
					  template:
 | 
				
			||||||
 | 
					    src: nslcd.conf.j2
 | 
				
			||||||
 | 
					    dest: /etc/nslcd.conf
 | 
				
			||||||
 | 
					    owner: root
 | 
				
			||||||
 | 
					    group: root
 | 
				
			||||||
 | 
					    mode: "0640"
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					- name: Ensure systemd service is enabled
 | 
				
			||||||
 | 
					  systemd:
 | 
				
			||||||
 | 
					    service: "{{ nslcd_systemd_service_name }}"
 | 
				
			||||||
 | 
					    enabled: true
 | 
				
			||||||
 | 
					  when: ansible_facts['service_mgr'] == 'systemd'
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					- name: Ensure systemd service is running
 | 
				
			||||||
 | 
					  systemd:
 | 
				
			||||||
 | 
					    service: "{{ nslcd_systemd_service_name }}"
 | 
				
			||||||
 | 
					    state: started
 | 
				
			||||||
 | 
					  when: ansible_facts['service_mgr'] == 'systemd'
 | 
				
			||||||
							
								
								
									
										17
									
								
								roles/nslcd/templates/nslcd.conf.j2
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										17
									
								
								roles/nslcd/templates/nslcd.conf.j2
									
									
									
									
									
										Normal file
									
								
							@@ -0,0 +1,17 @@
 | 
				
			|||||||
 | 
					uid {{ nslcd_config_uid }}
 | 
				
			||||||
 | 
					gid {{ nslcd_config_gid }}
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					uri {{ nslcd_config_ldap_uri }}
 | 
				
			||||||
 | 
					base {{ nslcd_config_ldap_base }}
 | 
				
			||||||
 | 
					binddn {{ nslcd_config_ldap_bind_dn }}
 | 
				
			||||||
 | 
					bindpw {{ nslcd_config_ldap_bind_pw }}
 | 
				
			||||||
 | 
					ldap_version {{ nslcd_config_ldap_version }}
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					rootpwmoddn {{ nslcd_config_ldap_root_pw_mod_dn }}
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					ssl {{ nslcd_config_ldap_ssl }}
 | 
				
			||||||
 | 
					tls_reqcert {{ nslcd_config_ldap_tls_reqcert }}
 | 
				
			||||||
 | 
					tls_cacertfile {{ nslcd_config_ldap_tls_cacertfile }}
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					scope {{ nslcd_config_ldap_scope }}
 | 
				
			||||||
 | 
					pam_authz_search {{ nslcd_config_ldap_pam_authz_search }}
 | 
				
			||||||
							
								
								
									
										0
									
								
								roles/nslcd/vars/main.yml
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										0
									
								
								roles/nslcd/vars/main.yml
									
									
									
									
									
										Normal file
									
								
							@@ -1,3 +0,0 @@
 | 
				
			|||||||
# `finallycoffee.base.openldap` ansible role
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
Deploy and configure [OpenLDAP](https://www.openldap.org/).
 | 
					 | 
				
			||||||
@@ -1,61 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
openldap_container_name: "openldap"
 | 
					 | 
				
			||||||
openldap_container_image_registry: docker.finally.coffee
 | 
					 | 
				
			||||||
openldap_container_image_namespace: containers
 | 
					 | 
				
			||||||
openldap_container_image_name: "openldap"
 | 
					 | 
				
			||||||
openldap_container_image_tag: ~
 | 
					 | 
				
			||||||
openldap_container_image_source: "pull"
 | 
					 | 
				
			||||||
openldap_container_image_force_source: >-2
 | 
					 | 
				
			||||||
  {{ openldap_container_image_tag | default(false, true) }}
 | 
					 | 
				
			||||||
openldap_container_image_repository: >-2
 | 
					 | 
				
			||||||
  {{
 | 
					 | 
				
			||||||
    [
 | 
					 | 
				
			||||||
      openldap_container_image_registry | default([], true),
 | 
					 | 
				
			||||||
      openldap_container_image_namespace | default([], true),
 | 
					 | 
				
			||||||
      openldap_container_image_name
 | 
					 | 
				
			||||||
    ] | flatten | join('/')
 | 
					 | 
				
			||||||
  }}
 | 
					 | 
				
			||||||
openldap_container_image: >-2
 | 
					 | 
				
			||||||
  {{
 | 
					 | 
				
			||||||
    [
 | 
					 | 
				
			||||||
      openldap_container_image_repository,
 | 
					 | 
				
			||||||
      openldap_container_image_tag
 | 
					 | 
				
			||||||
        | default(openldap_alpine_package_version, true),
 | 
					 | 
				
			||||||
    ] | join(':')
 | 
					 | 
				
			||||||
  }}
 | 
					 | 
				
			||||||
openldap_container_env: ~
 | 
					 | 
				
			||||||
openldap_container_user: ~
 | 
					 | 
				
			||||||
openldap_container_ports: ~
 | 
					 | 
				
			||||||
openldap_container_labels: ~
 | 
					 | 
				
			||||||
openldap_container_volumes: ~
 | 
					 | 
				
			||||||
openldap_container_networks: ~
 | 
					 | 
				
			||||||
openldap_container_network_mode: ~
 | 
					 | 
				
			||||||
openldap_container_dns_servers: ~
 | 
					 | 
				
			||||||
openldap_container_etc_hosts: ~
 | 
					 | 
				
			||||||
openldap_container_ulimits:
 | 
					 | 
				
			||||||
  - "nofile:{{ openldap_fd_soft_limit }}:{{ openldap_fd_hard_limit }}"
 | 
					 | 
				
			||||||
openldap_container_memory: "256M"
 | 
					 | 
				
			||||||
openldap_container_memory_swap: ~
 | 
					 | 
				
			||||||
openldap_container_memory_reservation: "128M"
 | 
					 | 
				
			||||||
openldap_container_restart_policy: "on-failure"
 | 
					 | 
				
			||||||
openldap_container_state: >-2
 | 
					 | 
				
			||||||
  {{ (openldap_state == 'present') | ternary('started', 'absent') }}
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
openldap_container_data_path: "{{ openldap_data_path }}"
 | 
					 | 
				
			||||||
openldap_container_config_path: "{{ openldap_config_path }}"
 | 
					 | 
				
			||||||
openldap_container_socket_path: "{{ openldap_socket_path }}"
 | 
					 | 
				
			||||||
openldap_container_base_volumes:
 | 
					 | 
				
			||||||
  - "{{ openldap_config_path }}:{{ openldap_container_config_path }}:Z"
 | 
					 | 
				
			||||||
  - "{{ openldap_data_path }}:{{ openldap_container_data_path }}:rw"
 | 
					 | 
				
			||||||
  - "{{ openldap_socket_path }}:{{ openldap_container_socket_path }}:rw"
 | 
					 | 
				
			||||||
openldap_container_all_volumes: >-2
 | 
					 | 
				
			||||||
  {{ openldap_container_base_volumes | default([], true)
 | 
					 | 
				
			||||||
    + openldap_container_volumes | default([], true) }}
 | 
					 | 
				
			||||||
openldap_init_container_volumes:
 | 
					 | 
				
			||||||
  - "{{ [openldap_slapd_path, openldap_slapd_path, 'ro'] | join(':') }}"
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
openldap_container_healthcheck:
 | 
					 | 
				
			||||||
  test: >-2
 | 
					 | 
				
			||||||
    [[ $(netstat -plnte | grep slapd | wc -l) -ge 1 ]]
 | 
					 | 
				
			||||||
    && [[ $(ps aux | grep slapd | wc -l) -ge 1 ]]
 | 
					 | 
				
			||||||
    || exit 1
 | 
					 | 
				
			||||||
@@ -1,24 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
openldap_version: "2.6.8"
 | 
					 | 
				
			||||||
openldap_alpine_revision: "0"
 | 
					 | 
				
			||||||
openldap_alpine_package_version: >-2
 | 
					 | 
				
			||||||
  v{{ openldap_version }}-r{{ openldap_alpine_revision | string }}
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
openldap_domain: ~
 | 
					 | 
				
			||||||
openldap_organization: ~
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
openldap_config_path: "/etc/openldap/"
 | 
					 | 
				
			||||||
openldap_olc_path: "{{ openldap_config_path }}/{0}config"
 | 
					 | 
				
			||||||
openldap_slapd_path: "{{ openldap_config_path }}/slapd.ldif"
 | 
					 | 
				
			||||||
openldap_schema_path: "{{ openldap_config_path }}/schema"
 | 
					 | 
				
			||||||
openldap_data_path: "/var/lib/openldap"
 | 
					 | 
				
			||||||
openldap_socket_path: "/run/openldap"
 | 
					 | 
				
			||||||
openldap_socket: "{{ openldap_socket_path }}/slapd.sock"
 | 
					 | 
				
			||||||
openldap_socket_url: >-2
 | 
					 | 
				
			||||||
  ldapi://{{ openldap_socket | urlencode | replace('/', '%2F') }}
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
openldap_state: "present"
 | 
					 | 
				
			||||||
openldap_deployment_method: "docker"
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
openldap_slapadd_init_command: >-2
 | 
					 | 
				
			||||||
  slapadd -v -F {{ openldap_olc_path }} -n 0 -l {{ openldap_slapd_path }}
 | 
					 | 
				
			||||||
@@ -1,65 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
openldap_dn: >-2
 | 
					 | 
				
			||||||
  dc={{ openldap_domain | regex_replace('\.', ',dc=') }}
 | 
					 | 
				
			||||||
openldap_root_username: "admin"
 | 
					 | 
				
			||||||
openldap_root_pw: ~
 | 
					 | 
				
			||||||
openldap_root_node_object_classes:
 | 
					 | 
				
			||||||
  - "top"
 | 
					 | 
				
			||||||
  - "dcObject"
 | 
					 | 
				
			||||||
  - "organization"
 | 
					 | 
				
			||||||
openldap_root_node_dc: "{{ openldap_domain | regex_replace('\\..+', '') }}"
 | 
					 | 
				
			||||||
openldap_root_node_o: "{{ openldap_organization | default('not set!', true) }}"
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
openldap_fd_soft_limit: "8192"
 | 
					 | 
				
			||||||
openldap_fd_hard_limit: "8192"
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
openldap_module_path: "/usr/lib/openldap"
 | 
					 | 
				
			||||||
openldap_modules:
 | 
					 | 
				
			||||||
  - "mdb"
 | 
					 | 
				
			||||||
  - "hdb"
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
openldap_core_schema_path: "{{ openldap_schema_path }}/core.ldif"
 | 
					 | 
				
			||||||
openldap_enabled_schemas:
 | 
					 | 
				
			||||||
  - name: "cosine"
 | 
					 | 
				
			||||||
  - name: "inetorgperson"
 | 
					 | 
				
			||||||
openldap_additional_schemas: []
 | 
					 | 
				
			||||||
openldap_schemas: >-2
 | 
					 | 
				
			||||||
  {{ openldap_enabled_schemas + openldap_additional_schemas }}
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
openldap_config_dn: "cn=config"
 | 
					 | 
				
			||||||
openldap_config_db_dn: "olcDatabase={0}config,cn=config"
 | 
					 | 
				
			||||||
openldap_config_db_olc_access:
 | 
					 | 
				
			||||||
  - '{0} to *
 | 
					 | 
				
			||||||
      by dn.base="gidNumber=0+uidNumber=0,cn=peercred,cn=external,cn=auth" manage
 | 
					 | 
				
			||||||
      by * none'
 | 
					 | 
				
			||||||
openldap_config_attributes: {}
 | 
					 | 
				
			||||||
openldap_config_db_attributes:
 | 
					 | 
				
			||||||
  olcAccess: "{{ openldap_config_db_olc_access }}"
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
openldap_default_indices:
 | 
					 | 
				
			||||||
  - "objectClass eq"
 | 
					 | 
				
			||||||
openldap_indices: []
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
openldap_default_database_name: "mdb"
 | 
					 | 
				
			||||||
openldap_default_database_object_class: "olcMdbConfig"
 | 
					 | 
				
			||||||
openldap_default_database_suffix: "{{ openldap_dn }}"
 | 
					 | 
				
			||||||
openldap_default_database_root_dn: >-2
 | 
					 | 
				
			||||||
  cn={{ openldap_root_username }},{{ openldap_default_database_suffix }}
 | 
					 | 
				
			||||||
openldap_default_database_root_pw: "{{ openldap_root_pw }}"
 | 
					 | 
				
			||||||
openldap_default_database_directory: >-2
 | 
					 | 
				
			||||||
  {{ openldap_data_path }}/{{ openldap_default_database_name }}
 | 
					 | 
				
			||||||
openldap_default_database_indices: >-2
 | 
					 | 
				
			||||||
  {{ openldap_default_indices + openldap_indices }}
 | 
					 | 
				
			||||||
openldap_default_database_config: >-2
 | 
					 | 
				
			||||||
  olcDatabase={1}{{ openldap_default_database_name }},{{ openldap_config_dn }}
 | 
					 | 
				
			||||||
openldap_default_database:
 | 
					 | 
				
			||||||
  name: "{{ openldap_default_database_name }}"
 | 
					 | 
				
			||||||
  object_class: "{{ openldap_default_database_object_class }}"
 | 
					 | 
				
			||||||
  suffix: "{{ openldap_default_database_suffix }}"
 | 
					 | 
				
			||||||
  root_dn: "{{ openldap_default_database_root_dn }}"
 | 
					 | 
				
			||||||
  root_pw: "{{ openldap_default_database_root_pw }}"
 | 
					 | 
				
			||||||
  directory: "{{ openldap_default_database_directory }}"
 | 
					 | 
				
			||||||
  indices: "{{ openldap_default_database_indices }}"
 | 
					 | 
				
			||||||
openldap_default_database_olc_access: "{{ openldap_config_db_olc_access }}"
 | 
					 | 
				
			||||||
openldap_databases:
 | 
					 | 
				
			||||||
  - "{{ openldap_default_database }}" 
 | 
					 | 
				
			||||||
@@ -1,80 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
- name: Ensure config attributes are configured
 | 
					 | 
				
			||||||
  community.general.ldap_attrs:
 | 
					 | 
				
			||||||
    dn: "{{ openldap_config_dn }}"
 | 
					 | 
				
			||||||
    attributes: "{{ { entry.key : entry.value } }}"
 | 
					 | 
				
			||||||
    state: exact
 | 
					 | 
				
			||||||
    server_uri: "{{ openldap_socket_url }}"
 | 
					 | 
				
			||||||
  loop: "{{ openldap_config_attributes | dict2items }}"
 | 
					 | 
				
			||||||
  loop_control:
 | 
					 | 
				
			||||||
    loop_var: "entry"
 | 
					 | 
				
			||||||
    label: "{{ entry.key }}"
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Ensure config db attributes are configured
 | 
					 | 
				
			||||||
  community.general.ldap_attrs:
 | 
					 | 
				
			||||||
    dn: "{{ openldap_config_db_dn }}"
 | 
					 | 
				
			||||||
    attributes: "{{ { entry.key : entry.value } }}"
 | 
					 | 
				
			||||||
    state: exact
 | 
					 | 
				
			||||||
    server_uri: "{{ openldap_socket_url }}"
 | 
					 | 
				
			||||||
  loop: "{{ openldap_config_db_attributes | dict2items }}"
 | 
					 | 
				
			||||||
  loop_control:
 | 
					 | 
				
			||||||
    loop_var: "entry"
 | 
					 | 
				
			||||||
    label: "{{ entry.key }}"
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Ensure ACLs for default database are configured
 | 
					 | 
				
			||||||
  community.general.ldap_attrs:
 | 
					 | 
				
			||||||
    dn: "{{ openldap_default_database_config }}"
 | 
					 | 
				
			||||||
    attributes:
 | 
					 | 
				
			||||||
      olcAccess: "{{ openldap_default_database_olc_access }}"
 | 
					 | 
				
			||||||
    state: "exact"
 | 
					 | 
				
			||||||
    server_uri: "{{ openldap_socket_url }}"
 | 
					 | 
				
			||||||
  retries: 3
 | 
					 | 
				
			||||||
  delay: 3
 | 
					 | 
				
			||||||
  register: openldap_acl_result
 | 
					 | 
				
			||||||
  until: openldap_acl_result is succeeded
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Ensure LDAP DIT is configured
 | 
					 | 
				
			||||||
  when:
 | 
					 | 
				
			||||||
    - openldap_default_database_root_dn is defined
 | 
					 | 
				
			||||||
    - openldap_default_database_root_pw is defined
 | 
					 | 
				
			||||||
  vars:
 | 
					 | 
				
			||||||
    _meta: &openldap_bind_info
 | 
					 | 
				
			||||||
      bind_dn: "{{ openldap_default_database_root_dn }}"
 | 
					 | 
				
			||||||
      bind_pw: "{{ openldap_default_database_root_pw }}"
 | 
					 | 
				
			||||||
      server_uri: "{{ openldap_socket_url }}"
 | 
					 | 
				
			||||||
  block:
 | 
					 | 
				
			||||||
    - name: Ensure rootDN + credentials are correct
 | 
					 | 
				
			||||||
      community.general.ldap_attrs:
 | 
					 | 
				
			||||||
        dn: "{{ openldap_default_database_config }}"
 | 
					 | 
				
			||||||
        attributes: "{{ {entry.key: entry.value} }}"
 | 
					 | 
				
			||||||
        state: "exact"
 | 
					 | 
				
			||||||
        server_uri: "{{ openldap_socket_url }}"
 | 
					 | 
				
			||||||
      no_log: "{{ entry.log is defined and not entry.log }}"
 | 
					 | 
				
			||||||
      loop:
 | 
					 | 
				
			||||||
        - key: "olcRootDN"
 | 
					 | 
				
			||||||
          value: "{{ openldap_default_database_root_dn }}"
 | 
					 | 
				
			||||||
        - key: "olcRootPW"
 | 
					 | 
				
			||||||
          value: "{{ openldap_default_database_root_pw }}"
 | 
					 | 
				
			||||||
          log: false
 | 
					 | 
				
			||||||
      loop_control:
 | 
					 | 
				
			||||||
        loop_var: "entry"
 | 
					 | 
				
			||||||
        label: "{{ entry.key }}"
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
    - name: Ensure root node is {{ openldap_state }}
 | 
					 | 
				
			||||||
      community.general.ldap_entry:
 | 
					 | 
				
			||||||
        dn: "{{ openldap_dn }}"
 | 
					 | 
				
			||||||
        objectClass: "{{ openldap_root_node_object_classes }}"
 | 
					 | 
				
			||||||
        attributes:
 | 
					 | 
				
			||||||
          dc: "{{ openldap_root_node_dc }}"
 | 
					 | 
				
			||||||
          o: "{{ openldap_root_node_o }}"
 | 
					 | 
				
			||||||
        <<: *openldap_bind_info
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
    - name: Ensure root node attributes are up to date
 | 
					 | 
				
			||||||
      community.general.ldap_attrs:
 | 
					 | 
				
			||||||
        dn: "{{ openldap_dn }}"
 | 
					 | 
				
			||||||
        attributes:
 | 
					 | 
				
			||||||
          dc: "{{ openldap_root_node_dc }}"
 | 
					 | 
				
			||||||
          o: "{{ openldap_root_node_o }}"
 | 
					 | 
				
			||||||
        state: exact
 | 
					 | 
				
			||||||
        <<: *openldap_bind_info
 | 
					 | 
				
			||||||
      when: openldap_state == 'present'
 | 
					 | 
				
			||||||
@@ -1,25 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
- name: Ensure container '{{ openldap_container_name }}' is {{ openldap_container_state }}
 | 
					 | 
				
			||||||
  community.docker.docker_container:
 | 
					 | 
				
			||||||
    name: "{{ openldap_container_name }}"
 | 
					 | 
				
			||||||
    image: "{{ openldap_container_image }}"
 | 
					 | 
				
			||||||
    env: "{{ openldap_container_env | default(omit, true) }}"
 | 
					 | 
				
			||||||
    user: "{{ openldap_container_user | default(omit, true) }}"
 | 
					 | 
				
			||||||
    ports: "{{ openldap_container_ports | default(omit, true) }}"
 | 
					 | 
				
			||||||
    labels: "{{ openldap_container_labels | default(omit, true) }}"
 | 
					 | 
				
			||||||
    volumes: "{{ openldap_container_all_volumes | default(omit, true) }}"
 | 
					 | 
				
			||||||
    networks: "{{ openldap_container_networks | default(omit, true) }}"
 | 
					 | 
				
			||||||
    network_mode: "{{ openldap_container_network_mode | default(omit, true) }}"
 | 
					 | 
				
			||||||
    dns_servers: "{{ openldap_container_dns_servers | default(omit, true) }}"
 | 
					 | 
				
			||||||
    etc_hosts: "{{ openldap_container_etc_hosts | default(omit, true) }}"
 | 
					 | 
				
			||||||
    command: "{{ openldap_container_command | default(omit, true) }}"
 | 
					 | 
				
			||||||
    ulimits: "{{ openldap_container_ulimits | default(omit, true) }}"
 | 
					 | 
				
			||||||
    memory: "{{ openldap_container_memory | default(omit, true) }}"
 | 
					 | 
				
			||||||
    memory_swap: "{{ openldap_container_memory_swap | default(omit, true) }}"
 | 
					 | 
				
			||||||
    memory_reservation: >-2
 | 
					 | 
				
			||||||
      {{ openldap_container_memory_reservation | default(omit, true) }}
 | 
					 | 
				
			||||||
    restart_policy: >-2
 | 
					 | 
				
			||||||
      {{ openldap_container_restart_policy | default(omit, true) }}
 | 
					 | 
				
			||||||
    healthcheck: "{{ openldap_container_healthcheck | default(omit, true) }}"
 | 
					 | 
				
			||||||
    state: "{{ openldap_container_state }}"
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
@@ -1,37 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
- name: Ensure additional schemas are mapped to container
 | 
					 | 
				
			||||||
  ansible.builtin.set_fact:
 | 
					 | 
				
			||||||
    openldap_init_container_volumes: >-2
 | 
					 | 
				
			||||||
      {{ openldap_init_container_volumes + [ schema_mount ] }}
 | 
					 | 
				
			||||||
  vars:
 | 
					 | 
				
			||||||
    schema_file: "{{ openldap_schema_path }}/{{ schema.name }}.ldif"
 | 
					 | 
				
			||||||
    schema_mount: >-2
 | 
					 | 
				
			||||||
      {{ schema_file }}:{{ schema_file }}:ro
 | 
					 | 
				
			||||||
  loop: "{{ openldap_additional_schemas }}"
 | 
					 | 
				
			||||||
  loop_control:
 | 
					 | 
				
			||||||
    loop_var: "schema"
 | 
					 | 
				
			||||||
    label: "{{ schema.name }}"
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Ensure ldap container is initialized
 | 
					 | 
				
			||||||
  community.docker.docker_container:
 | 
					 | 
				
			||||||
    name: "{{ openldap_container_name }}"
 | 
					 | 
				
			||||||
    image: "{{ openldap_container_image }}"
 | 
					 | 
				
			||||||
    env: "{{ openldap_container_env | default(omit, true) }}"
 | 
					 | 
				
			||||||
    user: "{{ openldap_container_user | default(omit, true) }}"
 | 
					 | 
				
			||||||
    ports: "{{ openldap_container_ports | default(omit, true) }}"
 | 
					 | 
				
			||||||
    labels: "{{ openldap_container_labels | default(omit, true) }}"
 | 
					 | 
				
			||||||
    volumes: "{{ openldap_container_merged_volumes | default(omit, true) }}"
 | 
					 | 
				
			||||||
    networks: "{{ openldap_container_networks | default(omit, true) }}"
 | 
					 | 
				
			||||||
    network_mode: "{{ openldap_container_network_mode | default(omit, true) }}"
 | 
					 | 
				
			||||||
    dns_servers: "{{ openldap_container_dns_servers | default(omit, true) }}"
 | 
					 | 
				
			||||||
    etc_hosts: "{{ openldap_container_etc_hosts | default(omit, true) }}"
 | 
					 | 
				
			||||||
    memory: "{{ openldap_container_memory | default(omit, true) }}"
 | 
					 | 
				
			||||||
    memory_swap: "{{ openldap_container_memory_swap | default(omit, true) }}"
 | 
					 | 
				
			||||||
    memory_reservation: >-2
 | 
					 | 
				
			||||||
      {{ openldap_container_memory_reservation | default(omit, true) }}
 | 
					 | 
				
			||||||
    command: "{{ openldap_slapadd_init_command }}"
 | 
					 | 
				
			||||||
    detach: false
 | 
					 | 
				
			||||||
    cleanup: true
 | 
					 | 
				
			||||||
  vars:
 | 
					 | 
				
			||||||
    openldap_container_merged_volumes: >-2
 | 
					 | 
				
			||||||
      {{ openldap_container_all_volumes + openldap_init_container_volumes }}
 | 
					 | 
				
			||||||
@@ -1,47 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
- name: Determine if persisted OLC config exists
 | 
					 | 
				
			||||||
  ansible.builtin.stat:
 | 
					 | 
				
			||||||
    path: "{{ openldap_olc_path }}/cn=config"
 | 
					 | 
				
			||||||
  register: openldap_olc_stat_info
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Ensure openldap databases are initialized
 | 
					 | 
				
			||||||
  when: not openldap_olc_stat_info.stat.exists
 | 
					 | 
				
			||||||
  block:
 | 
					 | 
				
			||||||
    - name: Ensure initial slapd.ldif is templated
 | 
					 | 
				
			||||||
      ansible.builtin.template:
 | 
					 | 
				
			||||||
        src: "slapd.ldif.j2"
 | 
					 | 
				
			||||||
        dest: "{{ openldap_slapd_path }}"
 | 
					 | 
				
			||||||
        mode: "0644"
 | 
					 | 
				
			||||||
    - name: Ensure additional schemas to install are present
 | 
					 | 
				
			||||||
      ansible.builtin.copy:
 | 
					 | 
				
			||||||
        content: "{{ schema.content }}"
 | 
					 | 
				
			||||||
        dest: "{{ openldap_schema_path }}/{{ schema.name }}.ldif"
 | 
					 | 
				
			||||||
        mode: "0644"
 | 
					 | 
				
			||||||
      loop: "{{ openldap_additional_schemas }}"
 | 
					 | 
				
			||||||
      loop_control:
 | 
					 | 
				
			||||||
        loop_var: "schema"
 | 
					 | 
				
			||||||
        label: "{{ schema.name }}"
 | 
					 | 
				
			||||||
    - name: Ensure db data directory exists
 | 
					 | 
				
			||||||
      ansible.builtin.file:
 | 
					 | 
				
			||||||
        path: "{{ openldap_default_database_directory }}"
 | 
					 | 
				
			||||||
        state: directory
 | 
					 | 
				
			||||||
        mode: "0750"
 | 
					 | 
				
			||||||
    - name: Ensure container is initialized using {{ openldap_deployment_method }}
 | 
					 | 
				
			||||||
      ansible.builtin.include_tasks:
 | 
					 | 
				
			||||||
        file: "initialize-{{ openldap_deployment_method }}.yml"
 | 
					 | 
				
			||||||
  rescue:
 | 
					 | 
				
			||||||
    - name: Ensure temporary schema files are absent
 | 
					 | 
				
			||||||
      ansible.builtin.file:
 | 
					 | 
				
			||||||
        path: "{{ openldap_schema_path }}/{{ file.name }}.ldif"
 | 
					 | 
				
			||||||
        state: absent
 | 
					 | 
				
			||||||
      loop: >-2
 | 
					 | 
				
			||||||
        {{ openldap_additional_schemas }}
 | 
					 | 
				
			||||||
      loop_control:
 | 
					 | 
				
			||||||
        loop_var: "file"
 | 
					 | 
				
			||||||
        label: "{{ file.name }}"
 | 
					 | 
				
			||||||
      ignore_errors: true
 | 
					 | 
				
			||||||
    - name: Ensure intial slapd.ldif file is absent
 | 
					 | 
				
			||||||
      ansible.builtin.file:
 | 
					 | 
				
			||||||
        path: "{{ openldap_slapd_path }}"
 | 
					 | 
				
			||||||
        state: absent
 | 
					 | 
				
			||||||
      ignore_errors: true
 | 
					 | 
				
			||||||
@@ -1,26 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
- name: Check if 'openldap_state' is valid
 | 
					 | 
				
			||||||
  ansible.builtin.fail:
 | 
					 | 
				
			||||||
    msg: >-2
 | 
					 | 
				
			||||||
      Invalid state '{{ openldap_state }}'!
 | 
					 | 
				
			||||||
      Supported states are {{ openldap_states | join(', ') }}.
 | 
					 | 
				
			||||||
  when: openldap_state not in openldap_states
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Check if 'openldap_deployment_method' is valid
 | 
					 | 
				
			||||||
  ansible.builtin.fail:
 | 
					 | 
				
			||||||
    msg: >-2
 | 
					 | 
				
			||||||
      Invalid state '{{ openldap_deployment_method }}'!
 | 
					 | 
				
			||||||
      Supported states are {{ openldap_deployment_methods | join(', ') }}.
 | 
					 | 
				
			||||||
  when: openldap_deployment_method not in openldap_deployment_methods
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Ensure openldap deployment is prepared
 | 
					 | 
				
			||||||
  ansible.builtin.include_tasks:
 | 
					 | 
				
			||||||
    file: "prepare-{{ openldap_deployment_method }}.yml"
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Ensure openldap is deployed using {{ openldap_deployment_method }}
 | 
					 | 
				
			||||||
  ansible.builtin.include_tasks:
 | 
					 | 
				
			||||||
    file: "deploy-{{ openldap_deployment_method }}.yml"
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Ensure openldap is configured
 | 
					 | 
				
			||||||
  ansible.builtin.include_tasks:
 | 
					 | 
				
			||||||
    file: "configure.yml"
 | 
					 | 
				
			||||||
@@ -1,7 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
- name: Ensure container image '{{ openldap_container_image }}' is {{ openldap_state }}
 | 
					 | 
				
			||||||
  community.docker.docker_image:
 | 
					 | 
				
			||||||
    name: "{{ openldap_container_image }}"
 | 
					 | 
				
			||||||
    state: "{{ openldap_state }}"
 | 
					 | 
				
			||||||
    source: "{{ openldap_container_image_source }}"
 | 
					 | 
				
			||||||
    force_source: "{{ openldap_container_image_force_source }}"
 | 
					 | 
				
			||||||
@@ -1,64 +0,0 @@
 | 
				
			|||||||
dn: cn=config
 | 
					 | 
				
			||||||
objectClass: olcGlobal
 | 
					 | 
				
			||||||
cn: config
 | 
					 | 
				
			||||||
olcPidFile: /run/openldap/slapd.pid
 | 
					 | 
				
			||||||
olcArgsFile: /run/openldap/slapd.args
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
# Dynamic backend modules
 | 
					 | 
				
			||||||
dn: cn=module,cn=config
 | 
					 | 
				
			||||||
objectClass: olcModuleList
 | 
					 | 
				
			||||||
cn: module
 | 
					 | 
				
			||||||
olcModulepath: {{ openldap_module_path }}
 | 
					 | 
				
			||||||
{% for mod in openldap_modules | default([]) %}
 | 
					 | 
				
			||||||
olcModuleload: back_{{ mod }}.so
 | 
					 | 
				
			||||||
{% endfor %}
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
# Schema config
 | 
					 | 
				
			||||||
dn: cn=schema,cn=config
 | 
					 | 
				
			||||||
objectClass: olcSchemaConfig
 | 
					 | 
				
			||||||
cn: schema
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
include: file://{{ openldap_core_schema_path }}
 | 
					 | 
				
			||||||
{% for schema in openldap_schemas %}
 | 
					 | 
				
			||||||
include: file://{{ openldap_schema_path }}/{{ schema.name }}.ldif
 | 
					 | 
				
			||||||
{% endfor %}
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
# Frontend settings
 | 
					 | 
				
			||||||
dn: olcDatabase=frontend,cn=config
 | 
					 | 
				
			||||||
objectClass: olcDatabaseConfig
 | 
					 | 
				
			||||||
objectClass: olcFrontendConfig
 | 
					 | 
				
			||||||
olcDatabase: frontend
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
# Config-DB settings
 | 
					 | 
				
			||||||
dn: olcDatabase=config,cn=config
 | 
					 | 
				
			||||||
objectClass: olcDatabaseConfig
 | 
					 | 
				
			||||||
olcDatabase: config
 | 
					 | 
				
			||||||
{% for attr in openldap_config_db_attributes | dict2items %}
 | 
					 | 
				
			||||||
{% if attr is string %}
 | 
					 | 
				
			||||||
{{ attr.key }}: {{ attr.value }}
 | 
					 | 
				
			||||||
{% else %}
 | 
					 | 
				
			||||||
{% for val in attr.value %}
 | 
					 | 
				
			||||||
{{ attr.key }}: {{ val }}
 | 
					 | 
				
			||||||
{% endfor %}
 | 
					 | 
				
			||||||
{% endif %}
 | 
					 | 
				
			||||||
{% endfor %}
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
# database settings
 | 
					 | 
				
			||||||
{% for db in openldap_databases %}
 | 
					 | 
				
			||||||
dn: olcDatabase={{ db.name }},cn=config
 | 
					 | 
				
			||||||
objectClass: olcDatabaseConfig
 | 
					 | 
				
			||||||
objectClass: {{ db.object_class }}
 | 
					 | 
				
			||||||
olcDatabase: {{ db.name }}
 | 
					 | 
				
			||||||
olcSuffix: {{ db.suffix }}
 | 
					 | 
				
			||||||
olcRootDN: {{ db.root_dn }}
 | 
					 | 
				
			||||||
olcRootPW: {{ db.root_pw }}
 | 
					 | 
				
			||||||
olcDbDirectory: {{ db.directory }}
 | 
					 | 
				
			||||||
{% for idx in db.indices %}
 | 
					 | 
				
			||||||
olcDbIndex: {{ idx }}
 | 
					 | 
				
			||||||
{% endfor %}
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
{% endfor %}
 | 
					 | 
				
			||||||
@@ -1,6 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
openldap_states:
 | 
					 | 
				
			||||||
  - "present"
 | 
					 | 
				
			||||||
  - "absent"
 | 
					 | 
				
			||||||
openldap_deployment_methods:
 | 
					 | 
				
			||||||
  - "docker"
 | 
					 | 
				
			||||||
@@ -1,13 +0,0 @@
 | 
				
			|||||||
# `finallycoffee.base.openssh`
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
Ansible role to manage and configure openssh and it's components (like `sshd`).
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
Currently supports `fedora` and `debian` linux distributions.
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
## `sshd`
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
To configure `sshd`, see the [`defaults/main/sshd.yml`](defaults/main/sshd.yml),
 | 
					 | 
				
			||||||
where snake\_cased config keys for `/etc/ssh/sshd_config` are available in
 | 
					 | 
				
			||||||
the `openssh_sshd_config_` namespace.
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
To add your own config on top, simply use key-value syntax in `openssh_sshd_config`.
 | 
					 | 
				
			||||||
@@ -1,3 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
openssh_state: 'present'
 | 
					 | 
				
			||||||
openssh_sshd_config_file: "/etc/ssh/sshd_config"
 | 
					 | 
				
			||||||
@@ -1,8 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
openssh_packages:
 | 
					 | 
				
			||||||
  fedora: "{{ openssh_fedora_packages }}"
 | 
					 | 
				
			||||||
  debian: "{{ openssh_debian_packages }}"
 | 
					 | 
				
			||||||
openssh_fedora_packages:
 | 
					 | 
				
			||||||
  - "openssh-server"
 | 
					 | 
				
			||||||
openssh_debian_packages:
 | 
					 | 
				
			||||||
  - "openssh-server"
 | 
					 | 
				
			||||||
@@ -1,33 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
openssh_sshd_enable: true
 | 
					 | 
				
			||||||
openssh_sshd_config_pubkey_authentication: true
 | 
					 | 
				
			||||||
openssh_sshd_config_password_authentication: false
 | 
					 | 
				
			||||||
openssh_sshd_config_challenge_response_authentication: false
 | 
					 | 
				
			||||||
openssh_sshd_config_permit_root_login: false
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
# Limits
 | 
					 | 
				
			||||||
openssh_sshd_config_max_sessions: ~
 | 
					 | 
				
			||||||
openssh_sshd_config_max_startups: ~
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
# Hardening
 | 
					 | 
				
			||||||
openssh_sshd_config_protocol: 2
 | 
					 | 
				
			||||||
openssh_sshd_config_x11_forwarding: false
 | 
					 | 
				
			||||||
openssh_sshd_config_allow_agent_forwarding: false
 | 
					 | 
				
			||||||
openssh_sshd_config_allow_tcp_forwarding: false
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
openssh_sshd_default_config:
 | 
					 | 
				
			||||||
  PubkeyAuthentication: "{{ openssh_sshd_config_pubkey_authentication }}"
 | 
					 | 
				
			||||||
  PasswordAuthentication: "{{ openssh_sshd_config_password_authentication }}"
 | 
					 | 
				
			||||||
  ChallengeResponseAuthentication: >-2
 | 
					 | 
				
			||||||
    {{ openssh_sshd_config_challenge_response_authentication }}
 | 
					 | 
				
			||||||
  PermitRootLogin: "{{ openssh_sshd_config_permit_root_login }}"
 | 
					 | 
				
			||||||
  MaxSessions: "{{ openssh_sshd_config_max_sessions }}"
 | 
					 | 
				
			||||||
  MaxStartups: "{{ openssh_sshd_config_max_startups }}"
 | 
					 | 
				
			||||||
  Protocol: "{{ openssh_sshd_config_protocol }}"
 | 
					 | 
				
			||||||
  X11Forwarding: "{{ openssh_sshd_config_x11_forwarding }}"
 | 
					 | 
				
			||||||
  AllowAgentForwarding: "{{ openssh_sshd_config_allow_agent_forwarding }}"
 | 
					 | 
				
			||||||
  AllowTcpForwarding: "{{ openssh_sshd_config_allow_tcp_forwarding }}"
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
openssh_sshd_merged_config: >-2
 | 
					 | 
				
			||||||
  {{ openssh_sshd_default_config | default({}, true)
 | 
					 | 
				
			||||||
     | combine(openssh_sshd_config | default({}, true)) }}
 | 
					 | 
				
			||||||
@@ -1,2 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
openssh_sshd_systemd_service_name: "sshd.service"
 | 
					 | 
				
			||||||
@@ -1,7 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
- name: Ensure sshd is reloaded
 | 
					 | 
				
			||||||
  ansible.builtin.systemd_service:
 | 
					 | 
				
			||||||
    name: "{{ openssh_sshd_systemd_service_name }}"
 | 
					 | 
				
			||||||
    state: "reloaded"
 | 
					 | 
				
			||||||
  when: ansible_facts['service_mgr'] == 'systemd'
 | 
					 | 
				
			||||||
  listen: openssh_sshd_reload
 | 
					 | 
				
			||||||
@@ -1,28 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
- name: Configure sshd
 | 
					 | 
				
			||||||
  ansible.builtin.lineinfile:
 | 
					 | 
				
			||||||
    path: "{{ openssh_sshd_config_file }}"
 | 
					 | 
				
			||||||
    regexp: "{{ openssh_sshd_config_regexp }}"
 | 
					 | 
				
			||||||
    line: "{{ openssh_sshd_config_line }}"
 | 
					 | 
				
			||||||
    firstmatch: true
 | 
					 | 
				
			||||||
    state: present
 | 
					 | 
				
			||||||
    validate: "sshd -Tf %s"
 | 
					 | 
				
			||||||
  loop: "{{ openssh_sshd_merged_config | dict2items }}"
 | 
					 | 
				
			||||||
  loop_control:
 | 
					 | 
				
			||||||
    loop_var: "tuple"
 | 
					 | 
				
			||||||
    label: "{{ tuple.key }}"
 | 
					 | 
				
			||||||
  notify:
 | 
					 | 
				
			||||||
    - openssh_sshd_reload
 | 
					 | 
				
			||||||
  vars:
 | 
					 | 
				
			||||||
    openssh_sshd_config_regexp: "^\\s*#?\\s*{{ tuple.key }}"
 | 
					 | 
				
			||||||
    openssh_sshd_config_line: >-2
 | 
					 | 
				
			||||||
      {{ openssh_sshd_config_line_commented }}{{ tuple.key }} {{ openssh_sshd_config_value }}
 | 
					 | 
				
			||||||
    openssh_sshd_config_value_is_none: "{{ tuple.value is none }}"
 | 
					 | 
				
			||||||
    openssh_sshd_config_line_commented: >-2
 | 
					 | 
				
			||||||
      {{ openssh_sshd_config_value_is_none | ternary('#', '') }}
 | 
					 | 
				
			||||||
    openssh_sshd_config_value: >-2
 | 
					 | 
				
			||||||
      {{ (tuple.value is boolean) | ternary(
 | 
					 | 
				
			||||||
           tuple.value | ternary('yes', 'no'),
 | 
					 | 
				
			||||||
           tuple.value
 | 
					 | 
				
			||||||
         )
 | 
					 | 
				
			||||||
      }}
 | 
					 | 
				
			||||||
@@ -1,16 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
- name: Ensure openssh server package is {{ openssh_state }} (dnf)
 | 
					 | 
				
			||||||
  ansible.builtin.dnf:
 | 
					 | 
				
			||||||
    name: "{{ openssh_packages[ansible_distribution | lower] }}"
 | 
					 | 
				
			||||||
    state: "{{ openssh_state }}"
 | 
					 | 
				
			||||||
  when:
 | 
					 | 
				
			||||||
    - ansible_facts['pkg_mgr'] in ['dnf', 'dnf5']
 | 
					 | 
				
			||||||
    - ansible_distribution | lower in openssh_packages.keys()
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Ensure openssh server package is {{ openssh_state }} (apt)
 | 
					 | 
				
			||||||
  ansible.builtin.apt:
 | 
					 | 
				
			||||||
    package: "{{ openssh_packages[ansible_distribution | lower] }}"
 | 
					 | 
				
			||||||
    state: "{{ openssh_state }}"
 | 
					 | 
				
			||||||
  when:
 | 
					 | 
				
			||||||
    - ansible_facts['pkg_mgr'] in ['apt']
 | 
					 | 
				
			||||||
    - ansible_distribution | lower in openssh_packages.keys()
 | 
					 | 
				
			||||||
@@ -1,15 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
- name: Ensure 'openssh_state' is valid
 | 
					 | 
				
			||||||
  ansible.builtin.fail:
 | 
					 | 
				
			||||||
    msg: >-2
 | 
					 | 
				
			||||||
      Invalid value '{{ openssh_state }}' for 'openssh_state'.
 | 
					 | 
				
			||||||
      Valid values are {{ openssh_states | join(', ') }}!
 | 
					 | 
				
			||||||
  when: openssh_state not in openssh_states
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Ensure openssh is {{ openssh_state }}
 | 
					 | 
				
			||||||
  ansible.builtin.include_tasks:
 | 
					 | 
				
			||||||
    file: "install.yml"
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Ensure sshd is configured
 | 
					 | 
				
			||||||
  ansible.builtin.include_tasks:
 | 
					 | 
				
			||||||
    file: "configure-sshd.yml"
 | 
					 | 
				
			||||||
@@ -1,4 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
openssh_states:
 | 
					 | 
				
			||||||
  - "present"
 | 
					 | 
				
			||||||
  - "absent"
 | 
					 | 
				
			||||||
@@ -1,25 +0,0 @@
 | 
				
			|||||||
# `finallycoffee.base.powerdns_tsig_key`
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
Simple ansible role for ensuring a TSIG key is present in a given PowerDNS-
 | 
					 | 
				
			||||||
instance.
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
## Usage
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
The usage example below assumes `powerdns` is running in a container named `powerdns` (as supplied to `powerdns_tsig_key_container_name`.
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
```yaml
 | 
					 | 
				
			||||||
- hosts: "{{ target_hosts }}"
 | 
					 | 
				
			||||||
  become: true
 | 
					 | 
				
			||||||
  roles:
 | 
					 | 
				
			||||||
    - role: finallycoffee.base.powerdns_tsig_key
 | 
					 | 
				
			||||||
      vars:
 | 
					 | 
				
			||||||
        powerdns_tsig_key_name: "nameofmykey"
 | 
					 | 
				
			||||||
        powerdns_tsig_key_path: "/var/lib/myapp/tsig.key"
 | 
					 | 
				
			||||||
        powernds_tsig_key_algo: "hmac-sha512"
 | 
					 | 
				
			||||||
        powerdns_tsig_key_path_owner: "myappuser"
 | 
					 | 
				
			||||||
        powerdns_tsig_key_path_group: "myappgroup"
 | 
					 | 
				
			||||||
        powerdns_tsig_key_container_name: 'powerdns'
 | 
					 | 
				
			||||||
```
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
> [!NOTE]
 | 
					 | 
				
			||||||
> Support for non-docker deployments is pending.
 | 
					 | 
				
			||||||
@@ -1,2 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
powerdns_tsig_key_container_name: powerdns
 | 
					 | 
				
			||||||
@@ -1,104 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
- name: Ensure unix group '{{ powerdns_tsig_key_path_group }}' exists
 | 
					 | 
				
			||||||
  ansible.builtin.group:
 | 
					 | 
				
			||||||
    name: "{{ powerdns_tsig_key_path_group }}"
 | 
					 | 
				
			||||||
    state: "present"
 | 
					 | 
				
			||||||
    system: true
 | 
					 | 
				
			||||||
  register: powerdns_tsig_key_path_group_info
 | 
					 | 
				
			||||||
  when: powerdns_tsig_key_path_group is defined
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Ensure unix user '{{ powerdns_tsig_key_path_owner }}' exists
 | 
					 | 
				
			||||||
  ansible.builtin.user:
 | 
					 | 
				
			||||||
    name: "{{ powerdns_tsig_key_path_owner }}"
 | 
					 | 
				
			||||||
    state: "present"
 | 
					 | 
				
			||||||
    system: true
 | 
					 | 
				
			||||||
    create_home: false
 | 
					 | 
				
			||||||
    groups: "{{ powerdns_tsig_key_path_group is defined | ternary([powerdns_tsig_key_path_group], omit) }}"
 | 
					 | 
				
			||||||
    append: "{{ powerdns_tsig_key_path_group is defined | ternary(true, omit) }}"
 | 
					 | 
				
			||||||
  register: powerdns_tsig_key_path_owner_info
 | 
					 | 
				
			||||||
  when: powerdns_tsig_key_path_owner is defined
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Check if TSIG key is already present
 | 
					 | 
				
			||||||
  ansible.builtin.stat:
 | 
					 | 
				
			||||||
    path: "{{ powerdns_tsig_key_path }}"
 | 
					 | 
				
			||||||
  register: powerdns_tsig_key_info
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Ensure TSIG key directory is present
 | 
					 | 
				
			||||||
  ansible.builtin.file:
 | 
					 | 
				
			||||||
    path: "{{ powerdns_tsig_key_path | dirname }}"
 | 
					 | 
				
			||||||
    state: directory
 | 
					 | 
				
			||||||
    owner: "{{ powerdns_tsig_key_path_owner | default(omit) }}"
 | 
					 | 
				
			||||||
    group: "{{ powerdns_tsig_key_path_group | default(omit) }}"
 | 
					 | 
				
			||||||
    mode: "u+rwX,g+rX"
 | 
					 | 
				
			||||||
    recurse: true
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Ensure a TSIG key is configured and persisted
 | 
					 | 
				
			||||||
  when: >-
 | 
					 | 
				
			||||||
    not powerdns_tsig_key_info.stat.exists
 | 
					 | 
				
			||||||
    or powerdns_tsig_key_info.stat.size == 0
 | 
					 | 
				
			||||||
  block:
 | 
					 | 
				
			||||||
    - name: Ensure TSIG key is not already present
 | 
					 | 
				
			||||||
      community.docker.docker_container_exec:
 | 
					 | 
				
			||||||
        container: "{{ powerdns_tsig_key_container_name }}"
 | 
					 | 
				
			||||||
        command: "pdnsutil list-tsig-keys"
 | 
					 | 
				
			||||||
      delegate_to: "{{ powerdns_tsig_key_hostname }}"
 | 
					 | 
				
			||||||
      register: powerdns_tsig_key_powerdns_info
 | 
					 | 
				
			||||||
      changed_when: false
 | 
					 | 
				
			||||||
      check_mode: false
 | 
					 | 
				
			||||||
      become: true
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
    - name: Ensure TSIG key is generated in powerdns
 | 
					 | 
				
			||||||
      community.docker.docker_container_exec:
 | 
					 | 
				
			||||||
        container: "{{ powerdns_tsig_key_container_name }}"
 | 
					 | 
				
			||||||
        command: "pdnsutil generate-tsig-key '{{ powerdns_tsig_key_name }}' '{{ powerdns_tsig_key_algo }}'"
 | 
					 | 
				
			||||||
      when: >-
 | 
					 | 
				
			||||||
        (powerdns_tsig_key_name ~ '. ' ~ powerdns_tsig_key_algo ~ '. ')
 | 
					 | 
				
			||||||
        not in powerdns_tsig_key_powerdns_info.stdout
 | 
					 | 
				
			||||||
      delegate_to: "{{ powerdns_tsig_key_hostname }}"
 | 
					 | 
				
			||||||
      register: powerdns_tsig_key_powerdns_generated_tsig_key
 | 
					 | 
				
			||||||
      throttle: 1
 | 
					 | 
				
			||||||
      become: true
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
    - name: Ensure PowerDNS is restarted
 | 
					 | 
				
			||||||
      community.docker.docker_container:
 | 
					 | 
				
			||||||
        name: "{{ powerdns_tsig_key_container_name }}"
 | 
					 | 
				
			||||||
        state: started
 | 
					 | 
				
			||||||
        restart: true
 | 
					 | 
				
			||||||
      when: >-
 | 
					 | 
				
			||||||
        (powerdns_tsig_key_name ~ '. ' ~ powerdns_tsig_key_algo ~ '. ')
 | 
					 | 
				
			||||||
        not in powerdns_tsig_key_powerdns_info.stdout
 | 
					 | 
				
			||||||
      delegate_to: "{{ powerdns_tsig_key_hostname }}"
 | 
					 | 
				
			||||||
      throttle: 1
 | 
					 | 
				
			||||||
      become: true
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
    - name: Extract TSIG key into variable
 | 
					 | 
				
			||||||
      ansible.builtin.set_fact:
 | 
					 | 
				
			||||||
        powerdns_tsig_key_key: >-
 | 
					 | 
				
			||||||
          {{
 | 
					 | 
				
			||||||
            (powerdns_tsig_key_powerdns_generated_tsig_key.stdout | trim | split(' ') | list | last)
 | 
					 | 
				
			||||||
            if (powerdns_tsig_key_name ~ '. ' ~ powerdns_tsig_key_algo ~ '. ')
 | 
					 | 
				
			||||||
            not in powerdns_tsig_key_powerdns_info.stdout
 | 
					 | 
				
			||||||
            else (powerdns_generated_tsig_key | trim | split(' ') | list | last)
 | 
					 | 
				
			||||||
          }}
 | 
					 | 
				
			||||||
      vars:
 | 
					 | 
				
			||||||
        powerdns_generated_tsig_key: >-
 | 
					 | 
				
			||||||
          {% for line in powerdns_tsig_key_powerdns_info.stdout_lines %}
 | 
					 | 
				
			||||||
          {% if powerdns_tsig_key_name in line %}
 | 
					 | 
				
			||||||
          {{ line }}
 | 
					 | 
				
			||||||
          {% endif %}
 | 
					 | 
				
			||||||
          {% endfor %}
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
    - name: Ensure TSIG key is persisted into {{ powerdns_tsig_key_path }}
 | 
					 | 
				
			||||||
      ansible.builtin.copy:
 | 
					 | 
				
			||||||
        content: "{{ powerdns_tsig_key_key }}"
 | 
					 | 
				
			||||||
        dest: "{{ powerdns_tsig_key_path }}"
 | 
					 | 
				
			||||||
        owner: "{{ powerdns_tsig_key_path_owner | default(omit) }}"
 | 
					 | 
				
			||||||
        group: "{{ powerdns_tsig_key_path_group | default(omit) }}"
 | 
					 | 
				
			||||||
        mode: "0640"
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Ensure TSIG key permissions on {{ powerdns_tsig_key_path }} are correct
 | 
					 | 
				
			||||||
  ansible.builtin.file:
 | 
					 | 
				
			||||||
    path: "{{ powerdns_tsig_key_path }}"
 | 
					 | 
				
			||||||
    owner: "{{ powerdns_tsig_key_path_owner | default(omit) }}"
 | 
					 | 
				
			||||||
    group: "{{ powerdns_tsig_key_path_group | default(omit) }}"
 | 
					 | 
				
			||||||
    mode: "u+rwX,g+rwX"
 | 
					 | 
				
			||||||
@@ -1,77 +0,0 @@
 | 
				
			|||||||
# `finallycoffee.base.restic`
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
Ansible role for backup up data using `restic`, utilizing `systemd` timers for scheduling.
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
## Overview
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
As restic encrypts the data before storing it, the `restic_repo_password` needs
 | 
					 | 
				
			||||||
to be populated with a strong key, and saved accordingly as only this key can
 | 
					 | 
				
			||||||
be used to decrypt the data for a restore!
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
### Backends
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
#### S3 Backend
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
To use a `s3`-compatible backend like AWS buckets or minio, both `restic_s3_key_id`
 | 
					 | 
				
			||||||
and `restic_s3_access_key` need to be populated, and the `restic_repo_url` has the
 | 
					 | 
				
			||||||
format `s3:https://my.s3.endpoint:port/bucket-name`.
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
#### SFTP Backend
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
Using the `sftp` backend requires the configured `restic_user` to be able to
 | 
					 | 
				
			||||||
authenticate to the configured SFTP-Server using password-less methods like
 | 
					 | 
				
			||||||
publickey-authentication. The `restic_repo_url` then follows the format
 | 
					 | 
				
			||||||
`sftp:{user}@{server}:/my-restic-repository` (or without leading `/` for relative
 | 
					 | 
				
			||||||
paths to the `{user}`s home directory.
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
### Backing up data
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
A job name like `$service-postgres` or similar needs to be set in `restic_job_name`,
 | 
					 | 
				
			||||||
which is used for naming the `systemd` units, their syslog identifiers etc.
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
If backing up filesystem locations, the paths need to be specified in
 | 
					 | 
				
			||||||
`restic_backup_paths` as lists of strings representing absolute filesystem
 | 
					 | 
				
			||||||
locations.
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
If backing up f.ex. database or other data which is generating backups using
 | 
					 | 
				
			||||||
a command like `pg_dump`, use `restic_backup_stdin_command` (which needs to output
 | 
					 | 
				
			||||||
to `stdout`) in conjunction with `restic_backup_stdin_command_filename` to name
 | 
					 | 
				
			||||||
the resulting output (required).
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
### Policy
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
The backup policy can be adjusted by overriding the `restic_policy_keep_*`
 | 
					 | 
				
			||||||
variables, with the defaults being:
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
```yaml
 | 
					 | 
				
			||||||
restic_policy_keep_all_within: 1d
 | 
					 | 
				
			||||||
restic_policy_keep_hourly: 6
 | 
					 | 
				
			||||||
restic_policy_keep_daily: 2
 | 
					 | 
				
			||||||
restic_policy_keep_weekly: 7
 | 
					 | 
				
			||||||
restic_policy_keep_monthly: 4
 | 
					 | 
				
			||||||
restic_policy_backup_frequency: hourly
 | 
					 | 
				
			||||||
```
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
**Note:** `restic_policy_backup_frequency` must conform to `systemd`s
 | 
					 | 
				
			||||||
`OnCalendar` syntax, which can be checked using `systemd-analyze calender $x`.
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
## Role behaviour
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
Per default, when the systemd unit for a job changes, the job is not immediately
 | 
					 | 
				
			||||||
started. This can be overridden using `restic_start_job_on_unit_change: true`,
 | 
					 | 
				
			||||||
which will immediately start the backup job if it's configuration changed.
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
The systemd unit runs with `restic_user`, which is root by default, guaranteeing
 | 
					 | 
				
			||||||
that filesystem paths are always readable. The `restic_user` can be overridden,
 | 
					 | 
				
			||||||
but care needs to be taken to ensure the user has permission to read all the
 | 
					 | 
				
			||||||
provided filesystem paths / the backup command may be executed by the user.
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
If ansible should create the user, set `restic_create_user` to `true`, which
 | 
					 | 
				
			||||||
will attempt to create the `restic_user` as a system user.
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
### Installing
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
For Debian and RedHat, the role attempts to install restic using the default
 | 
					 | 
				
			||||||
package manager's ansible module (apt/dnf). For other distributions, the generic
 | 
					 | 
				
			||||||
`package` module tries to install `restic_package_name` (default: `restic`),
 | 
					 | 
				
			||||||
which can be overridden if needed.
 | 
					 | 
				
			||||||
@@ -1,60 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
restic_repo_url: ~
 | 
					 | 
				
			||||||
restic_repo_password: ~
 | 
					 | 
				
			||||||
restic_s3_key_id: ~
 | 
					 | 
				
			||||||
restic_s3_access_key: ~
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
restic_backup_paths: []
 | 
					 | 
				
			||||||
restic_backup_stdin_command: ~
 | 
					 | 
				
			||||||
restic_backup_stdin_command_filename: ~
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
restic_policy_keep_all_within: 1d
 | 
					 | 
				
			||||||
restic_policy_keep_hourly: 12
 | 
					 | 
				
			||||||
restic_policy_keep_daily: 7
 | 
					 | 
				
			||||||
restic_policy_keep_weekly: 6
 | 
					 | 
				
			||||||
restic_policy_keep_monthly: 6
 | 
					 | 
				
			||||||
restic_policy_keep_yearly: 5
 | 
					 | 
				
			||||||
restic_policy_backup_frequency: hourly
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
restic_base_environment:
 | 
					 | 
				
			||||||
  RESTIC_JOBNAME: "{{ restic_job_name | default('unknown') }}"
 | 
					 | 
				
			||||||
  RESTIC_FORGET_KEEP_WITHIN: "{{ restic_policy_keep_all_within }}"
 | 
					 | 
				
			||||||
  RESTIC_FORGET_KEEP_HOURLY: "{{ restic_policy_keep_hourly }}"
 | 
					 | 
				
			||||||
  RESTIC_FORGET_KEEP_DAILY: "{{ restic_policy_keep_daily }}"
 | 
					 | 
				
			||||||
  RESTIC_FORGET_KEEP_WEEKLY: "{{ restic_policy_keep_weekly }}"
 | 
					 | 
				
			||||||
  RESTIC_FORGET_KEEP_MONTHLY: "{{ restic_policy_keep_monthly }}"
 | 
					 | 
				
			||||||
  RESTIC_FORGET_KEEP_YEARLY: "{{ restic_policy_keep_yearly }}"
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
restic_s3_environment:
 | 
					 | 
				
			||||||
  AWS_ACCESS_KEY_ID: "{{ restic_s3_key_id }}"
 | 
					 | 
				
			||||||
  AWS_SECRET_ACCESS_KEY: "{{ restic_s3_access_key }}"
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
restic_complete_environment: >-
 | 
					 | 
				
			||||||
  {{
 | 
					 | 
				
			||||||
    restic_base_environment
 | 
					 | 
				
			||||||
    | combine((restic_s3_environment
 | 
					 | 
				
			||||||
      if (restic_s3_key_id and restic_s3_access_key) else {}) | default({}))
 | 
					 | 
				
			||||||
    | combine(restic_environment | default({}))
 | 
					 | 
				
			||||||
  }}
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
restic_policy:
 | 
					 | 
				
			||||||
  keep_within: "{{ restic_policy_keep_all_within }}"
 | 
					 | 
				
			||||||
  hourly: "{{ restic_policy_keep_hourly }}"
 | 
					 | 
				
			||||||
  daily: "{{ restic_policy_keep_daily }}"
 | 
					 | 
				
			||||||
  weekly: "{{ restic_policy_keep_weekly }}"
 | 
					 | 
				
			||||||
  monthly: "{{ restic_policy_keep_monthly }}"
 | 
					 | 
				
			||||||
  yearly: "{{ restic_policy_keep_yearly }}"
 | 
					 | 
				
			||||||
  frequency: "{{ restic_policy_backup_frequency }}"
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
restic_user: root
 | 
					 | 
				
			||||||
restic_create_user: false
 | 
					 | 
				
			||||||
restic_start_job_on_unit_change: false
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
restic_job_name: ~
 | 
					 | 
				
			||||||
restic_job_description: "Restic backup job for {{ restic_job_name }}"
 | 
					 | 
				
			||||||
restic_systemd_unit_naming_scheme: "restic.{{ restic_job_name }}"
 | 
					 | 
				
			||||||
restic_systemd_working_directory: /tmp
 | 
					 | 
				
			||||||
restic_systemd_syslog_identifier: "restic-{{ restic_job_name }}"
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
restic_package_name: restic
 | 
					 | 
				
			||||||
@@ -1,37 +0,0 @@
 | 
				
			|||||||
#!/usr/bin/env bash
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
set -euo pipefail
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
if [[ -n ${RESTIC_PRE_BACKUP_HOOK-} ]]; then
 | 
					 | 
				
			||||||
    /bin/bash -c "$RESTIC_PRE_BACKUP_HOOK"
 | 
					 | 
				
			||||||
fi
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
echo "List existing snapshots or attempt to initialize/unlock repository"
 | 
					 | 
				
			||||||
restic snapshots || restic init || restic unlock
 | 
					 | 
				
			||||||
sleep 1;
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
echo "Attempting to remove lock if present"
 | 
					 | 
				
			||||||
restic unlock
 | 
					 | 
				
			||||||
sleep 2
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
echo "Start backup on ${@:1}"
 | 
					 | 
				
			||||||
restic --verbose --retry-lock=${RESTIC_RETRY_LOCK:-5m} backup "${@:1}"
 | 
					 | 
				
			||||||
sleep 2
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
echo "Forget and prune old snapshots"
 | 
					 | 
				
			||||||
restic forget --prune --retry-lock=${RESTIC_RETRY_LOCK:-5m} \
 | 
					 | 
				
			||||||
    --keep-within=${RESTIC_FORGET_KEEP_WITHIN:-1d} \
 | 
					 | 
				
			||||||
    --keep-hourly=${RESTIC_FORGET_KEEP_HOURLY:-6} \
 | 
					 | 
				
			||||||
    --keep-daily=${RESTIC_FORGET_KEEP_DAILY:-2} \
 | 
					 | 
				
			||||||
    --keep-weekly=${RESTIC_FORGET_KEEP_WEEKLY:-7} \
 | 
					 | 
				
			||||||
    --keep-monthly=${RESTIC_FORGET_KEEP_MONTHLY:-4} \
 | 
					 | 
				
			||||||
    --verbose
 | 
					 | 
				
			||||||
sleep 2
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
echo "Generate snapshot metrics"
 | 
					 | 
				
			||||||
restic --json snapshots | /opt/restic-generate-snapshot-metrics.sh \
 | 
					 | 
				
			||||||
    > /var/lib/node_exporter/restic-snapshots-${RESTIC_JOBNAME:-unknown}.prom-src
 | 
					 | 
				
			||||||
sleep 2
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
echo "Check repository"
 | 
					 | 
				
			||||||
restic check
 | 
					 | 
				
			||||||
@@ -1,12 +0,0 @@
 | 
				
			|||||||
#!/usr/bin/env bash
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
RESTIC_JSON=$(</dev/stdin)
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
echo $RESTIC_JSON | jq -r '.[]
 | 
					 | 
				
			||||||
    | {
 | 
					 | 
				
			||||||
        "hostname": .hostname,
 | 
					 | 
				
			||||||
        "username": .username,
 | 
					 | 
				
			||||||
	"short_id": .short_id,
 | 
					 | 
				
			||||||
        "time": ((((.time | split(".")[0]) + "Z") | fromdate) - (3600 * (.time | split("+")[1] | split(":")[0] | tonumber + 1))),
 | 
					 | 
				
			||||||
        "paths": .paths[]
 | 
					 | 
				
			||||||
    } | "restic_snapshots{hostname=\"\(.hostname)\",username=\"\(.username)\",short_id=\"\(.short_id)\",paths=\"\(.paths)\"} \(.time)"'
 | 
					 | 
				
			||||||
@@ -1,13 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Ensure system daemon is reloaded
 | 
					 | 
				
			||||||
  listen: reload-systemd
 | 
					 | 
				
			||||||
  systemd:
 | 
					 | 
				
			||||||
    daemon_reload: true
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Ensure systemd service for '{{ restic_job_name }}' is started immediately
 | 
					 | 
				
			||||||
  listen: trigger-restic
 | 
					 | 
				
			||||||
  systemd:
 | 
					 | 
				
			||||||
    name: "{{ restic_systemd_unit_naming_scheme }}.service"
 | 
					 | 
				
			||||||
    state: started
 | 
					 | 
				
			||||||
  when: restic_start_job_on_unit_change
 | 
					 | 
				
			||||||
@@ -1,77 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Ensure {{ restic_user }} system user exists
 | 
					 | 
				
			||||||
  user:
 | 
					 | 
				
			||||||
    name: "{{ restic_user }}"
 | 
					 | 
				
			||||||
    state: present
 | 
					 | 
				
			||||||
    system: true
 | 
					 | 
				
			||||||
  when: restic_create_user
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Ensure either backup_paths or backup_stdin_command is populated
 | 
					 | 
				
			||||||
  when: restic_backup_paths|length > 0 and restic_backup_stdin_command and false
 | 
					 | 
				
			||||||
  fail:
 | 
					 | 
				
			||||||
    msg: "Setting both `restic_backup_paths` and `restic_backup_stdin_command` is not supported"
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Ensure a filename for stdin_command backup is given
 | 
					 | 
				
			||||||
  when: restic_backup_stdin_command and not restic_backup_stdin_command_filename
 | 
					 | 
				
			||||||
  fail:
 | 
					 | 
				
			||||||
    msg: "`restic_backup_stdin_command` was set but no filename for the resulting output was supplied in `restic_backup_stdin_command_filename`"
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Ensure backup frequency adheres to systemd's OnCalender syntax
 | 
					 | 
				
			||||||
  command:
 | 
					 | 
				
			||||||
    cmd: "systemd-analyze calendar {{ restic_policy.frequency }}"
 | 
					 | 
				
			||||||
  register: systemd_calender_parse_res
 | 
					 | 
				
			||||||
  failed_when: systemd_calender_parse_res.rc != 0
 | 
					 | 
				
			||||||
  changed_when: false
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Ensure restic is installed
 | 
					 | 
				
			||||||
  block:
 | 
					 | 
				
			||||||
    - name: Ensure restic is installed via apt
 | 
					 | 
				
			||||||
      apt:
 | 
					 | 
				
			||||||
        package: restic
 | 
					 | 
				
			||||||
        state: latest
 | 
					 | 
				
			||||||
      when: ansible_os_family == 'Debian'
 | 
					 | 
				
			||||||
    - name: Ensure restic is installed via dnf
 | 
					 | 
				
			||||||
      dnf:
 | 
					 | 
				
			||||||
        name: restic
 | 
					 | 
				
			||||||
        state: latest
 | 
					 | 
				
			||||||
      when: ansible_os_family == 'RedHat'
 | 
					 | 
				
			||||||
    - name: Ensure restic is installed using the auto-detected package-manager
 | 
					 | 
				
			||||||
      package:
 | 
					 | 
				
			||||||
        name: "{{ restic_package_name }}"
 | 
					 | 
				
			||||||
        state: present
 | 
					 | 
				
			||||||
      when: ansible_os_family not in ['RedHat', 'Debian']
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Ensure systemd service file for '{{ restic_job_name }}' is templated
 | 
					 | 
				
			||||||
  template:
 | 
					 | 
				
			||||||
    dest: "/etc/systemd/system/{{ restic_systemd_unit_naming_scheme }}.service"
 | 
					 | 
				
			||||||
    src: restic.service.j2
 | 
					 | 
				
			||||||
    owner: root
 | 
					 | 
				
			||||||
    group: root
 | 
					 | 
				
			||||||
    mode: 0640
 | 
					 | 
				
			||||||
  notify:
 | 
					 | 
				
			||||||
    - reload-systemd
 | 
					 | 
				
			||||||
    - trigger-restic
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Ensure systemd service file for '{{ restic_job_name }}' is templated
 | 
					 | 
				
			||||||
  template:
 | 
					 | 
				
			||||||
    dest: "/etc/systemd/system/{{ restic_systemd_unit_naming_scheme }}.timer"
 | 
					 | 
				
			||||||
    src: restic.timer.j2
 | 
					 | 
				
			||||||
    owner: root
 | 
					 | 
				
			||||||
    group: root
 | 
					 | 
				
			||||||
    mode: 0640
 | 
					 | 
				
			||||||
  notify:
 | 
					 | 
				
			||||||
    - reload-systemd
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Flush handlers to ensure systemd knows about '{{ restic_job_name }}'
 | 
					 | 
				
			||||||
  meta: flush_handlers
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Ensure systemd timer for '{{ restic_job_name }}' is activated
 | 
					 | 
				
			||||||
  systemd:
 | 
					 | 
				
			||||||
    name: "{{ restic_systemd_unit_naming_scheme }}.timer"
 | 
					 | 
				
			||||||
    enabled: true
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- name: Ensure systemd timer for '{{ restic_job_name }}' is started
 | 
					 | 
				
			||||||
  systemd:
 | 
					 | 
				
			||||||
    name: "{{ restic_systemd_unit_naming_scheme }}.timer"
 | 
					 | 
				
			||||||
    state: started
 | 
					 | 
				
			||||||
@@ -1,51 +0,0 @@
 | 
				
			|||||||
[Unit]
 | 
					 | 
				
			||||||
Description={{ restic_job_description }}
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
[Service]
 | 
					 | 
				
			||||||
Type=simple
 | 
					 | 
				
			||||||
User={{ restic_user }}
 | 
					 | 
				
			||||||
WorkingDirectory={{ restic_systemd_working_directory }}
 | 
					 | 
				
			||||||
SyslogIdentifier={{ restic_systemd_syslog_identifier }}
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
Environment=RESTIC_REPOSITORY={{ restic_repo_url }}
 | 
					 | 
				
			||||||
Environment=RESTIC_PASSWORD={{ restic_repo_password }}
 | 
					 | 
				
			||||||
{% for kv in restic_complete_environment | dict2items %}
 | 
					 | 
				
			||||||
Environment={{ kv.key }}={{ kv.value }}
 | 
					 | 
				
			||||||
{% endfor %}
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
{% if restic_init | default(true) %}
 | 
					 | 
				
			||||||
ExecStartPre=-/bin/sh -c '/usr/bin/restic snapshots || /usr/bin/restic init'
 | 
					 | 
				
			||||||
{% endif %}
 | 
					 | 
				
			||||||
{% if restic_unlock_before_backup | default(false) %}
 | 
					 | 
				
			||||||
ExecStartPre=-/bin/sh -c 'sleep 3 && /usr/bin/restic unlock'
 | 
					 | 
				
			||||||
{% endif %}
 | 
					 | 
				
			||||||
{% if restic_backup_pre_hook | default(false) %}
 | 
					 | 
				
			||||||
ExecStartPre=-{{ restic_backup_pre_hook }}
 | 
					 | 
				
			||||||
{% endif %}
 | 
					 | 
				
			||||||
{% if restic_backup_stdin_command %}
 | 
					 | 
				
			||||||
ExecStart=/bin/sh -c '{{ restic_backup_stdin_command }} | /usr/bin/restic backup \
 | 
					 | 
				
			||||||
	--retry-lock {{ restic_retry_lock | default('5m') }} \
 | 
					 | 
				
			||||||
	--verbose --stdin \
 | 
					 | 
				
			||||||
	--stdin-filename {{ restic_backup_stdin_command_filename }}'
 | 
					 | 
				
			||||||
{% else %}
 | 
					 | 
				
			||||||
ExecStart=/opt/restic-backup-directories.sh {{ restic_backup_paths | join(' ') }}
 | 
					 | 
				
			||||||
{% endif %}
 | 
					 | 
				
			||||||
{% if restic_forget_prune | default(true) %}
 | 
					 | 
				
			||||||
ExecStartPost=/usr/bin/restic forget --prune \
 | 
					 | 
				
			||||||
	--retry-lock {{ restic_retry_lock | default('5m') }} \
 | 
					 | 
				
			||||||
	--keep-within={{ restic_policy.keep_within }} \
 | 
					 | 
				
			||||||
	--keep-hourly={{ restic_policy.hourly }} \
 | 
					 | 
				
			||||||
	--keep-daily={{ restic_policy.daily }} \
 | 
					 | 
				
			||||||
	--keep-weekly={{ restic_policy.weekly }} \
 | 
					 | 
				
			||||||
	--keep-monthly={{ restic_policy.monthly }} \
 | 
					 | 
				
			||||||
	--keep-yearly={{ restic_policy.yearly }}
 | 
					 | 
				
			||||||
{% endif %}
 | 
					 | 
				
			||||||
{% if restic_list_snapshots | default(true) %}
 | 
					 | 
				
			||||||
ExecStartPost=-/usr/bin/restic snapshots --retry-lock {{ restic_retry_lock | default('5m') }}
 | 
					 | 
				
			||||||
{% endif %}
 | 
					 | 
				
			||||||
{% if restic_backup_post_hook | default(false) %}
 | 
					 | 
				
			||||||
ExecStartPost=-{{ restic_backup_post_hook }}
 | 
					 | 
				
			||||||
{% endif %}
 | 
					 | 
				
			||||||
{% if restic_check | default(true) %}
 | 
					 | 
				
			||||||
ExecStartPost=/usr/bin/restic check --retry-lock {{ restic_retry_lock | default('5m') }}
 | 
					 | 
				
			||||||
{% endif %}
 | 
					 | 
				
			||||||
@@ -1,9 +0,0 @@
 | 
				
			|||||||
[Unit]
 | 
					 | 
				
			||||||
Description=Run {{ restic_timer_description | default(restic_job_name) }}
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
[Timer]
 | 
					 | 
				
			||||||
OnCalendar={{ restic_policy.frequency }}
 | 
					 | 
				
			||||||
Unit={{ restic_systemd_unit_naming_scheme }}.service
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
[Install]
 | 
					 | 
				
			||||||
WantedBy=timers.target
 | 
					 | 
				
			||||||
@@ -1,23 +0,0 @@
 | 
				
			|||||||
# `finallycoffee.base.user` ansible role
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
Provision and manage user accounts on the remote host. Supports setting user
 | 
					 | 
				
			||||||
home, gecos (display name) and shell.
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
Warning: if the users' home exists and is changed, the role will attempt to
 | 
					 | 
				
			||||||
move the home directory. Set `move_home` to false on the user to disable this
 | 
					 | 
				
			||||||
behaviour.
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
## Examples
 | 
					 | 
				
			||||||
```yaml
 | 
					 | 
				
			||||||
- hosts: all
 | 
					 | 
				
			||||||
  roles:
 | 
					 | 
				
			||||||
    - role: finallycoffee.base.user
 | 
					 | 
				
			||||||
  vars:
 | 
					 | 
				
			||||||
    users:
 | 
					 | 
				
			||||||
      - name: root
 | 
					 | 
				
			||||||
      - name: alice
 | 
					 | 
				
			||||||
      - name: bob
 | 
					 | 
				
			||||||
        state: present
 | 
					 | 
				
			||||||
      - name: eve
 | 
					 | 
				
			||||||
        state: absent
 | 
					 | 
				
			||||||
```
 | 
					 | 
				
			||||||
@@ -1,2 +0,0 @@
 | 
				
			|||||||
---
 | 
					 | 
				
			||||||
users: []
 | 
					 | 
				
			||||||
Some files were not shown because too many files have changed in this diff Show More
		Reference in New Issue
	
	Block a user