Files

6.8 KiB

Lab4 — Git, fork и MR

Этот рецепт рассчитан на ситуацию, когда рабочая папка mtusi2026lab4 распакована из архива и все Docker-тесты выполнялись из неё. Не копирует .env, .git, исходные tests/smoke.py, tests/client.py, README.md, COURSE.md, contracts/.

1. Подложить отчёт и измерить стоимость обхода

# Из рабочей папки Lab4
Expand-Archive -Path "$HOME\Downloads\lab4_submission_docs.zip" -DestinationPath . -Force
$env:PYTHONUTF8 = '1'
# Если есть время до MR: три уровня нагрузки, пять замеров на каждом
powershell -ExecutionPolicy Bypass -File scripts/measure_reconcile.ps1

После измерения добавьте таблицу из evidence/reconcile-cost-*.csv в REPORT.md вместо пометки «не проверено». Скрипт создаёт синтетические вложения и не удаляет их; используйте тестовый стенд.

2. Если локальная папка НЕ является Git clone

Создайте fork именно репозитория Lab4 в Gitea. Затем из рабочей папки Lab4 выполните:

$ErrorActionPreference = 'Stop'
$src = (Get-Location).Path
$forkUrl = Read-Host 'Вставьте HTTPS-ссылку на свой fork Lab4'
Set-Location ..
if (Test-Path .\mtusi2026lab4-fork) { throw 'Папка mtusi2026lab4-fork уже есть; не перезаписываем её' }
git clone $forkUrl mtusi2026lab4-fork
if ($LASTEXITCODE -ne 0) { throw 'Не получилось клонировать fork' }
Set-Location .\mtusi2026lab4-fork
git switch -c solution/BPI2301-Avzalov
if ($LASTEXITCODE -ne 0) { throw 'Не получилось создать ветку' }

# Собственные исходники и миграции; skeleton сохраняем.
New-Item -ItemType Directory -Force app, 'db/migrations', infra, scripts, tests, evidence | Out-Null
Copy-Item "$src\app\*.py" '.\app\' -Force
Copy-Item "$src\db\migrations\*.sql" '.\db\migrations\' -Force
Copy-Item "$src\infra\haproxy.cfg", "$src\infra\filer.toml" '.\infra\' -Force

foreach ($name in @('Dockerfile','compose.yaml','requirements.txt','.env.example','.gitattributes','REPORT.md','DEMO.md','LAB4_TEST_COMMANDS.md')) {
    Copy-Item (Join-Path $src $name) . -Force
}
foreach ($name in @('restart.cmd','restart.sh','stop-one.cmd','stop-one.sh','rolling-update.sh','wait_ready.py','measure_reconcile.ps1')) {
    Copy-Item (Join-Path $src ('scripts/' + $name)) '.\scripts\' -Force
}
foreach ($name in @('attachments_concurrent.py','attachments_negative.py','idempotency_parallel.py','own_unit.py')) {
    Copy-Item (Join-Path $src ('tests/' + $name)) '.\tests\' -Force
}
Copy-Item "$src\evidence\verified_results_2026-11-12.md" '.\evidence\' -Force
foreach ($name in @('attachments-concurrent.json')) {
    $path = Join-Path $src ('evidence/' + $name)
    if (Test-Path $path) { Copy-Item $path '.\evidence\' -Force }
}
Get-ChildItem "$src\evidence\reconcile-cost-*.csv" -ErrorAction SilentlyContinue | ForEach-Object {
    Copy-Item $_.FullName '.\evidence\' -Force
}

# Тесты и контракт должны остаться из fork.
git add .env.example .gitattributes Dockerfile compose.yaml requirements.txt REPORT.md DEMO.md LAB4_TEST_COMMANDS.md app db/migrations infra/haproxy.cfg infra/filer.toml scripts/restart.cmd scripts/restart.sh scripts/stop-one.cmd scripts/stop-one.sh scripts/rolling-update.sh scripts/wait_ready.py scripts/measure_reconcile.ps1 tests/attachments_concurrent.py tests/attachments_negative.py tests/idempotency_parallel.py tests/own_unit.py evidence

git update-index --chmod=+x scripts/restart.sh
git update-index --chmod=+x scripts/stop-one.sh
git update-index --chmod=+x scripts/rolling-update.sh

git diff --cached --check
git --no-pager diff --cached --stat
git status --short
git ls-files .env
python scripts/check_contract.py

# ПОСЛЕ ручного просмотра staged diff на наличие секретов:
git commit -m 'Implement lab4 private S3 attachments and reconciliation track'
git push -u origin solution/BPI2301-Avzalov

Почему без запуска нового Docker Compose внутри clone: новый каталог и имя Compose-проекта создадут новые volumes, а порт 8080 может быть занят старым стендом. Поэтому интеграционные тесты сначала относятся к рабочему каталогу, из которого копируются файлы. Если нужно проверить именно clone, остановите старый стенд, создайте локальный .env в clone, поднимите чистый стенд и повторите публичные тесты.

3. Если Lab4 УЖЕ находится в Git clone

Тогда ничего не клонируйте и не копируйте, оставайтесь в рабочей папке:

git remote -v
git branch --show-current
git status --short
git add .env.example .gitattributes Dockerfile compose.yaml requirements.txt REPORT.md DEMO.md LAB4_TEST_COMMANDS.md app db/migrations infra/haproxy.cfg infra/filer.toml scripts/restart.cmd scripts/restart.sh scripts/stop-one.cmd scripts/stop-one.sh scripts/rolling-update.sh scripts/wait_ready.py scripts/measure_reconcile.ps1 tests/attachments_concurrent.py tests/attachments_negative.py tests/idempotency_parallel.py tests/own_unit.py evidence
git diff --cached --check
git --no-pager diff --cached --stat
git ls-files .env
# убедитесь, что origin — ваш fork, а в diff нет секретов и изменения контрактов
git commit -m 'Implement lab4 private S3 attachments and reconciliation track'
git push origin HEAD

4. Создать MR

Title: ЛР 4 — БПИ2301 — Авзалов — на 5.

  • Source: ваш fork, ветка solution/BPI2301-Avzalov (либо фактическая ветка, если MR уже создан).
  • Target: исходный Lab4, main.
  • Описание: скопировать содержимое MR_DESCRIPTION.md.
  • Перед отправкой выполнить git status --short, просмотреть список изменённых файлов, убрать секреты и проверить, что public tests/, contracts/, README.md, COURSE.md не переписаны.

Если MR уже создан, достаточно нового коммита и push в его существующую source-ветку; пересоздавать MR не нужно.