feat: set feature flags to opt in or out of tasks

users/tasks/main.yml functions as a thin dispatcher with logical steps imported from their own files gated by a variable

meta/runtime.yml

@@ -0,0 +1,2 @@
+---
+requires_ansible: ">=2.15.0"

roles/base/tasks/main.yml

@@ -35,5 +35,3 @@
 #       APT::Periodic::Unattended-Upgrade "1";
 #     mode: "0644"
 #   when: ansible_facts['os_family'] == "Debian"
-
-## SCHEDULE REBOOTS 4 kernel upgrades: with cron, unattended-upgrades or action workflows?

roles/docker/tasks/main.yml

@@ -1,82 +1,75 @@
 ---
-- name: Install Docker prerequisites
+- name: Install Docker
-  ansible.builtin.apt:
-    name:
-      - ca-certificates
-      - curl
-    state: present
-    update_cache: true
   become: true
+  block:
+    - name: Install Docker prerequisites
+      ansible.builtin.apt:
+        name:
+          - ca-certificates
+          - curl
+          - python3-debian ## needed for the deb822 module
+        state: present
+        update_cache: true
 
-- name: Ensure APT keyrings directory exists
+    - name: Add Docker official APT repository (DEB822 format)
-  ansible.builtin.file:
+      ansible.builtin.deb822_repository:
-    path: /etc/apt/keyrings
+        name: docker
-    state: directory
+        types: deb
-    mode: "0755"
+        uris: "https://download.docker.com/linux/{{ ansible_facts['distribution'] | lower }}"
-  become: true
+        suites: "{{ ansible_facts['distribution_release'] }}"
+        components: stable
+        signed_by: "https://download.docker.com/linux/{{ ansible_facts['distribution'] | lower }}/gpg"
+        state: present
 
-- name: Download Docker official GPG key
+    - name: Install Docker CE packages
-  ansible.builtin.get_url:
+      ansible.builtin.apt:
-    url: "https://download.docker.com/linux/{{ ansible_distribution | lower }}/gpg"
+        name:
-    dest: /etc/apt/keyrings/docker.asc
+          - docker-ce
-    mode: "0644"
+          - docker-ce-cli
-  become: true
+          - containerd.io
+          - docker-buildx-plugin
+          - docker-compose-plugin
+        state: present
+        update_cache: true
 
-- name: Get system architecture
+    - name: Ensure Docker service is running and enabled
-  ansible.builtin.command: dpkg --print-architecture
+      ansible.builtin.service:
-  register: dpkg_architecture
+        name: docker
-  changed_when: false
+        state: started
-  become: true
+        enabled: true
 
-- name: Add Docker official APT repository
+- name: Configure deployment user for Docker
-  ansible.builtin.apt_repository:
-    repo: "deb [arch={{ dpkg_architecture.stdout }} signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/{{ ansible_distribution | lower }} {{ ansible_distribution_release }} stable"
-    state: present
-    filename: docker
-    update_cache: yes
   become: true
+  block:
+    - name: Add user to docker group
+      ansible.builtin.user:
+        name: deployment
+        groups: docker
+        append: true
 
-- name: Install modern Docker CE packages
+    - name: Create target for docker compose
-  ansible.builtin.apt:
+      ansible.builtin.file:
-    name:
+        path: /opt/docker
-      - docker-ce
+        state: directory
-      - docker-ce-cli
+        owner: deployment
-      - containerd.io
+        group: deployment
-      - docker-buildx-plugin
+        mode: "0755"
-      - docker-compose-plugin
-    state: present
-  become: true
 
-- name: Ensure Docker services are running and enabled
+- name: Create app user for secure container execution
-  ansible.builtin.service:
-    name: docker
-    state: started
-    enabled: true
   become: true
+  block:
+    - name: Create appuser group
+      ansible.builtin.group:
+        name: appuser
+        state: present
+        gid: 9999
 
-- name: Create docker user for container execution
+    - name: Create user
-  ansible.builtin.user:
+      ansible.builtin.user:
-    name: docker
+        name: appuser
-    state: present
+        state: present
-    system: true
+        uid: 9999
-    shell: /usr/sbin/nologin
+        group: appuser
-    groups: docker
+        system: true
-    append: true
+        shell: /usr/sbin/nologin
-    create_home: false
+        create_home: false
-  become: true
-
-- name: Add deployment user to docker group
-  ansible.builtin.user:
-    name: deployment
-    groups: docker
-    append: true
-  become: true
-
-- name: Create target for docker compose
-  ansible.builtin.file:
-    path: /opt/docker
-    state: directory
-    owner: deployment
-    group: deployment
-    mode: "0755"
-  become: true

roles/security/tasks/main.yml

@@ -1,33 +1,35 @@
 ---
-- name: Create SSH drop-in directory
+- name: Harden SSH configuration
-  ansible.builtin.file:
-    path: /etc/ssh/sshd_config.d
-    state: directory
-    owner: root
-    group: root
-    mode: "0755"
   become: true
+  block:
+    - name: Create SSH drop-in directory
+      ansible.builtin.file:
+        path: /etc/ssh/sshd_config.d
+        state: directory
+        owner: root
+        group: root
+        mode: "0755"
 
-- name: Harden SSH configuration with drop-in template
+    - name: Harden SSH configuration with drop-in template
-  ansible.builtin.template:
+      ansible.builtin.template:
-    src: sshd.conf.j2
+        src: sshd.conf.j2
-    dest: /etc/ssh/sshd_config.d/sshd.conf
+        dest: /etc/ssh/sshd_config.d/sshd.conf
-    owner: root
+        owner: root
-    group: root
+        group: root
-    mode: "0644"
+        mode: "0644"
-    validate: "sshd -t -f %s"
+      notify: Restart sshd
-  notify: Restart sshd
+
+- name: Enable fail2ban
   become: true
+  block:
+    - name: Install fail2ban
+      ansible.builtin.apt:
+        name:
+          - fail2ban
+        state: present
 
-- name: Install fail2ban
+    - name: Start fail2ban
-  ansible.builtin.apt:
+      ansible.builtin.service:
-    name:
+        name: fail2ban
-      - fail2ban
+        state: started
-    state: present
+        enabled: yes
-  become: true
-
-- name: Start fail2ban
-  ansible.builtin.service:
-    name: fail2ban
-    state: started
-    enabled: yes

roles/users/defaults/main.yml

@@ -0,0 +1,3 @@
+---
+users_setup_sysadmin: true
+users_setup_deployment: false   # opt-in: enable explicitly to use

roles/users/tasks/deployment.yml

@@ -0,0 +1,14 @@
+---
+- name: Create deployment user for CI/CD
+  ansible.builtin.user:
+    name: deployment
+    shell: /bin/bash
+    create_home: yes
+  become: true
+
+- name: Add SSH public key for deployment user
+  ansible.posix.authorized_key:
+    user: deployment
+    state: present
+    key: "{{ deployment_public_ssh_key }}"
+  become: true

roles/users/tasks/main.yml

@@ -1,38 +1,14 @@
 ---
-# - name: Create primary admin user
+- name: Configure sysadmin user
-#   ansible.builtin.user:
+  ansible.builtin.import_tasks: sysadmin.yml
-#     name: sysadmin
+  when: users_setup_sysadmin | bool
-#     groups: sudo
-#     append: yes
-#     shell: /bin/bash
-#     create_home: yes
-#   become: true
 
-# - name: Add SSH public key for sysadmin
+- name: Configure deployment user
-#   ansible.posix.authorized_key:
+  ansible.builtin.import_tasks: deployment.yml
-#     user: sysadmin
+  when: users_setup_deployment | bool
-#     state: present
-#     key: "{{ sysadmin_public_ssh_key }}"
-#   become: true
 
-# - name: Allow passwordless sudo to sysadmin user
+# opt in to feature flags / tasks with:
-#   ansible.builtin.copy:
+# roles:
-#     dest: /etc/sudoers.d/sysadmin
+#   - role: studio.ansible.users
-#     content: "sysadmin ALL=(ALL) NOPASSWD: ALL"
+#     vars:
-#     mode: "0440"
+#       users_setup_deployment: true
-#     validate: /usr/sbin/visudo -cf %s
-#   become: true
-
-- name: Create deployment user for CI/CD
-  ansible.builtin.user:
-    name: deployment
-    shell: /bin/bash
-    create_home: yes
-  become: true
-
-- name: Add SSH public key for deployment user
-  ansible.posix.authorized_key:
-    user: deployment
-    state: present
-    key: "{{ deployment_public_ssh_key }}"
-  become: true

roles/users/tasks/sysadmin.yml

@@ -0,0 +1,24 @@
+---
+- name: Create primary sysadmin user
+  ansible.builtin.user:
+    name: "{{ sysadmin_user }}"
+    groups: sudo
+    append: yes
+    shell: /bin/bash
+    create_home: yes
+  become: true
+
+- name: Add SSH public key for sysadmin
+  ansible.posix.authorized_key:
+    user: "{{ sysadmin_user }}"
+    state: present
+    key: "{{ sysadmin_public_ssh_key }}"
+  become: true
+
+- name: Allow passwordless sudo for sudo group
+  ansible.builtin.copy:
+    dest: /etc/sudoers.d/sudo-nopasswd
+    content: "%sudo ALL=(ALL) NOPASSWD: ALL"
+    mode: "0440"
+    validate: /usr/sbin/visudo -cf %s
+  become: true