infrastruktur:saltstack

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen Revision Vorhergehende Überarbeitung
infrastruktur:saltstack [2020/08/27 11:12] – Inhaltsverzeichnis ausgeblendet Djangoinfrastruktur:saltstack [2026/11/16 16:51] (aktuell) – Saltstack: Aufbau und Ablauf aktualisiert; neue Seite wgkex wartung
Zeile 9: Zeile 9:
 ====== Saltstack von Freifunk München ====== ====== Saltstack von Freifunk München ======
  
-Die Automatisierung der Infrastruktur basiert zum Großteil auf [[https://www.saltstack.com|Saltstack]]. +Die Automatisierung der Infrastruktur basiert zum Großteil auf [[https://www.saltstack.com|Saltstack]]. Ein Salt-Master verwaltet alle Server (Gateways, Docker-Hosts, Webfrontends, Hypervisoren, Meet-Server usw.) und rollt die Konfiguration per Pull-Request-Workflow aus.
  
 Nach dem initialen Setup eines Servers verwenden wir noch ein [[https://github.com/freifunkMUC/ansible-ffmuc|Ansible Playbook]] um SSH Keys zu deployen und Saltstack zu installieren. Im Grunde könnte dies aber durch ein pre-seed File gelöst werden. Nach dem initialen Setup eines Servers verwenden wir noch ein [[https://github.com/freifunkMUC/ansible-ffmuc|Ansible Playbook]] um SSH Keys zu deployen und Saltstack zu installieren. Im Grunde könnte dies aber durch ein pre-seed File gelöst werden.
Zeile 18: Zeile 18:
  
 <WRAP center round important 80%> <WRAP center round important 80%>
-Dies ist nur ein winziger Einblick in unseren Saltstack und welche Komponenten er benötigt.+Dies ist nur ein winziger Einblick in unseren Saltstack und welche Komponenten er benötigt. Geheimnisse (Passwörter, Schlüssel, Tokens) liegen nie im Repository, sondern im nicht öffentlichen Salt-Pillar.
 </WRAP> </WRAP>
  
 +===== Aufbau des Repositories =====
 +
 +  * Jede Komponente ist ein eigenes Verzeichnis (eine "Formula") mit einer ''init.sls'', zum Beispiel ''wgkex'', ''haproxy'', ''bird2'', ''nebula'' oder ''telegraf''.
 +  * In der ''top.sls'' steht, welche Formulas auf welche Server kommen: einige für alle Minions (SSH, sudo, Monitoring, Updates, Zeitzone usw.), weitere je nach Hostname (z. B. ''gw*'' für die Gateways, ''webfrontend*'' für HAProxy und DNS, ''docker0*'' für die Docker-Hosts).
 +  * Zusätzlich entscheiden Rollen und Config Contexte aus Netbox, was auf einem Server tatsächlich konfiguriert wird.
 +  * Docker-Dienste liegen als Compose-Stacks unter ''stacks/<host>/<projekt>/''. Sie werden mit [[https://komo.do|Komodo]] ausgerollt; Salt kümmert sich nur um den Host selbst (Docker, Firewall, Komodo Periphery). Images sind per Version und Digest festgelegt.
 +  * Versionen von Containern, Salt selbst und mehreren Programmen hält [[https://docs.renovatebot.com/|Renovate]] aktuell: Es öffnet Pull Requests, die wir prüfen und mergen.
 +  * CI prüft jeden Pull Request (''black'', ''yamllint'', ''salt-lint'', ''shellcheck'').
 +
 +===== So kommt eine Änderung auf die Server =====
 +
 +  - Änderung als Pull Request im [[https://github.com/freifunkMUC/ffmuc-salt-public|Repository]] vorschlagen. Das Admin-Team schaut drüber.
 +  - Nach dem Merge wird der Stand auf dem Salt-Master übernommen.
 +  - Ein Admin prüft die Änderung auf einem Beispielserver mit ''state.apply <formula> test=True'' (nur Vorschau) und wendet sie dann an. Bei Änderungen, die viele Server betreffen oder einen Dienst neu starten, geht man Host für Host vor.
 +  - Alles, was nicht von Hand angewendet wurde, rollt täglich ein ''highstate'' (18:00 Uhr) auf allen Servern aus. Manuelle Änderungen direkt auf einem Server werden dabei überschrieben.
 +
 +Netbox wird beim Rendern der Konfiguration zwingend gebraucht: Ist sie nicht erreichbar, bricht der Lauf bewusst ab, statt eine Konfiguration ohne Präfixe oder DNS-Einträge zu erzeugen.
  
 ===== Netbox ===== ===== Netbox =====
Zeile 29: Zeile 46:
 Von einem Server werden alle IP-Adressen, Interfaces, Rollen und extra Konfigurationssnippets in der Netbox gepflegt. Von einem Server werden alle IP-Adressen, Interfaces, Rollen und extra Konfigurationssnippets in der Netbox gepflegt.
  
-Hier ein Screenshot von unserem GW01, wie man sieht ist es in der Rolle "gateway" und alle Interfaces sind in der Netbox angelegt. Außerdem sieht man, auf welchem physikalischen Host die VM läuft.+Hier ein Screenshot von unserem GW01, wie man sieht ist es in der Rolle "gateway" und alle Interfaces sind in der Netbox angelegt. Außerdem sieht man, auf welchem physikalischen Host die VM läuft. (Die Screenshots stammen von 2019; Rollen und Namen haben sich seither geändert, das Prinzip nicht.)
  
 {{:infrastruktur:netbox:2019-07-07_16.38.10_nb.in.ffmuc.net_2f80ead399c9.png?800|}} {{:infrastruktur:netbox:2019-07-07_16.38.10_nb.in.ffmuc.net_2f80ead399c9.png?800|}}
  
-Neben den vorgegebenen Feldern von Netbox benutzen wir außerdem stark die Config Contexte, welche einfach JSON Input erwarten. Hier mit lassen sich noch komplexere Probleme lösen, wie zum Beispiel die Zuweisung welche Segmente auf dem Gateway existieren sollen und welchen fastd Port dieses Segment besitzt.+Neben den vorgegebenen Feldern von Netbox benutzen wir außerdem stark die Config Contexte, welche einfach JSON Input erwarten. Hier mit lassen sich noch komplexere Probleme lösen, wie zum Beispiel die Zuweisung welche Segmente (Domains) auf dem Gateway existieren sollen, welche Rollen ein Server hat (z. B. Backup- oder Icinga-Client) und welche Docker-Dienste auf einem Host laufen.
  
 {{:infrastruktur:netbox:2019-07-07_16.40.55_nb.in.ffmuc.net_2ebcbc57d85b.png?800|}} {{:infrastruktur:netbox:2019-07-07_16.40.55_nb.in.ffmuc.net_2ebcbc57d85b.png?800|}}
 +
 +===== Beispiel: wgkex =====
 +
 +Die Gateways bekommen über die Formula ''wgkex'' den Worker des WireGuard-Schlüsselaustauschs, siehe [[infrastruktur:wgkex|wgkex]].
  
 ===== Github Repository ===== ===== Github Repository =====
  
-Unseren kompletten Saltstack findet ihr auf [[https://github.com/freifunkMUC/ffmuc-salt-public|Github]]. +Unseren kompletten Saltstack findet ihr auf [[https://github.com/freifunkMUC/ffmuc-salt-public|Github]]. Die ''README.md'' und die READMEs in einzelnen Verzeichnissen (z. B. ''wgkex/'', ''bird2/'', ''stacks/'') erklären Details.
  
 Solltet ihr Fragen dazu haben sprecht uns beim nächsten Treffen an oder kommt in den [[https://chat.ffmuc.net|Chat]] :). Solltet ihr Fragen dazu haben sprecht uns beim nächsten Treffen an oder kommt in den [[https://chat.ffmuc.net|Chat]] :).
Zeile 45: Zeile 66:
 ===== Links ===== ===== Links =====
 //**[[:start|Zurück zur WIKI-Startseite]]**// //**[[:start|Zurück zur WIKI-Startseite]]**//
- 
  
  • infrastruktur/saltstack.txt
  • Zuletzt geändert: 2026/11/16 16:51
  • von wartung