Files
mtusi2026lab7-fork/run.ps1

231 lines
14 KiB
PowerShell
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<#
.SYNOPSIS
Лабораторная 7 (мессенджер): развернуть стенд и проверить всё — одной командой в PowerShell.
.DESCRIPTION
Запуск из корня репозитория:
powershell -ExecutionPolicy Bypass -File .\run.ps1 # всё: up + все проверки
powershell -ExecutionPolicy Bypass -File .\run.ps1 -Action up # только развернуть
powershell -ExecutionPolicy Bypass -File .\run.ps1 -Action test # публичные тесты lab7 (HTTPS)
powershell -ExecutionPolicy Bypass -File .\run.ps1 -Action security
powershell -ExecutionPolicy Bypass -File .\run.ps1 -Action resilience
powershell -ExecutionPolicy Bypass -File .\run.ps1 -Action lifecycle
powershell -ExecutionPolicy Bypass -File .\run.ps1 -Action extra
powershell -ExecutionPolicy Bypass -File .\run.ps1 -Action scan
powershell -ExecutionPolicy Bypass -File .\run.ps1 -Action down # остановить, данные сохраняются
powershell -ExecutionPolicy Bypass -File .\run.ps1 -Action destroy # НАМЕРЕННО удалить данные стенда
Нужно: Docker Desktop (Compose v2), Python 3.9+ (только стандартная библиотека; PKI создаётся
в контейнере, если на хосте нет пакета cryptography), свободные порты 127.0.0.1:8443 и :3000.
Вывод каждого шага сохраняется в evidence\run\<шаг>.txt, итоговая таблица — в конце.
#>
[CmdletBinding()]
param(
[ValidateSet('all', 'check', 'up', 'test', 'security', 'resilience', 'lifecycle', 'extra', 'scan', 'down', 'destroy')]
[string]$Action = 'all',
# Не разворачивать стенд в режиме all (если он уже запущен)
[switch]$SkipUp,
# Остановиться на первом проваленном шаге
[switch]$StopOnFailure
)
$ErrorActionPreference = 'Continue'
Set-StrictMode -Version 2.0
$Root = Split-Path -Parent $MyInvocation.MyCommand.Path
Set-Location $Root
try { [Console]::OutputEncoding = [System.Text.Encoding]::UTF8 } catch { }
$env:PYTHONIOENCODING = 'utf-8'
$env:PYTHONUTF8 = '1'
$env:COMPOSE_PROJECT_NAME = 'messenger-lab7'
$CaFile = Join-Path $Root 'secrets\pki\ca.crt'
$HttpsPort = 8443
if (Test-Path (Join-Path $Root '.env')) {
foreach ($line in Get-Content (Join-Path $Root '.env')) {
if ($line -match '^\s*HTTPS_PORT\s*=\s*(\d+)') { $HttpsPort = [int]$Matches[1] }
}
}
$BaseUrl = "https://localhost:$HttpsPort"
$EvidenceDir = Join-Path $Root 'evidence\run'
New-Item -ItemType Directory -Force -Path $EvidenceDir | Out-Null
$Results = New-Object System.Collections.Generic.List[object]
# ------------------------------------------------------------------ Python
$Py = $null
$PyArgs = @()
foreach ($candidate in @(@('python'), @('py', '-3'), @('python3'))) {
$exe = Get-Command $candidate[0] -ErrorAction SilentlyContinue
if (-not $exe) { continue }
$extra = @()
if ($candidate.Count -gt 1) { $extra = @($candidate[1..($candidate.Count - 1)]) }
$ver = & $candidate[0] @extra -c "import sys; print('%d.%d' % sys.version_info[:2])" 2>$null
if ($LASTEXITCODE -eq 0 -and $ver -and ([version]"$ver" -ge [version]'3.9')) {
$Py = $candidate[0]; $PyArgs = $extra; break
}
}
function Write-Title([string]$Text) {
Write-Host ''
Write-Host ('=' * 78) -ForegroundColor DarkCyan
Write-Host " $Text" -ForegroundColor Cyan
Write-Host ('=' * 78) -ForegroundColor DarkCyan
}
function Invoke-Step {
<# Выполнить внешнюю команду, показать вывод построчно и сохранить его в evidence\run\<Name>.txt #>
param([string]$Name, [string]$Title, [string]$Exe, [string[]]$Arguments, [hashtable]$EnvVars = @{})
Write-Title "$Name — $Title"
$file = Join-Path $EvidenceDir ($Name + '.txt')
"# $Title`r`n# $Exe $($Arguments -join ' ')`r`n# $(Get-Date -Format o)" | Out-File -FilePath $file -Encoding utf8
$saved = @{}
foreach ($k in $EnvVars.Keys) { $saved[$k] = [Environment]::GetEnvironmentVariable($k); [Environment]::SetEnvironmentVariable($k, $EnvVars[$k]) }
$sw = [Diagnostics.Stopwatch]::StartNew()
& $Exe @Arguments 2>&1 | ForEach-Object {
$line = "$_"
Write-Host $line
Add-Content -Path $file -Value $line -Encoding UTF8
}
$code = $LASTEXITCODE
$sw.Stop()
foreach ($k in $saved.Keys) { [Environment]::SetEnvironmentVariable($k, $saved[$k]) }
$ok = ($code -eq 0)
$Results.Add([pscustomobject]@{ Step = $Name; Result = $(if ($ok) { 'PASS' } else { "FAIL ($code)" });
Seconds = [int]$sw.Elapsed.TotalSeconds; Evidence = "evidence\run\$Name.txt" }) | Out-Null
if ($ok) { Write-Host "[PASS] $Name" -ForegroundColor Green } else { Write-Host "[FAIL] $Name (exit $code)" -ForegroundColor Red }
if (-not $ok -and $StopOnFailure) { Show-Summary; exit 1 }
return $ok
}
function Invoke-Py {
param([string]$Name, [string]$Title, [string[]]$Arguments, [hashtable]$EnvVars = @{})
return Invoke-Step -Name $Name -Title $Title -Exe $Py -Arguments (@($PyArgs) + @($Arguments)) -EnvVars $EnvVars
}
function Show-Summary {
Write-Title 'Итог'
$Results | Format-Table -AutoSize | Out-String -Width 200 | Write-Host
$failed = @($Results | Where-Object { $_.Result -ne 'PASS' }).Count
$summary = Join-Path $EvidenceDir 'SUMMARY.txt'
$Results | Format-Table -AutoSize | Out-String -Width 200 | Out-File -FilePath $summary -Encoding utf8
if ($failed -eq 0) { Write-Host "Все шаги пройдены. Сводка: evidence\run\SUMMARY.txt" -ForegroundColor Green }
else { Write-Host "Провалено шагов: $failed. Подробности — в файлах evidence\run\*.txt" -ForegroundColor Red }
}
# ------------------------------------------------------------------ шаги
function Step-Check {
Write-Title 'Проверка окружения'
$ok = $true
if (-not $Py) { Write-Host 'Нужен Python 3.9+ (python или py -3 в PATH)' -ForegroundColor Red; $ok = $false }
else { Write-Host "Python: $Py $($PyArgs -join ' ') ($(& $Py @PyArgs --version 2>&1))" }
if (-not (Get-Command docker -ErrorAction SilentlyContinue)) { Write-Host 'Нужен Docker Desktop' -ForegroundColor Red; $ok = $false }
else {
docker info --format '{{.ServerVersion}}' 1>$null 2>$null
if ($LASTEXITCODE -ne 0) { Write-Host 'Docker daemon не запущен (запустите Docker Desktop)' -ForegroundColor Red; $ok = $false }
$cv = docker compose version --short 2>$null
if ($LASTEXITCODE -ne 0) { Write-Host 'Нужен Docker Compose v2 (docker compose)' -ForegroundColor Red; $ok = $false }
else { Write-Host "Docker Compose: $cv" }
}
foreach ($port in @($HttpsPort, 3000)) {
$busy = $false
try { $busy = @(Get-NetTCPConnection -LocalPort $port -State Listen -ErrorAction Stop).Count -gt 0 } catch { }
if ($busy) {
$own = docker ps --filter "label=com.docker.compose.project=messenger-lab7" -q 2>$null
if (-not $own) { Write-Host "Порт $port занят другим процессом" -ForegroundColor Yellow }
}
}
if (-not $ok) { Write-Host 'Окружение не готово.' -ForegroundColor Red; exit 2 }
Invoke-Py 'check-contract' 'make check: структура skeleton, контракт, синтаксис тестов' @('scripts/check_contract.py') | Out-Null
Invoke-Step 'compose-config' 'docker compose config --quiet' 'docker' @('compose', 'config', '--quiet') | Out-Null
}
function Step-Up {
Invoke-Py 'up' 'Bootstrap: secrets -> образ -> PKI -> OpenBao init/unseal/configure -> стенд -> ожидание готовности' `
@('scripts/ops.py', 'up') | Out-Null
Invoke-Py 'ps' 'Реплики API: alias, health, статус в LB' @('scripts/ops.py', 'ps') | Out-Null
}
function Step-Test {
Invoke-Py 'test-smoke' "make test BASE_URL=$BaseUrl CA_FILE=secrets\pki\ca.crt" `
@('tests/smoke.py', '--base-url', $BaseUrl, '--ca-file', $CaFile) | Out-Null
Invoke-Py 'test-security' 'make test-security: доверенный CA работает, недоверенный — ошибка проверки сертификата' `
@('tests/security.py', '--base-url', $BaseUrl, '--ca-file', $CaFile) | Out-Null
}
function Step-Security {
Invoke-Py 'tls-audit' 'Вся trust matrix: TLS/mTLS (нет cert / чужой CA / чужая identity / верная), имена, plaintext, ACL' `
@('scripts/ops.py', 'tls-audit') | Out-Null
Invoke-Py 'security-http' 'ACL/вложения, X-User-Id, logout, 429 + Retry-After (общий), 413, ошибки без утечек, TLS снаружи' `
@('scripts/ops.py', 'security-http') | Out-Null
Invoke-Py 'bao-policy' 'OpenBao: allow/deny политик реальными токенами AppRole, CIDR, TTL' `
@('scripts/ops.py', 'bao-policy') | Out-Null
Invoke-Py 'hardening' 'Hardening: non-root, read_only, cap_drop, no-new-privileges, лимиты, порты, сегментация, egress' `
@('scripts/ops.py', 'hardening') | Out-Null
Invoke-Py 'rehash' 'Argon2id: старый hash пересчитывается при успешном входе' @('scripts/ops.py', 'rehash-demo') | Out-Null
Invoke-Py 'leak-check' 'В Loki/Tempo/Prometheus нет паролей, токенов, секретов ролей' @('scripts/ops.py', 'leak-check') | Out-Null
Invoke-Py 'expiry' 'Истечение сессии (экземпляр с TTL 2 с, mTLS напрямую к реплике)' @('scripts/ops.py', 'in-network', 'expiry') | Out-Null
}
function Step-Resilience {
$restart = Join-Path $Root 'scripts\restart.cmd'
$stopOne = Join-Path $Root 'scripts\stop-one.cmd'
Invoke-Py 'test-persistence' 'make test-persistence: рестарт API и всех хранилищ (вкл. OpenBao + unseal), данные и токен живы' `
@('tests/resilience.py', '--mode', 'persistence', '--action-script', $restart, '--base-url', $BaseUrl, '--ca-file', $CaFile) | Out-Null
Invoke-Py 'test-failover-1' 'make test-failover: отказ одной API-реплики по HTTPS' `
@('tests/resilience.py', '--mode', 'failover', '--action-script', $stopOne, '--base-url', $BaseUrl, '--ca-file', $CaFile) | Out-Null
Invoke-Py 'restore-1' 'Восстановление реплики' @('scripts/ops.py', 'restore') | Out-Null
Invoke-Py 'test-failover-2' 'Отказ другой реплики (последовательно)' `
@('tests/resilience.py', '--mode', 'failover', '--action-script', $stopOne, '--base-url', $BaseUrl, '--ca-file', $CaFile) | Out-Null
Invoke-Py 'restore-2' 'Восстановление реплики' @('scripts/ops.py', 'restore') | Out-Null
}
function Step-Lifecycle {
Invoke-Py 'rotate-db-password' 'Ротация рабочего секрета (пароль роли БД) без пересборки и рестарта API' `
@('scripts/ops.py', 'rotate-db-password', 'api') | Out-Null
Invoke-Py 'rotate-lb-cert' 'Ротация leaf LB->API + отзыв старого сертификата (CRL), проверка старым и новым' `
@('scripts/ops.py', 'rotate-lb-cert') | Out-Null
Invoke-Py 'rotate-secret-id' 'Новый SecretID агента API, старый уничтожен' @('scripts/ops.py', 'rotate-secret-id', 'api') | Out-Null
Invoke-Py 'revoke-identity' 'Отзыв identity worker в OpenBao -> агент без доступа -> восстановление' `
@('scripts/ops.py', 'revoke-identity', 'worker') | Out-Null
Invoke-Py 'bao-sealed' 'OpenBao sealed: API работает и перезапускается на отрисованных секретах, затем unseal' `
@('scripts/ops.py', 'bao-sealed') | Out-Null
Invoke-Py 'smoke-after-lifecycle' 'Smoke после всех ротаций' @('tests/smoke.py', '--base-url', $BaseUrl, '--ca-file', $CaFile) | Out-Null
}
function Step-Extra {
Invoke-Py 'student-tests' 'Собственные HTTP-тесты lab2-6 через HTTPS' `
@('student-tests/run_all.py', '--base-url', $BaseUrl) -EnvVars @{ CA_FILE = $CaFile } | Out-Null
Invoke-Py 'storage-tests' 'White-box тесты хранилища внутри сети (identity администратора БД)' `
@('scripts/ops.py', 'in-network', 'storage') | Out-Null
Invoke-Py 'login-budget' 'Бюджет login DoS: Argon2id на стенде + поток входов' @('scripts/ops.py', 'login-budget') | Out-Null
Invoke-Py 's3-check' 'Приватность бакета и права ключа API вне API' @('scripts/ops.py', 's3-check') | Out-Null
}
# ------------------------------------------------------------------ main
switch ($Action) {
'check' { Step-Check }
'up' { Step-Check; Step-Up }
'test' { Step-Test }
'security' { Step-Security }
'resilience' { Step-Resilience }
'lifecycle' { Step-Lifecycle }
'extra' { Step-Extra }
'scan' { Invoke-Py 'scan' 'pip-audit + trivy образов (разбор: docs/security/SCAN_TRIAGE.md)' @('scripts/ops.py', 'scan') | Out-Null }
'down' { Invoke-Py 'down' 'Остановка стенда (volumes сохраняются)' @('scripts/ops.py', 'down') | Out-Null }
'destroy' {
$answer = Read-Host 'Удалить ВСЕ данные стенда (БД, S3, broker, OpenBao, телеметрия)? Введите yes'
if ($answer -eq 'yes') { Invoke-Py 'destroy' 'Удаление volumes стенда' @('scripts/ops.py', 'destroy') | Out-Null }
}
'all' {
Step-Check
if (-not $SkipUp) { Step-Up }
Step-Test
Step-Security
Step-Resilience
Step-Lifecycle
Step-Extra
}
}
if ($Results.Count -gt 0) { Show-Summary }
if (@($Results | Where-Object { $_.Result -ne 'PASS' }).Count -gt 0) { exit 1 }
exit 0