Merge branch 'main' into feat/playbook

README.md

@@ -1,5 +1,8 @@
 # Ansible Collection
 
-Opinionated set of roles to configure reasonable defaults for newly provisioned virtual machines. The repository provides a ready-to-use Ansible Collection (`studio.ansible`) containing reusable roles.
+Opinionated set of roles to configure reasonable defaults for newly provisioned virtual machines. The repository provides:
+- An Ansible Collection (`studio.ansible`) containing reusable roles. Use with ansible-galaxy's `requirements.yml`.
+- A ready-to-use playbook configured by passing CLI vars `--extra-vars "ansible_host=${HOST_IP}` locally or through CI / CD.
 
 Currently only supports Debian-based systems.
+

galaxy.yml

@@ -9,6 +9,3 @@ authors:
 description: Studio Ansible collection containing common roles
 license:
   - MIT
-
-dependencies:
-  "devsec.hardening": ">=9.0.0"

inventory/hosts.ini

@@ -0,0 +1,5 @@
+[target]
+target_host ansible_host="{{ ansible_host }}"
+
+[all:vars]
+ansible_user="{{ ansible_user }}"

playbooks/setup.yml

@@ -0,0 +1,11 @@
+---
+- name: Setup machines
+  hosts: all
+  become: true
+
+  roles:
+    - base
+    - users
+    - security
+    - docker
+    # - backup

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,74 +1,76 @@
 ---
-- name: Install Docker prerequisites
+- name: Install Docker
-  ansible.builtin.apt:
-    name:
-      - ca-certificates
-      - curl
-      - python3-debian ## needed for the deb822 module
-    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: Add Docker official APT repository (DEB822 format)
+    - name: Add Docker official APT repository (DEB822 format)
-  ansible.builtin.deb822_repository:
+      ansible.builtin.deb822_repository:
-    name: docker
+        name: docker
-    types: deb
+        types: deb
-    uris: "https://download.docker.com/linux/{{ ansible_facts['distribution'] | lower }}"
+        uris: "https://download.docker.com/linux/{{ ansible_facts['distribution'] | lower }}"
-    suites: "{{ ansible_facts['distribution_release'] }}"
+        suites: "{{ ansible_facts['distribution_release'] }}"
-    components: stable
+        components: stable
-    signed_by: "https://download.docker.com/linux/{{ ansible_facts['distribution'] | lower }}/gpg"
+        signed_by: "https://download.docker.com/linux/{{ ansible_facts['distribution'] | lower }}/gpg"
-    state: present
+        state: present
-  become: true
 
-- name: Install Docker CE packages
+    - name: Install Docker CE packages
-  ansible.builtin.apt:
+      ansible.builtin.apt:
-    name:
+        name:
-      - docker-ce
+          - docker-ce
-      - docker-ce-cli
+          - docker-ce-cli
-      - containerd.io
+          - containerd.io
-      - docker-buildx-plugin
+          - docker-buildx-plugin
-      - docker-compose-plugin
+          - docker-compose-plugin
-    state: present
+        state: present
-    update_cache: true
+        update_cache: true
-  become: true
 
-- name: Ensure Docker service is running and enabled
+    - name: Ensure Docker service is running and enabled
-  ansible.builtin.service:
+      ansible.builtin.service:
-    name: docker
+        name: docker
-    state: started
+        state: started
-    enabled: true
+        enabled: true
-  become: true
 
-- name: Add deployment user to docker group
+- name: Configure deployment user for Docker
-  ansible.builtin.user:
+  when: deployment_public_ssh_key is defined
-    name: deployment
-    groups: docker
-    append: true
   become: true
+  block:
+    - name: Add deployment user to docker group
+      ansible.builtin.user:
+        name: deployment
+        groups: docker
+        append: true
 
-- name: Create target for docker compose files
+    - name: Create target for docker compose
-  ansible.builtin.file:
+      ansible.builtin.file:
-    path: /opt/docker
+        path: /opt/docker
-    state: directory
+        state: directory
-    owner: deployment
+        owner: deployment
-    group: deployment
+        group: deployment
-    mode: "0755"
+        mode: "0755"
-  become: true
-
-- name: Create appuser group
-  ansible.builtin.group:
-    name: appuser
-    state: present
-    gid: 9999
-  become: true
 
 - name: Create app user for secure container execution
-  ansible.builtin.user:
-    name: appuser
-    state: present
-    uid: 9999
-    group: appuser
-    system: true
-    shell: /usr/sbin/nologin
-    create_home: false
   become: true
+  block:
+    - name: Create appuser group
+      ansible.builtin.group:
+        name: appuser
+        state: present
+        gid: 9999
+
+    - name: Create appuser
+      ansible.builtin.user:
+        name: appuser
+        state: present
+        uid: 9999
+        group: appuser
+        system: true
+        shell: /usr/sbin/nologin
+        create_home: false

roles/security/tasks/main.yml

@@ -1,20 +1,35 @@
 ---
 - name: Harden SSH configuration
-  ansible.builtin.import_role:
-    name: devsec.hardening.ssh_hardening
-  vars:
-    ssh_permit_root_login: "no"
-    ssh_password_authentication: "no"
-
-- name: Install fail2ban
-  ansible.builtin.apt:
-    name:
-      - fail2ban
-    state: present
   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: Start fail2ban
+    - name: Harden SSH configuration with drop-in template
-  ansible.builtin.service:
+      ansible.builtin.template:
-    name: fail2ban
+        src: sshd.conf.j2
-    state: started
+        dest: /etc/ssh/sshd_config.d/sshd.conf
-    enabled: yes
+        owner: root
+        group: root
+        mode: "0644"
+      notify: Restart sshd
+
+- name: Enable fail2ban
+  become: true
+  block:
+    - name: Install fail2ban
+      ansible.builtin.apt:
+        name:
+          - fail2ban
+        state: present
+
+    - name: Start fail2ban
+      ansible.builtin.service:
+        name: fail2ban
+        state: started
+        enabled: yes

roles/security/templates/sshd.conf.j2

@@ -0,0 +1,5 @@
+## Disable root login
+PermitRootLogin no
+
+## Disable password authentication
+PasswordAuthentication no

roles/users/tasks/main.yml

@@ -1,38 +1,42 @@
 ---
-- name: Create primary sysadmin user
+- name: Set up primary sysadmin user
-  ansible.builtin.user:
+  when: sysadmin_public_ssh_key is defined
-    name: "{{ sysadmin_user }}"
-    groups: sudo
-    append: yes
-    shell: /bin/bash
-    create_home: yes
   become: true
+  block:
+    - name: Create sysadmin user
+      ansible.builtin.user:
+        name: "{{ sysadmin_user }}"
+        groups: sudo
+        append: yes
+        shell: /bin/bash
+        create_home: yes
 
-- name: Add SSH public key for sysadmin
+    - name: Add SSH public key
-  ansible.posix.authorized_key:
+      ansible.posix.authorized_key:
-    user: "{{ sysadmin_user }}"
+        user: "{{ sysadmin_user }}"
-    state: present
+        state: present
-    key: "{{ sysadmin_public_ssh_key }}"
+        key: "{{ sysadmin_public_ssh_key }}"
-  become: true
 
-- name: Allow passwordless sudo for sudo group
+    - name: Allow passwordless sudo
-  ansible.builtin.copy:
+      ansible.builtin.copy:
-    dest: /etc/sudoers.d/sudo-nopasswd
+        dest: /etc/sudoers.d/sudo-nopasswd
-    content: "%sudo ALL=(ALL) NOPASSWD: ALL"
+        content: "%sudo ALL=(ALL) NOPASSWD: ALL"
-    mode: "0440"
+        mode: "0440"
-    validate: /usr/sbin/visudo -cf %s
+        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
+- name: Set up deployment user for CI/CD
-  ansible.posix.authorized_key:
+  when: deployment_public_ssh_key is defined
-    user: deployment
-    state: present
-    key: "{{ deployment_public_ssh_key }}"
   become: true
+  block:
+    - name: Create deployment user
+      ansible.builtin.user:
+        name: deployment
+        shell: /bin/bash
+        create_home: yes
+
+    - name: Add SSH public key
+      ansible.posix.authorized_key:
+        user: deployment
+        state: present
+        key: "{{ deployment_public_ssh_key }}"