Pitfalls: /etc/hosts verboten, Split-Horizon-DNS bei UCS, Proxmox VMID-Wechsel
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
root
141
plans/refactored-sparking-glacier.md
Normal file
141
plans/refactored-sparking-glacier.md
Normal file
@@ -0,0 +1,141 @@
|
||||
# Plan: Cleanup + Wiki-Prinzip + Parallele Agenten
|
||||
|
||||
## Aufgabe 1: Backup-Verzeichnisse auf srvdocker02 bereinigen
|
||||
|
||||
**SSH:** `ssh root@10.0.0.48`
|
||||
|
||||
Folgende Verzeichnisse/Dateien löschen:
|
||||
```bash
|
||||
rm -rf /home/icke/unifi_backup/
|
||||
rm -rf /home/icke/unifi_data/data/db_backup_v8024/
|
||||
rm -rf /home/icke/unifi_old_20260129/
|
||||
rm -rf /home/icke/unifi_pre_restore_backup_20260129_075336/
|
||||
rm -f /home/icke/compose_files/unifi.yml.migrated_to_unifi_dir
|
||||
```
|
||||
|
||||
Vorher `du -sh` zur Bestätigung, nachher `df -h` zur Verifikation.
|
||||
|
||||
---
|
||||
|
||||
## Aufgabe 2: Globale Regeln in CLAUDE.md ergänzen
|
||||
|
||||
**Datei:** `~/dotfiles/claude_settings/CLAUDE.md`
|
||||
|
||||
### 2a: Wiki-Prinzip (neue Sektion)
|
||||
|
||||
Einfügen nach dem Abschnitt "Dokumentations-Verifikation (PFLICHT)", vor "Rolling Documentation":
|
||||
|
||||
```markdown
|
||||
### Wiki-Prinzip: Verlinkte Dokumentation (PFLICHT)
|
||||
|
||||
**JEDE Erwähnung eines Hosts, Dienstes oder Systems in der Dokumentation MUSS als Markdown-Link auf dessen Dokumentation verweisen.**
|
||||
|
||||
Dies gilt für ALLE Dokumentation - nicht nur Netzwerk, sondern auch Host-Dateien, Dependencies, Hardware, README, etc.
|
||||
|
||||
#### Regeln
|
||||
|
||||
1. **Host-Referenzen** → Link auf `hosts/[hostname].md`
|
||||
- Aus `hosts/`-Dateien: relativer Pfad `[srvdocker02](srvdocker02.md)`
|
||||
- Aus Root-Dateien: `[srvdocker02](hosts/srvdocker02.md)`
|
||||
- Aus Unterverzeichnissen: `[srvdocker02](../hosts/srvdocker02.md)`
|
||||
|
||||
2. **Hardware-Referenzen** → Link auf `hardware/[gerät].md`
|
||||
- `[HPE Switch](hardware/hpe-switch.md)` oder relativ `[HPE Switch](../hardware/hpe-switch.md)`
|
||||
|
||||
3. **Dienst-/System-Referenzen** → Link auf zugehörige Doku
|
||||
- Externe Repos: `[Zabbix](https://gitea.egonetix.de/Egonetix/zabbix)`
|
||||
- Interne Doku: `[Keycloak SSO](keycloak-sso.md)`
|
||||
|
||||
4. **Mermaid-Diagramme:** Hier sind keine Markdown-Links möglich. Stattdessen MUSS nach jedem Diagramm eine Referenz-Tabelle stehen mit Links zu den referenzierten Hosts/Diensten.
|
||||
|
||||
5. **Tabellen:** Host-/Dienstnamen in Tabellenzellen als Link formatieren.
|
||||
|
||||
#### Ausnahmen
|
||||
|
||||
- Derselbe Host innerhalb seiner eigenen Dokumentation (kein Self-Link)
|
||||
- Hosts in der "Entdeckte aber nicht gescannte Hosts"-Liste (keine Doku vorhanden)
|
||||
- Inline-Code-Blöcke (Befehle, Konfigurationen)
|
||||
|
||||
#### Beispiel
|
||||
|
||||
**Falsch:**
|
||||
```
|
||||
srvdocker02 benötigt srvdc01 für DNS.
|
||||
PBS auf Hetzner Storage Box (1TB)
|
||||
```
|
||||
|
||||
**Richtig:**
|
||||
```
|
||||
[srvdocker02](srvdocker02.md) benötigt [srvdc01](srvdc01.md) für DNS.
|
||||
PBS auf Hetzner Storage Box (1TB) - siehe [srvhost04 Storage](srvhost04.md#hardware--storage)
|
||||
```
|
||||
```
|
||||
|
||||
### 2b: Parallele Agenten (neue Sektion)
|
||||
|
||||
Einfügen im Bereich "Effizienz" oder als eigene Sektion nach "Rolling Documentation":
|
||||
|
||||
```markdown
|
||||
### Parallele Agenten-Nutzung (PFLICHT)
|
||||
|
||||
**Claude MUSS eigenständig entscheiden, wie viele Agenten parallel gestartet werden, um Aufgaben schneller zu erledigen.**
|
||||
|
||||
- Bis zu 10 oder mehr parallele Agenten sind erlaubt
|
||||
- Claude entscheidet selbst, wie viele Agenten sinnvoll sind
|
||||
- Unabhängige Teilaufgaben MÜSSEN parallel bearbeitet werden
|
||||
- Dies gilt für: Host-Scans, Dokumentations-Updates, Verifikation, Recherche
|
||||
|
||||
**Beispiele:**
|
||||
- 10 Host-Dateien aktualisieren → 10 Agenten parallel
|
||||
- 5 unabhängige Recherche-Aufgaben → 5 Agenten parallel
|
||||
- Scan + Dokumentation + Commit → sequentiell (abhängig)
|
||||
```
|
||||
|
||||
### 2c: Commit & Push
|
||||
|
||||
```bash
|
||||
cd ~/dotfiles/claude_settings
|
||||
git add CLAUDE.md
|
||||
git commit -m "Wiki-Prinzip und parallele Agenten als globale Regeln"
|
||||
git push origin main
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Aufgabe 3: Wiki-Prinzip retroaktiv auf bestehende Doku anwenden
|
||||
|
||||
Alle Markdown-Dateien im Infrastructure-Repo durchgehen und fehlende Links ergänzen. Parallele Agenten für unabhängige Dateien nutzen.
|
||||
|
||||
### Bekannte Lücken (aus Exploration):
|
||||
|
||||
| Datei | Fehlende Links |
|
||||
|-------|---------------|
|
||||
| `hosts/srvhost04.md` | Abhängigkeiten-Sektion: gw-nue01, GW-NU-WAN01 nicht verlinkt; Impact-Tabelle: alle 8 Hosts nicht verlinkt |
|
||||
| `hosts/srvdocker02.md` | Keine Links zu anderen Hosts/Diensten |
|
||||
| `dependencies.md` | Nach Mermaid-Diagrammen fehlen Referenz-Tabellen; Text-Referenzen ohne Links |
|
||||
| Alle `hosts/*.md` | Abhängigkeiten-Sektionen prüfen auf fehlende Links |
|
||||
| `hardware/*.md` | Referenzen auf Hosts prüfen |
|
||||
| `README.md` | Externe/VPN-Gegenstellen: gw-nu-wan01 schon verlinkt; Hardware-Tabelle prüfen |
|
||||
|
||||
### Vorgehen:
|
||||
1. Alle 13 Host-Dateien + 4 Hardware-Dateien + dependencies.md + README.md + keycloak-sso.md + netzwerk/*.md parallel lesen
|
||||
2. Fehlende Links identifizieren und ergänzen
|
||||
3. Commit pro logischer Gruppe
|
||||
|
||||
### Commit & Push
|
||||
|
||||
```bash
|
||||
cd ~/Nextcloud/egonetix/infrastructure
|
||||
git add -A
|
||||
git commit -m "Wiki-Prinzip: Querverweise in gesamter Doku verlinkt"
|
||||
git push origin main
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Verifikation
|
||||
|
||||
1. **Cleanup:** `df -h` auf srvdocker02 zeigt freien Speicher
|
||||
2. **CLAUDE.md:** Wiki-Prinzip und Parallele-Agenten Sektionen vorhanden, Settings-Repo gepusht
|
||||
3. **Wiki-Prinzip:** Stichprobenartig 3-4 Dateien prüfen ob alle Host-/Dienst-Referenzen verlinkt sind
|
||||
4. **Pflicht-Checkliste:** Dokumentations-Verifikation durchführen
|
||||
Reference in New Issue
Block a user