CCCHH/ansible-infra
CCCHH/ansible-infra
3
1
Fork 0
Code Issues 3 Pull requests Wiki Activity Actions
Ansible Playbooks and related configuration for CCCHH infrastructure
288 commits 3 branches 0 tags 4.9 MiB
Jinja 100%
Find a file
June abc738c9c2
All checks were successful
/ Ansible Lint (push) Successful in 1m33s
Details
flatten the "playbooks" directory for better structure 
Because of how Ansible local relative search paths work, the global
"files" and "templates" directories need to be next to the playbooks.
However its not intuitive to look into the playbooks directory to find
the files and templates for a host.
Therefore flatten the playbooks directory to get rid of this confusing
structure.

Also see:
https://docs.ansible.com/ansible/latest/playbook_guide/playbook_pathing.html#resolving-local-relative-paths
2024-12-02 00:48:19 +01:00
.forgejo/workflows add CI running ansible-lint 2024-12-01 04:16:42 +01:00
.vscode Add redhat.ansible extension to VSCode Workspace Recommendations 2023-07-30 19:30:06 +02:00
collections Use the .yaml file extension for all YAML files 2023-05-08 19:55:08 +02:00
files flatten the "playbooks" directory for better structure 2024-12-02 00:48:19 +01:00
inventories fix all ansible-lint yaml errors (except for line-length) 2024-11-23 02:49:23 +01:00
roles flatten the "playbooks" directory for better structure 2024-12-02 00:48:19 +01:00
templates/chaosknoten/configs flatten the "playbooks" directory for better structure 2024-12-02 00:48:19 +01:00
.ansible-lint exclude .forgejo/ directory from ansible-lint 2024-11-24 01:08:13 +01:00
.editorconfig add .editorconfig to ensure some style and format consistency 2024-11-23 02:11:48 +01:00
.gitignore Add auto-update 2024-08-11 20:49:21 +02:00
.yamllint.yaml add .yamllint.yaml for some nicer yaml configuration for ansible-lint 2024-11-23 02:31:31 +01:00
ansible.cfg Provide secrets for keycloak VM from pass 2023-07-29 00:59:01 +02:00
check.yaml flatten the "playbooks" directory for better structure 2024-12-02 00:48:19 +01:00
deploy.yaml flatten the "playbooks" directory for better structure 2024-12-02 00:48:19 +01:00
LICENSE Add LICENSE 2023-04-15 14:28:45 +00:00
maintenance.yaml flatten the "playbooks" directory for better structure 2024-12-02 00:48:19 +01:00
README.md Add galaxy requirements 2024-08-12 11:39:50 +02:00
requirements.yml fix all ansible-lint yaml errors (except for line-length) 2024-11-23 02:49:23 +01:00

README.md

CCCHH Ansible Repository

Folgende Geräte und Server werden duch dieses Ansible Repository verwaltet:

  • Diverse VMs auf dem ThinkCCCluster

Die Konfigurationsdateien liegen unter playbooks/files/configs bzw. playbooks/templates/configs und werden für Hosts jeweils in einer host_vars-Datei im Inventory geladen.

Galaxy-Collections und -Rollen installieren

Für einige Aspekte verwenden wir Rollen aus Ansible Galaxy. Die müssen zunächst installiert werden:

ansible-galaxy install -r requirements.yml

Secrets

Grundsätzlich sollten Secrets vermieden werden. (Also z.B.: Nutze SSH Keys statt Passwort.)

Da Secrets aber durchaus doch gebraucht werden, werden diese dann in diesem Repo direkt aus dem password-store (meist aus einem Sub-Eintrag des noc/ Ordners) geladen. Dies geschieht mit Hilfe des community.general.passwordstore lookup Plugins.

Playbook nur für einzelne Hosts ausführen

Ein paar der Hosts haben den selben Namen, was es etwas schwieriger macht, das Playbook nur für einen der Hosts auszuführen, z. B. public-reverse-proxy. Die Kombination aus --inventory und --limit führt zum Erfolg:

ansible-playbook playbooks/deploy.yaml --inventory inventories/chaosknoten/hosts.yaml --limit public-reverse-proxy

Neuen Web-Service hinzufügen

Wir deployen Web-Services hinter dem public-reverse-proxy. Der Service-Name service.hamburg.ccc.de ist ein CNAME für public-reverse-proxy.hamburg.ccc.de, und die Service-VM ist unter service-intern.hamburg.ccc.de mit einer 172.31.17.x-Adresse erreichbar.

Im Ansible-Repo müssen diese Sachen hinzugefügt werden:

  • inventories/chaosknoten/hosts.yaml:
    • SSH-Config für die neue VM unter all/children/debian_12/hosts
    • Einträge für die Rollen, die dieser Host haben soll, min. certbot_hosts, nginx_hosts, ggf. docker_compose_hosts
  • inventories/chaosknoten/host_vars/host.yaml: config vars für den neuen Host
  • playbooks/files/chaosknoten/configs/public-reverse-proxy/nginx/acme_challenge.conf: Liste der Hostnamen um den neuen Host erweitern, die hinter dem Reverse-Proxy stehen
  • playbooks/files/chaosknoten/configs/public-reverse-proxy/nginx/nginx.conf: Liste der Hostnamen um den neuen Host erweitern, die hinter dem Reverse-Proxy stehen
  • playbooks/files/chaosknoten/configs/cloud/nginx/host.hamburg.ccc.de.conf: Server auf dem Service-Host
    • Individuelle Config für den Service. Wenn Docker Compose, hier weiterleiten auf den eigentlichen Dienst in Compose.
    • Cert-Dateinamen anpassen
  • playbooks/templates/chaosknoten/configs/host/compose.yaml.j2: Config für Docker Compose (wenn verwendet)