🦊 Modul 3: GitLab für Netzwerkteams

Machen Sie sich mit der GitLab-Oberfläche vertraut.

1. Öffnen Sie GitLab im Browser (URL vom Instructor)
2. Neues Projekt erstellen:
   • Klicken Sie auf New project
   • Wählen Sie Create blank project
   • Name: netzwerk-config-IHRNAME
   • Visibility: Private
   • ✅ "Initialize repository with a README" aktivieren
3. Projekt erkunden:
   • Öffnen Sie Repository → Files
   • Schauen Sie sich Repository → Commits an
   • Öffnen Sie Settings → General
4. Projekt klonen:

   Öffnen Sie PowerShell und navigieren Sie zu Ihrem Desktop:

   📋 Kopierencd C:\Users\admin\Desktop
   
   # SSL-Verifikation deaktivieren (self-signed Zertifikat)
   git config --global http.sslVerify false
   
   # HTTPS-URL aus GitLab kopieren (Clone-Button)
   git clone https://198.18.133.100/gitlab-instance-668e631e/netzwerk-config-IHRNAME.git
   cd netzwerk-config-IHRNAME
   dir

   ⚠️Self-Signed Zertifikat

   Das Lab-GitLab verwendet ein selbstsigniertes Zertifikat. Der Befehl git config --global http.sslVerify false ist nötig, damit Git die HTTPS-Verbindung akzeptiert.

Aktualisieren Sie die vorhandene README mit einer sinnvollen Projektbeschreibung.

1. README.md bearbeiten:

   Die Datei README.md existiert bereits im Projektordnernetzwerk-config-IHRNAME (sie wurde beim Erstellen des Projekts mit angelegt). Öffnen Sie sie in VS Code und ersetzen Sie den Inhalt mit folgendem:

   📄 README.md

   📋 Kopieren# Netzwerk-Konfiguration
   
   Dieses Repository enthält die Netzwerkkonfiguration für unser VXLAN-Fabric.
   
   ## Struktur
   
   ```
   .
   ├── inventory/        # Geräte-Inventar
   ├── host_vars/        # Gerätespezifische Variablen
   ├── group_vars/       # Gruppenvariablen (Spines, Leafs)
   ├── templates/        # Jinja2-Templates
   └── playbooks/        # Ansible Playbooks
   ```
   
   ## Verwendung
   
   ```bash
   # Konfiguration validieren
   ansible-playbook playbooks/validate.yml
   
   # Konfiguration deployen (nur auf Staging)
   ansible-playbook playbooks/deploy.yml -l staging
   ```
   
   ## Kontakt
   
   Maintainer: IHR NAME

2. Änderungen committen und pushen (in PowerShell):

   📋 Kopierengit status
   git add README.md
   git commit -m "docs: README mit Projektstruktur aktualisiert"
   git push origin master

3. Alternative: Direkt in VS Code committen und pushen

   Sie können Änderungen auch direkt über die VS Code Source Control Sidebar committen, ohne das Terminal zu benutzen:

   1. Klicken Sie links auf das Source Control Icon (Branches-Symbol, oder Ctrl+Shift+G)
   2. Sie sehen die geänderten Dateien unter "Changes"
   3. Klicken Sie auf das + neben der Datei (oder "Stage All Changes"), um sie zu stagen
   4. Geben Sie eine Commit-Message im Textfeld oben ein
   5. Klicken Sie auf den "Commit" Button (✓ Häkchen)
   6. Klicken Sie auf "Sync Changes" oder die drei Punkte → Push, um zum Server zu pushen

   

   🔍 Vergrößern

4. In GitLab prüfen: Öffnen Sie Ihr Projekt im Browser und verifizieren Sie, dass die README angezeigt wird.

Schützen Sie Ihren main-Branch vor direkten Pushes.

1. In GitLab navigieren:
   • Öffnen Sie Ihr Projekt
   • Gehen Sie zu Settings → Repository
   • Klappen Sie Protected branches auf
2. Branch schützen:
   • Branch: main
   • Allowed to merge: Maintainers
   • Allowed to push and merge: No one
   • Klicken Sie Protect
3. Testen Sie den Schutz (in PowerShell):

   📋 Kopieren# Versuchen Sie, direkt auf main zu pushen
   Add-Content -Path README.md -Value "# Test"
   git add .
   git commit -m "test: direkter push"
   git push origin main
   
   # Erwartetes Ergebnis: FEHLER!
   # remote: GitLab: You are not allowed to push code to protected branches

4. Änderung rückgängig machen:

   📋 Kopierengit reset --hard HEAD~1

5. Protected Branch wieder deaktivieren:

   Damit wir in den nächsten Übungen wieder direkt auf main pushen können, entfernen Sie den Branch-Schutz wieder:

   • Gehen Sie zu Settings → Repository → Protected branches
   • Klicken Sie bei main auf Unprotect
   • Bestätigen Sie die Aktion

Erstellen Sie einen vollständigen Merge Request.

1. Feature-Branch erstellen (in PowerShell):

   📋 Kopierencd netzwerk-config-IHRNAME
   git checkout main
   git pull origin main
   git checkout -b feature/add-vlan-200
   
   # Ordner erstellen
   New-Item -ItemType Directory -Force -Path vlans

   Erstellen Sie in VS Code eine neue Datei vlans/vlan200.yaml mit folgendem Inhalt:

   📄 vlans/vlan200.yaml

   📋 Kopieren---
   vlan:
     id: 200
     name: Clients
     description: "Client-Netzwerk für Arbeitsplätze"
     ip_range: "10.200.0.0/24"
     gateway: "10.200.0.1"
     dhcp_enabled: true

   Dann committen und pushen:

   📋 Kopierengit add .
   git commit -m "feat: VLAN 200 für Client-Netzwerk"
   git push -u origin feature/add-vlan-200

2. In GitLab MR erstellen:
   • Klicken Sie auf den Link in der Push-Ausgabe ODER
   • Gehen Sie zu Merge requests → New merge request
   • Source: feature/add-vlan-200
   • Target: main
3. MR ausfüllen:
   • Titel: "feat: VLAN 200 für Client-Netzwerk hinzufügen"
   • Beschreibung: Was, warum, wie testen?
   • Reviewer: Lassen Sie das Feld leer oder weisen Sie sich selbst zu (in der Praxis würden Sie hier einen Kollegen als Reviewer zuweisen)

Üben Sie den Code Review Workflow, indem Sie Ihren eigenen Merge Request reviewen. In der Praxis würde ein Kollege diesen Review durchführen – hier lernen Sie die Werkzeuge und Funktionen kennen.

1. Ihren MR öffnen:
   • Gehen Sie zu Merge requests
   • Öffnen Sie Ihren MR aus Übung 4
   • Wechseln Sie zum Tab Changes
2. Kommentare hinterlassen:
   • Klicken Sie auf eine Zeile, um einen Kommentar zu hinterlassen
   • Fügen Sie mindestens 3 Kommentare mit verschiedenen Präfixen hinzu:
   • question: Warum /24 statt /23 für das Client-Netzwerk?
   • nit: VLAN-Name könnte sprechender sein
   • praise: Saubere YAML-Struktur! 👍
3. Suggestion erstellen:
   • Erstellen Sie einen neuen Kommentar an einer Codezeile
   • Klicken Sie auf das Suggestion-Icon (💡)
   • Schreiben Sie einen konkreten Änderungsvorschlag im Code-Block
   • Z.B. den VLAN-Namen von "Clients" zu "Client-Workstations" ändern
4. Auf Kommentare reagieren und Threads resolven:
   • Antworten Sie auf Ihre eigenen Kommentare (z.B. "Guter Punkt, wird angepasst")
   • Bei der Suggestion: Klicken Sie Apply suggestion
   • Resolven Sie alle bearbeiteten Threads über den Resolve thread-Button

Schließen Sie den Review-Prozess ab, indem Sie Ihren eigenen MR approven und mergen.

1. Eigenen MR approven:
   • Öffnen Sie Ihren MR aus Übung 4
   • Stellen Sie sicher, dass alle Threads resolved sind
   • Klicken Sie auf Approve
   ℹ️Self-Approval im Workshop

   Als root/Admin-User können Sie Ihren eigenen MR approven. In einer Produktionsumgebung wäre dies durch Approval Rules unterbunden – dort muss ein anderer Kollege den MR genehmigen (Vier-Augen-Prinzip).
2. MR mergen:
   • Klicken Sie auf Merge
   • Option: Delete source branch aktivieren
3. Lokal aktualisieren (in PowerShell):

   📋 Kopierengit checkout main
   git pull origin main
   
   # Prüfen, dass die Änderungen da sind
   dir vlans/
   Get-Content vlans/vlan200.yaml

4. In GitLab prüfen:
   • Der MR zeigt Status Merged
   • Der Feature-Branch wurde gelöscht
   • Die Datei vlans/vlan200.yaml ist auf main sichtbar

Erstellen Sie ein Issue und lösen Sie es mit einem Merge Request.

1. Issue erstellen:
   • Gehen Sie zu Issues → New issue
   • Titel: "VLAN 300 für Gäste-WLAN einrichten"
   • Beschreibung:

     📋 Kopieren## Anforderung
     Gäste-WLAN benötigt eigenes VLAN mit Internetzugang.
     
     ## Technische Details
     - VLAN ID: 300
     - Name: Guest-WiFi
     - IP-Range: 10.30.0.0/24
     - Gateway: 10.30.0.1
     
     ## Akzeptanzkriterien
     - [ ] VLAN konfiguriert
     - [ ] Gateway erreichbar
     - [ ] Internet-Zugang funktioniert

   • Label hinzufügen: feature
   • Merken Sie sich die Issue-Nummer (z.B. #1)
2. Feature-Branch mit Issue-Referenz (in PowerShell):

   📋 Kopierengit checkout main
   git pull origin main
   git checkout -b feature/issue-1-vlan-300

   Erstellen Sie in VS Code eine neue Datei vlans/vlan300.yaml:

   📄 vlans/vlan300.yaml

   📋 Kopieren---
   vlan:
     id: 300
     name: Guest-WiFi
     description: "Gäste-WLAN mit Internet-Zugang"
     ip_range: "10.30.0.0/24"
     gateway: "10.30.0.1"
     dhcp_enabled: true
     internet_access: true
     internal_access: false

   Dann committen und pushen:

   📋 Kopierengit add .
   git commit -m "feat: VLAN 300 für Gäste-WLAN
   
   Closes #1"
   git push -u origin feature/issue-1-vlan-300

3. MR erstellen:
   • In der Beschreibung: Closes #1
   • Prüfen Sie, dass das Issue verknüpft angezeigt wird
4. MR mergen und Issue prüfen:
   • Nach dem Merge: Öffnen Sie das Issue
   • Es sollte automatisch geschlossen sein!