Automatisierung
Diese Seite beschreibt, wie COD Switches über den Ansible-Runner konfiguriert, was Sie dafür einrichten müssen und wo die Grenzen liegen.
Was das Modul leistet, steht auf der Modulseite.
Stand: November 2026, COD 3.8.6
Inhalt der Dokumentation
- Übersicht
- Erste Schritte
- Voraussetzungen
- Namen und Adressen
- Netzgeräte
- Zeit und DNS
- Installation
- Aufbauformen
- Ersteinrichtung
- Updates
- Module
- Netzwerk und MikroTik
- Automatisierung
- NAC
- TACACS+
- Firewall
- Captive Portal
- Monitoring
- Backup
- Hypervisor
- OTP
- Passkeepr
- GRC
- Inventar und CMDB-Import
- Fehlerbilder
- Sicherheit
- Versionen
- Versionsverlauf
- Support
Dokumentation
- Übersicht
- Erste Schritte
- Voraussetzungen
- Namen und Adressen
- Netzgeräte
- Zeit und DNS
- Installation
- Aufbauformen
- Ersteinrichtung
- Updates
- Module
- Netzwerk und MikroTik
- Automatisierung
- NAC
- TACACS+
- Firewall
- Captive Portal
- Monitoring
- Backup
- Hypervisor
- OTP
- Passkeepr
- GRC
- Inventar und CMDB-Import
- Fehlerbilder
- Sicherheit
- Versionen
- Versionsverlauf
- Support
Überblick
| Merkmal | Wert |
|---|---|
| Zweck | Port-, Auth- und VLAN-Profile, VLAN Zones, Rollout über Port-Bereiche und Zonen, Kabeltest, Port-Neustart |
| Hersteller | Allied Telesis, Cisco, Ruijie |
| Ausführung | Ansible-Runner als eigener Dienst neben COD. Er führt nur Aktionen von COD aus, keine eigenen Playbooks |
| Verbindung und Richtung | COD beauftragt den Runner. Der Runner verbindet sich per SSH mit dem Switch und meldet das Ergebnis an COD zurück |
| Zugangsdaten | SSH-Zugang aus dem Netzwerkobjekt. Der Runner hält ihn verschlüsselt in seinem Vault |
| Ort des Runners | ab Werk auf dem COD-Server. Er nimmt ab Werk nur lokale Verbindungen an |
| Datenbank | keine eigene |
| Freigaben | Die Liste der Verbindungen und Freigaben erhalten Kunden und Partner im Projekt. |
Voraussetzungen
Am Switch
- SSH-Server an, erreichbar vom Host des Runners.
- Eigener Benutzer für COD mit Konfigurationsrechten. Die Mindestrechte erhalten Sie im Projekt.
- Für Auth-Profile: ein RADIUS-Server, etwa das Modul NAC.
In COD
- Der Switch ist als Netzwerkobjekt angelegt. Die Erfassung im Modul Netzwerk ist mindestens einmal erfolgreich gelaufen.
- Das Asset trägt den Hersteller Allied Telesis, Cisco oder Ruijie. Fehlt der Hersteller, lehnt COD den Auftrag ab, bevor ein Gerät angesprochen wird.
- Das Modul Ansible ist für den Standort ausgerollt.
- Die Einstellung „Ansible Config“ des Standorts ist gepflegt: API URL, Schema, API-Key und Vault-Passwort.
Einrichtung
- Schalten Sie das Modul mit dem Manager-Konto unter „Admin Area > Tenant > Modules“ frei. Melden Sie sich danach ab und wieder an.
- Rollen Sie den Runner unter „Admin Area > Module Rollout“ aus: Modul Ansible, Standort, dann Install, Connect, Configure und Apply.
- Prüfen Sie die Einstellung „Ansible Config“ des Standorts.
- Legen Sie unter „Network > Config“ die Profile an: PORT, AUTH und VLAN.
- Fassen Sie Switches bei Bedarf in VLAN Zones zusammen und legen Sie fest, welche VLANs eine Zone tragen muss.
- Rollen Sie ein Profil auf einen Port-Bereich oder eine Zone aus.
- Prüfen Sie das Ergebnis unter „Network > Config > Logs“.
Hinweis: Fast jedes Speichern unter „Network > Config“ schreibt auf echte Geräte. Prüfen Sie neue Profile zuerst an einem Testport. An Fernstandorten gilt: keine Änderung, die den Zugang kosten kann, und immer ein zweiter Zugangsweg.
Technische Details
| Merkmal | Wert |
|---|---|
| Profile | PORT (Interface), AUTH (802.1X und AAA), VLAN (anlegen und löschen), PORT_ACTION (Kabeltest, Port-Neustart) |
| Hersteller | Allied Telesis (AlliedWare Plus), Cisco IOS, Ruijie (über die CLI) |
| Transport | SSH. Ältere Algorithmen für Host-Key, Key Exchange und Cipher werden unterstützt |
| Zugangsdaten | nach dem ersten Rollout verschlüsselt im Vault des Runners, danach wiederverwendet |
| Ausführung | asynchron. Je Auftrag stehen Benutzer, Zeitpunkt, gesendete Daten und Antwort des Runners unter „Network > Config > Logs“ |
| Übersicht | „Network > Config“ nennt je Port das Profil, das COD ausgerollt hat |
Port-Neustart
Ein Port-Neustart setzt nur das einzelne Interface neu (shutdown und no shutdown). Der Switch bleibt in Betrieb.
Zugangsdaten
Nach dem ersten Rollout liegen die Zugangsdaten verschlüsselt im Vault des Runners. Sie geben sie nicht bei jeder Änderung neu ein.
Gleichzeitige Änderungen
Es gibt keine Sperre gegen parallele Änderungen. Der Runner arbeitet Aufträge nacheinander ab. Vermeiden Sie während eines Laufs Änderungen per CLI am selben Switch.
Konfigurationssicherung
Zeitgesteuerte Sicherungen der Switch-Konfiguration übernimmt das Modul Backup. Sichern Sie Switches dort, bevor Sie Profile ausrollen.
Bekannte Grenzen
| Grenze | Was Sie tun können |
|---|---|
| Konfiguration nur für Allied Telesis, Cisco und Ruijie | Switches anderer Hersteller erfasst COD lesend im Modul Netzwerk |
| Keine Sperre gegen parallele Änderungen | Stimmen Sie Änderungen im Team ab. Keine CLI-Änderungen während eines Laufs |
| Die Übersicht zeigt, was COD festgehalten hat, nicht den Ist-Stand am Switch | Prüfen Sie den Ist-Stand am Gerät oder in der Erfassung des Moduls Netzwerk |
| Änderungen an VLAN Zones und Vorlagen schreiben keinen eigenen Log-Eintrag | Dokumentieren Sie solche Änderungen selbst |
| Fast jedes Speichern wirkt sofort auf Geräte | Neue Profile zuerst an einem Testport prüfen |
| Der Runner nimmt ab Werk nur lokale Verbindungen an | Betreiben Sie ihn auf dem COD-Server. Soll er auf einem eigenen Server laufen, sprechen Sie das mit Ihrem Partner ab. |
| Ändert sich die Adresse, unter der COD erreichbar ist, scheitern Ansible-Läufe | Wiederholen Sie danach den Rollout des Runners |
| Keine eigenen Playbooks | Der Runner führt nur die Aktionen von COD aus |
| Mindestrechte am Switch nicht festgelegt | Die Mindestrechte erhalten Sie im Projekt. |
Weiterführend
- Modulseite Automatisierung
- Netzwerk und MikroTik
- NAC
- Was Ihr Netz für die Automatisierung braucht
- Aufbauformen
- Fehlerbilder
- Fragen zu den Modulen
- Support: Zuerst hilft Ihr Partner. Technische Rückfragen an extocode stellen Sie über das Helpdesk-Formular.