Seminar Netmaker API, nmctl und Automatisierung

Manuelle Änderungen an Netzen, Knoten, Schlüsseln und Richtlinien sind in größeren Umgebungen schwer nachvollziehbar. Das Seminar zeigt, wie administrative Aufgaben mit Kommandozeile, API und strukturierten Skripten standardisiert, geprüft und wiederholbar ausgeführt werden.

Inhaltsverzeichnis

1. Zielsetzung
2. Zielgruppe
3. Voraussetzungen
4. Seminarinhalte
5. Praxisübungen

Zielsetzung

Im Mittelpunkt stehen folgende fachliche und praktische Schwerpunkte:

• Kontexte, Benutzerzugriffstoken und technische Identitäten sicher einrichten.
• Netzwerke, Enrollment Keys, Knoten, DNS-Einträge und ACLs automatisiert verwalten.
• Idempotente Skripte mit belastbarer Fehler- und Rückgabecodebehandlung entwickeln.
• Automatisierungsabläufe in Versionsverwaltung, CI/CD und Change-Prozesse integrieren.

Zielgruppe

Systemadministration, DevOps, Platform Engineering, Netzwerkautomation und technische Betriebsverantwortung

Voraussetzungen

Sichere Linux-Kommandozeilenkenntnisse, grundlegende Netmaker-Administration sowie Basiswissen zu JSON, HTTP und Shell-Skripten

Seminarinhalte

Modul 1: Automatisierungsarchitektur und Sicherheitsmodell

Zunächst werden Steuerungsebene, API-Endpunkte, Rollen und die Trennung zwischen interaktiven und technischen Zugriffen eingeordnet.

1. Schritt 1: Automatisierbare Netmaker-Objekte und ihre Abhängigkeiten erfassen.
2. Schritt 2: Benutzerkonten, Rollen und Zugriffstoken nach dem Prinzip minimaler Rechte planen.
3. Schritt 3: Ablaufdaten, Rotation und sichere Ablage von Zugangsdaten festlegen.

Modul 2: nmctl-Kontexte und Bestandsabfragen

Mehrere SaaS- und On-Premises-Kontexte werden sauber getrennt und für reproduzierbare Abfragen vorbereitet.

1. Schritt 1: Kontexte mit Endpunkt, Authentisierung und eindeutiger Benennung anlegen.
2. Schritt 2: Aktiven Kontext prüfen und zwischen Test-, Staging- und Produktionsumgebung wechseln.
3. Schritt 3: Netzwerke, Knoten, Benutzer, Gruppen und Schlüssel maschinenlesbar inventarisieren.

Modul 3: Lebenszyklus von Netzwerken und Enrollment Keys

Netzaufbau und Geräte-Onboarding werden als kontrollierter, protokollierbarer Prozess automatisiert.

1. Schritt 1: Adressbereiche und Netzparameter vor der Erstellung validieren.
2. Schritt 2: Unbegrenzte, nutzungsbegrenzte und zeitgebundene Enrollment Keys erzeugen.
3. Schritt 3: Schlüssel mit Netzwerken, Tags und Gateway-Zuordnung verknüpfen und anschließend widerrufen.

Modul 4: Knoten, DNS und Zugriffsregeln verwalten

Die Automatisierung umfasst nicht nur Objekte, sondern auch ihre Beziehungen und Reihenfolge.

1. Schritt 1: Knotenstatus prüfen, Metadaten aktualisieren und nicht mehr benötigte Geräte geordnet entfernen.
2. Schritt 2: DNS-Einträge und Nameserver-Zuordnungen mit Vorabprüfung anlegen.
3. Schritt 3: ACL-Änderungen zunächst als Sollmodell erzeugen, dann anwenden und mit Negativtests verifizieren.

Modul 5: API-Aufrufe, Datenmodelle und Fehlerbehandlung

Direkte API-Nutzung wird für Funktionen eingesetzt, die über die Kommandozeile nicht vollständig abgedeckt sind.

1. Schritt 1: Anfrageaufbau, Header, Nutzdaten und Rückgabecodes strukturiert behandeln.
2. Schritt 2: Pagination, Zeitüberschreitungen, Wiederholungslogik und Rate-Limits berücksichtigen.
3. Schritt 3: Idempotenz durch Lesen, Vergleichen und gezieltes Ändern statt blindem Überschreiben herstellen.

Modul 6: CI/CD, Tests und betriebliche Übergabe

Automatisierung wird in einen kontrollierten Auslieferungs- und Freigabeprozess eingebettet.

1. Schritt 1: Konfigurationen versionieren und Änderungen über Review und Freigaben steuern.
2. Schritt 2: Testumgebungen, Dry-Run-Logik und automatisierte Konnektivitätsprüfungen einrichten.
3. Schritt 3: Rollback, Protokollierung und Übergabe an den Regelbetrieb als Runbook dokumentieren.

Praxisübungen

• Aufbau eines nmctl-Kontextsatzes für Labor, Staging und Produktion.
• Skriptgestützte Erstellung eines Netzwerks mit zeitgebundenem Enrollment Key und Tags.
• Automatisiertes Anlegen einer ACL mit anschließenden Positiv- und Negativtests.
• CI/CD-Muster mit Geheimnisübergabe, Freigabeschritt, Protokollierung und Rollback.