Ansible Collection: onkeldom.default_server

Diese Collection bundelt Basisrollen fuer Linux-Server und ist auf eine saubere, wiederholbare Rollenstruktur ausgelegt. Jede Rolle erhaelt ein einheitliches Geruest mit:

• README.md
• meta/main.yml
• meta/argument_specs.yml
• tests/test.yml

Zielplattformen

Die Collection ist auf folgende Baseline ausgerichtet:

• Ubuntu 22.04+
• Debian 12+
• RHEL 9+

Nicht jede Rolle ist auf jeder Plattform sinnvoll. Netzwerk- und Firewall-Rollen dokumentieren ihren effektiven Support jeweils im rollenlokalen README.md und in meta/main.yml.

Rollen

Die Collection enthaelt unter anderem Rollen fuer:

• Basis-Systemeinstellungen: chrony, hosts, motd, packages, sysctl, users
• Netzwerk: firewalld, ifcfg, interfaces, netplan, nfs, nmcli, resolvconf, systemd_resolved, systemd_timesyncd, ufw
• Paketquellen: apt_repos, dnf_repos
• Security: auditd, fail2ban, sshd, sssd
• Dienste und Tools: alloy, apache, borgbackup, borgmatic, certbot, dante, docker, haproxy, keepalived, msmtp, nginx, node_exporter, sftp_server, squid, telegraf, traefik, unbound, wpad
• Plattform-spezifische Helfer: dnf_automatic, dnf_repos, qemu_guest_agent, vmware_tools

Installation

ansible-galaxy collection install git+https://github.com/onkeldom/ansible-collection-default-server.git

Oder ueber eine requirements.yml:

collections:
  - name: git+https://github.com/onkeldom/ansible-collection-default-server.git

Verwendung

- name: Default server baseline
  hosts: all
  become: true
  roles:
    - role: onkeldom.default_server.chrony
    - role: onkeldom.default_server.users

Entwicklung

Lokale Hilfsmittel:

• Collection-Abhaengigkeiten: requirements.yml
• Test-Abhaengigkeiten: requirements-test.txt
• Rollen-Generator: tools/generate_role_scaffold.py

Generator ausfuehren:

python3 tools/generate_role_scaffold.py

Drift pruefen:

python3 tools/generate_role_scaffold.py --check

CI

GitHub Actions prueft automatisiert:

• ansible-lint
• ansible-test sanity
• Rollen-Geruest per pytest
• Syntax-Checks fuer jede Rolle
• Container-Smoke-Tests fuer Ubuntu 22.04, Debian 12 und Rocky Linux 9

Lizenz

MIT