Aufgaben-Python/courses/powershell/14_pester_automatisierte_unit_tests

PS 14: Pester v5 Automatisiertes Testing & Mocking 🧪

Willkommen zu Modul 14 des PowerShell 7+ DevOps-Kurses!

Pester ist das De-facto-Standard-Framework für Behavior-Driven Development (BDD) und automatisierte Unittests in PowerShell. Mit Version 5 wurde Pester von Grund auf modernisiert und trennt die Test-Erkennungsphase (Discovery Phase) strikt von der eigentlichen Ausführung (Run Phase).

---

💡 1. Das Wichtigste in Kürze

A. Pester v5 Syntax & Struktur

Describe 'Server Health Monitoring Service' {
    BeforeAll {
        # Einmaliges Setup vor allen Tests
        $testHost = 'srv-app01'
    }

    Context 'Wenn alle Dienste online sind' {
        It 'Sollte den Server als Operational einstufen' {
            # Arrange: Mocks definieren
            Mock Get-Service { [PSCustomObject]@{ Status = 'Running' } }
            Mock Test-Connection { $true }

            # Act: Funktion ausführen
            $result = Get-ServerHealthStatus -ServerName $testHost

            # Assert: Überprüfungen
            $result.IsHealthy | Should -BeTrue
            $result.Code | Should -Be 200
        }
    }

    Context 'Fehlerbehandlung' {
        It 'Sollte werfen, wenn Dienst unrettbar ist' {
            Mock Get-Service { [PSCustomObject]@{ Status = 'Stopped' } }
            Mock Restart-Service {}

            { Restart-FailedService -ServiceName 'CriticalDB' -MaxRetries 1 } | Should -Throw
        }
    }
}

---

B. Fluent Assertions mit Should

Pester bietet eine intuitive, lesbare Syntax für Zusicherungen:

• $val | Should -Be $expected
• $val | Should -BeTrue / $val | Should -BeFalse
• $list | Should -HaveCount 3
• $list | Should -Contain "Entry"
• { Invoke-DangerousCmdlet } | Should -Throw

---

C. Mocking (Isolierte Unittests)

Ein Mock ersetzt ein echtes PowerShell-Cmdlet (wie Restart-Service oder Invoke-RestMethod) während des Tests durch eine kontrollierte Attrappe. Dadurch zerstören Tests keine echten Produktivsysteme:

# Echten Reboot simulieren:
Mock Restart-Computer {}

# Prüfen, ob der Mock genau 1x aufgerufen wurde:
Should -Invoke Restart-Computer -Times 1 -Exactly

---

🎼 Die didaktische Analogie: "Der Flugsimulator"

• Das Flugzeug (Dein PowerShell-Code):
  Die Steuersoftware für echte Passagiermaschinen.
• Der Flugsimulator (Pester v5 Framework):
  Eine kontrollierte Testumgebung, in der Turbulenzen, Blitzeinschläge und Triebwerksausfälle simuliert werden.
• Die Mocks (Mock Get-Service):
  Die künstlichen Sensoren im Simulator. Sie melden "Triebwerk brennt", ohne dass echtes Kerosin brennen muss – und wir prüfen, ob die Notfall-Funktion blitzschnell und fehlerfrei reagiert!

---

🎯 Aufgaben & Teilziele in aufgabe.ps1

1. TODO 1: Get-ServerHealthStatus
   Implementiere die Zustandsprüfung, die auf Mock-Aufrufe von Get-Service und Test-Connection reagiert.
2. TODO 2: Restart-FailedService
   Baue eine Service-Restart-Schleife mit Retries und Exception-Handling bei anhaltendem Ausfall.
3. TODO 3: Test-PesterResultAnalyzer
   Berechne Erfolgsquote (PassRate) und erstelle CI/CD Quality-Gate-Entscheidungen aus Testresultaten.
4. TODO 4: Invoke-MockableApiAudit
   Führe einen REST-API-Audit durch und werte Status und Payload-Gültigkeit aus.

---

🧪 Tests ausführen

Invoke-Pester ./test_aufgabe.ps1