Files

104 lines
6.8 KiB
Markdown

# Lab4 — Git, fork и MR
Этот рецепт рассчитан на ситуацию, когда рабочая папка `mtusi2026lab4` распакована из архива и все Docker-тесты выполнялись **из неё**. Не копирует `.env`, `.git`, исходные `tests/smoke.py`, `tests/client.py`, `README.md`, `COURSE.md`, `contracts/`.
## 1. Подложить отчёт и измерить стоимость обхода
```powershell
# Из рабочей папки 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 выполните:
```powershell
$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
Тогда ничего не клонируйте и не копируйте, оставайтесь в рабочей папке:
```powershell
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 не нужно.