docs: complete lab 4 report and add the application CI job

- fill the skeleton sections of REPORT.md: author and target grade,
  launch from a clean clone, architecture and variable mapping, open
  questions to the teacher, limitations, sources and AI use
- add evidence/tests/clean-clone-final.md: clean clone of de98d77
- add .github/workflows/application.yml (CONTRIBUTING.md, CI) and the
  .github/ci/ override for the Gitea runner: configs instead of bind
  mounts, no host ports; evidence/tests/ci-application.md
- remove PLAN.md now that all changes are archived; point AGENTS.md
  and the rules at REPORT.md

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-10-29 18:12:55 +03:00
co-authored by Claude Opus 5.5
parent de98d77312
commit d947781591
13 changed files with 1376 additions and 1706 deletions
+129
View File
@@ -0,0 +1,129 @@
# Job приложения (CONTRIBUTING.md, «CI»): сборка образа, стенд и его
# готовность через LB, make check и make test, затем проверки, которым
# хватает сети стенда: приватность bucket для анонима, собственные тесты,
# сохранность после рестарта и отказ реплики. Workflow skeleton
# contracts.yml проверяет только контракт и не меняется.
# Раннер Gitea (act_runner) запускает job в контейнере на том же Docker,
# что и стенд: конфиги и порты — override .github/ci/compose.yml, к LB job
# ходит по сети стенда. Секретов CI не получает: пароли и ключи — случайные
# из make env_setup и живут только в прогоне. pull_request_target не
# используется (CONTRIBUTING.md). Нет make s3_check, test_isolated и
# failure_checks: им нужны порты на хосте; их результат — evidence/.
name: Application
on: [push, pull_request, workflow_dispatch]
permissions:
contents: read
# прогоны репозитория по очереди и без отмены: отменённый посреди прогона
# job оставил бы стенд на общем хосте раннера, а уборка хвостов не должна
# задеть стенд соседнего прогона
concurrency:
group: application-${{ github.repository }}
cancel-in-progress: false
jobs:
application:
runs-on: ubuntu-latest
timeout-minutes: 40
env:
# свой проект, volumes и образ у каждого прогона
COMPOSE_PROJECT_NAME: mtusi-lab4-safronov-ci-${{ github.run_id }}
COMPOSE_FILE: docker-compose.yml:.github/ci/compose.yml
CI_IMAGE_TAG: safronov-ci-${{ github.run_id }}
# LB по имени сервиса в сети стенда, порт — APP__PORT из .env.example
BASE_URL: http://haproxy:8080
steps:
- name: Checkout
# ровно commit прогона; репозиторий публичный, токен не нужен
run: |
git init -q .
git remote add origin "${{ github.server_url }}/${{ github.repository }}.git"
git fetch -q --depth=1 origin "${{ github.sha }}"
git checkout -q --detach FETCH_HEAD
git log --oneline -1
- name: Runner
run: |
docker info --format 'docker {{.ServerVersion}}, {{.OSType}}/{{.Architecture}}, {{.NCPU}} CPU, {{.MemTotal}} B'
docker compose version
python3 -V
- name: Remove stands of interrupted runs
# только проекты этого workflow: прогон, прерванный без уборки
# (сбой раннера), оставил бы их на хосте
run: |
for p in $(docker ps -a --format '{{.Label "com.docker.compose.project"}}' | grep '^mtusi-lab4-safronov-ci-' | sort -u || true); do
echo "remove leftover stand $p"
docker ps -aq --filter "label=com.docker.compose.project=$p" | xargs -r docker rm -f >/dev/null
docker volume ls -q --filter "label=com.docker.compose.project=$p" | xargs -r docker volume rm >/dev/null
docker network ls -q --filter "label=com.docker.compose.project=$p" | xargs -r docker network rm >/dev/null || true
done
- name: Build and start the stand
run: |
make env_setup
. .github/ci/stand-env.sh
docker compose config --quiet
make run_docker
make replicas
docker network connect "${COMPOSE_PROJECT_NAME}_default" "$HOSTNAME"
wait_replicas
docker compose ps -a --format 'table {{.Service}}\t{{.Status}}'
- name: make check and make test
run: |
make check
make test
- name: Bucket is closed to anonymous requests
# без подписи: список bucket и объектов — 403. Полная проверка
# приватности — make s3_check (evidence/s3/privacy.md)
run: |
s3="http://s3:$(sed -n 's/^S3_PORT=//p' .env)"
bucket=$(sed -n 's/^S3__BUCKET=//p' .env)
for url in "$s3/" "$s3/$bucket" "$s3/$bucket?list-type=2"; do
code=$(curl -s -o /dev/null -w '%{http_code}' "$url")
echo "anonymous GET $url -> $code"
test "$code" = 403
done
- name: Install uv
# та же версия, что в Dockerfile
run: |
python3 -m venv "$RUNNER_TEMP/uv"
"$RUNNER_TEMP/uv/bin/pip" install -q uv==0.12.17
echo "$RUNNER_TEMP/uv/bin" >> "$GITHUB_PATH"
- name: make student_test
# через LB: тесты реплик выполняются, проверки отказов — нет
run: make student_test
- name: make test-persistence
run: |
. .github/ci/stand-env.sh
make test-persistence ACTION_SCRIPT=scripts/restart.sh
wait_replicas
- name: make test-failover, stop and kill
# остановленную реплику возвращает make replicas (те же ID)
run: |
. .github/ci/stand-env.sh
log="$RUNNER_TEMP/stop-one.log"
STOP_ONE_LOG="$log" make test-failover ACTION_SCRIPT=scripts/stop-one.sh
make replicas
wait_replicas
STOP_ONE_LOG="$log" STOP_MODE=kill make test-failover ACTION_SCRIPT=scripts/stop-one.sh
make replicas
wait_replicas
cat "$log"
- name: Stand logs
if: failure()
run: |
if [ -f .env ]; then docker compose ps -a; docker compose logs --no-color --tail=200; fi
- name: Remove the stand
if: always()
run: |
docker network disconnect "${COMPOSE_PROJECT_NAME}_default" "$HOSTNAME" 2>/dev/null || true
if [ -f .env ]; then docker compose down -v --remove-orphans; fi
docker image rm "mtusi-messenger:$CI_IMAGE_TAG" >/dev/null 2>&1 || true