Pester: тестирование инфраструктуры с PowerShell

Инфраструктурные тесты — это автоматизированная проверка того, что серверы, сервисы и конфигурации находятся в ожидаемом состоянии. Забудьте про ручной чек-лист с пунктами «проверить DNS», «проверить сертификаты», «проверить бэкапы». Запускаете скрипт — и за минуту получаете результат по сотням параметров.

Pester — фреймворк тестирования для PowerShell. Он уже встроен в Windows 10/11 и Windows Server 2016+, ставить ничего дополнительно не нужно. Синтаксис — один из самых читаемых, что я встречал в экосистеме PowerShell:

Describe "DNS Server" {
    It "Should resolve company.ru" {
        (Resolve-DnsName company.ru -ErrorAction Stop).IPAddress |
            Should -Contain "1.2.3.4"
    }
}

На практике мы применяем инфраструктурные тесты в трёх случаях. Первый — проверка после деплоя: все ли сервисы поднялись, как ожидалось? Второй — регулярный аудит: не уехали ли критичные настройки куда не надо? Третий — валидация перед обновлением: готова ли инфраструктура к апгрейду, или что-то уже «болит»?

В Windows из коробки идёт Pester 3.x. Честно говоря, эту версию давно пора забыть — используйте версию 5. Вот как её поставить:

# Установка Pester 5
Install-Module -Name Pester -Force -SkipPublisherCheck
Import-Module Pester
Get-Module Pester | Select-Object Version

Структура теста Pester:

# tests/Server.Tests.ps1
Describe "Web Server Configuration" {

    Context "IIS Service" {
        It "W3SVC service should be running" {
            (Get-Service W3SVC).Status | Should -Be "Running"
        }

        It "Should listen on port 443" {
            $listener = Get-NetTCPConnection -LocalPort 443 -State Listen -ErrorAction SilentlyContinue
            $listener | Should -Not -BeNullOrEmpty
        }
    }

    Context "SSL Certificate" {
        It "Certificate should not expire within 30 days" {
            $cert = Get-ChildItem Cert:\LocalMachine\My |
                Where-Object { $_.Subject -match "company.ru" }
            ($cert.NotAfter - (Get-Date)).Days | Should -BeGreaterThan 30
        }
    }
}

Запуск тестов:

# Запуск конкретного файла
Invoke-Pester ./tests/Server.Tests.ps1 -Output Detailed

# Запуск всех тестов в директории
Invoke-Pester ./tests/ -Output Detailed

Комплексный набор тестов для проверки здоровья AD:

Describe "Active Directory Health" {

    Context "Domain Controllers" {
        $DCs = Get-ADDomainController -Filter *

        foreach ($dc in $DCs) {
            It "$($dc.Name) should be reachable" {
                Test-Connection $dc.HostName -Count 1 -Quiet |
                    Should -BeTrue
            }

            It "$($dc.Name) NTDS service should be running" {
                $svc = Get-Service -ComputerName $dc.HostName -Name NTDS
                $svc.Status | Should -Be "Running"
            }

            It "$($dc.Name) SYSVOL should be shared" {
                Test-Path "\\$($dc.HostName)\SYSVOL" |
                    Should -BeTrue
            }
        }
    }

    Context "Replication" {
        It "No replication failures should exist" {
            $failures = Get-ADReplicationFailure -Target (Get-ADDomain).DNSRoot
            $failures | Should -BeNullOrEmpty
        }

        It "Replication should complete within 15 minutes" {
            $replStatus = Get-ADReplicationPartnerMetadata -Target * -Partition *
            $stale = $replStatus | Where-Object {
                $_.LastReplicationSuccess -lt (Get-Date).AddMinutes(-15)
            }
            $stale | Should -BeNullOrEmpty
        }
    }

    Context "DNS" {
        It "_ldap._tcp SRV record should exist" {
            $srv = Resolve-DnsName "_ldap._tcp.company.local" -Type SRV -ErrorAction Stop
            $srv | Should -Not -BeNullOrEmpty
        }
    }
}

Проверка сетевых компонентов — DNS, маршруты, порты, VPN:

Describe "Network Infrastructure" {

    Context "DNS Resolution" {
        $dnsTests = @(
            @{ Name = "company.ru"; Expected = "1.2.3.4" },
            @{ Name = "mail.company.ru"; Expected = "1.2.3.5" },
            @{ Name = "vpn.company.ru"; Expected = "1.2.3.6" }
        )

        foreach ($test in $dnsTests) {
            It "$($test.Name) should resolve to $($test.Expected)" {
                $result = Resolve-DnsName $test.Name -Type A -ErrorAction Stop
                $result.IPAddress | Should -Contain $test.Expected
            }
        }
    }

    Context "Critical Ports" {
        $portTests = @(
            @{ Host = "db-srv-01"; Port = 5432; Service = "PostgreSQL" },
            @{ Host = "web-srv-01"; Port = 443; Service = "HTTPS" },
            @{ Host = "mail-srv-01"; Port = 25; Service = "SMTP" }
        )

        foreach ($test in $portTests) {
            It "$($test.Service) on $($test.Host):$($test.Port) should be accessible" {
                (Test-NetConnection $test.Host -Port $test.Port).TcpTestSucceeded |
                    Should -BeTrue
            }
        }
    }

    Context "Default Gateway" {
        It "Default gateway should respond" {
            $gw = (Get-NetRoute -DestinationPrefix "0.0.0.0/0").NextHop
            Test-Connection $gw -Count 1 -Quiet | Should -BeTrue
        }
    }
}

Набор тестов для проверки состояния серверов:

Describe "Server Health" -Tag "daily" {

    Context "Disk Space" {
        $volumes = Get-Volume | Where-Object { $_.DriveType -eq "Fixed" -and $_.DriveLetter }

        foreach ($vol in $volumes) {
            It "Drive $($vol.DriveLetter): should have >10% free space" {
                $freePercent = ($vol.SizeRemaining / $vol.Size) * 100
                $freePercent | Should -BeGreaterThan 10
            }
        }
    }

    Context "Windows Services" {
        $criticalServices = @("W3SVC", "MSSQLSERVER", "Spooler", "WinRM")

        foreach ($svc in $criticalServices) {
            It "Service $svc should be running" {
                $service = Get-Service -Name $svc -ErrorAction SilentlyContinue
                if ($service) {
                    $service.Status | Should -Be "Running"
                } else {
                    Set-ItResult -Skipped -Because "Service $svc not installed"
                }
            }
        }
    }

    Context "Windows Updates" {
        It "No critical updates should be pending for >30 days" {
            $session = New-Object -ComObject Microsoft.Update.Session
            $searcher = $session.CreateUpdateSearcher()
            $pending = $searcher.Search("IsInstalled=0 AND IsHidden=0").Updates
            $critical = $pending | Where-Object { $_.MsrcSeverity -eq "Critical" }
            $critical.Count | Should -BeLessThan 5
        }
    }
}

Pester 5 умеет выгружать результаты в формате NUnit/JUnit XML. Это открывает интеграцию с любой CI-системой — Jenkins, TeamCity, Azure DevOps:

# Конфигурация запуска с отчётом
$config = New-PesterConfiguration
$config.Run.Path = "./tests"
$config.Output.Verbosity = "Detailed"
$config.TestResult.Enabled = $true
$config.TestResult.OutputFormat = "NUnitXml"
$config.TestResult.OutputPath = "./test-results.xml"

Invoke-Pester -Configuration $config

Для интеграции с GitLab CI:

# .gitlab-ci.yml
infrastructure-tests:
  stage: test
  tags: [windows]
  script:
    - Import-Module Pester
    - $config = New-PesterConfiguration
    - $config.Run.Path = "./tests"
    - $config.TestResult.Enabled = $true
    - $config.TestResult.OutputFormat = "JUnitXml"
    - $config.TestResult.OutputPath = "test-results.xml"
    - Invoke-Pester -Configuration $config
  artifacts:
    reports:
      junit: test-results.xml

Настройте регулярный запуск через Task Scheduler — и ежедневный аудит инфраструктуры будет происходить без вашего участия:

# Создаём задачу через PowerShell
$action = New-ScheduledTaskAction -Execute "pwsh.exe" `
    -Argument '-File "C:\Scripts\Run-InfraTests.ps1"'
$trigger = New-ScheduledTaskTrigger -Daily -At "07:00"
$settings = New-ScheduledTaskSettingsSet -AllowStartIfOnBatteries
$principal = New-ScheduledTaskPrincipal -UserId "SYSTEM" -RunLevel Highest

Register-ScheduledTask -TaskName "Daily Infrastructure Tests" `
    -Action $action -Trigger $trigger `
    -Settings $settings -Principal $principal

Скрипт Run-InfraTests.ps1 запускает тесты и отправляет результаты туда, куда нужно:

# C:\Scripts\Run-InfraTests.ps1
Import-Module Pester

$config = New-PesterConfiguration
$config.Run.Path = "C:\Scripts\tests"
$config.Output.Verbosity = "None"
$results = Invoke-Pester -Configuration $config -PassThru

$failed = $results.FailedCount
$passed = $results.PassedCount
$total = $results.TotalCount

if ($failed -gt 0) {
    $body = "FAILED: $failed / $total tests.`n`n"
    $body += ($results.Tests | Where-Object Result -eq 'Failed' |
        ForEach-Object { "FAIL: $($_.Name) - $($_.ErrorRecord)" }) -join "`n"

    Send-MailMessage -To "admin@company.ru" -From "monitoring@company.ru" `
        -Subject "Infrastructure Tests: $failed failures" `
        -Body $body -SmtpServer "mail.company.ru"
}