🦊 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:

   📋 Kopieren# HTTPS-URL aus GitLab kopieren (Clone-Button)
   git clone https://gitlab.example.com/IHRNAME/netzwerk-config-IHRNAME.git
   cd netzwerk-config-IHRNAME
   ls -la

Erstellen Sie eine strukturierte README für Ihr Projekt.

1. README.md bearbeiten:

   📋 Kopierencd netzwerk-config-IHRNAME
   
   # README mit sinnvollem Inhalt erstellen
   cat > README.md << 'EOF'
   # 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
   EOF

2. Änderungen committen und pushen:

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

3. 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:

   📋 Kopieren# Versuchen Sie, direkt auf main zu pushen
   echo "# Test" >> README.md
   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

Erstellen Sie einen vollständigen Merge Request.

1. Feature-Branch erstellen:

   📋 Kopierencd netzwerk-config-IHRNAME
   git checkout main
   git pull origin main
   git checkout -b feature/add-vlan-200
   
   # VLAN-Konfiguration erstellen
   mkdir -p vlans
   cat > vlans/vlan200.yaml << 'EOF'
   ---
   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
   EOF
   
   git 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: Wählen Sie Ihren Sitznachbarn

Reviewen Sie den Merge Request Ihres Sitznachbarn und umgekehrt.

1. MR Ihres Partners öffnen:
   • Gehen Sie zu Merge requests
   • Finden Sie den MR, bei dem Sie als Reviewer eingetragen sind
   • Öffnen Sie den Tab Changes
2. Code prüfen:
   • Klicken Sie auf eine Zeile, um einen Kommentar zu hinterlassen
   • Fügen Sie mindestens 2 Kommentare hinzu (Frage, Vorschlag oder Lob)
   • Nutzen Sie die Präfixe: question:, suggestion:, etc.
3. Suggestion erstellen:
   • Bei einem Kommentar auf das Suggestion-Icon klicken
   • Konkreten Änderungsvorschlag im Code-Block schreiben
4. Auf Kommentare des Partners reagieren:
   • Gehen Sie zu Ihrem eigenen MR
   • Antworten Sie auf Kommentare
   • Bei Suggestions: Klicken Sie Apply suggestion
   • Resolven Sie bearbeitete Threads

Schließen Sie den Review-Prozess ab.

1. MR des Partners approven:
   • Öffnen Sie den MR Ihres Partners
   • Stellen Sie sicher, dass alle Threads resolved sind
   • Klicken Sie auf Approve
2. Ihren eigenen MR mergen:
   • Nachdem Ihr Partner approved hat
   • Klicken Sie auf Merge
   • Option: Delete source branch aktivieren
3. Lokal aktualisieren:

   📋 Kopierengit checkout main
   git pull origin main
   
   # Prüfen, dass die Änderungen da sind
   ls vlans/
   cat vlans/vlan200.yaml

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:

   📋 Kopierengit checkout main
   git pull origin main
   git checkout -b feature/issue-1-vlan-300
   
   # VLAN-Konfiguration erstellen
   cat > vlans/vlan300.yaml << 'EOF'
   ---
   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
   EOF
   
   git 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!