From 2e5f5bfe1b8552fdbe9c365ec2f11c70a8c9b636 Mon Sep 17 00:00:00 2001 From: Sergey Lyakhonov Date: Fri, 30 Oct 2026 17:24:00 +0300 Subject: [PATCH 1/5] =?UTF-8?q?=D0=9F=D0=B5=D1=80=D0=B5=D0=BD=D0=B5=D1=81?= =?UTF-8?q?=D1=82=D0=B8=20=D1=81=D0=BE=D0=B1=D1=81=D1=82=D0=B2=D0=B5=D0=BD?= =?UTF-8?q?=D0=BD=D1=83=D1=8E=20=D0=B1=D0=B0=D0=B7=D1=83=20=D0=BB=D0=B0?= =?UTF-8?q?=D0=B1=D0=BE=D1=80=D0=B0=D1=82=D0=BE=D1=80=D0=BD=D0=BE=D0=B9=20?= =?UTF-8?q?3=20=D1=81=20=D1=81=D0=BE=D1=85=D1=80=D0=B0=D0=BD=D0=B5=D0=BD?= =?UTF-8?q?=D0=B8=D0=B5=D0=BC=20=D0=B7=D0=B0=D0=B4=D0=B0=D0=BD=D0=B8=D1=8F?= =?UTF-8?q?=20=D0=B8=20=D0=BA=D0=BE=D0=BD=D1=82=D1=80=D0=B0=D0=BA=D1=82?= =?UTF-8?q?=D0=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- Dockerfile | 12 ++ compose.yaml | 70 +++++++++ infra/haproxy.cfg | 27 ++++ migrations/001_initial.sql | 33 +++++ migrations/002_idempotency.sql | 10 ++ requirements.lock.txt | 25 ++++ requirements.txt | 7 + scripts/bootstrap.py | 15 ++ scripts/wait_ready.py | 22 +++ src/__init__.py | 0 src/app.py | 162 ++++++++++++++++++++ src/cache.py | 60 ++++++++ src/config.py | 10 ++ src/main.py | 9 ++ src/migrate.py | 19 +++ src/models.py | 119 +++++++++++++++ src/routes/__init__.py | 0 src/routes/chats.py | 79 ++++++++++ src/routes/common.py | 29 ++++ src/routes/health.py | 21 +++ src/routes/messages.py | 83 +++++++++++ src/routes/users.py | 49 +++++++ src/storage.py | 260 +++++++++++++++++++++++++++++++++ 23 files changed, 1121 insertions(+) create mode 100644 Dockerfile create mode 100644 compose.yaml create mode 100644 infra/haproxy.cfg create mode 100644 migrations/001_initial.sql create mode 100644 migrations/002_idempotency.sql create mode 100644 requirements.lock.txt create mode 100644 requirements.txt create mode 100644 scripts/bootstrap.py create mode 100644 scripts/wait_ready.py create mode 100644 src/__init__.py create mode 100644 src/app.py create mode 100644 src/cache.py create mode 100644 src/config.py create mode 100644 src/main.py create mode 100644 src/migrate.py create mode 100644 src/models.py create mode 100644 src/routes/__init__.py create mode 100644 src/routes/chats.py create mode 100644 src/routes/common.py create mode 100644 src/routes/health.py create mode 100644 src/routes/messages.py create mode 100644 src/routes/users.py create mode 100644 src/storage.py diff --git a/Dockerfile b/Dockerfile new file mode 100644 index 00000000..d74bf817 --- /dev/null +++ b/Dockerfile @@ -0,0 +1,12 @@ +FROM python:3.11.10-slim-bookworm +WORKDIR /app +# Приложение работает без прав root. +RUN groupadd -r appuser && useradd -r -g appuser appuser +COPY requirements.lock.txt . +RUN pip install --no-cache-dir -r requirements.lock.txt +COPY src/ src/ +COPY migrations/ migrations/ +USER appuser +HEALTHCHECK --interval=2s --timeout=2s --start-period=10s --retries=3 CMD python -c "import urllib.request; urllib.request.urlopen('http://localhost:8080/health/ready',timeout=1)" +EXPOSE 8080 +CMD ["python", "-m", "uvicorn", "src.app:app", "--host", "0.0.0.0", "--port", "8080", "--timeout-graceful-shutdown", "8", "--timeout-keep-alive", "2", "--no-access-log"] diff --git a/compose.yaml b/compose.yaml new file mode 100644 index 00000000..80859499 --- /dev/null +++ b/compose.yaml @@ -0,0 +1,70 @@ +name: lyakhonov-lab3 +x-api: &api + image: lyakhonov-messenger:lab3 + build: . + environment: + DATABASE_URL_FILE: /run/secrets/database_url + CACHE_URL: redis://redis:6379/0 + SESSION_TTL_SECONDS: ${SESSION_TTL_SECONDS:-3600} + POOL_SIZE: ${POOL_SIZE:-10} + OPTIMIZED_WRITES: ${OPTIMIZED_WRITES:-1} + secrets: [database_url] + depends_on: + migrate: + condition: service_completed_successfully + cpus: ${API_CPUS:-0.5} + mem_limit: ${API_MEMORY:-256m} + stop_grace_period: 12s +services: + db: + image: postgres:16.6-alpine + environment: + POSTGRES_USER: messenger + POSTGRES_DB: messenger + POSTGRES_PASSWORD_FILE: /run/secrets/db_password + secrets: [db_password] + volumes: [postgres_data:/var/lib/postgresql/data] + healthcheck: + test: [CMD-SHELL, "pg_isready -U messenger -d messenger"] + interval: 2s + timeout: 2s + retries: 30 + cpus: 1 + mem_limit: 512m + redis: + image: redis:7.4.1-alpine + command: [redis-server, --maxmemory, 64mb, --maxmemory-policy, allkeys-lru, --save, "", --appendonly, "no"] + cpus: 0.25 + mem_limit: 128m + migrate: + <<: *api + command: [python, -m, src.migrate] + depends_on: + db: + condition: service_healthy + healthcheck: + disable: true + api: + <<: *api + deploy: + replicas: ${API_REPLICAS:-2} + lb: + image: haproxy:3.0.6-alpine + ports: ["127.0.0.1:8080:8080"] + volumes: [./infra/haproxy.cfg:/usr/local/etc/haproxy/haproxy.cfg:ro] + depends_on: [api] + cpus: 0.5 + mem_limit: 128m + stop_grace_period: 12s + healthcheck: + test: [CMD, haproxy, -c, -f, /usr/local/etc/haproxy/haproxy.cfg] + interval: 5s + timeout: 2s + retries: 3 +secrets: + db_password: + file: ./secrets/db_password + database_url: + file: ./secrets/database_url +volumes: + postgres_data: diff --git a/infra/haproxy.cfg b/infra/haproxy.cfg new file mode 100644 index 00000000..0981249f --- /dev/null +++ b/infra/haproxy.cfg @@ -0,0 +1,27 @@ +global + log stdout format raw local0 + maxconn 1024 +defaults + mode http + log global + timeout connect 1s + timeout client 10s + timeout server 5s + timeout check 1s + retries 0 +resolvers docker + nameserver dns 127.0.0.11:53 + resolve_retries 2 + timeout resolve 1s + timeout retry 1s + hold valid 1s + hold obsolete 1s +frontend public + bind :8080 + default_backend application +backend application + balance roundrobin + option httpchk GET /health/ready + http-check expect status 200 + default-server inter 1s fastinter 500ms downinter 1s fall 2 rise 1 + server-template api 1-4 api:8080 check resolvers docker init-addr none diff --git a/migrations/001_initial.sql b/migrations/001_initial.sql new file mode 100644 index 00000000..2ee14af7 --- /dev/null +++ b/migrations/001_initial.sql @@ -0,0 +1,33 @@ +CREATE TABLE users ( + id uuid PRIMARY KEY, + username varchar(32) NOT NULL UNIQUE CHECK (username ~ '^[a-z0-9_]{3,32}$'), + display_name varchar(100) NOT NULL CHECK (length(btrim(display_name)) > 0), + password_hash text NOT NULL, + created_at timestamptz NOT NULL DEFAULT clock_timestamp() +); +CREATE TABLE chats ( + id uuid PRIMARY KEY, + title varchar(100) NOT NULL CHECK (length(btrim(title)) > 0), + created_at timestamptz NOT NULL DEFAULT clock_timestamp() +); +CREATE TABLE chat_members ( + chat_id uuid NOT NULL REFERENCES chats(id), + user_id uuid NOT NULL REFERENCES users(id), + PRIMARY KEY (chat_id, user_id) +); +CREATE INDEX chat_members_user_idx ON chat_members (user_id, chat_id); +CREATE TABLE messages ( + id uuid PRIMARY KEY, + chat_id uuid NOT NULL REFERENCES chats(id), + sender_id uuid NOT NULL REFERENCES users(id), + text varchar(4000) NOT NULL CHECK (length(btrim(text)) > 0), + created_at timestamptz NOT NULL DEFAULT clock_timestamp(), + FOREIGN KEY (chat_id, sender_id) REFERENCES chat_members(chat_id, user_id) +); +CREATE INDEX messages_history_idx ON messages (chat_id, created_at, id); +CREATE TABLE sessions ( + token_hash char(64) PRIMARY KEY, + user_id uuid NOT NULL REFERENCES users(id), + expires_at timestamptz NOT NULL +); +CREATE INDEX sessions_expiry_idx ON sessions (expires_at); diff --git a/migrations/002_idempotency.sql b/migrations/002_idempotency.sql new file mode 100644 index 00000000..be707c47 --- /dev/null +++ b/migrations/002_idempotency.sql @@ -0,0 +1,10 @@ +CREATE TABLE message_requests ( + user_id uuid NOT NULL REFERENCES users(id), + chat_id uuid NOT NULL REFERENCES chats(id), + key varchar(128) NOT NULL, + body text NOT NULL, + message_id uuid NOT NULL REFERENCES messages(id), + expires_at timestamptz NOT NULL, + PRIMARY KEY (user_id, chat_id, key) +); +CREATE INDEX message_requests_expiry_idx ON message_requests(expires_at); diff --git a/requirements.lock.txt b/requirements.lock.txt new file mode 100644 index 00000000..ceec59ee --- /dev/null +++ b/requirements.lock.txt @@ -0,0 +1,25 @@ +annotated-types==0.8.0 +anyio==4.15.1 +argon2-cffi==23.1.0 +argon2-cffi-bindings==26.1.0 +cffi==2.1.1 +click==8.5.0 +fastapi==0.115.0 +h11==0.16.0 +httptools==0.8.0 +idna==3.20 +psycopg==3.2.3 +psycopg-binary==3.2.3 +psycopg-pool==3.2.4 +pycparser==3.1 +pydantic==2.9.2 +pydantic_core==2.23.4 +python-dotenv==1.2.4 +PyYAML==6.0.3 +starlette==0.38.6 +typing_extensions==4.16.0 +uvicorn==0.32.0 +uvloop==0.23.0 +watchfiles==1.3.0 +websockets==17.2 +redis==5.2.0 diff --git a/requirements.txt b/requirements.txt new file mode 100644 index 00000000..1b6204da --- /dev/null +++ b/requirements.txt @@ -0,0 +1,7 @@ +fastapi==0.115.0 +uvicorn[standard]==0.32.0 +pydantic==2.9.2 +psycopg[binary]==3.2.3 +psycopg-pool==3.2.4 +argon2-cffi==23.1.0 +redis==5.2.0 diff --git a/scripts/bootstrap.py b/scripts/bootstrap.py new file mode 100644 index 00000000..e1fd52c4 --- /dev/null +++ b/scripts/bootstrap.py @@ -0,0 +1,15 @@ +"""Создать локальные секреты, не перезаписывая существующие.""" +from pathlib import Path +import secrets + +root = Path(__file__).resolve().parents[1] +folder = root / 'secrets' +folder.mkdir(exist_ok=True) +password_file = folder / 'db_password' +if not password_file.exists(): + password_file.write_text(secrets.token_hex(24), encoding='utf-8') +url_file = folder / 'database_url' +if not url_file.exists(): + password = password_file.read_text(encoding='utf-8').strip() + url_file.write_text(f'postgresql://messenger:{password}@db:5432/messenger', encoding='utf-8') +print('Локальные секреты готовы; значения не выводятся.') diff --git a/scripts/wait_ready.py b/scripts/wait_ready.py new file mode 100644 index 00000000..b483a49b --- /dev/null +++ b/scripts/wait_ready.py @@ -0,0 +1,22 @@ +"""Дождаться HTTP readiness перед запуском проверок.""" +import argparse +import time +import urllib.request +parser=argparse.ArgumentParser() +parser.add_argument('--base-url',default='http://localhost:8080') +parser.add_argument('--replicas',type=int,default=1) +args=parser.parse_args() +observed=set() +for _ in range(120): + try: + with urllib.request.urlopen(args.base_url+'/health/ready',timeout=2) as response: + if response.status==200: + observed.add(response.headers.get('X-Instance-Id')) + if len(observed)>=args.replicas: + print('PASS: API ready, replicas:', len(observed)) + break + time.sleep(0.1) + except Exception: + time.sleep(0.5) +else: + raise SystemExit('API readiness timeout') diff --git a/src/__init__.py b/src/__init__.py new file mode 100644 index 00000000..e69de29b diff --git a/src/app.py b/src/app.py new file mode 100644 index 00000000..1b02146e --- /dev/null +++ b/src/app.py @@ -0,0 +1,162 @@ +import uuid +import os +import socket +from contextlib import asynccontextmanager +import psycopg +from psycopg_pool import PoolTimeout, TooManyRequests +from starlette.concurrency import run_in_threadpool + +from fastapi import FastAPI, Request +from fastapi.exceptions import RequestValidationError +from fastapi.responses import JSONResponse +from pydantic import ValidationError as PydanticValidationError +from starlette.exceptions import HTTPException as StarletteHTTPException + +from src.models import ErrorResponse +from src.routes import chats, health, messages, users +from src.storage import storage + + +def create_app() -> FastAPI: + """Создать и настроить приложение FastAPI.""" + @asynccontextmanager + async def lifespan(app): + await run_in_threadpool(storage.pool.open, wait=True) + try: + yield + finally: + await run_in_threadpool(storage.pool.close) + + instance_id = os.getenv("INSTANCE_ID", socket.gethostname()) + "-" + uuid.uuid4().hex[:8] + app = FastAPI(title="MTUSI Messenger Lab3", version="1.3.0", lifespan=lifespan) + + @app.exception_handler(psycopg.OperationalError) + @app.exception_handler(psycopg.errors.QueryCanceled) + @app.exception_handler(psycopg.errors.LockNotAvailable) + @app.exception_handler(PoolTimeout) + @app.exception_handler(TooManyRequests) + async def dependency_error(request, exc): + return JSONResponse(status_code=503, content=ErrorResponse(error={ + "code": "unavailable", "message": "хранилище временно недоступно", + "request_id": request.state.request_id}).model_dump(), + headers={"X-Request-Id": request.state.request_id}) + + @app.middleware("http") + async def add_request_id(request: Request, call_next): + """Добавляет идентификаторы запроса и процесса, ограничивает очередь.""" + request_id = request.headers.get("X-Request-Id", "") or str(uuid.uuid4()) + request.state.request_id = request_id + + # Ограничение числа обслуживаемых запросов в процессе. + if not storage.acquire_request_slot(): + return JSONResponse( + status_code=503, + content=ErrorResponse( + error={ + "code": "unavailable", + "message": "сервер перегружен, попробуйте позже", + "request_id": request_id, + } + ).model_dump(), + headers={"X-Request-Id": request_id, "X-Instance-Id": instance_id}, + ) + + try: + response = await call_next(request) + response.headers["X-Request-Id"] = request_id + response.headers["X-Instance-Id"] = instance_id + return response + finally: + storage.release_request_slot() + + @app.exception_handler(StarletteHTTPException) + async def http_exception_handler(request: Request, exc: StarletteHTTPException): + """Обработчик HTTPException: возвращает ошибку в формате контракта {"error": ...}.""" + request_id = getattr(request.state, "request_id", str(uuid.uuid4())) + if isinstance(exc.detail, dict) and "error" in exc.detail: + return JSONResponse( + status_code=exc.status_code, + content=exc.detail, + headers={"X-Request-Id": request_id, **(exc.headers or {})}, + ) + return JSONResponse( + status_code=exc.status_code, + content=ErrorResponse( + error={ + "code": "internal_error", + "message": str(exc.detail), + "request_id": request_id, + } + ).model_dump(), + headers={"X-Request-Id": request_id, "X-Instance-Id": instance_id}, + ) + + @app.exception_handler(RequestValidationError) + async def request_validation_handler(request: Request, exc: RequestValidationError): + """Перехватываем ошибки валидации запроса (422 -> 400 по контракту).""" + request_id = getattr(request.state, "request_id", str(uuid.uuid4())) + errors = exc.errors() + messages = [] + for err in errors: + loc = ".".join(str(x) for x in err.get("loc", [])) + messages.append(f"{loc}: {err.get('msg', 'invalid')}") + return JSONResponse( + status_code=400, + content=ErrorResponse( + error={ + "code": "invalid_request", + "message": "; ".join(messages), + "request_id": request_id, + } + ).model_dump(), + headers={"X-Request-Id": request_id, "X-Instance-Id": instance_id}, + ) + + @app.exception_handler(PydanticValidationError) + async def validation_exception_handler(request: Request, exc: PydanticValidationError): + """Перехватываем ошибки Pydantic (422 -> 400 по контракту).""" + request_id = getattr(request.state, "request_id", str(uuid.uuid4())) + errors = exc.errors() + messages = [] + for err in errors: + loc = ".".join(str(x) for x in err.get("loc", [])) + messages.append(f"{loc}: {err.get('msg', 'invalid')}") + return JSONResponse( + status_code=400, + content=ErrorResponse( + error={ + "code": "invalid_request", + "message": "; ".join(messages), + "request_id": request_id, + } + ).model_dump(), + headers={"X-Request-Id": request_id, "X-Instance-Id": instance_id}, + ) + + @app.exception_handler(Exception) + async def generic_exception_handler(request: Request, exc: Exception): + """Обработчик непредвиденных исключений: скрываем детали, возвращаем 500.""" + request_id = getattr(request.state, "request_id", str(uuid.uuid4())) + return JSONResponse( + status_code=500, + content=ErrorResponse( + error={ + "code": "internal_error", + "message": "внутренняя ошибка сервера", + "request_id": request_id, + } + ).model_dump(), + headers={"X-Request-Id": request_id, "X-Instance-Id": instance_id}, + ) + + # Подключаем роуты + app.include_router(health.router) + app.include_router(users.router) + app.include_router(chats.router) + app.include_router(messages.router) + + return app + + +# Экземпляр приложения для uvicorn +app = create_app() diff --git a/src/cache.py b/src/cache.py new file mode 100644 index 00000000..edeb5357 --- /dev/null +++ b/src/cache.py @@ -0,0 +1,60 @@ +"""Необязательный кэш неизменяемого публичного профиля; ошибки обходятся через БД.""" +import logging +import os +from concurrent.futures import ThreadPoolExecutor, TimeoutError as FutureTimeout +import threading +from redis import Redis, RedisError +from pydantic import ValidationError +from src.config import setting +from src.models import User + + +class ProfileCache: + def __init__(self): + url = setting('CACHE_URL') + self.client = Redis.from_url(url, decode_responses=True, socket_connect_timeout=0.2, + socket_timeout=0.2, max_connections=16) if url else None + self.ttl = int(os.getenv('PROFILE_CACHE_TTL_SECONDS','60')) + self.hits = self.misses = self.errors = 0 + # DNS может ждать дольше socket timeout; один фоновый вызов ограничивает и время, и очередь. + self._executor = ThreadPoolExecutor(max_workers=1, thread_name_prefix='profile-cache') + self._pending = None + self._guard = threading.Lock() + + def _bounded(self, action, *args, **kwargs): + with self._guard: + if self._pending is not None and not self._pending.done(): + raise RedisError('кэш занят') + self._pending = self._executor.submit(action, *args, **kwargs) + future = self._pending + try: + return future.result(timeout=0.25) + except FutureTimeout: + raise RedisError('истекло время ожидания кэша') from None + + def get(self, user_id): + if not self.client: + return None + try: + value = self._bounded(self.client.get, 'profile:v1:'+user_id) + if value: + user=User.model_validate_json(value) + if user.id != user_id: + raise ValueError('неверный ключ кэша') + self.hits += 1 + return user + self.misses += 1 + except (RedisError, ValidationError, ValueError): + self.errors += 1 + logging.getLogger(__name__).warning('Кэш профиля недоступен; чтение из PostgreSQL') + return None + + def put(self, user): + if self.client: + try: + self._bounded(self.client.set, 'profile:v1:'+user.id,user.model_dump_json(),ex=self.ttl) + except RedisError: + self.errors += 1 + + +profile_cache = ProfileCache() diff --git a/src/config.py b/src/config.py new file mode 100644 index 00000000..30d65e7a --- /dev/null +++ b/src/config.py @@ -0,0 +1,10 @@ +"""Настройки окружения и чтение секретов из файлов.""" +import os +from pathlib import Path + + +def setting(name, default=None): + path = os.getenv(name + '_FILE') + if path: + return Path(path).read_text(encoding='utf-8').strip() + return os.getenv(name, default) diff --git a/src/main.py b/src/main.py new file mode 100644 index 00000000..38862ac0 --- /dev/null +++ b/src/main.py @@ -0,0 +1,9 @@ +import os + +import uvicorn + +if __name__ == "__main__": + """Точка входа: запуск Uvicorn с параметрами из переменных окружения.""" + host = os.getenv("APP_HOST", "0.0.0.0") + port = int(os.getenv("APP_PORT", "8080")) + uvicorn.run("src.app:app", host=host, port=port, log_level="info") diff --git a/src/migrate.py b/src/migrate.py new file mode 100644 index 00000000..69dacbfe --- /dev/null +++ b/src/migrate.py @@ -0,0 +1,19 @@ +"""Версионируемые миграции: одна транзакция, блокировка от параллельного запуска.""" +from pathlib import Path +import psycopg +from src.config import setting + + +def main(): + with psycopg.connect(setting('DATABASE_URL'), connect_timeout=5) as conn: + conn.execute('SELECT pg_advisory_xact_lock(2301002)') + conn.execute('CREATE TABLE IF NOT EXISTS schema_migrations (version text PRIMARY KEY)') + for path in sorted(Path('/app/migrations' if Path('/app/migrations').exists() else 'migrations').glob('*.sql')): + if not conn.execute('SELECT 1 FROM schema_migrations WHERE version=%s', (path.name,)).fetchone(): + conn.execute(path.read_text(encoding='utf-8')) + conn.execute('INSERT INTO schema_migrations VALUES (%s)', (path.name,)) + print('Применена миграция:', path.name) + + +if __name__ == '__main__': + main() diff --git a/src/models.py b/src/models.py new file mode 100644 index 00000000..e0ec1ac2 --- /dev/null +++ b/src/models.py @@ -0,0 +1,119 @@ +from datetime import datetime, timezone +from typing import Optional +import uuid + +from pydantic import BaseModel, ConfigDict, Field, field_validator + + +def utc_now() -> str: + """Возвращает текущее время в формате RFC 3339 UTC с суффиксом Z.""" + return datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ") + + +class ErrorDetail(BaseModel): + """Детали ошибки API.""" + code: str + message: str + request_id: str + + +class ErrorResponse(BaseModel): + """Стандартный ответ об ошибке.""" + error: ErrorDetail + + +class Health(BaseModel): + """Ответ проверки работоспособности.""" + status: str = "ok" + + +class User(BaseModel): + """Модель пользователя.""" + id: str + username: str + display_name: str + created_at: str + + +class CreateUser(BaseModel): + """Данные для создания пользователя.""" + model_config = ConfigDict(extra="forbid", strict=True) + + password: str = Field(..., min_length=12, max_length=128) + username: str = Field(..., pattern=r"^[a-z0-9_]{3,32}$") + display_name: str = Field(..., min_length=1, max_length=100) + + @field_validator("display_name") + @classmethod + def display_name_not_whitespace_only(cls, v: str) -> str: + """Запрещаем display_name, состоящий только из пробельных символов.""" + if v.strip() == "": + raise ValueError("display_name не может состоять только из пробелов") + return v + + +class Chat(BaseModel): + """Модель чата.""" + id: str + title: str + member_ids: list[str] + created_at: str + + +class CreateChat(BaseModel): + """Данные для создания чата.""" + model_config = ConfigDict(extra="forbid", strict=True) + + title: str = Field(..., min_length=1, max_length=100) + member_ids: list[str] = Field(..., min_length=1, max_length=100) + + @field_validator("member_ids") + @classmethod + def valid_members(cls, values): + """Проверить UUID и привести их к единому представлению.""" + return [str(uuid.UUID(value)) for value in values] + + @field_validator("title") + @classmethod + def title_not_whitespace_only(cls, v: str) -> str: + """Запрещаем title, состоящий только из пробельных символов.""" + if v.strip() == "": + raise ValueError("title не может состоять только из пробелов") + return v + + +class Message(BaseModel): + """Модель сообщения.""" + id: str + chat_id: str + sender_id: str + text: str + created_at: str + + +class CreateMessage(BaseModel): + """Данные для отправки сообщения.""" + model_config = ConfigDict(extra="forbid", strict=True) + + text: str = Field(..., min_length=1, max_length=4000) + attachment_ids: list[str] = Field(default_factory=list, max_length=0) + + @field_validator("text") + @classmethod + def text_not_whitespace_only(cls, v: str) -> str: + """Запрещаем текст, состоящий только из пробельных символов.""" + if v.strip() == "": + raise ValueError("текст не может состоять только из пробелов") + return v + + +class ChatPage(BaseModel): + """Страница списка чатов с курсорной пагинацией.""" + items: list[Chat] + next_cursor: Optional[str] = None + + +class MessagePage(BaseModel): + """Страница истории сообщений с курсорной пагинацией.""" + items: list[Message] + next_cursor: Optional[str] = None diff --git a/src/routes/__init__.py b/src/routes/__init__.py new file mode 100644 index 00000000..e69de29b diff --git a/src/routes/chats.py b/src/routes/chats.py new file mode 100644 index 00000000..1324eca1 --- /dev/null +++ b/src/routes/chats.py @@ -0,0 +1,79 @@ +from uuid import UUID + +from fastapi import APIRouter, Depends, HTTPException, Request + +from src.models import Chat, ChatPage, CreateChat +from src.routes.common import get_request_id, make_error, require_user +from src.storage import LimitExceeded, ValidationError, storage + +router = APIRouter() + + +@router.post("/api/v1/chats", response_model=Chat, status_code=201) +def create_chat( + request: Request, + body: CreateChat, + x_user_id: str = Depends(require_user), +): + """Создать чат. Создатель обязательно должен входить в member_ids.""" + request_id = get_request_id(request) + + try: + chat = storage.create_chat(body.title, body.member_ids, x_user_id) + return chat + except ValidationError as e: + raise HTTPException( + status_code=400, + detail=make_error("invalid_request", str(e), request_id).model_dump(), + ) + except LimitExceeded as e: + raise HTTPException( + status_code=429, + detail=make_error("rate_limited", str(e), request_id).model_dump(), + ) + + +@router.get("/api/v1/chats", response_model=ChatPage) +def list_chats( + request: Request, + x_user_id: str = Depends(require_user), + limit: int = 50, + cursor: str | None = None, +): + """Список чатов текущего пользователя с курсорной пагинацией.""" + request_id = get_request_id(request) + + if limit < 1 or limit > 100: + raise HTTPException( + status_code=400, + detail=make_error("invalid_request", "limit должен быть от 1 до 100", request_id).model_dump(), + ) + + try: + items, next_cursor = storage.list_chats_for_user(x_user_id, cursor, limit) + return ChatPage(items=items, next_cursor=next_cursor) + except ValidationError as e: + raise HTTPException( + status_code=400, + detail=make_error("invalid_request", str(e), request_id).model_dump(), + ) + + +@router.get("/api/v1/chats/{chat_id}", response_model=Chat) +def get_chat( + request: Request, + chat_id: UUID, + x_user_id: str = Depends(require_user), +): + """Получить чат по id. Доступен только участникам чата (чужой — 404).""" + request_id = get_request_id(request) + + chat_id_str = str(chat_id) + chat = storage.get_chat(chat_id_str) + if not chat or x_user_id not in chat.member_ids: + raise HTTPException( + status_code=404, + detail=make_error("not_found", "чат не найден", request_id).model_dump(), + ) + + return chat diff --git a/src/routes/common.py b/src/routes/common.py new file mode 100644 index 00000000..628e51e6 --- /dev/null +++ b/src/routes/common.py @@ -0,0 +1,29 @@ +"""Общие ошибки и проверка Bearer-сессии; X-User-Id не используется.""" +from fastapi import HTTPException, Request +from src.models import ErrorResponse +from src.storage import storage + + +def make_error(code, message, request_id): + return ErrorResponse(error={'code': code, 'message': message, 'request_id': request_id}) + + +def get_request_id(request): + return request.state.request_id + + +def unauthorized(request, basic=False): + challenge = 'Basic realm="messenger", charset="UTF-8"' if basic else 'Bearer realm="messenger"' + raise HTTPException(401, detail=make_error('unauthorized', 'неверные учётные данные', get_request_id(request)).model_dump(), headers={'WWW-Authenticate': challenge}) + + +def require_user(request: Request): + authorization = request.headers.get('Authorization', '') + parts = authorization.split() + if len(parts) != 2 or parts[0].lower() != 'bearer': + unauthorized(request) + user_id = storage.session_user(parts[1]) + if not user_id: + unauthorized(request) + request.state.token = parts[1] + return user_id diff --git a/src/routes/health.py b/src/routes/health.py new file mode 100644 index 00000000..2f2caafb --- /dev/null +++ b/src/routes/health.py @@ -0,0 +1,21 @@ +"""Жизнь процесса и готовность критичного хранилища проверяются отдельно.""" +from fastapi import APIRouter +from src.models import Health +from src.storage import storage +router = APIRouter() + + +@router.get('/health/live') +def liveness(): + return Health() + + +@router.get('/health/ready') +def readiness(): + storage.ready() + return Health() + + +@router.get('/stats') +def stats(): + return storage.get_stats() diff --git a/src/routes/messages.py b/src/routes/messages.py new file mode 100644 index 00000000..1f8ea128 --- /dev/null +++ b/src/routes/messages.py @@ -0,0 +1,83 @@ +from uuid import UUID +import re +import os + +from fastapi import APIRouter, Depends, HTTPException, Request + +from src.models import CreateMessage, Message, MessagePage +from src.routes.common import get_request_id, make_error, require_user +from src.storage import ConflictError, LimitExceeded, ValidationError, storage + +router = APIRouter() + + +@router.post("/api/v1/chats/{chat_id}/messages", response_model=Message, status_code=201) +def create_message( + request: Request, + chat_id: UUID, + body: CreateMessage, + x_user_id: str = Depends(require_user), +): + """Отправить сообщение от владельца Bearer-сессии с общей защитой повторов.""" + request_id = get_request_id(request) + + chat_id_str = str(chat_id) + if os.getenv('OPTIMIZED_WRITES','1') == '1': + allowed = storage.is_chat_member(chat_id_str, x_user_id) + else: + chat = storage.get_chat(chat_id_str) + allowed = bool(chat and x_user_id in chat.member_ids) + if not allowed: + raise HTTPException( + status_code=404, + detail=make_error("not_found", "чат не найден", request_id).model_dump(), + ) + + try: + key = request.headers.get('Idempotency-Key', '') + if not re.fullmatch(r'[A-Za-z0-9._:-]{1,128}', key): + raise HTTPException(400, detail=make_error('invalid_request', 'неверный Idempotency-Key', request_id).model_dump()) + msg = storage.create_message(chat_id_str, x_user_id, body.text, key) + return msg + except ConflictError as e: + raise HTTPException(409, detail=make_error('conflict', str(e), request_id).model_dump()) + except LimitExceeded as e: + raise HTTPException( + status_code=429, + detail=make_error("rate_limited", str(e), request_id).model_dump(), + ) + + +@router.get("/api/v1/chats/{chat_id}/messages", response_model=MessagePage) +def list_messages( + request: Request, + chat_id: UUID, + x_user_id: str = Depends(require_user), + limit: int = 50, + cursor: str | None = None, +): + """История сообщений чата с курсорной пагинацией. Доступно только участникам.""" + request_id = get_request_id(request) + + chat_id_str = str(chat_id) + chat = storage.get_chat(chat_id_str) + if not chat or x_user_id not in chat.member_ids: + raise HTTPException( + status_code=404, + detail=make_error("not_found", "чат не найден", request_id).model_dump(), + ) + + if limit < 1 or limit > 100: + raise HTTPException( + status_code=400, + detail=make_error("invalid_request", "limit должен быть от 1 до 100", request_id).model_dump(), + ) + + try: + items, next_cursor = storage.list_messages(chat_id_str, cursor, limit) + return MessagePage(items=items, next_cursor=next_cursor) + except ValidationError as e: + raise HTTPException( + status_code=400, + detail=make_error("invalid_request", str(e), request_id).model_dump(), + ) diff --git a/src/routes/users.py b/src/routes/users.py new file mode 100644 index 00000000..4709e263 --- /dev/null +++ b/src/routes/users.py @@ -0,0 +1,49 @@ +"""Регистрация, вход, текущий пользователь и отзыв сессии.""" +import base64 +import binascii +from fastapi import APIRouter, Request, Response, HTTPException +from src.models import CreateUser, User +from src.routes.common import get_request_id, make_error, require_user, unauthorized +from src.storage import ConflictError, storage + +router = APIRouter() + + +@router.post('/api/v1/users', response_model=User, status_code=201) +def register_user(request: Request, body: CreateUser): + try: + return storage.create_user(body.username,body.display_name,body.password) + except ConflictError as exc: + raise HTTPException(409,detail=make_error('conflict',str(exc),get_request_id(request)).model_dump()) + + +@router.post('/api/v1/auth/sessions', status_code=201) +async def login(request: Request): + if await request.body(): + raise HTTPException(400, detail=make_error('invalid_request','тело запроса не допускается',get_request_id(request)).model_dump()) + parts = request.headers.get('Authorization','').split() + try: + if len(parts) != 2 or parts[0].lower() != 'basic': + unauthorized(request, basic=True) + username,password = base64.b64decode(parts[1],validate=True).decode('utf-8').split(':',1) + username.encode('ascii') + except (ValueError, UnicodeError, binascii.Error): + unauthorized(request,basic=True) + # Вычисление KDF и синхронные запросы выполняются вне цикла событий. + from starlette.concurrency import run_in_threadpool + result = await run_in_threadpool(storage.login,username,password) + if not result: + unauthorized(request,basic=True) + return result + + +@router.get('/api/v1/users/me',response_model=User) +def current_user(request: Request): + return storage.get_user(require_user(request)) + + +@router.delete('/api/v1/auth/sessions/current',status_code=204) +def logout(request: Request): + require_user(request) + storage.logout(request.state.token) + return Response(status_code=204) diff --git a/src/storage.py b/src/storage.py new file mode 100644 index 00000000..358184ec --- /dev/null +++ b/src/storage.py @@ -0,0 +1,260 @@ +"""PostgreSQL — источник истины; каждый контекст подключения завершает транзакцию.""" +import base64 +import binascii +from datetime import datetime, timezone +import hashlib +import json +import os +import secrets +import threading +import uuid + +from argon2 import PasswordHasher +from argon2.exceptions import VerifyMismatchError, VerificationError, InvalidHashError +from psycopg.errors import UniqueViolation, ForeignKeyViolation +from psycopg.rows import dict_row +from psycopg_pool import ConnectionPool +from src.config import setting +from src.cache import profile_cache +from src.models import User, Chat, Message + +_CURSOR_FIELDS = {"scope", "resource_id", "created_at", "id"} +PASSWORDS = PasswordHasher(time_cost=2, memory_cost=19456, parallelism=1) +DUMMY_HASH = PASSWORDS.hash('synthetic-dummy-password') + + +class ValidationError(Exception): + """Неверный запрос.""" + + +class ConflictError(Exception): + """Имя уже занято.""" + + +class LimitExceeded(Exception): + """Перегрузка сервера.""" + + +class NotFoundError(Exception): + """Объект отсутствует или недоступен.""" + + +def timestamp(value): + return value.astimezone(timezone.utc).isoformat(timespec='microseconds').replace('+00:00', 'Z') + + +def public_row(row): + return {k: timestamp(v) if isinstance(v, datetime) else str(v) if isinstance(v, uuid.UUID) else v + for k, v in row.items() if k != 'password_hash'} + + +class PostgresStorage: + def __init__(self): + self.pool = ConnectionPool(setting('DATABASE_URL', ''), min_size=1, max_size=int(os.getenv("POOL_SIZE", "10")), + timeout=3, max_waiting=32, open=False, check=ConnectionPool.check_connection, + kwargs={'row_factory': dict_row, 'connect_timeout': 3, + 'options': '-c statement_timeout=3000 -c lock_timeout=2000'}) + self._lock = threading.Lock() + self._requests = 0 + + @staticmethod + def _encode_cursor(scope: str, resource_id: str, created_at: str, item_id: str) -> str: + """Собрать непрозрачный курсор, привязанный к конкретному ресурсу.""" + payload = { + "scope": scope, + "resource_id": resource_id, + "created_at": created_at, + "id": item_id, + } + raw = json.dumps(payload, separators=(",", ":"), sort_keys=True).encode("utf-8") + return base64.urlsafe_b64encode(raw).decode("ascii") + + @staticmethod + def _decode_cursor(cursor: str, expected_scope: str, expected_resource_id: str) -> tuple[str, str]: + """Разобрать и проверить курсор. + + Клиент видит курсор как непрозрачную строку, поэтому любые пустые, + повреждённые или относящиеся к другому ресурсу значения отклоняем. + """ + if cursor == "": + raise ValidationError("некорректный cursor") + + allowed_chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_=" + if any(char not in allowed_chars for char in cursor) or "=" in cursor.rstrip("="): + raise ValidationError("некорректный cursor") + + try: + raw = base64.b64decode(cursor.encode("ascii"), altchars=b"-_", validate=True) + payload = json.loads(raw.decode("utf-8")) + except (UnicodeEncodeError, UnicodeDecodeError, binascii.Error, json.JSONDecodeError): + raise ValidationError("некорректный cursor") + + if not isinstance(payload, dict) or set(payload) != _CURSOR_FIELDS: + raise ValidationError("некорректный cursor") + + if not all(isinstance(payload[field], str) for field in _CURSOR_FIELDS): + raise ValidationError("некорректный cursor") + + if payload["scope"] != expected_scope or payload["resource_id"] != expected_resource_id: + raise ValidationError("некорректный cursor") + + try: + uuid.UUID(payload["resource_id"]) + uuid.UUID(payload["id"]) + datetime.fromisoformat(payload["created_at"].replace("Z", "+00:00")) + except ValueError: + raise ValidationError("некорректный cursor") + + return payload["created_at"], payload["id"] + + + def create_user(self, username, display_name, password): + password_hash = PASSWORDS.hash(password) + try: + with self.pool.connection() as conn: + row = conn.execute('INSERT INTO users (id,username,display_name,password_hash) VALUES (%s,%s,%s,%s) RETURNING id,username,display_name,created_at', + (uuid.uuid4(), username, display_name, password_hash)).fetchone() + return User(**public_row(row)) + except UniqueViolation: + raise ConflictError('имя пользователя уже занято') from None + + def get_user(self, user_id): + cached = profile_cache.get(user_id) + if cached: + return cached + with self.pool.connection() as conn: + row = conn.execute('SELECT id,username,display_name,created_at FROM users WHERE id=%s', (user_id,)).fetchone() + user = User(**public_row(row)) if row else None + if user: + profile_cache.put(user) + return user + + def login(self, username, password): + with self.pool.connection() as conn: + row = conn.execute('SELECT * FROM users WHERE username=%s', (username,)).fetchone() + try: + PASSWORDS.verify(row['password_hash'] if row else DUMMY_HASH, password) + except (VerifyMismatchError, VerificationError, InvalidHashError): + return None + if not row: + return None + token = secrets.token_urlsafe(32) + with self.pool.connection() as conn: + session = conn.execute("INSERT INTO sessions VALUES (%s,%s,clock_timestamp() + %s * interval '1 second') RETURNING expires_at", + (self.token_hash(token), row['id'], int(os.getenv('SESSION_TTL_SECONDS', '3600')))).fetchone() + return {'token': token, 'token_type': 'Bearer', 'expires_at': timestamp(session['expires_at']), 'user': User(**public_row(row)).model_dump()} + + @staticmethod + def token_hash(token): + return hashlib.sha256(token.encode()).hexdigest() + + def session_user(self, token): + with self.pool.connection() as conn: + row = conn.execute('SELECT user_id FROM sessions WHERE token_hash=%s AND expires_at > clock_timestamp()', (self.token_hash(token),)).fetchone() + return str(row['user_id']) if row else None + + def logout(self, token): + with self.pool.connection() as conn: + conn.execute('DELETE FROM sessions WHERE token_hash=%s', (self.token_hash(token),)) + + def create_chat(self, title, member_ids, creator_id): + if len(set(member_ids)) != len(member_ids) or creator_id not in member_ids: + raise ValidationError('неверный список участников') + chat_id = uuid.uuid4() + try: + with self.pool.connection() as conn: + row = conn.execute('INSERT INTO chats (id,title) VALUES (%s,%s) RETURNING *', (chat_id,title)).fetchone() + for member in member_ids: + conn.execute('INSERT INTO chat_members VALUES (%s,%s)', (chat_id,member)) + return Chat(**public_row(row), member_ids=sorted(member_ids)) + except ForeignKeyViolation: + raise ValidationError('участник не существует') from None + + def get_chat(self, chat_id): + with self.pool.connection() as conn: + row = conn.execute('SELECT * FROM chats WHERE id=%s', (chat_id,)).fetchone() + if not row: + return None + members = conn.execute('SELECT user_id FROM chat_members WHERE chat_id=%s ORDER BY user_id', (chat_id,)).fetchall() + return Chat(**public_row(row), member_ids=[str(x['user_id']) for x in members]) + + def is_chat_member(self, chat_id, user_id): + """Проверить доступ без загрузки всего чата и списка участников.""" + with self.pool.connection() as conn: + return conn.execute('SELECT 1 FROM chat_members WHERE chat_id=%s AND user_id=%s', (chat_id,user_id)).fetchone() is not None + + def list_chats_for_user(self, user_id, cursor, limit): + with self.pool.connection() as conn: + params = [user_id] + boundary = '' + if cursor is not None: + when, item = self._decode_cursor(cursor, 'chats', user_id) + marker = conn.execute('SELECT c.created_at FROM chats c JOIN chat_members m ON m.chat_id=c.id WHERE c.id=%s AND m.user_id=%s', (item,user_id)).fetchone() + if not marker or timestamp(marker['created_at']) != when: + raise ValidationError('некорректный cursor') + boundary = ' AND (c.created_at,c.id) > (%s,%s)' + params += [when,item] + rows = conn.execute('SELECT c.* FROM chats c JOIN chat_members m ON m.chat_id=c.id WHERE m.user_id=%s' + boundary + ' ORDER BY c.created_at,c.id LIMIT %s', params+[limit+1]).fetchall() + page = [self.get_chat(str(row['id'])) for row in rows[:limit]] + next_cursor = self._encode_cursor('chats',user_id,page[-1].created_at,page[-1].id) if len(rows)>limit else None + return page,next_cursor + + def create_message(self, chat_id, sender_id, text, key): + # Блокировка сериализует один ключ на всех репликах; результат и сообщение атомарны. + with self.pool.connection() as conn: + scope = json.dumps([sender_id, chat_id, key]) + conn.execute('SELECT pg_advisory_xact_lock(hashtextextended(%s, 0))', (scope,)) + old = conn.execute('SELECT * FROM message_requests WHERE user_id=%s AND chat_id=%s AND key=%s AND expires_at>clock_timestamp()', (sender_id,chat_id,key)).fetchone() + if old: + if old['body'] != text: + raise ConflictError('ключ уже использован с другим сообщением') + row = conn.execute('SELECT * FROM messages WHERE id=%s', (old['message_id'],)).fetchone() + return Message(**public_row(row)) + optimized = os.getenv('OPTIMIZED_WRITES','1') == '1' + if not optimized: + conn.execute('DELETE FROM message_requests WHERE user_id=%s AND chat_id=%s AND key=%s', (sender_id,chat_id,key)) + row = conn.execute('INSERT INTO messages (id,chat_id,sender_id,text) VALUES (%s,%s,%s,%s) RETURNING *', (uuid.uuid4(),chat_id,sender_id,text)).fetchone() + # Под той же блокировкой UPSERT заменяет просроченный результат без отдельного DELETE. + suffix = ' ON CONFLICT (user_id,chat_id,key) DO UPDATE SET body=EXCLUDED.body,message_id=EXCLUDED.message_id,expires_at=EXCLUDED.expires_at' if optimized else '' + conn.execute("INSERT INTO message_requests VALUES (%s,%s,%s,%s,%s,clock_timestamp()+interval '24 hours')"+suffix, (sender_id,chat_id,key,text,row['id'])) + return Message(**public_row(row)) + + def list_messages(self, chat_id, cursor, limit): + with self.pool.connection() as conn: + params = [chat_id] + boundary = '' + if cursor is not None: + when,item = self._decode_cursor(cursor,'messages',chat_id) + marker = conn.execute('SELECT created_at FROM messages WHERE id=%s AND chat_id=%s', (item,chat_id)).fetchone() + if not marker or timestamp(marker['created_at']) != when: + raise ValidationError('некорректный cursor') + boundary = ' AND (created_at,id) > (%s,%s)' + params += [when,item] + rows = conn.execute('SELECT * FROM messages WHERE chat_id=%s' + boundary + ' ORDER BY created_at,id LIMIT %s', params+[limit+1]).fetchall() + page = [Message(**public_row(row)) for row in rows[:limit]] + next_cursor = self._encode_cursor('messages',chat_id,page[-1].created_at,page[-1].id) if len(rows)>limit else None + return page,next_cursor + + def ready(self): + with self.pool.connection() as conn: + conn.execute('SELECT 1 FROM schema_migrations LIMIT 1') + + def acquire_request_slot(self): + with self._lock: + if self._requests >= 100: + return False + self._requests += 1 + return True + + def release_request_slot(self): + with self._lock: + self._requests -= 1 + + def get_stats(self): + with self.pool.connection() as conn: + result = {table: conn.execute('SELECT count(*) AS n FROM '+table).fetchone()['n'] for table in ('users','chats','messages')} + result['profile_cache'] = {'hits': profile_cache.hits, 'misses': profile_cache.misses, 'errors': profile_cache.errors, 'ttl_seconds': profile_cache.ttl} + return result + + +storage = PostgresStorage() -- 2.54.0 From 4f85fb96a69601f31fc69d1e4c75f7f467d590a1 Mon Sep 17 00:00:00 2001 From: Sergey Lyakhonov Date: Fri, 30 Oct 2026 17:33:07 +0300 Subject: [PATCH 2/5] =?UTF-8?q?=D0=A0=D0=B5=D0=B0=D0=BB=D0=B8=D0=B7=D0=BE?= =?UTF-8?q?=D0=B2=D0=B0=D1=82=D1=8C=20=D1=83=D1=80=D0=BE=D0=B2=D0=B5=D0=BD?= =?UTF-8?q?=D1=8C=203:=20=D0=BF=D1=80=D0=B8=D0=B2=D0=B0=D1=82=D0=BD=D0=BE?= =?UTF-8?q?=D0=B5=20S3,=20=D0=B2=D0=BB=D0=BE=D0=B6=D0=B5=D0=BD=D0=B8=D1=8F?= =?UTF-8?q?=20=D0=B8=20=D1=81=D0=BE=D1=85=D1=80=D0=B0=D0=BD=D0=BD=D0=BE?= =?UTF-8?q?=D1=81=D1=82=D1=8C=20=D0=BF=D1=80=D0=B8=20=D0=BE=D1=82=D0=BA?= =?UTF-8?q?=D0=B0=D0=B7=D0=B0=D1=85?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .gitattributes | 5 + compose.yaml | 44 +++++++- evidence/check.txt | 1 + evidence/failover-1.txt | 3 + evidence/failover-2.txt | 3 + evidence/operations.json | 168 +++++++++++++++++++++++++++++++ evidence/operations.txt | 1 + evidence/persistence.txt | 2 + evidence/smoke.txt | 1 + evidence/transfer.md | 7 ++ infra/bucket.sh | 20 ++++ infra/haproxy.cfg | 4 +- infra/s3-policy.json | 1 + migrations/003_attachments.sql | 17 ++++ requirements.lock.txt | 9 ++ requirements.txt | 3 + scripts/actions.py | 22 ++++ scripts/bootstrap.py | 5 + scripts/restart.cmd | 2 + scripts/restart.sh | 3 + scripts/stop-one.cmd | 2 + scripts/stop-one.sh | 3 + src/app.py | 8 +- src/models.py | 25 +++-- src/objects.py | 17 ++++ src/routes/attachments.py | 134 ++++++++++++++++++++++++ src/routes/health.py | 2 + src/routes/messages.py | 6 +- src/storage.py | 30 ++++-- student-tests/test_operations.py | 71 +++++++++++++ 30 files changed, 592 insertions(+), 27 deletions(-) create mode 100644 .gitattributes create mode 100644 evidence/check.txt create mode 100644 evidence/failover-1.txt create mode 100644 evidence/failover-2.txt create mode 100644 evidence/operations.json create mode 100644 evidence/operations.txt create mode 100644 evidence/persistence.txt create mode 100644 evidence/smoke.txt create mode 100644 evidence/transfer.md create mode 100644 infra/bucket.sh create mode 100644 infra/s3-policy.json create mode 100644 migrations/003_attachments.sql create mode 100644 scripts/actions.py create mode 100644 scripts/restart.cmd create mode 100644 scripts/restart.sh create mode 100644 scripts/stop-one.cmd create mode 100644 scripts/stop-one.sh create mode 100644 src/objects.py create mode 100644 src/routes/attachments.py create mode 100644 student-tests/test_operations.py diff --git a/.gitattributes b/.gitattributes new file mode 100644 index 00000000..a1c22612 --- /dev/null +++ b/.gitattributes @@ -0,0 +1,5 @@ +* text=auto +*.sh text eol=lf +*.py text eol=lf +*.sql text eol=lf +*.yaml text eol=lf diff --git a/compose.yaml b/compose.yaml index 80859499..d1da6816 100644 --- a/compose.yaml +++ b/compose.yaml @@ -1,19 +1,23 @@ -name: lyakhonov-lab3 +name: lyakhonov-lab4 x-api: &api - image: lyakhonov-messenger:lab3 + image: lyakhonov-messenger:lab4 build: . environment: DATABASE_URL_FILE: /run/secrets/database_url CACHE_URL: redis://redis:6379/0 SESSION_TTL_SECONDS: ${SESSION_TTL_SECONDS:-3600} POOL_SIZE: ${POOL_SIZE:-10} + S3_ENDPOINT: http://s3:9000 + S3_BUCKET: attachments + S3_ACCESS_KEY_FILE: /run/secrets/s3_access_key + S3_SECRET_KEY_FILE: /run/secrets/s3_secret_key OPTIMIZED_WRITES: ${OPTIMIZED_WRITES:-1} - secrets: [database_url] + secrets: [database_url, s3_access_key, s3_secret_key] depends_on: migrate: condition: service_completed_successfully cpus: ${API_CPUS:-0.5} - mem_limit: ${API_MEMORY:-256m} + mem_limit: ${API_MEMORY:-512m} stop_grace_period: 12s services: db: @@ -44,13 +48,34 @@ services: condition: service_healthy healthcheck: disable: true + s3: + image: minio/minio@sha256:14cea493d9a34af32f524e538b8346cf79f3321eff8e708c1e2960462bd8936e + command: [server, /data, --console-address, '127.0.0.1:9001'] + environment: + MINIO_ROOT_USER_FILE: /run/secrets/s3_root_user + MINIO_ROOT_PASSWORD_FILE: /run/secrets/s3_root_password + secrets: [s3_root_user, s3_root_password] + volumes: [s3_data:/data] + cpus: 1 + mem_limit: 768m + bucket-init: + image: minio/minio@sha256:14cea493d9a34af32f524e538b8346cf79f3321eff8e708c1e2960462bd8936e + entrypoint: [/bin/sh, /bootstrap/bucket.sh] + secrets: [s3_root_user, s3_root_password, s3_access_key, s3_secret_key] + volumes: [./infra/bucket.sh:/bootstrap/bucket.sh:ro, ./infra/s3-policy.json:/bootstrap/policy.json:ro] + depends_on: [s3] api: <<: *api + depends_on: + migrate: + condition: service_completed_successfully + bucket-init: + condition: service_completed_successfully deploy: replicas: ${API_REPLICAS:-2} lb: image: haproxy:3.0.6-alpine - ports: ["127.0.0.1:8080:8080"] + ports: ["127.0.0.1:${LAB4_PORT:-8084}:8080"] volumes: [./infra/haproxy.cfg:/usr/local/etc/haproxy/haproxy.cfg:ro] depends_on: [api] cpus: 0.5 @@ -62,9 +87,18 @@ services: timeout: 2s retries: 3 secrets: + s3_root_user: + file: ./secrets/s3_root_user + s3_root_password: + file: ./secrets/s3_root_password + s3_access_key: + file: ./secrets/s3_access_key + s3_secret_key: + file: ./secrets/s3_secret_key db_password: file: ./secrets/db_password database_url: file: ./secrets/database_url volumes: postgres_data: + s3_data: diff --git a/evidence/check.txt b/evidence/check.txt new file mode 100644 index 00000000..b62af9c5 --- /dev/null +++ b/evidence/check.txt @@ -0,0 +1 @@ +PASS: offline skeleton structure, local refs and Python syntax; application NOT tested. diff --git a/evidence/failover-1.txt b/evidence/failover-1.txt new file mode 100644 index 00000000..8c478f30 --- /dev/null +++ b/evidence/failover-1.txt @@ -0,0 +1,3 @@ +Executing explicit failover hook; hook output suppressed to avoid leaking secrets. +{"observed_instances_before": 2, "successful_writes": 109, "failed_attempts": 2, "first_recovery_seconds": 2.439} +PASS: failover preserved confirmed data and existing session. Hook scope needs operator evidence. diff --git a/evidence/failover-2.txt b/evidence/failover-2.txt new file mode 100644 index 00000000..180e5083 --- /dev/null +++ b/evidence/failover-2.txt @@ -0,0 +1,3 @@ +Executing explicit failover hook; hook output suppressed to avoid leaking secrets. +{"observed_instances_before": 2, "successful_writes": 109, "failed_attempts": 3, "first_recovery_seconds": 2.442} +PASS: failover preserved confirmed data and existing session. Hook scope needs operator evidence. diff --git a/evidence/operations.json b/evidence/operations.json new file mode 100644 index 00000000..aa22df4c --- /dev/null +++ b/evidence/operations.json @@ -0,0 +1,168 @@ +{ + "result": "PASS", + "each_uploading_replica_stopped": [ + { + "stopped": { + "id": "24498cc4891a", + "hostname": "24498cc4891a", + "name": "lyakhonov-lab4-api-1", + "running": true, + "started_at": "2026-10-30T14:31:07.744742532Z", + "project": "lyakhonov-lab4" + }, + "after": { + "id": "24498cc4891a", + "hostname": "24498cc4891a", + "name": "lyakhonov-lab4-api-1", + "running": false, + "started_at": "2026-10-30T14:31:07.744742532Z", + "project": "lyakhonov-lab4" + }, + "download_instance": "950e5ae78851-f8e15971", + "sha256": "99ea7533c441f79cd630d15ce4d58d1ec4e06f6f0efb3b77a5c088305cd1bd75", + "recovery_seconds": 1.135 + }, + { + "stopped": { + "id": "950e5ae78851", + "hostname": "950e5ae78851", + "name": "lyakhonov-lab4-api-2", + "running": true, + "started_at": "2026-10-30T14:31:12.431277515Z", + "project": "lyakhonov-lab4" + }, + "after": { + "id": "950e5ae78851", + "hostname": "950e5ae78851", + "name": "lyakhonov-lab4-api-2", + "running": false, + "started_at": "2026-10-30T14:31:12.431277515Z", + "project": "lyakhonov-lab4" + }, + "download_instance": "24498cc4891a-5564fcf3", + "sha256": "99ea7533c441f79cd630d15ce4d58d1ec4e06f6f0efb3b77a5c088305cd1bd75", + "recovery_seconds": 1.096 + } + ], + "s3_503_seconds": 4.046069000149146, + "restart_before": { + "api": [ + { + "id": "24498cc4891a", + "hostname": "24498cc4891a", + "name": "lyakhonov-lab4-api-1", + "running": true, + "started_at": "2026-10-30T14:31:55.001303564Z", + "project": "lyakhonov-lab4" + }, + { + "id": "950e5ae78851", + "hostname": "950e5ae78851", + "name": "lyakhonov-lab4-api-2", + "running": true, + "started_at": "2026-10-30T14:31:59.649868974Z", + "project": "lyakhonov-lab4" + } + ], + "db": [ + { + "id": "10138b5c0bee", + "hostname": "10138b5c0bee", + "name": "lyakhonov-lab4-db-1", + "running": true, + "started_at": "2026-10-30T14:30:00.149637002Z", + "project": "lyakhonov-lab4" + } + ], + "redis": [ + { + "id": "68997bbba33b", + "hostname": "68997bbba33b", + "name": "lyakhonov-lab4-redis-1", + "running": true, + "started_at": "2026-10-30T14:30:00.082955484Z", + "project": "lyakhonov-lab4" + } + ], + "s3": [ + { + "id": "83df7acfb73f", + "hostname": "83df7acfb73f", + "name": "lyakhonov-lab4-s3-1", + "running": true, + "started_at": "2026-10-30T14:32:07.860463524Z", + "project": "lyakhonov-lab4" + } + ], + "lb": [ + { + "id": "e9682a892ad3", + "hostname": "e9682a892ad3", + "name": "lyakhonov-lab4-lb-1", + "running": true, + "started_at": "2026-10-30T14:29:59.993685266Z", + "project": "lyakhonov-lab4" + } + ] + }, + "restart_after": { + "api": [ + { + "id": "24498cc4891a", + "hostname": "24498cc4891a", + "name": "lyakhonov-lab4-api-1", + "running": true, + "started_at": "2026-10-30T14:32:12.97023467Z", + "project": "lyakhonov-lab4" + }, + { + "id": "950e5ae78851", + "hostname": "950e5ae78851", + "name": "lyakhonov-lab4-api-2", + "running": true, + "started_at": "2026-10-30T14:32:13.834829902Z", + "project": "lyakhonov-lab4" + } + ], + "db": [ + { + "id": "10138b5c0bee", + "hostname": "10138b5c0bee", + "name": "lyakhonov-lab4-db-1", + "running": true, + "started_at": "2026-10-30T14:32:12.605184626Z", + "project": "lyakhonov-lab4" + } + ], + "redis": [ + { + "id": "68997bbba33b", + "hostname": "68997bbba33b", + "name": "lyakhonov-lab4-redis-1", + "running": true, + "started_at": "2026-10-30T14:32:12.532082166Z", + "project": "lyakhonov-lab4" + } + ], + "s3": [ + { + "id": "83df7acfb73f", + "hostname": "83df7acfb73f", + "name": "lyakhonov-lab4-s3-1", + "running": true, + "started_at": "2026-10-30T14:32:12.440778626Z", + "project": "lyakhonov-lab4" + } + ], + "lb": [ + { + "id": "e9682a892ad3", + "hostname": "e9682a892ad3", + "name": "lyakhonov-lab4-lb-1", + "running": true, + "started_at": "2026-10-30T14:32:13.55378444Z", + "project": "lyakhonov-lab4" + } + ] + } +} \ No newline at end of file diff --git a/evidence/operations.txt b/evidence/operations.txt new file mode 100644 index 00000000..75c1eb2c --- /dev/null +++ b/evidence/operations.txt @@ -0,0 +1 @@ +PASS: both uploading API replicas stopped; S3 failure/recovery; all services really restarted; original and session preserved diff --git a/evidence/persistence.txt b/evidence/persistence.txt new file mode 100644 index 00000000..749fd29b --- /dev/null +++ b/evidence/persistence.txt @@ -0,0 +1,2 @@ +Executing explicit persistence hook; hook output suppressed to avoid leaking secrets. +PASS: persistence preserved confirmed data and existing session. Hook scope needs operator evidence. diff --git a/evidence/smoke.txt b/evidence/smoke.txt new file mode 100644 index 00000000..c554fd6f --- /dev/null +++ b/evidence/smoke.txt @@ -0,0 +1 @@ +PASS: lab4 public API scenario; infrastructure and grading evidence remain separate. diff --git a/evidence/transfer.md b/evidence/transfer.md new file mode 100644 index 00000000..33627c7d --- /dev/null +++ b/evidence/transfer.md @@ -0,0 +1,7 @@ +# Перенос базы +Ляхонов Сергей, БВТ2301. Выбран трек 2 лабораторной 4. +Источник: собственная лабораторная 3, 374c43e, только чтение; оба рабочих дерева были чистыми. +Перенесены src, migrations, Dockerfile, зависимости и необходимые конфигурации/bootstrap/readiness. +Задание, README, COURSE, contracts и публичные tests лабораторной 4 сохранены. +Секреты, .env, Git, тома, старые измерения и виртуальное окружение не переносились. +Новый стенд: Compose project lyakhonov-lab4, порт 127.0.0.1:8084, отдельные тома/сеть/образ. diff --git a/infra/bucket.sh b/infra/bucket.sh new file mode 100644 index 00000000..295b0271 --- /dev/null +++ b/infra/bucket.sh @@ -0,0 +1,20 @@ +#!/bin/sh + +set -eu + +# Не включать set -x: аргументы содержат учебные credentials. + +until mc alias set local http://s3:9000 "$(cat /run/secrets/s3_root_user)" "$(cat /run/secrets/s3_root_password)" >/dev/null 2>&1; do sleep 1; done + +mc mb --ignore-existing local/attachments >/dev/null + +mc anonymous set none local/attachments >/dev/null + +mc admin user add local "$(cat /run/secrets/s3_access_key)" "$(cat /run/secrets/s3_secret_key)" >/dev/null + +mc admin policy create local attachments-app /bootstrap/policy.json >/dev/null + +mc admin policy attach local attachments-app --user "$(cat /run/secrets/s3_access_key)" >/dev/null + +echo 'Private bucket and restricted application user ready' + diff --git a/infra/haproxy.cfg b/infra/haproxy.cfg index 0981249f..042a6cb2 100644 --- a/infra/haproxy.cfg +++ b/infra/haproxy.cfg @@ -5,8 +5,8 @@ defaults mode http log global timeout connect 1s - timeout client 10s - timeout server 5s + timeout client 60s + timeout server 45s timeout check 1s retries 0 resolvers docker diff --git a/infra/s3-policy.json b/infra/s3-policy.json new file mode 100644 index 00000000..6b7d394e --- /dev/null +++ b/infra/s3-policy.json @@ -0,0 +1 @@ +{"Version":"2012-10-17","Statement":[{"Effect":"Allow","Action":["s3:ListBucket"],"Resource":["arn:aws:s3:::attachments"],"Condition":{"StringLike":{"s3:prefix":["originals/*"]}}},{"Effect":"Allow","Action":["s3:GetObject","s3:PutObject","s3:DeleteObject"],"Resource":["arn:aws:s3:::attachments/originals/*"]}]} \ No newline at end of file diff --git a/migrations/003_attachments.sql b/migrations/003_attachments.sql new file mode 100644 index 00000000..9bdc747c --- /dev/null +++ b/migrations/003_attachments.sql @@ -0,0 +1,17 @@ +ALTER TABLE messages DROP CONSTRAINT messages_text_check; +ALTER TABLE messages ADD CONSTRAINT messages_text_limit CHECK (length(text)<=4000); +CREATE TABLE attachments ( + id uuid PRIMARY KEY, chat_id uuid NOT NULL REFERENCES chats(id), + owner_id uuid NOT NULL REFERENCES users(id), object_key text NOT NULL UNIQUE, + filename text NOT NULL, content_type text NOT NULL, size_bytes integer NOT NULL, + sha256 char(64) NOT NULL, state text NOT NULL CHECK(state IN ('ready','missing')), + created_at timestamptz NOT NULL DEFAULT clock_timestamp(), + updated_at timestamptz NOT NULL DEFAULT clock_timestamp(), + FOREIGN KEY(chat_id,owner_id) REFERENCES chat_members(chat_id,user_id) +); +CREATE TABLE message_attachments ( + message_id uuid NOT NULL REFERENCES messages(id), attachment_id uuid NOT NULL REFERENCES attachments(id), + position integer NOT NULL, PRIMARY KEY(message_id,attachment_id), UNIQUE(message_id,position) +); +-- Старые сохранённые ключи теперь сравнивают полное нормализованное тело. +UPDATE message_requests SET body=json_build_object('text',body,'attachment_ids',json_build_array())::text; diff --git a/requirements.lock.txt b/requirements.lock.txt index ceec59ee..6fccf885 100644 --- a/requirements.lock.txt +++ b/requirements.lock.txt @@ -23,3 +23,12 @@ uvloop==0.23.0 watchfiles==1.3.0 websockets==17.2 redis==5.2.0 + +boto3==1.40.61 +Pillow==12.0.0 +botocore==1.40.76 +s3transfer==0.14.0 +jmespath==1.1.0 +python-dateutil==2.9.0.post0 +six==1.17.0 +urllib3==2.8.0 diff --git a/requirements.txt b/requirements.txt index 1b6204da..7010e5f2 100644 --- a/requirements.txt +++ b/requirements.txt @@ -5,3 +5,6 @@ psycopg[binary]==3.2.3 psycopg-pool==3.2.4 argon2-cffi==23.1.0 redis==5.2.0 + +boto3==1.40.61 +Pillow==12.0.0 diff --git a/scripts/actions.py b/scripts/actions.py new file mode 100644 index 00000000..4e2f15c4 --- /dev/null +++ b/scripts/actions.py @@ -0,0 +1,22 @@ +"""Restart/failover hooks scoped to lab4; never remove volumes.""" +import json +import os +from pathlib import Path +import subprocess +import sys +root=Path(__file__).resolve().parents[1] +base=['docker','compose','--project-directory',str(root),'-p','lyakhonov-lab4'] +def compose(*args): + return subprocess.check_output(base+list(args),text=True).strip() +mode=sys.argv[1] +if mode=='restart': + compose('restart','api','db','redis','s3','lb') +elif mode=='stop-one': + target=os.environ['TARGET_INSTANCE_ID'] + for cid in compose('ps','-q','api').splitlines(): + info=json.loads(subprocess.check_output(['docker','inspect',cid],text=True))[0] + if target.startswith(info['Config']['Hostname']+'-'): + subprocess.check_call(['docker','stop','--time','1',cid],stdout=subprocess.DEVNULL) + break + else: raise SystemExit('No matching lab4 API instance') +else: raise SystemExit('unknown action') diff --git a/scripts/bootstrap.py b/scripts/bootstrap.py index e1fd52c4..4824cfcd 100644 --- a/scripts/bootstrap.py +++ b/scripts/bootstrap.py @@ -13,3 +13,8 @@ if not url_file.exists(): password = password_file.read_text(encoding='utf-8').strip() url_file.write_text(f'postgresql://messenger:{password}@db:5432/messenger', encoding='utf-8') print('Локальные секреты готовы; значения не выводятся.') + +for name in ('s3_root_user', 's3_root_password', 's3_access_key', 's3_secret_key'): + target = folder / name + if not target.exists(): + target.write_text(secrets.token_hex(24), encoding='utf-8') diff --git a/scripts/restart.cmd b/scripts/restart.cmd new file mode 100644 index 00000000..7bc66929 --- /dev/null +++ b/scripts/restart.cmd @@ -0,0 +1,2 @@ +@echo off +python "%~dp0actions.py" restart diff --git a/scripts/restart.sh b/scripts/restart.sh new file mode 100644 index 00000000..c22c1f7f --- /dev/null +++ b/scripts/restart.sh @@ -0,0 +1,3 @@ +#!/bin/sh +set -eu +exec python3 "$(dirname "$0")/actions.py" restart diff --git a/scripts/stop-one.cmd b/scripts/stop-one.cmd new file mode 100644 index 00000000..c757e172 --- /dev/null +++ b/scripts/stop-one.cmd @@ -0,0 +1,2 @@ +@echo off +python "%~dp0actions.py" stop-one diff --git a/scripts/stop-one.sh b/scripts/stop-one.sh new file mode 100644 index 00000000..04aa2950 --- /dev/null +++ b/scripts/stop-one.sh @@ -0,0 +1,3 @@ +#!/bin/sh +set -eu +exec python3 "$(dirname "$0")/actions.py" stop-one diff --git a/src/app.py b/src/app.py index 1b02146e..131bc654 100644 --- a/src/app.py +++ b/src/app.py @@ -13,7 +13,8 @@ from pydantic import ValidationError as PydanticValidationError from starlette.exceptions import HTTPException as StarletteHTTPException from src.models import ErrorResponse -from src.routes import chats, health, messages, users +from src.routes import chats, health, messages, users, attachments +from botocore.exceptions import BotoCoreError, ClientError from src.storage import storage @@ -28,8 +29,10 @@ def create_app() -> FastAPI: await run_in_threadpool(storage.pool.close) instance_id = os.getenv("INSTANCE_ID", socket.gethostname()) + "-" + uuid.uuid4().hex[:8] - app = FastAPI(title="MTUSI Messenger Lab3", version="1.3.0", lifespan=lifespan) + app = FastAPI(title="MTUSI Messenger Lab4", version="1.4.0", lifespan=lifespan) + @app.exception_handler(BotoCoreError) + @app.exception_handler(ClientError) @app.exception_handler(psycopg.OperationalError) @app.exception_handler(psycopg.errors.QueryCanceled) @app.exception_handler(psycopg.errors.LockNotAvailable) @@ -154,6 +157,7 @@ def create_app() -> FastAPI: app.include_router(users.router) app.include_router(chats.router) app.include_router(messages.router) + app.include_router(attachments.router) return app diff --git a/src/models.py b/src/models.py index e0ec1ac2..dc507cce 100644 --- a/src/models.py +++ b/src/models.py @@ -2,7 +2,7 @@ from datetime import datetime, timezone from typing import Optional import uuid -from pydantic import BaseModel, ConfigDict, Field, field_validator +from pydantic import BaseModel, ConfigDict, Field, field_validator, model_validator def utc_now() -> str: @@ -89,22 +89,29 @@ class Message(BaseModel): sender_id: str text: str created_at: str + attachment_ids: list[str] = Field(default_factory=list) class CreateMessage(BaseModel): """Данные для отправки сообщения.""" model_config = ConfigDict(extra="forbid", strict=True) - text: str = Field(..., min_length=1, max_length=4000) - attachment_ids: list[str] = Field(default_factory=list, max_length=0) + text: str = Field(..., max_length=4000) + attachment_ids: list[str] = Field(default_factory=list, max_length=10) - @field_validator("text") + @field_validator('attachment_ids') @classmethod - def text_not_whitespace_only(cls, v: str) -> str: - """Запрещаем текст, состоящий только из пробельных символов.""" - if v.strip() == "": - raise ValueError("текст не может состоять только из пробелов") - return v + def valid_attachments(cls, values): + ids = [str(uuid.UUID(v)) for v in values] + if len(set(ids)) != len(ids): + raise ValueError('duplicate attachment_id') + return ids + + @model_validator(mode='after') + def valid_content(self): + if not self.text.strip() and not self.attachment_ids: + raise ValueError('empty message') + return self class ChatPage(BaseModel): diff --git a/src/objects.py b/src/objects.py new file mode 100644 index 00000000..ef7f82ee --- /dev/null +++ b/src/objects.py @@ -0,0 +1,17 @@ +"""S3 operations with bounded timeouts and immutable server-generated keys.""" +import boto3 +from botocore.config import Config +from src.config import setting + +def client(): + return boto3.client('s3', endpoint_url=setting('S3_ENDPOINT','http://s3:9000'), + aws_access_key_id=setting('S3_ACCESS_KEY'), aws_secret_access_key=setting('S3_SECRET_KEY'), + region_name='us-east-1', config=Config(connect_timeout=2,read_timeout=5, + retries={'total_max_attempts':1},s3={'addressing_style':'path'})) + +BUCKET = setting('S3_BUCKET','attachments') + +def object_lock(conn, key, wait=True): + fn = 'pg_advisory_xact_lock' if wait else 'pg_try_advisory_xact_lock' + row = conn.execute('SELECT '+fn+'(hashtextextended(%s,42)) AS locked',(key,)).fetchone() + return wait or row['locked'] diff --git a/src/routes/attachments.py b/src/routes/attachments.py new file mode 100644 index 00000000..3461724e --- /dev/null +++ b/src/routes/attachments.py @@ -0,0 +1,134 @@ +"""Bounded synchronous image uploads; one decode per process.""" +import asyncio +import hashlib +import tempfile +import unicodedata +import uuid +import warnings +from PIL import Image, UnidentifiedImageError +from fastapi import APIRouter, Depends, HTTPException, Request +from starlette.concurrency import run_in_threadpool +from starlette.responses import StreamingResponse +from src.routes.common import require_user, make_error, get_request_id +from src.storage import storage, timestamp +from src.objects import client, BUCKET, object_lock + +router = APIRouter() +slots = asyncio.Semaphore(1) +MAX_BYTES=10*1024*1024 +Image.MAX_IMAGE_PIXELS=40_000_000 + +class InvalidImage(Exception): + def __init__(self,status): + self.status=status + +def error(request, status, code, message): + return HTTPException(status, detail=make_error(code,message,get_request_id(request)).model_dump()) + +def inspect_image(stream, declared): + try: + with warnings.catch_warnings(): + warnings.simplefilter('error', Image.DecompressionBombWarning) + with Image.open(stream) as image: + if image.width*image.height>40_000_000: + raise InvalidImage(413) + actual={'PNG':'image/png','JPEG':'image/jpeg'}.get(image.format) + if not actual or actual != declared: + raise InvalidImage(415) + image.verify() + stream.seek(0) + with Image.open(stream) as image: + image.load() + except (Image.DecompressionBombError,Image.DecompressionBombWarning): + raise InvalidImage(413) from None + except (UnidentifiedImageError,OSError,SyntaxError,ValueError): + raise InvalidImage(415) from None + finally: + stream.seek(0) + +def metadata(row): + return {k: str(row[k]) for k in ('id','chat_id','owner_id')} | { + k:row[k] for k in ('filename','content_type','size_bytes','sha256')} | { + 'status':'ready','variants':[],'error_code':None, + 'created_at':timestamp(row['created_at']),'updated_at':timestamp(row['updated_at'])} + +def save(stream, chat_id, owner, filename, content_type, size, digest): + attachment_id=uuid.uuid4() + key='originals/'+str(attachment_id) + # Keep this lock through S3 PUT and DB COMMIT/ROLLBACK. Reconciler shares it. + with storage.pool.connection() as conn: + object_lock(conn,key) + client().put_object(Bucket=BUCKET,Key=key,Body=stream,ContentLength=size, + ContentType=content_type,Metadata={'sha256':digest},IfNoneMatch='*') + row=conn.execute("INSERT INTO attachments(id,chat_id,owner_id,object_key,filename,content_type,size_bytes,sha256,state) VALUES (%s,%s,%s,%s,%s,%s,%s,%s,'ready') RETURNING *", + (attachment_id,chat_id,owner,key,filename,content_type,size,digest)).fetchone() + # Never blindly delete after ambiguous COMMIT: grace-period reconciliation handles it. + return metadata(row) + +@router.post('/api/v1/chats/{chat_id}/attachments',status_code=201) +async def upload(request:Request,chat_id:uuid.UUID,filename:str='',actor:str=Depends(require_user)): + if not await run_in_threadpool(storage.is_chat_member,str(chat_id),actor): + raise error(request,404,'not_found','chat not found') + if not 1<=len(filename)<=255 or any(c in '/\\' or unicodedata.category(c)=='Cc' for c in filename): + raise error(request,400,'invalid_request','invalid filename') + mime=request.headers.get('content-type','').lower() + if mime not in ('image/png','image/jpeg'): + raise error(request,415,'unsupported_media_type','PNG/JPEG required') + length=request.headers.get('content-length') + if length is not None: + if not length.isdecimal(): + raise error(request,400,'invalid_request','invalid length') + if int(length)>MAX_BYTES: + raise error(request,413,'payload_too_large','limit 10 MiB') + try: + await asyncio.wait_for(slots.acquire(),timeout=25) + except asyncio.TimeoutError: + raise error(request,503,'unavailable','upload queue busy') from None + try: + with tempfile.TemporaryFile() as stream: + size=0; digest=hashlib.sha256() + async def receive(): + nonlocal size + async for chunk in request.stream(): + size+=len(chunk) + if size>MAX_BYTES: + raise error(request,413,'payload_too_large','limit 10 MiB') + digest.update(chunk) + await run_in_threadpool(stream.write,chunk) + try: + await asyncio.wait_for(receive(),timeout=20) + await run_in_threadpool(stream.seek,0) + await run_in_threadpool(inspect_image,stream,mime) + except asyncio.TimeoutError: + raise error(request,400,'invalid_request','upload timed out') from None + except InvalidImage as exc: + raise error(request,exc.status,'payload_too_large' if exc.status==413 else 'unsupported_media_type','invalid image') from None + return await run_in_threadpool(save,stream,str(chat_id),actor,filename,mime,size,digest.hexdigest()) + finally: + slots.release() + +def accessible(request,attachment_id,actor): + with storage.pool.connection() as conn: + row=conn.execute('SELECT a.* FROM attachments a JOIN chat_members m ON a.chat_id=m.chat_id WHERE a.id=%s AND m.user_id=%s',(attachment_id,actor)).fetchone() + if not row: + raise error(request,404,'not_found','attachment not found') + if row['state']!='ready': + raise error(request,503,'unavailable','original temporarily unavailable') + return row + +@router.get('/api/v1/attachments/{attachment_id}') +def get_attachment(request:Request,attachment_id:uuid.UUID,actor:str=Depends(require_user)): + return metadata(accessible(request,attachment_id,actor)) + +@router.get('/api/v1/attachments/{attachment_id}/content') +def content(request:Request,attachment_id:uuid.UUID,variant:str='original',actor:str=Depends(require_user)): + row=accessible(request,attachment_id,actor) + if variant!='original': + raise error(request,404,'not_found','variant not found') + obj=client().get_object(Bucket=BUCKET,Key=row['object_key']) + def chunks(): + try: + yield from obj['Body'].iter_chunks(chunk_size=64*1024) + finally: + obj['Body'].close() + return StreamingResponse(chunks(),media_type=row['content_type'],headers={'Content-Length':str(row['size_bytes'])}) diff --git a/src/routes/health.py b/src/routes/health.py index 2f2caafb..0e9b4b94 100644 --- a/src/routes/health.py +++ b/src/routes/health.py @@ -13,6 +13,8 @@ def liveness(): @router.get('/health/ready') def readiness(): storage.ready() + from src.objects import client, BUCKET + client().list_objects_v2(Bucket=BUCKET,Prefix="originals/",MaxKeys=1) return Health() diff --git a/src/routes/messages.py b/src/routes/messages.py index 1f8ea128..1045e5dc 100644 --- a/src/routes/messages.py +++ b/src/routes/messages.py @@ -6,7 +6,7 @@ from fastapi import APIRouter, Depends, HTTPException, Request from src.models import CreateMessage, Message, MessagePage from src.routes.common import get_request_id, make_error, require_user -from src.storage import ConflictError, LimitExceeded, ValidationError, storage +from src.storage import NotFoundError, ConflictError, LimitExceeded, ValidationError, storage router = APIRouter() @@ -37,8 +37,10 @@ def create_message( key = request.headers.get('Idempotency-Key', '') if not re.fullmatch(r'[A-Za-z0-9._:-]{1,128}', key): raise HTTPException(400, detail=make_error('invalid_request', 'неверный Idempotency-Key', request_id).model_dump()) - msg = storage.create_message(chat_id_str, x_user_id, body.text, key) + msg = storage.create_message(chat_id_str, x_user_id, body.text, key, body.attachment_ids) return msg + except NotFoundError as e: + raise HTTPException(404, detail=make_error('not_found', str(e), request_id).model_dump()) except ConflictError as e: raise HTTPException(409, detail=make_error('conflict', str(e), request_id).model_dump()) except LimitExceeded as e: diff --git a/src/storage.py b/src/storage.py index 358184ec..995a4cb1 100644 --- a/src/storage.py +++ b/src/storage.py @@ -199,25 +199,41 @@ class PostgresStorage: next_cursor = self._encode_cursor('chats',user_id,page[-1].created_at,page[-1].id) if len(rows)>limit else None return page,next_cursor - def create_message(self, chat_id, sender_id, text, key): + def create_message(self, chat_id, sender_id, text, key, attachment_ids=None): + attachment_ids = attachment_ids or [] + normalized = {'text': text, 'attachment_ids': attachment_ids} # Блокировка сериализует один ключ на всех репликах; результат и сообщение атомарны. with self.pool.connection() as conn: scope = json.dumps([sender_id, chat_id, key]) conn.execute('SELECT pg_advisory_xact_lock(hashtextextended(%s, 0))', (scope,)) old = conn.execute('SELECT * FROM message_requests WHERE user_id=%s AND chat_id=%s AND key=%s AND expires_at>clock_timestamp()', (sender_id,chat_id,key)).fetchone() if old: - if old['body'] != text: + if json.loads(old['body']) != normalized: raise ConflictError('ключ уже использован с другим сообщением') row = conn.execute('SELECT * FROM messages WHERE id=%s', (old['message_id'],)).fetchone() - return Message(**public_row(row)) - optimized = os.getenv('OPTIMIZED_WRITES','1') == '1' + return self.message_model(conn, row) + for attachment_id in sorted(attachment_ids): + attachment = conn.execute('SELECT state FROM attachments WHERE id=%s AND chat_id=%s FOR SHARE', (attachment_id,chat_id)).fetchone() + if not attachment: + raise NotFoundError('вложение не найдено') + if attachment['state'] != 'ready': + raise ConflictError('вложение недоступно') + optimized = os.getenv('OPTIMIZED_WRITES','1') == '1' if not optimized: conn.execute('DELETE FROM message_requests WHERE user_id=%s AND chat_id=%s AND key=%s', (sender_id,chat_id,key)) row = conn.execute('INSERT INTO messages (id,chat_id,sender_id,text) VALUES (%s,%s,%s,%s) RETURNING *', (uuid.uuid4(),chat_id,sender_id,text)).fetchone() # Под той же блокировкой UPSERT заменяет просроченный результат без отдельного DELETE. suffix = ' ON CONFLICT (user_id,chat_id,key) DO UPDATE SET body=EXCLUDED.body,message_id=EXCLUDED.message_id,expires_at=EXCLUDED.expires_at' if optimized else '' - conn.execute("INSERT INTO message_requests VALUES (%s,%s,%s,%s,%s,clock_timestamp()+interval '24 hours')"+suffix, (sender_id,chat_id,key,text,row['id'])) - return Message(**public_row(row)) + conn.execute("INSERT INTO message_requests VALUES (%s,%s,%s,%s,%s,clock_timestamp()+interval '24 hours')"+suffix, (sender_id,chat_id,key,json.dumps(normalized,ensure_ascii=False),row['id'])) + for position, attachment_id in enumerate(attachment_ids): + conn.execute('INSERT INTO message_attachments VALUES (%s,%s,%s)', (row['id'],attachment_id,position)) + result = self.message_model(conn,row) + return result + + @staticmethod + def message_model(conn, row): + ids = conn.execute('SELECT attachment_id FROM message_attachments WHERE message_id=%s ORDER BY position', (row['id'],)).fetchall() + return Message(**public_row(row), attachment_ids=[str(x['attachment_id']) for x in ids]) def list_messages(self, chat_id, cursor, limit): with self.pool.connection() as conn: @@ -231,7 +247,7 @@ class PostgresStorage: boundary = ' AND (created_at,id) > (%s,%s)' params += [when,item] rows = conn.execute('SELECT * FROM messages WHERE chat_id=%s' + boundary + ' ORDER BY created_at,id LIMIT %s', params+[limit+1]).fetchall() - page = [Message(**public_row(row)) for row in rows[:limit]] + page = [self.message_model(conn,row) for row in rows[:limit]] next_cursor = self._encode_cursor('messages',chat_id,page[-1].created_at,page[-1].id) if len(rows)>limit else None return page,next_cursor diff --git a/student-tests/test_operations.py b/student-tests/test_operations.py new file mode 100644 index 00000000..c0b03814 --- /dev/null +++ b/student-tests/test_operations.py @@ -0,0 +1,71 @@ +"""Actual Docker failures, scoped by Compose service labels.""" +import hashlib +import json +import os +from pathlib import Path +import subprocess +import sys +import time +sys.path.insert(0,str(Path(__file__).resolve().parents[1]/'tests')) +from client import Client, check, Failure +ROOT=Path(__file__).resolve().parents[1] +BASE=['docker','compose','--project-directory',str(ROOT),'-p','lyakhonov-lab4'] +def dc(*args): return subprocess.check_output(BASE+list(args),text=True).strip() +def info(cid): + x=json.loads(subprocess.check_output(['docker','inspect',cid],text=True))[0] + return {'id':x['Id'][:12],'hostname':x['Config']['Hostname'],'name':x['Name'].lstrip('/'),'running':x['State']['Running'],'started_at':x['State']['StartedAt'],'project':x['Config']['Labels']['com.docker.compose.project']} +def wait(c): + for _ in range(120): + try: c.call('GET','/health/ready'); return + except Failure: time.sleep(.5) + raise AssertionError('readiness did not recover') +def main(): + c=Client('http://localhost:8084',timeout=8) + alice,bob,eve,chat=c.bootstrap() + data=(ROOT/'tests/fixtures/sample.png').read_bytes() + records=[] + ids=dc('ps','-q','api').splitlines() + for cid in ids: + target=info(cid) + check(target['project']=='lyakhonov-lab4','wrong project') + for _ in range(20): + result=c.call('POST','/api/v1/chats/'+chat['id']+'/attachments?filename=failover.png',201,actor=alice,raw=data,headers={'Content-Type':'image/png'},schema='Attachment') + if result['headers']['X-Instance-Id'].startswith(target['hostname']+'-'): break + else: raise AssertionError('target never uploaded') + started=time.monotonic() + try: + subprocess.check_call(['docker','stop','--time','1',cid],stdout=subprocess.DEVNULL) + check(not info(cid)['running'],'target still running') + for _ in range(40): + try: + downloaded=c.call('GET','/api/v1/attachments/'+result['json']['id']+'/content',actor=bob) + break + except Failure: time.sleep(.25) + else: raise AssertionError('download unavailable') + check(downloaded['bytes']==data,'original changed') + check(not downloaded['headers']['X-Instance-Id'].startswith(target['hostname']+'-'),'same replica') + records.append({'stopped':target,'after':info(cid),'download_instance':downloaded['headers']['X-Instance-Id'],'sha256':hashlib.sha256(downloaded['bytes']).hexdigest(),'recovery_seconds':round(time.monotonic()-started,3)}) + finally: + subprocess.check_call(['docker','start',cid],stdout=subprocess.DEVNULL) + wait(c); time.sleep(3) + attachment,_=c.attachment(alice,chat) + # S3 failure must bound the wait and preserve the existing DB/session. + try: + dc('stop','--timeout','1','s3') + started=time.monotonic() + c.call('GET','/api/v1/attachments/'+attachment['id']+'/content',503,actor=bob) + failure_seconds=time.monotonic()-started + finally: + dc('start','s3'); wait(c) + check(c.call('GET','/api/v1/attachments/'+attachment['id']+'/content',actor=bob)['bytes']==data,'S3 recovery lost original') + before={service:[info(x) for x in dc('ps','-q',service).splitlines()] for service in ('api','db','redis','s3','lb')} + dc('restart','api','db','redis','s3','lb'); wait(c) + after={service:[info(x) for x in dc('ps','-q',service).splitlines()] for service in before} + for service in before: + check(all(a['started_at']!=b['started_at'] for a,b in zip(before[service],after[service])),'service not restarted: '+service) + check(c.call('GET','/api/v1/attachments/'+attachment['id']+'/content',actor=bob)['bytes']==data,'restart lost original') + c.call('GET','/api/v1/users/me',actor=alice,schema='User') + out={'result':'PASS','each_uploading_replica_stopped':records,'s3_503_seconds':failure_seconds,'restart_before':before,'restart_after':after} + (ROOT/'evidence/operations.json').write_text(json.dumps(out,indent=2),encoding='utf-8') + print('PASS: both uploading API replicas stopped; S3 failure/recovery; all services really restarted; original and session preserved') +if __name__=='__main__': main() -- 2.54.0 From 9dded977a583b0cf6f0f1c96f3872568b879a7d9 Mon Sep 17 00:00:00 2001 From: Sergey Lyakhonov Date: Fri, 30 Oct 2026 17:47:29 +0300 Subject: [PATCH 3/5] =?UTF-8?q?=D0=97=D0=B0=D0=B2=D0=B5=D1=80=D1=88=D0=B8?= =?UTF-8?q?=D1=82=D1=8C=20=D1=83=D1=80=D0=BE=D0=B2=D0=B5=D0=BD=D1=8C=204:?= =?UTF-8?q?=20=D0=BF=D1=80=D0=BE=D0=B2=D0=B5=D1=80=D0=B8=D1=82=D1=8C=20?= =?UTF-8?q?=D0=BE=D1=88=D0=B8=D0=B1=D0=BA=D0=B8,=20=D0=BE=D0=B3=D1=80?= =?UTF-8?q?=D0=B0=D0=BD=D0=B8=D1=87=D0=B8=D1=82=D1=8C=20=D0=BF=D0=B0=D0=BC?= =?UTF-8?q?=D1=8F=D1=82=D1=8C=20=D0=B8=20=D0=B0=D0=B2=D1=82=D0=BE=D0=BC?= =?UTF-8?q?=D0=B0=D1=82=D0=B8=D0=B7=D0=B8=D1=80=D0=BE=D0=B2=D0=B0=D1=82?= =?UTF-8?q?=D1=8C=20=D1=81=D0=B2=D0=B5=D1=80=D0=BA=D1=83=20S3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .github/workflows/application.yml | 24 ++ Dockerfile | 2 +- Dockerfile.s3 | 17 + compose.yaml | 21 +- evidence/attachments.txt | 1 + evidence/bootstrap-repeat.txt | 1 + evidence/cpu.json | 5 + evidence/docker-resources.json | 8 + evidence/hardware.json | 4 + evidence/level4.json | 44 +++ evidence/make-check-test.txt | 4 + evidence/operations.json | 172 ++++----- evidence/s3-source-hashes.json | 10 + evidence/upload-load-output.txt | 1 + evidence/upload-load.json | 600 ++++++++++++++++++++++++++++++ evidence/validate.txt | 2 + infra/reconciliation.md | 60 +++ infra/s3-entrypoint.sh | 5 + requirements-research.txt | 2 + scripts/actions.py | 2 +- scripts/run_upload_load.py | 36 ++ src/reconcile.py | 118 ++++++ src/routes/attachments.py | 5 + student-tests/test_attachments.py | 105 ++++++ student-tests/upload_load.py | 54 +++ 25 files changed, 1213 insertions(+), 90 deletions(-) create mode 100644 .github/workflows/application.yml create mode 100644 Dockerfile.s3 create mode 100644 evidence/attachments.txt create mode 100644 evidence/bootstrap-repeat.txt create mode 100644 evidence/cpu.json create mode 100644 evidence/docker-resources.json create mode 100644 evidence/hardware.json create mode 100644 evidence/level4.json create mode 100644 evidence/make-check-test.txt create mode 100644 evidence/s3-source-hashes.json create mode 100644 evidence/upload-load-output.txt create mode 100644 evidence/upload-load.json create mode 100644 evidence/validate.txt create mode 100644 infra/reconciliation.md create mode 100644 infra/s3-entrypoint.sh create mode 100644 requirements-research.txt create mode 100644 scripts/run_upload_load.py create mode 100644 src/reconcile.py create mode 100644 student-tests/test_attachments.py create mode 100644 student-tests/upload_load.py diff --git a/.github/workflows/application.yml b/.github/workflows/application.yml new file mode 100644 index 00000000..7ac092b9 --- /dev/null +++ b/.github/workflows/application.yml @@ -0,0 +1,24 @@ +name: Application lab4 +on: [push, pull_request] +permissions: + contents: read +jobs: + application: + runs-on: ubuntu-latest + timeout-minutes: 30 + steps: + - uses: actions/checkout@v4 + - uses: actions/setup-python@v5 + with: + python-version: '3.12' + - run: python scripts/bootstrap.py + - run: docker compose build api s3 + - run: docker compose up -d + - run: python scripts/wait_ready.py --base-url http://localhost:8084 --replicas 2 + - run: make check test PYTHON=python BASE_URL=http://localhost:8084 + - run: docker compose run --rm --no-deps -T -v "$PWD:/suite:ro" -w /suite api python student-tests/test_attachments.py + - run: docker compose run --rm --no-deps -T -v "$PWD:/suite:ro" -w /suite api python student-tests/test_reconcile.py + - run: chmod +x scripts/restart.sh scripts/stop-one.sh + - run: make test-persistence PYTHON=python BASE_URL=http://localhost:8084 ACTION_SCRIPT=scripts/restart.sh + - if: always() + run: docker compose down diff --git a/Dockerfile b/Dockerfile index d74bf817..4e389d7a 100644 --- a/Dockerfile +++ b/Dockerfile @@ -1,4 +1,4 @@ -FROM python:3.11.10-slim-bookworm +FROM python:3.11.10-slim-bookworm@sha256:840e180ebcc6e5c8efab209c43f5e40fd2af98cb49db5c7103c90539c56bb30e WORKDIR /app # Приложение работает без прав root. RUN groupadd -r appuser && useradd -r -g appuser appuser diff --git a/Dockerfile.s3 b/Dockerfile.s3 new file mode 100644 index 00000000..b813ecf0 --- /dev/null +++ b/Dockerfile.s3 @@ -0,0 +1,17 @@ +# Reproducible fallback: official MinIO images are unavailable from registries. +FROM golang:1.24.6-bookworm@sha256:ab1d1823abb55a9504d2e3e003b75b36dbeb1cbcc4c92593d85a84ee46becc6c AS build +WORKDIR /build +ADD --checksum=sha256:8819e3e7817e46b7b3798f8f200ead208562e571563c2e040352378031abe9f2 https://github.com/minio/minio/archive/07c3a429bfed433e49018cb0f78a52145d4bedeb.tar.gz /tmp/minio.tar.gz +RUN tar -xzf /tmp/minio.tar.gz --strip-components=1 && CGO_ENABLED=0 go build -trimpath -o /out/minio . +WORKDIR /build-mc +ADD --checksum=sha256:526ec538e7f83e4bfa631788129b08ec85898ca572ce0523ebf9a597946bea27 https://github.com/minio/mc/archive/refs/tags/RELEASE.2025-04-16T18-13-26Z.tar.gz /tmp/mc.tar.gz +RUN tar -xzf /tmp/mc.tar.gz --strip-components=1 && CGO_ENABLED=0 go build -trimpath -o /out/mc . +FROM debian:bookworm-20251020-slim@sha256:78d2f66e0fec9e5a39fb2c72ea5e052b548df75602b5215ed01a17171529f706 +LABEL org.opencontainers.image.source="https://github.com/minio/minio" org.opencontainers.image.revision="07c3a429bfed433e49018cb0f78a52145d4bedeb" +COPY --from=build /build/LICENSE /usr/share/doc/minio/LICENSE +COPY --from=build /build-mc/LICENSE /usr/share/doc/mc/LICENSE +COPY --from=build /out/minio /out/mc /usr/bin/ +COPY --from=build /etc/ssl/certs/ca-certificates.crt /etc/ssl/certs/ca-certificates.crt +COPY infra/s3-entrypoint.sh /usr/local/bin/s3-entrypoint.sh +ENTRYPOINT ["/bin/sh","/usr/local/bin/s3-entrypoint.sh"] +CMD ["server","/data"] diff --git a/compose.yaml b/compose.yaml index d1da6816..e8773ac6 100644 --- a/compose.yaml +++ b/compose.yaml @@ -49,7 +49,10 @@ services: healthcheck: disable: true s3: - image: minio/minio@sha256:14cea493d9a34af32f524e538b8346cf79f3321eff8e708c1e2960462bd8936e + image: lyakhonov-storage:lab4 + build: + context: . + dockerfile: Dockerfile.s3 command: [server, /data, --console-address, '127.0.0.1:9001'] environment: MINIO_ROOT_USER_FILE: /run/secrets/s3_root_user @@ -59,7 +62,8 @@ services: cpus: 1 mem_limit: 768m bucket-init: - image: minio/minio@sha256:14cea493d9a34af32f524e538b8346cf79f3321eff8e708c1e2960462bd8936e + image: lyakhonov-storage:lab4 + pull_policy: never entrypoint: [/bin/sh, /bootstrap/bucket.sh] secrets: [s3_root_user, s3_root_password, s3_access_key, s3_secret_key] volumes: [./infra/bucket.sh:/bootstrap/bucket.sh:ro, ./infra/s3-policy.json:/bootstrap/policy.json:ro] @@ -73,6 +77,19 @@ services: condition: service_completed_successfully deploy: replicas: ${API_REPLICAS:-2} + reconciler: + <<: *api + command: [python, -m, src.reconcile, --apply, --interval, '300'] + restart: unless-stopped + cpus: 0.25 + mem_limit: 256m + healthcheck: + disable: true + depends_on: + migrate: + condition: service_completed_successfully + bucket-init: + condition: service_completed_successfully lb: image: haproxy:3.0.6-alpine ports: ["127.0.0.1:${LAB4_PORT:-8084}:8080"] diff --git a/evidence/attachments.txt b/evidence/attachments.txt new file mode 100644 index 00000000..c855b42e --- /dev/null +++ b/evidence/attachments.txt @@ -0,0 +1 @@ +{"result": "PASS", "concurrent_retries": 16, "failure_after_s3_put": true, "interrupted_upload_no_object": true, "private_bucket": true, "restricted_credentials": true} diff --git a/evidence/bootstrap-repeat.txt b/evidence/bootstrap-repeat.txt new file mode 100644 index 00000000..b7e057c3 --- /dev/null +++ b/evidence/bootstrap-repeat.txt @@ -0,0 +1 @@ +Private bucket and restricted application user ready diff --git a/evidence/cpu.json b/evidence/cpu.json new file mode 100644 index 00000000..11aa23a8 --- /dev/null +++ b/evidence/cpu.json @@ -0,0 +1,5 @@ +{ + "Name": "13th Gen Intel(R) Core(TM) i5-1340P", + "NumberOfCores": 12, + "NumberOfLogicalProcessors": 16 +} diff --git a/evidence/docker-resources.json b/evidence/docker-resources.json new file mode 100644 index 00000000..8491cc0d --- /dev/null +++ b/evidence/docker-resources.json @@ -0,0 +1,8 @@ +{ + "ServerVersion": "28.5.1", + "NCPU": 16, + "MemTotal": 8126664704, + "OSType": "linux", + "OperatingSystem": "Docker Desktop", + "Architecture": "x86_64" +} diff --git a/evidence/hardware.json b/evidence/hardware.json new file mode 100644 index 00000000..e1b6346e --- /dev/null +++ b/evidence/hardware.json @@ -0,0 +1,4 @@ +{ + "NumberOfLogicalProcessors": 16, + "TotalPhysicalMemory": 16778182656 +} diff --git a/evidence/level4.json b/evidence/level4.json new file mode 100644 index 00000000..4052dec6 --- /dev/null +++ b/evidence/level4.json @@ -0,0 +1,44 @@ +{ + "negative_suite": { + "result": "PASS", + "concurrent_retries": 16, + "failure_after_s3_put": true, + "interrupted_upload_no_object": true, + "private_bucket": true, + "restricted_credentials": true + }, + "uploads": [ + { + "size_bytes": 3151219, + "successful_rps_median": 16.729828936800814, + "p50_seconds_median": 0.4081998335022945, + "p95_seconds_median": 0.584588757907477, + "p99_seconds_median": 0.5914236595887633, + "errors": 0, + "attempts": 30, + "elapsed_seconds": 1.8537453600001754 + }, + { + "size_bytes": 9648062, + "successful_rps_median": 5.626450903085569, + "p50_seconds_median": 1.0610903210035758, + "p95_seconds_median": 1.7164175714497103, + "p99_seconds_median": 1.7635092142925715, + "errors": 0, + "attempts": 30, + "elapsed_seconds": 5.111771299998509 + } + ], + "kernel_memory_peak_mib": { + "68ab8db39c84": 167.9453125, + "a6106479affd": 156.98046875 + }, + "sampled_memory_max_mib": { + "lyakhonov-lab4-api-1": 157.2, + "lyakhonov-lab4-api-2": 149.2, + "lyakhonov-lab4-db-1": 40.3, + "lyakhonov-lab4-lb-1": 17.27, + "lyakhonov-lab4-s3-1": 312.1 + }, + "cleanup_mechanism": "src.reconcile, grace 3600 seconds, interval 300 seconds; explicit 5-second synthetic test in track evidence" +} \ No newline at end of file diff --git a/evidence/make-check-test.txt b/evidence/make-check-test.txt new file mode 100644 index 00000000..be2183ec --- /dev/null +++ b/evidence/make-check-test.txt @@ -0,0 +1,4 @@ +python scripts/check_contract.py +PASS: offline skeleton structure, local refs and Python syntax; application NOT tested. +python tests/smoke.py --base-url "http://localhost:8084" +PASS: lab4 public API scenario; infrastructure and grading evidence remain separate. diff --git a/evidence/operations.json b/evidence/operations.json index aa22df4c..5e003977 100644 --- a/evidence/operations.json +++ b/evidence/operations.json @@ -3,124 +3,64 @@ "each_uploading_replica_stopped": [ { "stopped": { - "id": "24498cc4891a", - "hostname": "24498cc4891a", + "id": "550435eb1893", + "hostname": "550435eb1893", "name": "lyakhonov-lab4-api-1", "running": true, - "started_at": "2026-10-30T14:31:07.744742532Z", + "started_at": "2026-10-30T14:38:55.142398594Z", "project": "lyakhonov-lab4" }, "after": { - "id": "24498cc4891a", - "hostname": "24498cc4891a", + "id": "550435eb1893", + "hostname": "550435eb1893", "name": "lyakhonov-lab4-api-1", "running": false, - "started_at": "2026-10-30T14:31:07.744742532Z", + "started_at": "2026-10-30T14:38:55.142398594Z", "project": "lyakhonov-lab4" }, - "download_instance": "950e5ae78851-f8e15971", + "download_instance": "5c0c5d76b6ee-fbcdf384", "sha256": "99ea7533c441f79cd630d15ce4d58d1ec4e06f6f0efb3b77a5c088305cd1bd75", - "recovery_seconds": 1.135 + "recovery_seconds": 1.286 }, { "stopped": { - "id": "950e5ae78851", - "hostname": "950e5ae78851", + "id": "5c0c5d76b6ee", + "hostname": "5c0c5d76b6ee", "name": "lyakhonov-lab4-api-2", "running": true, - "started_at": "2026-10-30T14:31:12.431277515Z", + "started_at": "2026-10-30T14:38:54.95782885Z", "project": "lyakhonov-lab4" }, "after": { - "id": "950e5ae78851", - "hostname": "950e5ae78851", + "id": "5c0c5d76b6ee", + "hostname": "5c0c5d76b6ee", "name": "lyakhonov-lab4-api-2", "running": false, - "started_at": "2026-10-30T14:31:12.431277515Z", + "started_at": "2026-10-30T14:38:54.95782885Z", "project": "lyakhonov-lab4" }, - "download_instance": "24498cc4891a-5564fcf3", + "download_instance": "550435eb1893-4bee0210", "sha256": "99ea7533c441f79cd630d15ce4d58d1ec4e06f6f0efb3b77a5c088305cd1bd75", - "recovery_seconds": 1.096 + "recovery_seconds": 1.406 } ], - "s3_503_seconds": 4.046069000149146, + "s3_503_seconds": 4.043458599830046, "restart_before": { "api": [ { - "id": "24498cc4891a", - "hostname": "24498cc4891a", + "id": "550435eb1893", + "hostname": "550435eb1893", "name": "lyakhonov-lab4-api-1", "running": true, - "started_at": "2026-10-30T14:31:55.001303564Z", + "started_at": "2026-10-30T14:40:54.440796232Z", "project": "lyakhonov-lab4" }, { - "id": "950e5ae78851", - "hostname": "950e5ae78851", + "id": "5c0c5d76b6ee", + "hostname": "5c0c5d76b6ee", "name": "lyakhonov-lab4-api-2", "running": true, - "started_at": "2026-10-30T14:31:59.649868974Z", - "project": "lyakhonov-lab4" - } - ], - "db": [ - { - "id": "10138b5c0bee", - "hostname": "10138b5c0bee", - "name": "lyakhonov-lab4-db-1", - "running": true, - "started_at": "2026-10-30T14:30:00.149637002Z", - "project": "lyakhonov-lab4" - } - ], - "redis": [ - { - "id": "68997bbba33b", - "hostname": "68997bbba33b", - "name": "lyakhonov-lab4-redis-1", - "running": true, - "started_at": "2026-10-30T14:30:00.082955484Z", - "project": "lyakhonov-lab4" - } - ], - "s3": [ - { - "id": "83df7acfb73f", - "hostname": "83df7acfb73f", - "name": "lyakhonov-lab4-s3-1", - "running": true, - "started_at": "2026-10-30T14:32:07.860463524Z", - "project": "lyakhonov-lab4" - } - ], - "lb": [ - { - "id": "e9682a892ad3", - "hostname": "e9682a892ad3", - "name": "lyakhonov-lab4-lb-1", - "running": true, - "started_at": "2026-10-30T14:29:59.993685266Z", - "project": "lyakhonov-lab4" - } - ] - }, - "restart_after": { - "api": [ - { - "id": "24498cc4891a", - "hostname": "24498cc4891a", - "name": "lyakhonov-lab4-api-1", - "running": true, - "started_at": "2026-10-30T14:32:12.97023467Z", - "project": "lyakhonov-lab4" - }, - { - "id": "950e5ae78851", - "hostname": "950e5ae78851", - "name": "lyakhonov-lab4-api-2", - "running": true, - "started_at": "2026-10-30T14:32:13.834829902Z", + "started_at": "2026-10-30T14:40:59.474039309Z", "project": "lyakhonov-lab4" } ], @@ -146,11 +86,11 @@ ], "s3": [ { - "id": "83df7acfb73f", - "hostname": "83df7acfb73f", + "id": "8d6296c66f50", + "hostname": "8d6296c66f50", "name": "lyakhonov-lab4-s3-1", "running": true, - "started_at": "2026-10-30T14:32:12.440778626Z", + "started_at": "2026-10-30T14:41:07.545035588Z", "project": "lyakhonov-lab4" } ], @@ -164,5 +104,65 @@ "project": "lyakhonov-lab4" } ] + }, + "restart_after": { + "api": [ + { + "id": "550435eb1893", + "hostname": "550435eb1893", + "name": "lyakhonov-lab4-api-1", + "running": true, + "started_at": "2026-10-30T14:41:12.906035738Z", + "project": "lyakhonov-lab4" + }, + { + "id": "5c0c5d76b6ee", + "hostname": "5c0c5d76b6ee", + "name": "lyakhonov-lab4-api-2", + "running": true, + "started_at": "2026-10-30T14:41:12.736844839Z", + "project": "lyakhonov-lab4" + } + ], + "db": [ + { + "id": "10138b5c0bee", + "hostname": "10138b5c0bee", + "name": "lyakhonov-lab4-db-1", + "running": true, + "started_at": "2026-10-30T14:41:12.415067466Z", + "project": "lyakhonov-lab4" + } + ], + "redis": [ + { + "id": "68997bbba33b", + "hostname": "68997bbba33b", + "name": "lyakhonov-lab4-redis-1", + "running": true, + "started_at": "2026-10-30T14:41:12.598940634Z", + "project": "lyakhonov-lab4" + } + ], + "s3": [ + { + "id": "8d6296c66f50", + "hostname": "8d6296c66f50", + "name": "lyakhonov-lab4-s3-1", + "running": true, + "started_at": "2026-10-30T14:41:12.309884842Z", + "project": "lyakhonov-lab4" + } + ], + "lb": [ + { + "id": "e9682a892ad3", + "hostname": "e9682a892ad3", + "name": "lyakhonov-lab4-lb-1", + "running": true, + "started_at": "2026-10-30T14:41:12.504270669Z", + "project": "lyakhonov-lab4" + } + ] } } \ No newline at end of file diff --git a/evidence/s3-source-hashes.json b/evidence/s3-source-hashes.json new file mode 100644 index 00000000..d3acd196 --- /dev/null +++ b/evidence/s3-source-hashes.json @@ -0,0 +1,10 @@ +{ + "minio": { + "url": "https://github.com/minio/minio/archive/07c3a429bfed433e49018cb0f78a52145d4bedeb.tar.gz", + "sha256": "8819e3e7817e46b7b3798f8f200ead208562e571563c2e040352378031abe9f2" + }, + "mc": { + "url": "https://github.com/minio/mc/archive/refs/tags/RELEASE.2025-04-16T18-13-26Z.tar.gz", + "sha256": "526ec538e7f83e4bfa631788129b08ec85898ca572ce0523ebf9a597946bea27" + } +} \ No newline at end of file diff --git a/evidence/upload-load-output.txt b/evidence/upload-load-output.txt new file mode 100644 index 00000000..1abd1934 --- /dev/null +++ b/evidence/upload-load-output.txt @@ -0,0 +1 @@ +{"result": "PASS", "profile": "closed-loop batch, 10 simultaneous uploads, 3 repeats per size, 1 warmup, all confirmed originals downloaded", "runs": [{"size_bytes": 3151219, "side": 1024, "repeat": 1, "concurrency": 10, "attempts": 10, "successes": 10, "errors": 0, "elapsed_seconds": 0.7838622859999305, "successful_rps": 12.75734293970215, "p50_seconds": 0.4336575634952169, "p95_seconds": 0.7340192681040206, "p99_seconds": 0.7722596784304188}, {"size_bytes": 3151219, "side": 1024, "repeat": 2, "concurrency": 10, "attempts": 10, "successes": 10, "errors": 0, "elapsed_seconds": 0.597734743001638, "successful_rps": 16.729828936800814, "p50_seconds": 0.4081998335022945, "p95_seconds": 0.584588757907477, "p99_seconds": 0.5914236595887633}, {"size_bytes": 3151219, "side": 1024, "repeat": 3, "concurrency": 10, "attempts": 10, "successes": 10, "errors": 0, "elapsed_seconds": 0.472148330998607, "successful_rps": 21.179784706322522, "p50_seconds": 0.2796381600055611, "p95_seconds": 0.4425103257497539, "p99_seconds": 0.4638570675504161}, {"size_bytes": 9648062, "side": 1792, "repeat": 1, "concurrency": 10, "attempts": 10, "successes": 10, "errors": 0, "elapsed_seconds": 1.5366208479972556, "successful_rps": 6.507786233040787, "p50_seconds": 1.0274780609979643, "p95_seconds": 1.4637623943453943, "p99_seconds": 1.5201743212681322}, {"size_bytes": 9648062, "side": 1792, "repeat": 2, "concurrency": 10, "attempts": 10, "successes": 10, "errors": 0, "elapsed_seconds": 1.7978311129991198, "successful_rps": 5.56225772693305, "p50_seconds": 1.1837765999953263, "p95_seconds": 1.746605640908092, "p99_seconds": 1.784828035391838}, {"size_bytes": 9648062, "side": 1792, "repeat": 3, "concurrency": 10, "attempts": 10, "successes": 10, "errors": 0, "elapsed_seconds": 1.7773193390021333, "successful_rps": 5.626450903085569, "p50_seconds": 1.0610903210035758, "p95_seconds": 1.7164175714497103, "p99_seconds": 1.7635092142925715}]} diff --git a/evidence/upload-load.json b/evidence/upload-load.json new file mode 100644 index 00000000..808501c7 --- /dev/null +++ b/evidence/upload-load.json @@ -0,0 +1,600 @@ +{ + "result": "PASS", + "profile": "closed-loop batch, 10 simultaneous uploads, 3 repeats per size, 1 warmup, all confirmed originals downloaded", + "runs": [ + { + "size_bytes": 3151219, + "side": 1024, + "repeat": 1, + "concurrency": 10, + "attempts": 10, + "successes": 10, + "errors": 0, + "elapsed_seconds": 0.7838622859999305, + "successful_rps": 12.75734293970215, + "p50_seconds": 0.4336575634952169, + "p95_seconds": 0.7340192681040206, + "p99_seconds": 0.7722596784304188 + }, + { + "size_bytes": 3151219, + "side": 1024, + "repeat": 2, + "concurrency": 10, + "attempts": 10, + "successes": 10, + "errors": 0, + "elapsed_seconds": 0.597734743001638, + "successful_rps": 16.729828936800814, + "p50_seconds": 0.4081998335022945, + "p95_seconds": 0.584588757907477, + "p99_seconds": 0.5914236595887633 + }, + { + "size_bytes": 3151219, + "side": 1024, + "repeat": 3, + "concurrency": 10, + "attempts": 10, + "successes": 10, + "errors": 0, + "elapsed_seconds": 0.472148330998607, + "successful_rps": 21.179784706322522, + "p50_seconds": 0.2796381600055611, + "p95_seconds": 0.4425103257497539, + "p99_seconds": 0.4638570675504161 + }, + { + "size_bytes": 9648062, + "side": 1792, + "repeat": 1, + "concurrency": 10, + "attempts": 10, + "successes": 10, + "errors": 0, + "elapsed_seconds": 1.5366208479972556, + "successful_rps": 6.507786233040787, + "p50_seconds": 1.0274780609979643, + "p95_seconds": 1.4637623943453943, + "p99_seconds": 1.5201743212681322 + }, + { + "size_bytes": 9648062, + "side": 1792, + "repeat": 2, + "concurrency": 10, + "attempts": 10, + "successes": 10, + "errors": 0, + "elapsed_seconds": 1.7978311129991198, + "successful_rps": 5.56225772693305, + "p50_seconds": 1.1837765999953263, + "p95_seconds": 1.746605640908092, + "p99_seconds": 1.784828035391838 + }, + { + "size_bytes": 9648062, + "side": 1792, + "repeat": 3, + "concurrency": 10, + "attempts": 10, + "successes": 10, + "errors": 0, + "elapsed_seconds": 1.7773193390021333, + "successful_rps": 5.626450903085569, + "p50_seconds": 1.0610903210035758, + "p95_seconds": 1.7164175714497103, + "p99_seconds": 1.7635092142925715 + } + ], + "samples": [ + { + "time": 1793371458.0681832, + "containers": [ + { + "BlockIO": "0B / 0B", + "CPUPerc": "7.04%", + "Container": "68ab8db39c844427ad170edeb784590708e6fc3e69cd4abe43c05b8b6adce6d3", + "ID": "68ab8db39c84", + "MemPerc": "19.38%", + "MemUsage": "99.22MiB / 512MiB", + "Name": "lyakhonov-lab4-api-1", + "NetIO": "61.5kB / 61.2kB", + "PIDs": "11" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "8.49%", + "Container": "a6106479affd1937a2a56fae0888dc2c155b382a2e1325e94c99194491109dbb", + "ID": "a6106479affd", + "MemPerc": "19.54%", + "MemUsage": "100.1MiB / 512MiB", + "Name": "lyakhonov-lab4-api-2", + "NetIO": "3.22MB / 3.23MB", + "PIDs": "10" + }, + { + "BlockIO": "0B / 2.65MB", + "CPUPerc": "2.09%", + "Container": "10138b5c0beefe8a15a6679fdad81ddac663eea21e8f63bf3ca03545c2558f20", + "ID": "10138b5c0bee", + "MemPerc": "5.18%", + "MemUsage": "26.52MiB / 512MiB", + "Name": "lyakhonov-lab4-db-1", + "NetIO": "662kB / 705kB", + "PIDs": "9" + }, + { + "BlockIO": "741kB / 0B", + "CPUPerc": "0.18%", + "Container": "e9682a892ad30d5becf1fda8abbc16770aed81f261b0843f9cb047b5085baf76", + "ID": "e9682a892ad3", + "MemPerc": "10.57%", + "MemUsage": "13.52MiB / 128MiB", + "Name": "lyakhonov-lab4-lb-1", + "NetIO": "789MB / 789MB", + "PIDs": "17" + }, + { + "BlockIO": "0B / 3.19MB", + "CPUPerc": "2.00%", + "Container": "a6482b44d70a2031a2563b1b72d955435125453a48e95087464775c918801941", + "ID": "a6482b44d70a", + "MemPerc": "39.63%", + "MemUsage": "304.4MiB / 768MiB", + "Name": "lyakhonov-lab4-s3-1", + "NetIO": "4.08MB / 798MB", + "PIDs": "21" + } + ] + }, + { + "time": 1793371461.407941, + "containers": [ + { + "BlockIO": "0B / 0B", + "CPUPerc": "2.06%", + "Container": "68ab8db39c844427ad170edeb784590708e6fc3e69cd4abe43c05b8b6adce6d3", + "ID": "68ab8db39c84", + "MemPerc": "20.62%", + "MemUsage": "105.6MiB / 512MiB", + "Name": "lyakhonov-lab4-api-1", + "NetIO": "31.7MB / 31.7MB", + "PIDs": "14" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "0.88%", + "Container": "a6106479affd1937a2a56fae0888dc2c155b382a2e1325e94c99194491109dbb", + "ID": "a6106479affd", + "MemPerc": "20.64%", + "MemUsage": "105.7MiB / 512MiB", + "Name": "lyakhonov-lab4-api-2", + "NetIO": "34.9MB / 34.9MB", + "PIDs": "14" + }, + { + "BlockIO": "0B / 2.74MB", + "CPUPerc": "0.14%", + "Container": "10138b5c0beefe8a15a6679fdad81ddac663eea21e8f63bf3ca03545c2558f20", + "ID": "10138b5c0bee", + "MemPerc": "6.84%", + "MemUsage": "35.02MiB / 512MiB", + "Name": "lyakhonov-lab4-db-1", + "NetIO": "705kB / 746kB", + "PIDs": "13" + }, + { + "BlockIO": "741kB / 0B", + "CPUPerc": "0.21%", + "Container": "e9682a892ad30d5becf1fda8abbc16770aed81f261b0843f9cb047b5085baf76", + "ID": "e9682a892ad3", + "MemPerc": "10.60%", + "MemUsage": "13.57MiB / 128MiB", + "Name": "lyakhonov-lab4-lb-1", + "NetIO": "852MB / 853MB", + "PIDs": "17" + }, + { + "BlockIO": "0B / 34.8MB", + "CPUPerc": "16.97%", + "Container": "a6482b44d70a2031a2563b1b72d955435125453a48e95087464775c918801941", + "ID": "a6482b44d70a", + "MemPerc": "39.90%", + "MemUsage": "306.5MiB / 768MiB", + "Name": "lyakhonov-lab4-s3-1", + "NetIO": "35.7MB / 830MB", + "PIDs": "21" + } + ] + }, + { + "time": 1793371464.4601676, + "containers": [ + { + "BlockIO": "0B / 0B", + "CPUPerc": "8.26%", + "Container": "68ab8db39c844427ad170edeb784590708e6fc3e69cd4abe43c05b8b6adce6d3", + "ID": "68ab8db39c84", + "MemPerc": "21.66%", + "MemUsage": "110.9MiB / 512MiB", + "Name": "lyakhonov-lab4-api-1", + "NetIO": "63.5MB / 63.4MB", + "PIDs": "14" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "8.14%", + "Container": "a6106479affd1937a2a56fae0888dc2c155b382a2e1325e94c99194491109dbb", + "ID": "a6106479affd", + "MemPerc": "20.75%", + "MemUsage": "106.2MiB / 512MiB", + "Name": "lyakhonov-lab4-api-2", + "NetIO": "66.6MB / 66.6MB", + "PIDs": "14" + }, + { + "BlockIO": "0B / 2.84MB", + "CPUPerc": "2.95%", + "Container": "10138b5c0beefe8a15a6679fdad81ddac663eea21e8f63bf3ca03545c2558f20", + "ID": "10138b5c0bee", + "MemPerc": "6.88%", + "MemUsage": "35.23MiB / 512MiB", + "Name": "lyakhonov-lab4-db-1", + "NetIO": "745kB / 784kB", + "PIDs": "13" + }, + { + "BlockIO": "741kB / 0B", + "CPUPerc": "0.17%", + "Container": "e9682a892ad30d5becf1fda8abbc16770aed81f261b0843f9cb047b5085baf76", + "ID": "e9682a892ad3", + "MemPerc": "10.80%", + "MemUsage": "13.82MiB / 128MiB", + "Name": "lyakhonov-lab4-lb-1", + "NetIO": "916MB / 916MB", + "PIDs": "17" + }, + { + "BlockIO": "0B / 66.4MB", + "CPUPerc": "0.94%", + "Container": "a6482b44d70a2031a2563b1b72d955435125453a48e95087464775c918801941", + "ID": "a6482b44d70a", + "MemPerc": "40.05%", + "MemUsage": "307.6MiB / 768MiB", + "Name": "lyakhonov-lab4-s3-1", + "NetIO": "67.4MB / 861MB", + "PIDs": "21" + } + ] + }, + { + "time": 1793371467.8057384, + "containers": [ + { + "BlockIO": "0B / 0B", + "CPUPerc": "1.27%", + "Container": "68ab8db39c844427ad170edeb784590708e6fc3e69cd4abe43c05b8b6adce6d3", + "ID": "68ab8db39c84", + "MemPerc": "24.28%", + "MemUsage": "124.3MiB / 512MiB", + "Name": "lyakhonov-lab4-api-1", + "NetIO": "105MB / 105MB", + "PIDs": "14" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "1.05%", + "Container": "a6106479affd1937a2a56fae0888dc2c155b382a2e1325e94c99194491109dbb", + "ID": "a6106479affd", + "MemPerc": "21.76%", + "MemUsage": "111.4MiB / 512MiB", + "Name": "lyakhonov-lab4-api-2", + "NetIO": "98.3MB / 98.2MB", + "PIDs": "14" + }, + { + "BlockIO": "0B / 2.94MB", + "CPUPerc": "0.38%", + "Container": "10138b5c0beefe8a15a6679fdad81ddac663eea21e8f63bf3ca03545c2558f20", + "ID": "10138b5c0bee", + "MemPerc": "7.74%", + "MemUsage": "39.62MiB / 512MiB", + "Name": "lyakhonov-lab4-db-1", + "NetIO": "786kB / 824kB", + "PIDs": "15" + }, + { + "BlockIO": "741kB / 0B", + "CPUPerc": "3.99%", + "Container": "e9682a892ad30d5becf1fda8abbc16770aed81f261b0843f9cb047b5085baf76", + "ID": "e9682a892ad3", + "MemPerc": "10.54%", + "MemUsage": "13.5MiB / 128MiB", + "Name": "lyakhonov-lab4-lb-1", + "NetIO": "989MB / 989MB", + "PIDs": "17" + }, + { + "BlockIO": "0B / 108MB", + "CPUPerc": "1.47%", + "Container": "a6482b44d70a2031a2563b1b72d955435125453a48e95087464775c918801941", + "ID": "a6482b44d70a", + "MemPerc": "40.25%", + "MemUsage": "309.1MiB / 768MiB", + "Name": "lyakhonov-lab4-s3-1", + "NetIO": "109MB / 893MB", + "PIDs": "21" + } + ] + }, + { + "time": 1793371471.140233, + "containers": [ + { + "BlockIO": "0B / 0B", + "CPUPerc": "7.55%", + "Container": "68ab8db39c844427ad170edeb784590708e6fc3e69cd4abe43c05b8b6adce6d3", + "ID": "68ab8db39c84", + "MemPerc": "26.00%", + "MemUsage": "133.1MiB / 512MiB", + "Name": "lyakhonov-lab4-api-1", + "NetIO": "202MB / 202MB", + "PIDs": "14" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "7.05%", + "Container": "a6106479affd1937a2a56fae0888dc2c155b382a2e1325e94c99194491109dbb", + "ID": "a6106479affd", + "MemPerc": "25.00%", + "MemUsage": "128MiB / 512MiB", + "Name": "lyakhonov-lab4-api-2", + "NetIO": "195MB / 195MB", + "PIDs": "14" + }, + { + "BlockIO": "0B / 3.03MB", + "CPUPerc": "0.17%", + "Container": "10138b5c0beefe8a15a6679fdad81ddac663eea21e8f63bf3ca03545c2558f20", + "ID": "10138b5c0bee", + "MemPerc": "7.79%", + "MemUsage": "39.86MiB / 512MiB", + "Name": "lyakhonov-lab4-db-1", + "NetIO": "828kB / 863kB", + "PIDs": "15" + }, + { + "BlockIO": "741kB / 0B", + "CPUPerc": "10.84%", + "Container": "e9682a892ad30d5becf1fda8abbc16770aed81f261b0843f9cb047b5085baf76", + "ID": "e9682a892ad3", + "MemPerc": "10.60%", + "MemUsage": "13.57MiB / 128MiB", + "Name": "lyakhonov-lab4-lb-1", + "NetIO": "1.18GB / 1.18GB", + "PIDs": "17" + }, + { + "BlockIO": "0B / 204MB", + "CPUPerc": "0.62%", + "Container": "a6482b44d70a2031a2563b1b72d955435125453a48e95087464775c918801941", + "ID": "a6482b44d70a", + "MemPerc": "40.63%", + "MemUsage": "312.1MiB / 768MiB", + "Name": "lyakhonov-lab4-s3-1", + "NetIO": "205MB / 990MB", + "PIDs": "21" + } + ] + }, + { + "time": 1793371474.203735, + "containers": [ + { + "BlockIO": "283kB / 9.65MB", + "CPUPerc": "42.97%", + "Container": "68ab8db39c844427ad170edeb784590708e6fc3e69cd4abe43c05b8b6adce6d3", + "ID": "68ab8db39c84", + "MemPerc": "27.88%", + "MemUsage": "142.8MiB / 512MiB", + "Name": "lyakhonov-lab4-api-1", + "NetIO": "298MB / 298MB", + "PIDs": "14" + }, + { + "BlockIO": "0B / 17.4MB", + "CPUPerc": "36.05%", + "Container": "a6106479affd1937a2a56fae0888dc2c155b382a2e1325e94c99194491109dbb", + "ID": "a6106479affd", + "MemPerc": "25.02%", + "MemUsage": "128.1MiB / 512MiB", + "Name": "lyakhonov-lab4-api-2", + "NetIO": "292MB / 292MB", + "PIDs": "14" + }, + { + "BlockIO": "0B / 3.11MB", + "CPUPerc": "4.78%", + "Container": "10138b5c0beefe8a15a6679fdad81ddac663eea21e8f63bf3ca03545c2558f20", + "ID": "10138b5c0bee", + "MemPerc": "7.84%", + "MemUsage": "40.12MiB / 512MiB", + "Name": "lyakhonov-lab4-db-1", + "NetIO": "867kB / 900kB", + "PIDs": "15" + }, + { + "BlockIO": "745kB / 0B", + "CPUPerc": "12.86%", + "Container": "e9682a892ad30d5becf1fda8abbc16770aed81f261b0843f9cb047b5085baf76", + "ID": "e9682a892ad3", + "MemPerc": "10.67%", + "MemUsage": "13.66MiB / 128MiB", + "Name": "lyakhonov-lab4-lb-1", + "NetIO": "1.38GB / 1.38GB", + "PIDs": "17" + }, + { + "BlockIO": "0B / 301MB", + "CPUPerc": "27.30%", + "Container": "a6482b44d70a2031a2563b1b72d955435125453a48e95087464775c918801941", + "ID": "a6482b44d70a", + "MemPerc": "40.42%", + "MemUsage": "310.5MiB / 768MiB", + "Name": "lyakhonov-lab4-s3-1", + "NetIO": "302MB / 1.09GB", + "PIDs": "21" + } + ] + }, + { + "time": 1793371477.556512, + "containers": [ + { + "BlockIO": "631kB / 15MB", + "CPUPerc": "49.68%", + "Container": "68ab8db39c844427ad170edeb784590708e6fc3e69cd4abe43c05b8b6adce6d3", + "ID": "68ab8db39c84", + "MemPerc": "30.71%", + "MemUsage": "157.2MiB / 512MiB", + "Name": "lyakhonov-lab4-api-1", + "NetIO": "343MB / 327MB", + "PIDs": "13" + }, + { + "BlockIO": "77.8kB / 24.7MB", + "CPUPerc": "51.60%", + "Container": "a6106479affd1937a2a56fae0888dc2c155b382a2e1325e94c99194491109dbb", + "ID": "a6106479affd", + "MemPerc": "29.14%", + "MemUsage": "149.2MiB / 512MiB", + "Name": "lyakhonov-lab4-api-2", + "NetIO": "340MB / 331MB", + "PIDs": "16" + }, + { + "BlockIO": "0B / 3.18MB", + "CPUPerc": "0.99%", + "Container": "10138b5c0beefe8a15a6679fdad81ddac663eea21e8f63bf3ca03545c2558f20", + "ID": "10138b5c0bee", + "MemPerc": "7.85%", + "MemUsage": "40.21MiB / 512MiB", + "Name": "lyakhonov-lab4-db-1", + "NetIO": "890kB / 920kB", + "PIDs": "15" + }, + { + "BlockIO": "827kB / 4.1kB", + "CPUPerc": "7.90%", + "Container": "e9682a892ad30d5becf1fda8abbc16770aed81f261b0843f9cb047b5085baf76", + "ID": "e9682a892ad3", + "MemPerc": "13.49%", + "MemUsage": "17.27MiB / 128MiB", + "Name": "lyakhonov-lab4-lb-1", + "NetIO": "1.47GB / 1.47GB", + "PIDs": "17" + }, + { + "BlockIO": "0B / 301MB", + "CPUPerc": "0.29%", + "Container": "a6482b44d70a2031a2563b1b72d955435125453a48e95087464775c918801941", + "ID": "a6482b44d70a", + "MemPerc": "36.71%", + "MemUsage": "281.9MiB / 768MiB", + "Name": "lyakhonov-lab4-s3-1", + "NetIO": "302MB / 1.09GB", + "PIDs": "21" + } + ] + }, + { + "time": 1793371480.9294415, + "containers": [ + { + "BlockIO": "750kB / 15MB", + "CPUPerc": "13.86%", + "Container": "68ab8db39c844427ad170edeb784590708e6fc3e69cd4abe43c05b8b6adce6d3", + "ID": "68ab8db39c84", + "MemPerc": "27.79%", + "MemUsage": "142.3MiB / 512MiB", + "Name": "lyakhonov-lab4-api-1", + "NetIO": "395MB / 395MB", + "PIDs": "13" + }, + { + "BlockIO": "77.8kB / 24.7MB", + "CPUPerc": "1.84%", + "Container": "a6106479affd1937a2a56fae0888dc2c155b382a2e1325e94c99194491109dbb", + "ID": "a6106479affd", + "MemPerc": "26.86%", + "MemUsage": "137.5MiB / 512MiB", + "Name": "lyakhonov-lab4-api-2", + "NetIO": "389MB / 389MB", + "PIDs": "14" + }, + { + "BlockIO": "0B / 3.21MB", + "CPUPerc": "2.21%", + "Container": "10138b5c0beefe8a15a6679fdad81ddac663eea21e8f63bf3ca03545c2558f20", + "ID": "10138b5c0bee", + "MemPerc": "7.87%", + "MemUsage": "40.3MiB / 512MiB", + "Name": "lyakhonov-lab4-db-1", + "NetIO": "910kB / 942kB", + "PIDs": "15" + }, + { + "BlockIO": "827kB / 4.1kB", + "CPUPerc": "0.51%", + "Container": "e9682a892ad30d5becf1fda8abbc16770aed81f261b0843f9cb047b5085baf76", + "ID": "e9682a892ad3", + "MemPerc": "10.84%", + "MemUsage": "13.88MiB / 128MiB", + "Name": "lyakhonov-lab4-lb-1", + "NetIO": "1.57GB / 1.57GB", + "PIDs": "17" + }, + { + "BlockIO": "0B / 397MB", + "CPUPerc": "0.44%", + "Container": "a6482b44d70a2031a2563b1b72d955435125453a48e95087464775c918801941", + "ID": "a6482b44d70a", + "MemPerc": "37.20%", + "MemUsage": "285.7MiB / 768MiB", + "Name": "lyakhonov-lab4-s3-1", + "NetIO": "399MB / 1.18GB", + "PIDs": "21" + } + ] + } + ], + "cgroup_before": [ + { + "id": "68ab8db39c84", + "memory.peak": "94355456", + "memory.current": "88948736", + "cpu.stat": "usage_usec 1520787\nuser_usec 1229926\nsystem_usec 290861\nnr_periods 100\nnr_throttled 20\nthrottled_usec 838500\nnr_bursts 0\nburst_usec 0" + }, + { + "id": "a6106479affd", + "memory.peak": "94523392", + "memory.current": "89448448", + "cpu.stat": "usage_usec 1465401\nuser_usec 1200760\nsystem_usec 264641\nnr_periods 97\nnr_throttled 18\nthrottled_usec 858421\nnr_bursts 0\nburst_usec 0" + } + ], + "cgroup_after": [ + { + "id": "68ab8db39c84", + "memory.peak": "176103424", + "memory.current": "155086848", + "cpu.stat": "usage_usec 6981108\nuser_usec 5342601\nsystem_usec 1638507\nnr_periods 318\nnr_throttled 84\nthrottled_usec 4194115\nnr_bursts 0\nburst_usec 0" + }, + { + "id": "a6106479affd", + "memory.peak": "164605952", + "memory.current": "150552576", + "cpu.stat": "usage_usec 6971952\nuser_usec 5392216\nsystem_usec 1579735\nnr_periods 304\nnr_throttled 84\nthrottled_usec 4096903\nnr_bursts 0\nburst_usec 0" + } + ] +} \ No newline at end of file diff --git a/evidence/validate.txt b/evidence/validate.txt new file mode 100644 index 00000000..b6bb5737 --- /dev/null +++ b/evidence/validate.txt @@ -0,0 +1,2 @@ +.venv/Scripts/python scripts/validate_openapi.py +PASS: full OpenAPI 3.1 and JSON Schema validation; application NOT tested. diff --git a/infra/reconciliation.md b/infra/reconciliation.md new file mode 100644 index 00000000..30f3e437 --- /dev/null +++ b/infra/reconciliation.md @@ -0,0 +1,60 @@ +# Согласованность PostgreSQL и S3 + +Источник истины для доступа/связей — PostgreSQL; исходные bytes — приватный S3. +Upload принимает raw body в ограниченный временный spool (не durable storage), проверяет MIME/целостность/пиксели, +затем выбирает уникальный originals/UUID, берёт транзакционную advisory lock по ключу и выполняет S3 PUT → INSERT Attachment → COMMIT. +201 возвращается только после COMMIT. Оригинал не перекодируется. Сессия и ACL проверяются до чтения body. + +## Сбои и восстановление + +- Обрыв до PUT: временный spool закрывается, постоянного объекта нет. +- PUT не прошёл: INSERT/COMMIT не выполняются, ответ 503. +- PUT прошёл, INSERT/COMMIT не прошёл или результат COMMIT неизвестен: объект не удаляется вслепую. + Если COMMIT всё же прошёл, удаление уничтожило бы подтверждённое вложение. Reconciler после grace проверяет наличие строки заново. +- Метаданные есть, объекта нет/он повреждён: строка переводится во внутреннее missing. Публичное Attachment ready не подделывается: + GET метаданных/content даёт 503, добавление такого вложения в новое сообщение — 409. Ранее созданное сообщение и его связи остаются. +- Когда оператор вернул оригинал из резервной копии, reconciler читает реальные bytes потоково, сравнивает размер, SHA-256 и MIME. + Только совпадение возвращает ready. Сверка сама не может восстановить утраченные bytes; backup/репликация здесь не реализованы. + +## Алгоритм + +1. Время cutoff фиксируется в начале запуска. LIST обходится страницами (default 100). +2. Для каждого объекта попробовать ту же advisory lock. Активный uploader/другой reconciler приводит к skip. +3. Под блокировкой повторно прочитать метаданные; любая существующая строка сохраняет объект, даже если сообщение ещё не создано. +4. При отсутствии строки заново HEAD; только LastModified <= cutoff позволяет удаление orphan. Иначе fresh_kept. +5. Метаданные обойти keyset-страницами по UUID. Под той же блокировкой и FOR UPDATE проверить HEAD и SHA-256 тела блоками 64 KiB. + 404 означает missing, сетевой/авторизационный/серверный сбой не считается отсутствием и прерывает проход. +6. Dry-run имеет те же проверки, но не меняет ни один store. Apply атомарно фиксирует каждое изменение метаданных; + повтор после сбоя или конкурентный проход безопасен. Глобального snapshot между двумя store нет, изменения во время прохода могут попасть в следующий. + +Защита от гонки orphan/COMMIT — общая блокировка, а не только ожидание времени. +Область originals доступна на запись только приложению/оператору учебного стенда. Протокол не защищает от администратора, +который обходит advisory lock и одновременно перезаписывает/удаляет объекты. Случайная hash-коллизия вызывает лишний skip/ожидание, а не удаление используемого объекта. +Метаданные и связи сообщений алгоритм не удаляет вообще. Уникальный ключ не переиспользуется upload; PUT имеет If-None-Match: *. + +## Запуск + +```sh +# Dry-run по умолчанию: +docker compose run --rm --no-deps api python -m src.reconcile +# Применение, обычный grace 1 час: +docker compose run --rm --no-deps api python -m src.reconcile --apply +``` + +Сервис reconciler делает apply каждые 300 секунд, grace=3600 секунд; после ошибки пишет только класс ошибки и повторяет проход. +Полный цикл обнаружения старого orphan — grace + период запуска + длительность прохода; при недоступных stores SLA не гарантируется. +При benchmark сервис останавливают, затем восстанавливают, чтобы его чтение/хеширование не искажало измерения. +В тесте используются grace=5 секунд и искусственные synthetic objects; этот интервал не является эксплуатационной рекомендацией. +Минимально разрешено 5 секунд, default остаётся 3600. CPU/RAM/трафик сверки растут с количеством объектов и bytes; +RAM ограничена размером страницы и chunk, а не размером всего bucket. + +## Ограничения памяти/таймаутов API + +На реплику один upload внутри semaphore; очередь не более общего лимита 100 запросов, ожидание слота <=25 с. +Body <=10 MiB контролируется по объявленному размеру и фактически прочитанным chunks, приём <=20 с. +PNG/JPEG проверяются до декодирования по размеру <=40 млн px; Pillow verify и затем load обнаруживают повреждённые потоки. +Наихудший framebuffer порядка 160 MB на одну декодируемую картинку; API ограничена 512 MiB. Потоковый приём не означает нулевую RAM декодера. +Временный файл используется только до синхронного PUT и закрывается при ошибке; API не хранит durable оригинал на своём диске. +S3 connect=2 с, read=5 с, SDK без автоматических retry; LB client=60 с/server=45 с, без повторов POST. +Readiness требует PostgreSQL и доступного S3 LIST в рабочем prefix, Redis необязателен. После обнаружения S3-отказа LB исключает обе API; +это осознанная граница доступности всего стенда. Ошибка LB может не иметь API-заголовков/JSON. diff --git a/infra/s3-entrypoint.sh b/infra/s3-entrypoint.sh new file mode 100644 index 00000000..2134296e --- /dev/null +++ b/infra/s3-entrypoint.sh @@ -0,0 +1,5 @@ +#!/bin/sh +set -eu +export MINIO_ROOT_USER="$(cat "$MINIO_ROOT_USER_FILE")" +export MINIO_ROOT_PASSWORD="$(cat "$MINIO_ROOT_PASSWORD_FILE")" +exec minio "$@" diff --git a/requirements-research.txt b/requirements-research.txt new file mode 100644 index 00000000..d8323040 --- /dev/null +++ b/requirements-research.txt @@ -0,0 +1,2 @@ +-r requirements-dev.txt +matplotlib==3.10.7 diff --git a/scripts/actions.py b/scripts/actions.py index 4e2f15c4..a8d51e27 100644 --- a/scripts/actions.py +++ b/scripts/actions.py @@ -10,7 +10,7 @@ def compose(*args): return subprocess.check_output(base+list(args),text=True).strip() mode=sys.argv[1] if mode=='restart': - compose('restart','api','db','redis','s3','lb') + compose('restart','api','db','redis','s3','lb','reconciler') elif mode=='stop-one': target=os.environ['TARGET_INSTANCE_ID'] for cid in compose('ps','-q','api').splitlines(): diff --git a/scripts/run_upload_load.py b/scripts/run_upload_load.py new file mode 100644 index 00000000..78111518 --- /dev/null +++ b/scripts/run_upload_load.py @@ -0,0 +1,36 @@ +"""Host-side Docker CPU/RAM sampling during the real upload experiment.""" +import json +from pathlib import Path +import subprocess +import time +ROOT=Path(__file__).resolve().parents[1] +base=['docker','compose','--project-directory',str(ROOT),'-p','lyakhonov-lab4'] +def cgroups(): + ids=subprocess.check_output(base+['ps','-q','api'],text=True).split() + result=[] + for cid in ids: + code="from pathlib import Path; import json; print(json.dumps({name:Path('/sys/fs/cgroup/'+name).read_text().strip() for name in ('memory.peak','memory.current','cpu.stat')}))" + raw=subprocess.check_output(['docker','exec',cid,'python','-c',code],text=True) + result.append({'id':cid[:12],**json.loads(raw)}) + return result +subprocess.check_call(base+['stop','reconciler'],stdout=subprocess.DEVNULL) +try: + before=cgroups() + cmd=base+['run','--rm','--no-deps','-T','-v',str(ROOT)+':/suite:ro','-w','/suite','api','python','student-tests/upload_load.py'] + with (ROOT/'evidence/upload-load-output.txt').open('w',encoding='utf-8') as output: + proc=subprocess.Popen(cmd,stdout=output) + samples=[] + while proc.poll() is None: + ids=subprocess.check_output(base+['ps','-q','api','db','s3','lb'],text=True).split() + if ids: + raw=subprocess.check_output(['docker','stats','--no-stream','--format','{{json .}}']+ids,text=True) + samples.append({'time':time.time(),'containers':[json.loads(x) for x in raw.splitlines()]}) + time.sleep(.3) + if proc.returncode: raise SystemExit(proc.returncode) + text=(ROOT/'evidence/upload-load-output.txt').read_text(encoding='utf-8').strip() + result=json.loads(text.splitlines()[-1]); result['samples']=samples + result['cgroup_before']=before; result['cgroup_after']=cgroups() + (ROOT/'evidence/upload-load.json').write_text(json.dumps(result,indent=2),encoding='utf-8') +finally: + subprocess.check_call(base+['start','reconciler'],stdout=subprocess.DEVNULL) +print('PASS: upload experiment and Docker CPU/RAM samples saved; batches:',len(result['runs'])) diff --git a/src/reconcile.py b/src/reconcile.py new file mode 100644 index 00000000..bb076103 --- /dev/null +++ b/src/reconcile.py @@ -0,0 +1,118 @@ +"""Repeatable bounded-memory reconciliation. Dry-run is the default.""" +import argparse +from collections import Counter +from datetime import datetime, timezone +import hashlib +import json +import time +from botocore.exceptions import ClientError +from src.objects import client, BUCKET, object_lock +from src.storage import storage + +def absent(exc): + return exc.response['Error']['Code'] in ('404','NoSuchKey','NotFound') + +def reconcile(apply=False,grace_seconds=3600,page_size=100,output=None): + if grace_seconds<5 or not 1<=page_size<=1000: + raise ValueError('grace must be >=5 seconds; page size 1..1000') + started=time.monotonic(); s3=client(); counts=Counter() + # Fixed cutoff at run start protects objects created during the traversal. + cutoff=datetime.now(timezone.utc).timestamp()-grace_seconds + # Streaming listing; no full bucket/object-body materialization. + paginator=s3.get_paginator('list_objects_v2') + for page in paginator.paginate(Bucket=BUCKET,Prefix='originals/',PaginationConfig={'PageSize':page_size}): + counts['list_requests']+=1 + for obj in page.get('Contents',[]): + counts['objects_scanned']+=1; key=obj['Key'] + with storage.pool.connection() as conn: + if not object_lock(conn,key,wait=False): + counts['locked_skipped']+=1; continue + row=conn.execute('SELECT id FROM attachments WHERE object_key=%s',(key,)).fetchone() + if row: + counts['referenced_kept']+=1; continue + counts['head_requests']+=1 + try: head=s3.head_object(Bucket=BUCKET,Key=key) + except ClientError as exc: + if absent(exc): continue + raise + if head['LastModified'].timestamp()>cutoff: + counts['fresh_kept']+=1; continue + counts['orphan_candidates']+=1 + if apply: + # Only application/reconciler may write this namespace; both hold this lock. + s3.delete_object(Bucket=BUCKET,Key=key) + counts['objects_deleted']+=1 + # Keyset pages keep RAM bounded even for a large metadata table. + last='00000000-0000-0000-0000-000000000000' + while True: + with storage.pool.connection() as conn: + rows=conn.execute('SELECT id,object_key FROM attachments WHERE id>%s ORDER BY id LIMIT %s',(last,page_size)).fetchall() + if not rows: break + counts['db_pages']+=1 + for item in rows: + last=str(item['id']); counts['metadata_scanned']+=1 + with storage.pool.connection() as conn: + if not object_lock(conn,item['object_key'],wait=False): + counts['locked_skipped']+=1; continue + row=conn.execute('SELECT * FROM attachments WHERE id=%s FOR UPDATE',(item['id'],)).fetchone() + if not row: continue + counts['head_requests']+=1 + try: + head=s3.head_object(Bucket=BUCKET,Key=row['object_key']) + except ClientError as exc: + if not absent(exc): raise + counts['missing_objects']+=1 + if row['state']=='ready': + counts['mark_missing_candidates']+=1 + if apply: + conn.execute("UPDATE attachments SET state='missing',updated_at=clock_timestamp() WHERE id=%s",(row['id'],)) + counts['metadata_marked_missing']+=1 + continue + # Verify actual bytes, never trust an ETag or user-provided hash metadata. + digest=hashlib.sha256(); size=0 + counts['get_requests']+=1 + obj=s3.get_object(Bucket=BUCKET,Key=row['object_key']) + try: + for chunk in obj['Body'].iter_chunks(64*1024): + size+=len(chunk); counts['bytes_verified']+=len(chunk) + if size>10*1024*1024: break + digest.update(chunk) + finally: obj['Body'].close() + valid=(size==row['size_bytes'] and digest.hexdigest()==row['sha256'] and head['ContentType']==row['content_type']) + desired='ready' if valid else 'missing' + counts['valid_objects' if valid else 'corrupt_objects']+=1 + if desired!=row['state']: + counts['restore_candidates' if valid else 'mark_missing_candidates']+=1 + if apply: + conn.execute('UPDATE attachments SET state=%s,updated_at=clock_timestamp() WHERE id=%s',(desired,row['id'])) + counts['metadata_restored' if valid else 'metadata_marked_missing']+=1 + result={'apply':apply,'grace_seconds':grace_seconds,'page_size':page_size, + 'elapsed_seconds':round(time.monotonic()-started,6),'counts':dict(counts)} + if output: + from pathlib import Path + Path(output).write_text(json.dumps(result,indent=2),encoding='utf-8') + return result + +def main(): + parser=argparse.ArgumentParser(description=__doc__) + parser.add_argument('--apply',action='store_true') + parser.add_argument('--grace-seconds',type=int,default=3600) + parser.add_argument('--page-size',type=int,default=100) + parser.add_argument('--interval',type=int,default=0,help='repeat every N seconds, 0 = one shot') + args=parser.parse_args() + if args.interval and args.interval<5: + parser.error('interval must be >=5 seconds') + storage.pool.open(wait=True) + try: + while True: + try: + print(json.dumps(reconcile(args.apply,args.grace_seconds,args.page_size)),flush=True) + except Exception as exc: + # Do not log endpoint URLs, DSNs, object keys or credentials. + print(json.dumps({'result':'failed','error_type':type(exc).__name__}),flush=True) + if not args.interval: raise SystemExit(1) from None + if not args.interval: break + time.sleep(args.interval) + finally: storage.pool.close() + +if __name__=='__main__': main() diff --git a/src/routes/attachments.py b/src/routes/attachments.py index 3461724e..e3ca1325 100644 --- a/src/routes/attachments.py +++ b/src/routes/attachments.py @@ -9,6 +9,7 @@ from PIL import Image, UnidentifiedImageError from fastapi import APIRouter, Depends, HTTPException, Request from starlette.concurrency import run_in_threadpool from starlette.responses import StreamingResponse +from starlette.requests import ClientDisconnect from src.routes.common import require_user, make_error, get_request_id from src.storage import storage, timestamp from src.objects import client, BUCKET, object_lock @@ -99,6 +100,8 @@ async def upload(request:Request,chat_id:uuid.UUID,filename:str='',actor:str=Dep await asyncio.wait_for(receive(),timeout=20) await run_in_threadpool(stream.seek,0) await run_in_threadpool(inspect_image,stream,mime) + except ClientDisconnect: + raise error(request,400,'invalid_request','upload disconnected') from None except asyncio.TimeoutError: raise error(request,400,'invalid_request','upload timed out') from None except InvalidImage as exc: @@ -123,6 +126,8 @@ def get_attachment(request:Request,attachment_id:uuid.UUID,actor:str=Depends(req @router.get('/api/v1/attachments/{attachment_id}/content') def content(request:Request,attachment_id:uuid.UUID,variant:str='original',actor:str=Depends(require_user)): row=accessible(request,attachment_id,actor) + if variant not in ('original','thumbnail','crop','optimized'): + raise error(request,400,'invalid_request','invalid variant') if variant!='original': raise error(request,404,'not_found','variant not found') obj=client().get_object(Bucket=BUCKET,Key=row['object_key']) diff --git a/student-tests/test_attachments.py b/student-tests/test_attachments.py new file mode 100644 index 00000000..1ae780fc --- /dev/null +++ b/student-tests/test_attachments.py @@ -0,0 +1,105 @@ +"""Real HTTP negative/transaction tests against the isolated lab4 stack.""" +import base64 +from concurrent.futures import ThreadPoolExecutor +import hashlib +import http.client +import io +import json +from pathlib import Path +import socket +import sys +import time +from urllib.parse import quote +import uuid +sys.path.insert(0,str(Path(__file__).resolve().parents[1])) +sys.path.insert(0,str(Path(__file__).resolve().parents[1]/'tests')) +from client import Client, check +from PIL import Image +from botocore import UNSIGNED +from botocore.config import Config +from botocore.exceptions import ClientError +import boto3 +from src.storage import storage +from src.objects import client,BUCKET + +def main(): + c=Client('http://lb:8080',timeout=40) + alice,bob,eve,chat=c.bootstrap(); path='/api/v1/chats/'+chat['id'] + png=(Path('tests/fixtures/sample.png')).read_bytes() + def upload(data=png,mime='image/png',filename='sample.png',expected=201): + return c.call('POST',path+'/attachments?filename='+quote(filename,safe=''),expected, + actor=alice,raw=data,headers={'Content-Type':mime},schema='Attachment' if expected==201 else None) + att=upload()['json'] + for name in ('../x.png','a\\b.png','a/b.png','a\x00.png','a\n.png',''): + upload(filename=name,expected=400) + upload(data=b'not an image',expected=415) + upload(data=png[:100],expected=415) + upload(mime='image/jpeg',expected=415) + upload(mime='application/octet-stream',expected=415) + upload(data=b'x'*(10*1024*1024+1),expected=413) + # Chunked body exercises the streaming limit with no Content-Length. + connection=http.client.HTTPConnection('lb',8080,timeout=30) + connection.request('POST',path+'/attachments?filename=chunked.png',body=iter([b'x'*1048576]*11), + headers={'Authorization':'Bearer '+alice['token'],'Content-Type':'image/png'},encode_chunked=True) + response=connection.getresponse(); payload=json.loads(response.read()); connection.close() + check(response.status==413 and payload['error']['code']=='payload_too_large','chunked byte limit failed') + # Pixel limit checked before decompression. No huge fixture stored in Git. + image=Image.new('L',(8001,5000)); buff=io.BytesIO(); image.save(buff,format='PNG') + upload(data=buff.getvalue(),expected=413) + del image,buff + image=Image.new('RGB',(8000,5000),(1,2,3)); buff=io.BytesIO(); image.save(buff,format='PNG') + upload(data=buff.getvalue()); del image,buff + buff=io.BytesIO(); Image.new('RGB',(48,32),(90,20,10)).save(buff,format='JPEG') + jpeg=buff.getvalue(); j=upload(data=jpeg,mime='image/jpeg',filename='фото.jpg')['json'] + check(c.call('GET','/api/v1/attachments/'+j['id']+'/content',actor=bob)['bytes']==jpeg,'JPEG changed') + upload(data=jpeg[:-20],mime='image/jpeg',expected=415) + c.call('GET','/api/v1/attachments/'+att['id']+'/content?variant=thumbnail',404,actor=bob) + c.call('GET','/api/v1/attachments/'+att['id']+'/content?variant=unknown',400,actor=bob) + c.call('POST',path+'/messages',404,actor=alice,body={'text':'','attachment_ids':[str(uuid.uuid4())]},headers={'Idempotency-Key':uuid.uuid4().hex}) + other=c.call('POST','/api/v1/chats',201,actor=alice,body={'title':'other','member_ids':[alice['id'],bob['id']]},schema='Chat')['json'] + c.call('POST','/api/v1/chats/'+other['id']+'/messages',404,actor=alice,body={'text':'','attachment_ids':[att['id']]},headers={'Idempotency-Key':uuid.uuid4().hex}) + c.call('POST',path+'/messages',400,actor=alice,body={'text':'','attachment_ids':[att['id'],att['id']]},headers={'Idempotency-Key':uuid.uuid4().hex}) + key=uuid.uuid4().hex + with ThreadPoolExecutor(max_workers=16) as pool: + messages=list(pool.map(lambda _:Client('http://lb:8080',timeout=40).message(alice,chat,'',key=key,attachments=[att['id']])['json'],range(16))) + check(len({m['id'] for m in messages})==1,'concurrent attachment retry duplicated') + c.call('POST',path+'/messages',409,actor=alice,body={'text':'','attachment_ids':[j['id']]},headers={'Idempotency-Key':key}) + text_key=uuid.uuid4().hex + m=c.message(alice,chat,'semantic equality',key=text_key)['json'] + check(c.message(alice,chat,'semantic equality',key=text_key,attachments=[])['json']==m,'default [] differs') + # Direct unauthenticated bucket read must fail. No public S3 host port needed. + storage.pool.open(wait=True) + s3=client() + with storage.pool.connection() as conn: + row=conn.execute('SELECT object_key FROM attachments WHERE id=%s',(att['id'],)).fetchone() + unsigned=boto3.client('s3',endpoint_url='http://s3:9000',config=Config(signature_version=UNSIGNED)) + try: unsigned.get_object(Bucket=BUCKET,Key=row['object_key']) + except ClientError as exc: check(exc.response['ResponseMetadata']['HTTPStatusCode']==403,'unsigned wrong error') + else: raise AssertionError('public object') + for operation in (lambda:s3.list_buckets(),lambda:s3.put_object(Bucket=BUCKET,Key='outside-prefix',Body=b'x'),lambda:s3.delete_bucket(Bucket=BUCKET)): + try: operation() + except ClientError as exc: check(exc.response['ResponseMetadata']['HTTPStatusCode']==403,'policy wrong error') + else: raise AssertionError('excessive app S3 privileges') + # Real TCP disconnect before declared length: no S3 PUT or metadata commit. + before=sum(1 for page in s3.get_paginator('list_objects_v2').paginate(Bucket=BUCKET,Prefix='originals/') for _ in page.get('Contents',[])) + sock=socket.create_connection(('lb',8080)) + header=('POST '+path+'/attachments?filename=abort.png HTTP/1.1\r\nHost: lb\r\nAuthorization: Bearer '+alice['token']+'\r\nContent-Type: image/png\r\nContent-Length: 1000000\r\n\r\n').encode() + sock.sendall(header+png[:100]); sock.close(); time.sleep(1) + after=sum(1 for page in s3.get_paginator('list_objects_v2').paginate(Bucket=BUCKET,Prefix='originals/') for _ in page.get('Contents',[])) + check(before==after,'interrupted upload created object') + # Inject DB failure AFTER a real S3 PUT, restricted to this new synthetic chat. + with storage.pool.connection() as conn: + conn.execute("CREATE OR REPLACE FUNCTION lab4_test_failure() RETURNS trigger LANGUAGE plpgsql AS $$ BEGIN IF NEW.chat_id='"+chat['id']+"'::uuid THEN RAISE EXCEPTION 'synthetic failure'; END IF; RETURN NEW; END $$") + conn.execute('CREATE TRIGGER lab4_test_failure BEFORE INSERT ON attachments FOR EACH ROW EXECUTE FUNCTION lab4_test_failure()') + try: upload(expected=500) + finally: + with storage.pool.connection() as conn: + conn.execute('DROP TRIGGER IF EXISTS lab4_test_failure ON attachments') + conn.execute('DROP FUNCTION IF EXISTS lab4_test_failure()') + after_failure=sum(1 for page in s3.get_paginator('list_objects_v2').paginate(Bucket=BUCKET,Prefix='originals/') for _ in page.get('Contents',[])) + check(after_failure==after+1,'did not exercise S3/DB gap') + upload() + storage.pool.close() + print(json.dumps({'result':'PASS','concurrent_retries':16,'failure_after_s3_put':True,'interrupted_upload_no_object':True,'private_bucket':True,'restricted_credentials':True})) + +if __name__=='__main__': main() diff --git a/student-tests/upload_load.py b/student-tests/upload_load.py new file mode 100644 index 00000000..d5937106 --- /dev/null +++ b/student-tests/upload_load.py @@ -0,0 +1,54 @@ +"""Ten simultaneous HTTP uploads, bounded synthetic PNGs, no retries.""" +from concurrent.futures import ThreadPoolExecutor +import hashlib +import io +import json +from pathlib import Path +import random +import statistics +import sys +import threading +import time +sys.path.insert(0,str(Path(__file__).resolve().parents[1]/'tests')) +from client import Client,check +from PIL import Image + +def percentile(values,p): + if not values: return None + values=sorted(values); pos=(len(values)-1)*p; lo=int(pos); hi=min(lo+1,len(values)-1) + return values[lo]+(values[hi]-values[lo])*(pos-lo) + +def main(): + c=Client('http://lb:8080',timeout=40) + alice,bob,eve,chat=c.bootstrap() + results=[] + for side in (1024,1792): + rng=random.Random(2301+side) + image=Image.frombytes('RGB',(side,side),rng.randbytes(side*side*3)) + buff=io.BytesIO(); image.save(buff,format='PNG'); data=buff.getvalue(); del image,buff + check(len(data)<=10*1024*1024,'invalid benchmark size') + # Warmup separately; no retry hides transient failures. + c.call('POST','/api/v1/chats/'+chat['id']+'/attachments?filename=warmup.png',201,actor=alice,raw=data,headers={'Content-Type':'image/png'},schema='Attachment') + for repeat in range(3): + barrier=threading.Barrier(11); start_event=threading.Event() + def task(_): + local=Client('http://lb:8080',timeout=40); barrier.wait(); start_event.wait(); started=time.monotonic() + try: + att=local.call('POST','/api/v1/chats/'+chat['id']+'/attachments?filename=load.png',201,actor=alice,raw=data,headers={'Content-Type':'image/png'},schema='Attachment')['json'] + check(att['sha256']==hashlib.sha256(data).hexdigest(),'bad checksum') + return {'ok':True,'seconds':time.monotonic()-started,'id':att['id']} + except Exception as exc: + return {'ok':False,'seconds':time.monotonic()-started,'error':type(exc).__name__} + with ThreadPoolExecutor(max_workers=10) as pool: + futures=[pool.submit(task,i) for i in range(10)] + barrier.wait(); started=time.monotonic(); start_event.set() + rows=[future.result() for future in futures] + elapsed=time.monotonic()-started + times=[r['seconds'] for r in rows if r['ok']] + for row in rows: + if row['ok']: + check(c.call('GET','/api/v1/attachments/'+row['id']+'/content',actor=bob)['bytes']==data,'confirmed upload not durable') + results.append({'size_bytes':len(data),'side':side,'repeat':repeat+1,'concurrency':10,'attempts':10,'successes':len(times),'errors':10-len(times),'elapsed_seconds':elapsed,'successful_rps':len(times)/elapsed,'p50_seconds':percentile(times,.5),'p95_seconds':percentile(times,.95),'p99_seconds':percentile(times,.99)}) + print(json.dumps({'result':'PASS' if all(r['errors']==0 for r in results) else 'FAIL','profile':'closed-loop batch, 10 simultaneous uploads, 3 repeats per size, 1 warmup, all confirmed originals downloaded','runs':results})) + check(all(r['errors']==0 for r in results),'upload failures') +if __name__=='__main__': main() -- 2.54.0 From 6c87ed2eba11e7f7d8a58aaab9844b8d202b4c46 Mon Sep 17 00:00:00 2001 From: Sergey Lyakhonov Date: Fri, 30 Oct 2026 17:54:00 +0300 Subject: [PATCH 4/5] =?UTF-8?q?=D0=97=D0=B0=D0=B2=D0=B5=D1=80=D1=88=D0=B8?= =?UTF-8?q?=D1=82=D1=8C=20=D1=82=D1=80=D0=B5=D0=BA=202:=20=D0=B4=D0=BE?= =?UTF-8?q?=D0=BA=D0=B0=D0=B7=D0=B0=D1=82=D1=8C=20=D1=81=D0=BE=D0=B3=D0=BB?= =?UTF-8?q?=D0=B0=D1=81=D0=BE=D0=B2=D0=B0=D0=BD=D0=BD=D0=BE=D1=81=D1=82?= =?UTF-8?q?=D1=8C=20=D1=85=D1=80=D0=B0=D0=BD=D0=B8=D0=BB=D0=B8=D1=89=20?= =?UTF-8?q?=D0=B8=20=D0=BE=D1=84=D0=BE=D1=80=D0=BC=D0=B8=D1=82=D1=8C=20?= =?UTF-8?q?=D0=B3=D1=80=D0=B0=D1=84=D0=B8=D0=BA=D0=B8=20=D0=B8=20=D0=BE?= =?UTF-8?q?=D1=82=D1=87=D1=91=D1=82?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .github/workflows/application.yml | 1 + REPORT.md | 272 ++- compose.yaml | 2 + evidence/figures/reconcile-cost.png | Bin 0 -> 80383 bytes evidence/figures/reconcile-cost.svg | 2322 ++++++++++++++++++++++++ evidence/figures/upload-memory.png | Bin 0 -> 58940 bytes evidence/figures/upload-memory.svg | 1715 +++++++++++++++++ evidence/figures/upload-throughput.png | Bin 0 -> 82574 bytes evidence/figures/upload-throughput.svg | 2006 ++++++++++++++++++++ evidence/reconcile.json | 1 + evidence/runtime.json | 99 + evidence/sources-manifest.json | 27 + evidence/summary-output.txt | 90 + evidence/summary.json | 90 + evidence/upload-summary.csv | 7 + lab4.env.example | 8 + scripts/bootstrap.py | 6 +- scripts/plot_results.py | 68 + student-tests/README.md | 56 + student-tests/test_reconcile.py | 82 + 20 files changed, 6831 insertions(+), 21 deletions(-) create mode 100644 evidence/figures/reconcile-cost.png create mode 100644 evidence/figures/reconcile-cost.svg create mode 100644 evidence/figures/upload-memory.png create mode 100644 evidence/figures/upload-memory.svg create mode 100644 evidence/figures/upload-throughput.png create mode 100644 evidence/figures/upload-throughput.svg create mode 100644 evidence/reconcile.json create mode 100644 evidence/runtime.json create mode 100644 evidence/sources-manifest.json create mode 100644 evidence/summary-output.txt create mode 100644 evidence/summary.json create mode 100644 evidence/upload-summary.csv create mode 100644 lab4.env.example create mode 100644 scripts/plot_results.py create mode 100644 student-tests/README.md create mode 100644 student-tests/test_reconcile.py diff --git a/.github/workflows/application.yml b/.github/workflows/application.yml index 7ac092b9..e2098231 100644 --- a/.github/workflows/application.yml +++ b/.github/workflows/application.yml @@ -16,6 +16,7 @@ jobs: - run: docker compose up -d - run: python scripts/wait_ready.py --base-url http://localhost:8084 --replicas 2 - run: make check test PYTHON=python BASE_URL=http://localhost:8084 + - run: docker compose stop reconciler - run: docker compose run --rm --no-deps -T -v "$PWD:/suite:ro" -w /suite api python student-tests/test_attachments.py - run: docker compose run --rm --no-deps -T -v "$PWD:/suite:ro" -w /suite api python student-tests/test_reconcile.py - run: chmod +x scripts/restart.sh scripts/stop-one.sh diff --git a/REPORT.md b/REPORT.md index 9ad2b84f..e0558414 100644 --- a/REPORT.md +++ b/REPORT.md @@ -1,37 +1,269 @@ -# Отчёт — лабораторная 4 +# Отчёт — лабораторная работа №4 -- Автор, группа: TODO -- Целевая оценка; выбранный трек 5, если нужен: TODO -- Commit/PR: TODO после публикации -- Использованные источники, библиотеки и помощь ИИ: TODO +Автор: **Ляхонов Сергей**, группа **БВТ2301**. Дата: **30 октября 2026 года**. +Целевая оценка: **5**, выбран **трек 2 — согласованность двух хранилищ**. Пользователь выбрал трек до реализации. +Ветка: `solution/BVT2301-lyakhonov`. Только локальные русскоязычные коммиты; push и PR не выполнялись. ## Запуск из чистого clone -TODO: версии runtime/образов, prerequisites, команды создания локальных secrets/.env, build, миграций, запуска, ожидания готовности, тестов и остановки. Указать необходимые действия оператора. Не вставлять секреты. Отдельно указать безопасную остановку и команду намеренного удаления учебных данных. +Нужны Docker Engine/Compose с Linux-контейнерами, Python 3.9+ и make (либо прямые эквивалентные Python-команды ниже). +Проверено: Windows, Python хоста 3.13.7, Docker Engine 28.5.1 / Docker Desktop, i5-1340P, 16 логических CPU и 16 GB RAM. +Docker VM: 16 CPU, 8 126 664 704 bytes RAM. См. [CPU](evidence/cpu.json), [RAM](evidence/hardware.json), [Docker](evidence/docker-resources.json). +Для сборки исходников S3 и всех экспериментов разумно выделить Docker около 8 GB RAM и иметь около 10 GB свободного диска под build cache/образы/учебные данные. +Постоянные runtime-лимиты стенда: суммарно 4 CPU и 2816 MiB; генератор и одноразовые сервисы требуют дополнительного ресурса. +Это лимиты, а не гарантированное фактическое потребление. -## Архитектура и решения +PowerShell, из корня лабораторной 4: -TODO: схема процессов/хранилищ, источник истины, транзакционные границы, ограничения. Что перенесено из lab3, что изменено в этой работе. Соответствие переменных из .env.example реальной конфигурации. +```powershell +$env:PYTHONUTF8='1' +python scripts/bootstrap.py +docker compose --env-file .env config --quiet +docker compose --env-file .env build api s3 +docker compose --env-file .env up -d +python scripts/wait_ready.py --base-url http://localhost:8084 --replicas 2 +make check test PYTHON=python BASE_URL=http://localhost:8084 +python -m venv .venv +.venv/Scripts/python -m pip install -r requirements-research.txt +make validate PYTHON=.venv/Scripts/python +``` + +Bootstrap создаёт случайные DB/S3 secrets и `.env` из `lab4.env.example` **только при отсутствии**; существующие файлы сохраняются. +Пароли и ключи не выводятся и не попадают в Git. Отдельный migrate применяет версии 001–003 под advisory lock до старта API. +Bucket-init создаёт приватный bucket и ограниченного пользователя приложения; повтор безопасен. +Все зависимости запускаются из этого репозитория; установленные ранее БД/S3 не используются. + +Реестр отказал в скачивании официальных образов MinIO/mc (Docker Hub denied, Quay 401), поэтому окончательный стенд +собирает S3 из исходников через `Dockerfile.s3`: MinIO commit `07c3a429bfed433e49018cb0f78a52145d4bedeb` +(исходники RELEASE.2025-09-07T16-13-09Z), mc RELEASE.2025-04-16T18-13-26Z. +Оба архива закреплены SHA-256 в ADD; Go и Debian закреплены digest, Go-зависимости проверяются go.sum. +Первичная сборка реально прошла, повтор использует build cache. Нужен доступ к GitHub, Docker Hub и Go module proxy; +наличие локального старого MinIO-образа не требуется. Версия самосборного бинарника может выводиться как DEVELOPMENT.GOGET; +точная идентичность задаётся commit и архивом, не этой строкой. Лицензии MinIO/mc AGPL включены в образ. +[Контрольные суммы](evidence/s3-source-hashes.json), [рецепт](Dockerfile.s3). + +Остановка без удаления данных: `docker compose down`. Стенд №3 не затрагивается. +Только при намеренном удалении собственных учебных данных: `docker compose down --volumes`. +Последняя команда необратима; в проверках она не используется. Внешние volumes и чужие Compose projects не удаляются. +На POSIX использовать python3 и executable `.sh` hooks (`chmod +x scripts/restart.sh scripts/stop-one.sh`). + +## Архитектура и конфигурация + +```mermaid +flowchart LR + Client[Клиент] --> LB[HAProxy localhost:8084] + LB --> API1[API 1] + LB --> API2[API 2] + API1 --> DB[(PostgreSQL: метаданные и сессии)] + API2 --> DB + API1 --> S3[(MinIO: приватные оригиналы)] + API2 --> S3 + API1 --> Redis[(Redis: необязательный кэш профилей)] + API2 --> Redis + Reconciler[Периодическая сверка] --> DB + Reconciler --> S3 +``` + +| Роль → service | Версия / CPU / RAM | Готовность / durable state / доступ | +| --- | --- | --- | +| API → api ×2 | Python 3.11.10, lock dependencies; 0.5 CPU / 512 MiB каждая | `/health/ready`: PostgreSQL + S3; без durable локальных оригиналов; только внутренняя сеть | +| БД → db | PostgreSQL 16.6-alpine; 1 CPU / 512 MiB | pg_isready; отдельный postgres_data; порт не опубликован | +| S3 → s3 | Собственная сборка из закреплённых исходников; 1 CPU / 768 MiB | bootstrap ждёт S3; API проверяет LIST рабочего prefix; отдельный s3_data; без внешних портов | +| LB → lb | HAProxy 3.0.6-alpine; 0.5 CPU / 128 MiB | HTTP readiness API; только 127.0.0.1:8084 | +| Кэш → redis | Redis 7.4.1-alpine; 0.25 CPU / 128 MiB | Необязателен; профили, без сессий/истории; persistence отключён | +| Миграции → migrate | Тот же исходный образ; 0.5 CPU / 512 MiB | Одноразовый exit 0 до API, schema_migrations | +| Bucket bootstrap → bucket-init | Тот же S3-образ, mc; 0.25 CPU / 128 MiB | Одноразовый exit 0; приватность и политика; root secrets доступны только здесь и S3 | +| Сверка → reconciler | Тот же исходный образ; 0.25 CPU / 256 MiB | Apply каждые 300 с, grace 3600 с; отдельный процесс, restart unless-stopped | + +Compose project `lyakhonov-lab4`, собственные сеть, `lyakhonov-lab4_postgres_data`, `lyakhonov-lab4_s3_data`, +образы `lyakhonov-messenger:lab4` и `lyakhonov-storage:lab4`. Нет container_name и наружных портов API/БД/S3/Redis. +Консоль MinIO слушает только loopback самого S3-контейнера. Пароли передаются через read-only Compose secrets files. +Приложение имеет S3 LIST только своего bucket/prefix и Get/Put/Delete только `attachments/originals/*`; +не имеет административного доступа, list buckets, delete bucket или записи вне prefix. Bucket — `attachments`, публичного чтения нет. +API работает без root. Единственные PostgreSQL, S3, LB и Docker-host остаются SPOF. + +`lab4.env.example` задаёт реальные пользовательские параметры LAB4_PORT, API_REPLICAS, API_CPUS, API_MEMORY, +POOL_SIZE, SESSION_TTL_SECONDS и OPTIMIZED_WRITES. Исходный `.env.example` skeleton сохранён как список логических интерфейсов: +APP_HOST/APP_PORT соответствуют фиксированному listener 0.0.0.0:8080; APP_ENV не используется; SESSION_STORE=postgres фиксирован; +CACHE_URL_FILE заменён внутренним CACHE_URL=redis://redis:6379/0; DATABASE_URL_FILE совпадает. +S3_ENDPOINT и регион совпадают; S3_BUCKET в решении фиксирован `attachments` вместо предложенного messenger-attachments. +S3_ACCESS_KEY_ID_FILE/S3_SECRET_ACCESS_KEY_FILE отображаются на внутренние S3_ACCESS_KEY_FILE/S3_SECRET_KEY_FILE. +IDEMPOTENCY_TTL_SECONDS=86400, MAX_UPLOAD_BYTES=10485760, MAX_IMAGE_PIXELS=40000000 — обязательные фиксированные лимиты, +не произвольные пользовательские настройки. Изменение старого `.env.example` не меняет эти внутренние значения. + +## Перенос и границы транзакций + +Источник: собственная лабораторная №3, HEAD `374c43e`, только чтение. Оба рабочих дерева до начала были чистыми. +Перенесены исходники, миграции, зависимости, Dockerfile и необходимые конфигурации/scripts. +README, COURSE, обязательные contracts, публичные tests и fixture лабораторной №4 сохранены. +Не переносились .git, .env, secrets, volumes, venv, старые измерения/графики. [Акт переноса](evidence/transfer.md). + +Сохранены PostgreSQL-сессии, Argon2id, ACL чатов, пагинация, две реплики и общая транзакционная идемпотентность. +В отличие от lab3, Message теперь всегда содержит attachment_ids; допускает пустой текст с вложениями. +Ключ сравнивает полный нормализованный body, включая порядок ID; отсутствующее attachment_ids равно []. +Результат ключа, Message и связи вложений фиксируются атомарно. Конкурентные повторы сериализуются общей блокировкой. +Миграция 003 переносит старые текстовые результаты ключей в JSON и добавляет Attachment/message_attachments. +Обратное смешивание lab3/lab4 API после этой миграции не поддерживается: требуется согласованный переход. +В этой работе использован новый отдельный volume, исходная БД lab3 не изменялась. + +Upload: авторизация/ACL → bounded temporary spool → MIME/размер/пиксели/verify/load → уникальный S3 PUT → INSERT → COMMIT → 201 ready. +Оригинал сохраняется побайтно. Приём <=10 MiB, <=40 млн px; один декодер на реплику, <=20 с на body, <=25 с ожидания слота. +Только временный spool живёт локально до PUT; download читает S3 блоками 64 KiB без redirect. +S3 timeout connect=2/read=5 с и без retry, LB client=60/server=45 с и без повторов POST. +Неопределённый COMMIT не вызывает слепое удаление объекта. Подробный протокол и инварианты: [infra/reconciliation.md](infra/reconciliation.md). ## Доказательства критериев -| Критерий README | Команда/сценарий | Наблюдаемый результат | Файл доказательства | +| Критерий | Команда/сценарий | Реальный результат / доказательство | +| --- | --- | --- | +| Обязательная база lab3 и контракт lab4 | make check/test/validate | PASS: [make](evidence/make-check-test.txt), [validate](evidence/validate.txt) | +| Upload 201 ready, сообщение, checksum, ACL | публичный smoke | PASS: [smoke](evidence/smoke.txt); PNG/JPEG неизменны | +| ≥2 API, остановка именно загрузившей реплики | python student-tests/test_operations.py | Обе разные реальные реплики остановлены по очереди; другой процесс вернул оригинал: [JSON](evidence/operations.json) | +| Retry и сохранность при failover | публичный resilience --mode failover | PASS, ошибки перехода учтены: [1](evidence/failover-1.txt), [2](evidence/failover-2.txt) | +| Рестарт с volumes и прежней сессией | публичный persistence + test_operations.py | PASS, реальные StartedAt до/после API/БД/Redis/S3/LB: [persistence](evidence/persistence.txt), [operations](evidence/operations.json) | +| S3 недоступен / восстановлен | test_operations.py | Ограниченный 503, после восстановления те же bytes и сессия | +| Bytes/пиксели/MIME/filename/повреждения | test_attachments.py | PASS, включая chunked body >10 MiB, >40 млн px и допустимые ровно 40 млн px: [negative suite](evidence/attachments.txt) | +| Чужой ID, другой чат, дубли ID | test_attachments.py | 404/400, без 500 | +| Обрыв body | реальный TCP disconnect | Постоянный объект не создан | +| Сбой после PUT до INSERT | ограниченный synthetic DB trigger | Получен 500, объект найден сверкой как orphan; trigger снят в finally | +| Ограничение RAM при ≥10 загрузках | python scripts/run_upload_load.py | 60/60 успешно, два размера, cgroup peak и Docker stats: [raw](evidence/upload-load.json), [CSV](evidence/upload-summary.csv) | +| Приватность и минимальные S3-права | unsigned GET + запрещённые S3 API | 403; отдельные credentials приложения: [suite](evidence/attachments.txt) | +| Идемпотентный bucket bootstrap | docker compose run --rm --no-deps bucket-init | Повтор exit 0: [вывод](evidence/bootstrap-repeat.txt) | +| Orphan/missing/corrupt | test_reconcile.py | Найдены; old orphan удалены; missing/corrupt изолированы без удаления метаданных | +| Dry-run, повтор и конкуренция | test_reconcile.py | Все метаданные до/после dry-run совпали; блокировка/свежесть/ссылки сохранены; два прохода безопасны | +| Безопасное восстановление | неверный, затем правильный оригинал | Неверные bytes не вернули ready; проверенный оригинал восстановил его: [исследование](evidence/reconcile.json) | +| Стоимость обхода | 0/50/200 дополнительных объектов ×3 | Время, LIST/HEAD/GET и bytes измерены, график ниже | + +## Эксперимент загрузки и память + +Фиксированный seed, PNG RGB 1024² и 1792², один прогрев на размер. Три партии по 10 клиентов на размер через LB, +прозрачных retry нет. Клиенты готовы до начала измерительного окна; все одновременно отпускаются event. +Суммарное timed elapsed для шести партий — 6.966 с; это короткий опыт, не steady-state soak test. +Elapsed включает завершение всех запросов, не подготовку клиентов и не последующее скачивание подтверждённых оригиналов. +p50/p95/p99 интерполируются линейно по успешным запросам; при 10 наблюдениях хвост оценён грубо. +Генератор — отдельный контейнер с 0.5 CPU / 512 MiB. API пересозданы перед замером; фоновая сверка остановлена и затем восстановлена. +Не менялись ресурсы/версии между размерами. Это closed-loop партии, без контроля arrival rate и с coordinated omission; +универсальная максимальная пропускная способность не заявляется. Ранние пилоты с подготовкой клиента внутри окна заменены этой серией. + +| Размер PNG, bytes | Успехи / попытки | RPS, медиана | p50 / p95 / p99, с (медианы) | | --- | --- | --- | --- | -| Публичный smoke | make test | TODO | TODO | -| Остальные пункты уровня 3 | TODO | TODO | TODO | -| Все пункты уровня 4, если заявлен | TODO | TODO | TODO | -| Выбранный трек 5, если заявлен | TODO | TODO | TODO | +| 3151219 | 30 / 30 | 16.73 | 0.408 / 0.585 / 0.591 | +| 9648062 | 30 / 30 | 5.63 | 1.061 / 1.716 / 1.764 | -TODO: добавить отдельную строку для каждого заявленного критерия. PASS без команды и наблюдения не является доказательством. Проверка инфраструктурного hook требует подтверждения, какие реальные процессы/хранилища перезапущены. +![Скорость и задержка загрузки](evidence/figures/upload-throughput.png) -## Эксперименты и отказы +![Память API](evidence/figures/upload-memory.png) -TODO: гипотеза, hardware/лимиты, версии, объём данных, профиль нагрузки, concurrency/arrival rate, длительность/прогрев, повторы, успешные RPS, ошибки, p50/p95/p99, CPU/RAM. Сохранить raw summary без tokens и объяснить ограничения измерения. +Docker stats показывает выборочный working set, cgroup memory.peak — kernel high-water mark за жизнь новых API-контейнеров +(включает старт, прогрев, загрузки и проверку скачивания). Эти два показателя различаются учётом cache и частотой наблюдения. +- API `68ab8db39c84`: kernel peak **167.95 MiB** при лимите 512 MiB. +- API `a6106479affd`: kernel peak **156.98 MiB** при лимите 512 MiB. -| Воздействие | Что ожидаем | Что наблюдали | Время восстановления / потеря данных | +Для CPU 100% Docker stats означает одно логическое ядро. Сырые CPU%/RAM, временные метки и cpu.stat сохранены +в upload-load.json; sampled memory для API ниже лимита. Выборки включают прогрев, подготовку клиентов и скачивание, поэтому это не интеграл CPU только внутри timed batches. + +| Служба | CPU%, медиана / максимум выборок | +| --- | --- | +| lyakhonov-lab4-api-1 | 7.90 / 49.68 | +| lyakhonov-lab4-api-2 | 7.60 / 51.60 | +| lyakhonov-lab4-db-1 | 1.54 / 4.78 | +| lyakhonov-lab4-lb-1 | 2.25 / 12.86 | +| lyakhonov-lab4-s3-1 | 1.21 / 27.30 | + + Это не доказательство нулевых аллокаций: +декодер допустимого 40 MP изображения может занять порядка 160 MB дополнительно; одновременно декодируется одна картинка на процесс. + +## Исследование согласованности: гипотеза и результаты + +Гипотеза: PostgreSQL/S3 нельзя объединить обычным локальным COMMIT; безопасная периодическая сверка с общей блокировкой +и защитным интервалом убирает orphan и отмечает missing, сохраняя свежие и используемые вложения. +Цена — обход всех объектов/строк и чтение подтверждаемых bytes, поэтому она растёт с числом объектов и объёмом оригиналов. + +Методика: реальный INSERT отказал после PUT; отдельно удалён S3-оригинал уже привязанного к сообщению вложения. +Созданы старый orphan, свежий orphan и объект под удерживаемой общей блокировкой (имитация окна upload до COMMIT). +Dry-run сверяет полный снимок id/state/updated_at; apply удаляет только безопасные orphan и ставит missing. +Следующий проход не дублирует изменение state. После снятия блокировки/истечения grace ранее защищённые orphan могут быть удалены — +это ожидаемое продолжение очистки, а не ошибка идемпотентности. Существующие строки Attachment защищаются независимо от возраста и наличия сообщения. +Два конкурентных reconciler пропускают занятые ключи. Неверные bytes оставляют missing; корректные bytes возвращают ready; +связь с исходным сообщением сохраняется. Тестовый grace=5 с, ожидание старения=6 с; рабочий default=3600 с. +[Полные агрегаты](evidence/reconcile.json), [сценарий](student-tests/test_reconcile.py). + +Измерение стоимости: фиксированный набор метаданных и оригиналов, добавляются 0/50/200 неучтённых объектов по 1 KiB. +По три dry-run на точку, page_size=50; сервис периодической сверки остановлен, другая нагрузка не запускается. +Порядок 0→50→200; cache состояния не сбрасывался. Выигрыш/регрессию оптимизации этот опыт не измеряет. + +| Всего объектов | Время, медиана [min; max], с | LIST / HEAD / GET | Проверено bytes за проход | | --- | --- | --- | --- | -| TODO | TODO | TODO | TODO | +| 221 | 4.964 [4.835; 5.073] | 5 / 221 / 221 | 1193831654 | +| 271 | 5.185 [4.994; 5.314] | 6 / 271 / 221 | 1193831654 | +| 421 | 6.356 [6.225; 6.826] | 9 / 421 / 221 | 1193831654 | -## Ограничения и следующие шаги +![Стоимость сверки](evidence/figures/reconcile-cost.png) -TODO: какие отказы выдерживаются и какие нет; что не реализовано; где учебное упрощение; какое улучшение подтверждено, а какое пока гипотеза. +В этой серии GET/проверенные bytes постоянны, рост дополнительных orphan увеличивает HEAD и LIST. +Это подтверждает рост цены обхода; три повтора и небольшой bucket не доказывают асимптотическую производительность большой инсталляции. +Чтение всех оригиналов ради проверки SHA-256 может доминировать над числом объектов. RAM ограничена страницей и chunk 64 KiB, +но трафик и общее время не являются константными. Между страницами нет общего snapshot: проход eventually consistent, +новые записи/пропуски блокировок проверяются следующим запуском. + +## Воспроизведение и отказы + +```powershell +docker compose stop reconciler +docker compose run --rm --no-deps -T -v "${PWD}:/suite:ro" -w /suite api python student-tests/test_attachments.py +docker compose run --rm --no-deps -T -v "${PWD}:/suite:ro" -w /suite api python student-tests/test_reconcile.py +docker compose start reconciler +python student-tests/test_operations.py +python tests/resilience.py --mode persistence --action-script scripts/restart.cmd --base-url http://localhost:8084 +python tests/resilience.py --mode failover --action-script scripts/stop-one.cmd --base-url http://localhost:8084 +docker compose start api +docker compose up -d --no-deps --force-recreate api +python scripts/wait_ready.py --base-url http://localhost:8084 --replicas 2 +python scripts/run_upload_load.py +.venv/Scripts/python scripts/plot_results.py +# Dry-run вручную: +docker compose run --rm --no-deps api python -m src.reconcile +``` + +Собственные suites создают данные; повтор увеличивает набор и меняет результаты времени, это не фиксированный golden benchmark. +Графики Matplotlib 3.10.7 построены из сохранённых JSON, PNG и SVG лежат в evidence/figures. +Отключённый сервис после ручных опытов следует восстановить; нагрузочный runner делает это в finally. +Подробности, включая временный DB trigger и восстановление после аварийного завершения suite: [student-tests/README.md](student-tests/README.md). + +| Воздействие | Наблюдение | Сохранность / граница | +| --- | --- | --- | +| Остановлена lyakhonov-lab4-api-1 | Download через другую API за 1.286 с от начала действия | SHA-256 совпал, target реально остановлен | +| Остановлена lyakhonov-lab4-api-2 | Download через другую API за 1.406 с от начала действия | SHA-256 совпал, target реально остановлен | +| Остановка S3 | Первый 503 за 4.043 с | После восстановления прежние bytes/сессия; при исключении обеих API весь LB недоступен | +| Рестарт API/БД/Redis/S3/LB | StartedAt изменились у всех | Подтверждённые данные и прежний токен сохранены | +| PUT прошёл, INSERT отказал | 500 + orphan | Reconciler удалил после grace; слепой rollback S3 не применяется | +| Утрата/порча используемого оригинала | missing / API 503 | Метаданные/ссылки не удалены; нужен правильный оригинал из backup | + +В ранних публичных failover-прогонах: 109 подтверждённых записей в каждом, 2 и 3 ошибки перехода, +первая успешная запись после начала hook через 2.439 и 2.442 с. Пользовательские операции не выдаются за мгновенный failover. +Публичный hook выбирает заданный процесс; отдельный test_operations доказывает остановку обеих именно загрузивших реплик. + +## Ограничения и источники + +Один Docker-host и диск, единственные БД/S3/LB: отказ узла или утрата диска не покрыты. +Сверка обнаруживает утрату и возвращает состояние после восстановления из внешней копии, но не создаёт потерянные bytes из hash. +Ни репликация, ни backup/DR, ни production TLS/secret manager не реализованы; HTTP только localhost и синтетические данные. +Ключевые инварианты предполагают, что все писатели рабочего S3 namespace соблюдают общий протокол блокировки; +администратор с root credentials может его нарушить. Обрыв download после отправки headers может оборвать поток: +200 headers сами по себе не гарантируют полный файл, клиент проверяет длину/checksum. +Нагрузочные результаты зависят от Docker Desktop, CPU-квот, клиента и dataset; SLA и максимальные RPS не заявляются. +Удалённый CI не запускался, так как push запрещён. Добавлен отдельный application workflow без production secrets/privileged PR trigger. + +Использованы собственная лабораторная 3 и материалы курса; FastAPI/Uvicorn/Pydantic, psycopg, Redis, Argon2, boto3/botocore, +Pillow (версии в requirements.lock.txt), Matplotlib для графиков. Реализация, проверки, анализ и отчёт подготовлены с помощью Codex. +Исходный контракт и публичные проверки преподавателя не ослаблялись. + +Первичные источники: [Pillow Image / verify / pixel limits](https://pillow.readthedocs.io/en/stable/reference/Image.html), +[S3 PUT и условная запись](https://docs.aws.amazon.com/boto3/latest/reference/services/s3/client/put_object.html), +[LIST pagination](https://docs.aws.amazon.com/boto3/latest/reference/services/s3/paginator/ListObjectsV2.html), +[исходники MinIO](https://github.com/minio/minio/tree/07c3a429bfed433e49018cb0f78a52145d4bedeb), +[исходники mc](https://github.com/minio/mc/tree/RELEASE.2025-04-16T18-13-26Z), +[PostgreSQL advisory locks](https://www.postgresql.org/docs/16/explicit-locking.html#ADVISORY-LOCKS). + +Этапы истории: `2e5f5bf` — перенос; `4f85fb9` — обязательный минимум; `9dded97` — уровень 4; +финальный коммит исследования/отчёта и последующая проверка чистого экспорта видны в git log. diff --git a/compose.yaml b/compose.yaml index e8773ac6..38546b68 100644 --- a/compose.yaml +++ b/compose.yaml @@ -64,6 +64,8 @@ services: bucket-init: image: lyakhonov-storage:lab4 pull_policy: never + cpus: 0.25 + mem_limit: 128m entrypoint: [/bin/sh, /bootstrap/bucket.sh] secrets: [s3_root_user, s3_root_password, s3_access_key, s3_secret_key] volumes: [./infra/bucket.sh:/bootstrap/bucket.sh:ro, ./infra/s3-policy.json:/bootstrap/policy.json:ro] diff --git a/evidence/figures/reconcile-cost.png b/evidence/figures/reconcile-cost.png new file mode 100644 index 0000000000000000000000000000000000000000..458e0b8cf9813e0c1a84fa03a155bf7ac153539a GIT binary patch literal 80383 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 Qa#|9nWKJd=zi{J!0VO5?-2eap literal 0 HcmV?d00001 diff --git a/evidence/figures/reconcile-cost.svg b/evidence/figures/reconcile-cost.svg new file mode 100644 index 00000000..8c6f7f6e --- /dev/null +++ b/evidence/figures/reconcile-cost.svg @@ -0,0 +1,2322 @@ + + + + + + + + 2026-10-30T17:49:09.849194 + image/svg+xml + + + Matplotlib v3.10.7, https://matplotlib.org/ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/evidence/figures/upload-memory.png b/evidence/figures/upload-memory.png new file mode 100644 index 0000000000000000000000000000000000000000..819681384da6c6e0fa86dc79ff558754050ade94 GIT binary patch literal 58940 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 A%m4rY literal 0 HcmV?d00001 diff --git a/evidence/figures/upload-memory.svg b/evidence/figures/upload-memory.svg new file mode 100644 index 00000000..fca43770 --- /dev/null +++ b/evidence/figures/upload-memory.svg @@ -0,0 +1,1715 @@ + + + + + + + + 2026-10-30T17:49:10.393928 + image/svg+xml + + + Matplotlib v3.10.7, https://matplotlib.org/ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/evidence/figures/upload-throughput.png b/evidence/figures/upload-throughput.png new file mode 100644 index 0000000000000000000000000000000000000000..126c709a098c81eca345865020d913ad0adbc942 GIT binary patch literal 82574 zcmd?QcQ~7G8~=|Mt!i~EYILYgOHrFDYHw<5ty-ZXMhHr)t=h9{kJzL3raEk5gjCGd zh=fohV*6e`pXYgg$M3)I|KA)(ThSc%o%_D8>pb7*dA{BsbhK2?(=pRgP*9v#efmU? zf`Vq3f`Y2x3=Q~=MO|D0_(#%H>6xd#o4u#^a}PTT&F7x(E^eMKjxRX8>^z{3ZV(Z{ z2loZV`8i&Cdb&d;g@j!H_X$Ba4+kNQiaQ42C}-WDnm{Qim^n}WP`+ELo28(npiq6H zVBnLwGDYiibz!@6J?_n$X}|K}OELBe@?qJT*+FLtxOu~_q4_LZELV)nEZaQ(lHD=nc;MSY@i=pkg$`|K4@ko!J22@jtHydIj14{!GDmnyNSswED?{@|%*9yL}`rDHqscaig(O!7A{^w^J;wZ@~ z;CaLyl{;Ou9J%(WbXNx1oy;1i(VilM!WY!%u2)~?RC|^t30rAgE~~;=`t@(G&7e$G zYSo@T{gR&!@7W_QJ3w&*HCMQ_es#xjxlT9xjY~Yk0mN^*|6!W6%>+9P``)g)(kg1Xv zKf|tHxiWX)GSk{}NNzi>8Ohhq-(_2E5dQQ|(uT6DX{_AJt-N)wX!8J{pRp|w70K6j zxSawGZy=4Cm6}x950HG7qprZ^4pAS4T7UH<@HxCa$LO^xFcq**taTZ$jP@7&%1(rm z!PeM30B5bs&An@M-J|6F-EAF;TbV8e`>Rc;MN~${V)M|@keJV3Yrn;0hZ0Zxa7m!; z$AL7di72_FC8%k>R+`ILiHWb1dI63JVSl(tqVQBB;nx zlF-GzOv~bw)9r(r)YR+jek%_$#09~{I*B@u&3D|T;LzUPM9GyppwerdMtR#dA36^I zXx$_5;X)haz=hvP5qHa*qmO<^!jE+3X(Ydpfp2{&Z#%-`r0G_ui|S+3=YG_>PL%kO zR|BGK8V8OsZAS~Xj8rBIv+W@RGVg6VBgcPyxKipi(^}#(|I~Java1>;yWfYcaZb89 zD}_siuB>;m*SWRscHn;^tGBh~4$-0XOfM364J$<)1|G>Y#p_brGKxN3ZQY0DlQYy& zByr7C(Fjkr8*%~7o6XNEUUVnV;ssKQOV$(kjPJ>zf7=q!grxpGY#*>#MoXWp(NZ(m@1Q3D-K4 z7ca6ATSF?_QGo|{mdHG&)dixi*oQx7Osii$$CyJSYFx&LLmAjt4>Z>bJD6s?Dda8l zQ=)qkV^Z8&$GeNx`+|(AKlTbX^))!QzM50cZw$k}#LLW3b;&75FfW|`8$XnLVfyH0 ziEP4YqfQFDb1F(o5~IfP7OB(6IGUZ+`nd}%BK8^^)nlb*QkXqlMqukmnem4JJ3;49 zH#qnvJx4UPs6T@>_G=42l6FB@Uh8|BCIwU8-jevFd&rg9D;7R@s$SzDlwpC+Er)cg zz{AlZqEZs;v7<5D@zAu999KO=5y%|+biR9w!4%R z(MgWsj^f40r!lv;d-%$C_+KFw5{ymDEn8A?Zq4hVKRY_?_baKoSR>ixAXn~bxTiDR zxX)od?w=rh^Wn?rG{4mbtstR0@mV-8X>P-!c$C%|W~;5YjF#@{#dDb*?9`QE!DHuH z#5~j6HV33iUd}%S$-(v$q@zfyal%GD`9}LNMPEvyL?RyMeD^c*M8rKOiUs-a8 zyVL4cb;rtQ5eKb}=0fMr;`tOQO&N<*7H^8^-!AG0=`X0tI5J7gVTN*4(jH`2UkGCq zS~ahC;=p^)ATZsws_N$Esd2j=cx004Te@rf_wIG<7Fsrdjn{a^zrPEo*$?&GVdjt` z;pm>g$chy$R0uX1a$Wdq!cm4KtcQmjGi2x9(2^U%q%-g=Z|x!f96`}!q+yK{NV z7*9y9d_$tK4D-muondz3a!<9P{FAlv5*1RoLGpLR{x;G?O=-bLbRf?%=g@>RvnQU% z#uZ!rYTAapI;9}aF}iOa@tAZ26Var1SZZEzL^o&BBOEj>C4ng?jGLLID@pEX=X>N$ zi9ga92@8zf5%(aMlhjL>R`-qOZMDNeT$yosIxSJb#B+_UhAB_yzVT$1*80G)S$mO7SPRT@BgFX2Q>1%PT7y^J(WFsZvBMfR!@DYK41X(-E#w-g)Vc^4+!! zIq<{+Hl*R6OM~q=|JAM6r)X&oGO8RR7!THls2z3sSjO*!%Z? z8%obH3Z`x?Bw6hpu&1xhxtX!cz#rl_dW9J3<*xA=^{pLWbRCf|$K?2||52R@*mwO3 zt9&)rk!xDxw2O!WS@52KRjc&Uq4=F;*`in|9(BC3UVxImo0ri zHPRJiciEX7`PWpcAoJOOMb&`ipIc;DOkO!1t zI1o-#+gPQ%_zPbSWe?0inuxUzXYQ0jgNi|R?cUT%eKdq?y|}akB$(HFb7HD20zQ1r z*!(v+wFH_}mZk^pqveM5DH{4SJIAd+Y0Uc`rumIDhB913IhR+n-BF3`)0y~*AvqJA zgFAix5`?8IOW+!5XD*8Nze_z2ktOC& z*p|;c6d&{&K3d+D#WDyJLRld0(~8RjR!#S!(PYKpKjX6O;t=z%zN4~3{-$mY1F5Ry z%EE|*F)x0zT9;uE773fAcK;bZ5XHA9+}d_6Lc>>V+9!>>UH0|JZ3ivW2zus++_Uhg zhzQNbJwoxwf%Fk}G1(&28siG$YphYJ>9sA1%_@}axko}5FNAl~awwwx3|fMp$PnTU z6Gzczi)(?$O?F%$LauR~e^_b>BRp7;V0#O{+hBJ)ULdCgDUY6T8OhVs8jFKd6_TT; z&03NSpaC7>Oat}0K(B5kA7&qyXJoTQ5R!8%<3L7pS2HMJEE9hIa3<^;Un-mJU+rX> z9`~L?@MxsWs$a&86zkZ06m^@P++9Vi|76@=OmUM;Hp50eq-e-PzJtGWX7}(bC6K;{ zo`=G_@J)FLRht{U`^!K⋘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ⅆuX$At3pD|O{vUl4S4pt-Wj5vN74po?4=WCwLbi4eFGb(wYu z5*wUyY}wMJT+Sz$x!j=VH{ZBvAH#alC%e5>x!d9wzW45!ZDq|Ke%8BSgRXM*IB6bK z)7jywntAkLPe+M-@~>g!q^_JLqS$+EEw`}de0%p9fV54^yh*bP&$A67ijCq{RGC2v zaA!}t-B4WmnIn%1KagAoK9~FLi@n?(xwCB>MCpvr;o_am&7ZMf7?Iz(d)nP$Q9U;w z{o<#n(3s)bOTE&)%5nPRZ0{Z+TT4G7JL|Y+Sy|cbb?T>+YPu7a7Yo_!uZ-BAZ9rCE zt#2=R3OD3J4)`gcgpzg$mPLenOq`TIOhz^3!T3ya;nj$gvDD(*3!?h~AC@qCaK zTaInrS-38w|DW}51rEix0#C-9dgdQ+z%f?>cue(ossl z16beMi<*4i{~T1Qg4&EXoPZX1tDe8=JCFH<8Zdv{Z~%7KQ(gdPj3j_nE8E%n@C9yGpuKDY3gSUVlyw$U9*eCe*7JUq=W>~NUm>jtm z0z0XRz#(gY)3dxO=GIGZ8yJ~IK*xm{xqu{I02@E5D}W_l zB5>UCA#mS~&*z)Kygq>!m + + + + + + + 2026-10-30T17:49:10.222436 + image/svg+xml + + + Matplotlib v3.10.7, https://matplotlib.org/ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/evidence/reconcile.json b/evidence/reconcile.json new file mode 100644 index 00000000..ea3ee8c7 --- /dev/null +++ b/evidence/reconcile.json @@ -0,0 +1 @@ +{"result": "PASS", "dry_run": {"apply": false, "grace_seconds": 5, "page_size": 7, "elapsed_seconds": 4.696135, "counts": {"list_requests": 33, "objects_scanned": 225, "referenced_kept": 220, "head_requests": 225, "orphan_candidates": 3, "fresh_kept": 1, "locked_skipped": 1, "db_pages": 32, "metadata_scanned": 221, "get_requests": 220, "bytes_verified": 1193719837, "valid_objects": 220, "missing_objects": 1, "mark_missing_candidates": 1}}, "apply": {"apply": true, "grace_seconds": 5, "page_size": 7, "elapsed_seconds": 5.253011, "counts": {"list_requests": 33, "objects_scanned": 225, "referenced_kept": 220, "head_requests": 225, "orphan_candidates": 3, "objects_deleted": 3, "fresh_kept": 1, "locked_skipped": 1, "db_pages": 32, "metadata_scanned": 221, "get_requests": 220, "bytes_verified": 1193719837, "valid_objects": 220, "missing_objects": 1, "mark_missing_candidates": 1, "metadata_marked_missing": 1}}, "repeat": {"apply": true, "grace_seconds": 5, "page_size": 7, "elapsed_seconds": 5.53207, "counts": {"list_requests": 32, "objects_scanned": 222, "referenced_kept": 220, "head_requests": 223, "orphan_candidates": 2, "objects_deleted": 2, "db_pages": 32, "metadata_scanned": 221, "get_requests": 220, "bytes_verified": 1193719837, "valid_objects": 220, "missing_objects": 1}}, "corrupt": {"apply": true, "grace_seconds": 5, "page_size": 7, "elapsed_seconds": 4.835876, "counts": {"list_requests": 32, "objects_scanned": 221, "referenced_kept": 221, "db_pages": 32, "metadata_scanned": 221, "head_requests": 221, "get_requests": 221, "bytes_verified": 1193719844, "valid_objects": 220, "corrupt_objects": 1}}, "restored": {"apply": true, "grace_seconds": 5, "page_size": 7, "elapsed_seconds": 4.8535, "counts": {"list_requests": 32, "objects_scanned": 221, "referenced_kept": 221, "db_pages": 32, "metadata_scanned": 221, "head_requests": 221, "get_requests": 221, "bytes_verified": 1193831654, "valid_objects": 221, "restore_candidates": 1, "metadata_restored": 1}}, "concurrent": [{"apply": true, "grace_seconds": 5, "page_size": 11, "elapsed_seconds": 11.069536, "counts": {"list_requests": 21, "objects_scanned": 221, "locked_skipped": 70, "referenced_kept": 163, "db_pages": 21, "metadata_scanned": 221, "head_requests": 209, "get_requests": 209, "bytes_verified": 1107081684, "valid_objects": 209}}, {"apply": true, "grace_seconds": 5, "page_size": 11, "elapsed_seconds": 10.992802, "counts": {"list_requests": 21, "objects_scanned": 221, "referenced_kept": 166, "locked_skipped": 68, "db_pages": 21, "metadata_scanned": 221, "head_requests": 208, "get_requests": 208, "bytes_verified": 1100891063, "valid_objects": 208}}], "cost": [{"extra_objects": 0, "repeat": 1, "apply": false, "grace_seconds": 3600, "page_size": 50, "elapsed_seconds": 4.963795, "counts": {"list_requests": 5, "objects_scanned": 221, "referenced_kept": 221, "db_pages": 5, "metadata_scanned": 221, "head_requests": 221, "get_requests": 221, "bytes_verified": 1193831654, "valid_objects": 221}}, {"extra_objects": 0, "repeat": 2, "apply": false, "grace_seconds": 3600, "page_size": 50, "elapsed_seconds": 4.835272, "counts": {"list_requests": 5, "objects_scanned": 221, "referenced_kept": 221, "db_pages": 5, "metadata_scanned": 221, "head_requests": 221, "get_requests": 221, "bytes_verified": 1193831654, "valid_objects": 221}}, {"extra_objects": 0, "repeat": 3, "apply": false, "grace_seconds": 3600, "page_size": 50, "elapsed_seconds": 5.07319, "counts": {"list_requests": 5, "objects_scanned": 221, "referenced_kept": 221, "db_pages": 5, "metadata_scanned": 221, "head_requests": 221, "get_requests": 221, "bytes_verified": 1193831654, "valid_objects": 221}}, {"extra_objects": 50, "repeat": 1, "apply": false, "grace_seconds": 3600, "page_size": 50, "elapsed_seconds": 5.184831, "counts": {"list_requests": 6, "objects_scanned": 271, "referenced_kept": 221, "head_requests": 271, "fresh_kept": 50, "db_pages": 5, "metadata_scanned": 221, "get_requests": 221, "bytes_verified": 1193831654, "valid_objects": 221}}, {"extra_objects": 50, "repeat": 2, "apply": false, "grace_seconds": 3600, "page_size": 50, "elapsed_seconds": 5.314212, "counts": {"list_requests": 6, "objects_scanned": 271, "referenced_kept": 221, "head_requests": 271, "fresh_kept": 50, "db_pages": 5, "metadata_scanned": 221, "get_requests": 221, "bytes_verified": 1193831654, "valid_objects": 221}}, {"extra_objects": 50, "repeat": 3, "apply": false, "grace_seconds": 3600, "page_size": 50, "elapsed_seconds": 4.994448, "counts": {"list_requests": 6, "objects_scanned": 271, "referenced_kept": 221, "head_requests": 271, "fresh_kept": 50, "db_pages": 5, "metadata_scanned": 221, "get_requests": 221, "bytes_verified": 1193831654, "valid_objects": 221}}, {"extra_objects": 200, "repeat": 1, "apply": false, "grace_seconds": 3600, "page_size": 50, "elapsed_seconds": 6.356231, "counts": {"list_requests": 9, "objects_scanned": 421, "referenced_kept": 221, "head_requests": 421, "fresh_kept": 200, "db_pages": 5, "metadata_scanned": 221, "get_requests": 221, "bytes_verified": 1193831654, "valid_objects": 221}}, {"extra_objects": 200, "repeat": 2, "apply": false, "grace_seconds": 3600, "page_size": 50, "elapsed_seconds": 6.826461, "counts": {"list_requests": 9, "objects_scanned": 421, "referenced_kept": 221, "head_requests": 421, "fresh_kept": 200, "db_pages": 5, "metadata_scanned": 221, "get_requests": 221, "bytes_verified": 1193831654, "valid_objects": 221}}, {"extra_objects": 200, "repeat": 3, "apply": false, "grace_seconds": 3600, "page_size": 50, "elapsed_seconds": 6.225256, "counts": {"list_requests": 9, "objects_scanned": 421, "referenced_kept": 221, "head_requests": 421, "fresh_kept": 200, "db_pages": 5, "metadata_scanned": 221, "get_requests": 221, "bytes_verified": 1193831654, "valid_objects": 221}}], "final": {"apply": true, "grace_seconds": 3600, "page_size": 50, "elapsed_seconds": 5.115164, "counts": {"list_requests": 5, "objects_scanned": 221, "referenced_kept": 221, "db_pages": 5, "metadata_scanned": 221, "head_requests": 221, "get_requests": 221, "bytes_verified": 1193831654, "valid_objects": 221}}, "scope": "isolated lab4, metadata retained, no backup reconstruction claimed"} diff --git a/evidence/runtime.json b/evidence/runtime.json new file mode 100644 index 00000000..4a053dce --- /dev/null +++ b/evidence/runtime.json @@ -0,0 +1,99 @@ +[ + { + "id": "af9f952b1304", + "service": "api", + "project": "lyakhonov-lab4", + "image": "sha256:da31f98a9d1c6e6cc39e2f28e3a1de410451a7941d84d6ca46fccff13f23a2b6", + "started_at": "2026-10-30T14:46:59.471200143Z", + "memory_limit": 536870912, + "nano_cpus": 500000000, + "volumes": [], + "networks": [ + "lyakhonov-lab4_default" + ] + }, + { + "id": "99f4403277a7", + "service": "api", + "project": "lyakhonov-lab4", + "image": "sha256:da31f98a9d1c6e6cc39e2f28e3a1de410451a7941d84d6ca46fccff13f23a2b6", + "started_at": "2026-10-30T14:46:59.269605492Z", + "memory_limit": 536870912, + "nano_cpus": 500000000, + "volumes": [], + "networks": [ + "lyakhonov-lab4_default" + ] + }, + { + "id": "10138b5c0bee", + "service": "db", + "project": "lyakhonov-lab4", + "image": "sha256:1d04b9ba1d4996401f2552b51beda8187f175c0645c091e4781134fc9c9a3eef", + "started_at": "2026-10-30T14:45:44.07685361Z", + "memory_limit": 536870912, + "nano_cpus": 1000000000, + "volumes": [ + "lyakhonov-lab4_postgres_data" + ], + "networks": [ + "lyakhonov-lab4_default" + ] + }, + { + "id": "e9682a892ad3", + "service": "lb", + "project": "lyakhonov-lab4", + "image": "sha256:c22c8710886104a48b920306f063401f0d11811858e3c6b9d87d88a7556b2e61", + "started_at": "2026-10-30T14:45:44.017393725Z", + "memory_limit": 134217728, + "nano_cpus": 500000000, + "volumes": [], + "networks": [ + "lyakhonov-lab4_default" + ] + }, + { + "id": "7523f15dc398", + "service": "reconciler", + "project": "lyakhonov-lab4", + "image": "sha256:da31f98a9d1c6e6cc39e2f28e3a1de410451a7941d84d6ca46fccff13f23a2b6", + "started_at": "2026-10-30T14:49:08.477185174Z", + "memory_limit": 268435456, + "nano_cpus": 250000000, + "volumes": [], + "networks": [ + "lyakhonov-lab4_default" + ] + }, + { + "id": "68997bbba33b", + "service": "redis", + "project": "lyakhonov-lab4", + "image": "sha256:c1e88455c85225310bbea54816e9c3f4b5295815e6dbf80c34d40afc6df28275", + "started_at": "2026-10-30T14:45:43.846575438Z", + "memory_limit": 134217728, + "nano_cpus": 250000000, + "volumes": [ + "c2c6f149717b708d82beb471b6464d27f0c63cb02c7f97c1d8380274e7604f21" + ], + "networks": [ + "lyakhonov-lab4_default" + ] + }, + { + "id": "a6482b44d70a", + "service": "s3", + "project": "lyakhonov-lab4", + "image": "sha256:4222244a8b6792dac783b2bca633b34636e4b853092b3a0d805f9283562a83c5", + "started_at": "2026-10-30T14:45:43.938532131Z", + "memory_limit": 805306368, + "nano_cpus": 1000000000, + "volumes": [ + "lyakhonov-lab4_s3_data" + ], + "networks": [ + "lyakhonov-lab4_default" + ] + } +] \ No newline at end of file diff --git a/evidence/sources-manifest.json b/evidence/sources-manifest.json new file mode 100644 index 00000000..24a532e5 --- /dev/null +++ b/evidence/sources-manifest.json @@ -0,0 +1,27 @@ +{ + "src/app.py": "0cb5d0151e73166aed98acfe151415a93f18221cf27ebd8e39f433cda30b8f13", + "src/cache.py": "bfc8f1aa90bee4625b3887a3487be085560b7a2705cc94dcb557dd6c03062028", + "src/config.py": "aafa2db508658d2d5467d2c57ed5f4dea11609ab5928f86abc1e35fc8ba923d7", + "src/main.py": "3f49c442758f1a4c3a156a4555f2b3f6d8dff0529fc62cb763f11eaaa2d2760b", + "src/migrate.py": "48c2819b34e22ee099a97d8742a65c87bc0abf9cd617cf6b6caae8a1ad145af5", + "src/models.py": "afc5b651059a440904e1c4ac509ac8e24796bceac5869a6421e42d388f2fe6d6", + "src/objects.py": "75f15c13be0b5eecf441a437a8250a0d6367b7b098b288a2cd1994c0b1a4321a", + "src/reconcile.py": "228a7994ce5b4110d7391734b0885c01ece754912c285c7f530427ec2674f133", + "src/storage.py": "81f5bcb0bc6ce356c76f1ea0b90d74566d436ca6f2dcc35e80cc0ae512588979", + "src/__init__.py": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", + "src/routes/attachments.py": "5518b8a264b8b0454e30606123119e83382159f2f031864e33a3e48a62496c84", + "src/routes/chats.py": "46ef834fce05037c2ecab26192ed58c28be81afc6a1db1375560f11bb9d63c12", + "src/routes/common.py": "fa2df76c819abe9a99b8b380a50b2aa4556aa43ac84afa95cac574aab8468a7e", + "src/routes/health.py": "a2d7aef51d4fff4f4c8523a4b1d1b894747f945ac3dd4d26b521d6a228cb88be", + "src/routes/messages.py": "7dc016d1252f07538c06b7c155d3efb8af02ac2a2a9867267168a74e7cf0bd3c", + "src/routes/users.py": "f5d4c7e4c4e5b1abfde7869a46e8a81a935b32f4809ddb8b2a4cb13175a24f50", + "src/routes/__init__.py": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", + "migrations/001_initial.sql": "d4c044482ba61b6a59b35cb02cff16b650fa0fb813242c0678d45a3564e86340", + "migrations/002_idempotency.sql": "b3938061613446d1676dfdf41af1b8417dd0396d2a65e4d3d6b263d311ccdbce", + "migrations/003_attachments.sql": "4137877de095ca8cb590582bfa59758c31248f013e9b99ddcf6a2e2bedaff125", + "student-tests/README.md": "eb43baa6868c409f71905c7ab11b0bb187a8e9a87fc4842909949b270107e354", + "student-tests/test_attachments.py": "e26fece8adc6a63bcccfe6c1de53e3899f0c43d0c8c9fd6502c988403a9a95e5", + "student-tests/test_operations.py": "7a62d819afdaea80767cb2ff4e8141eebce9e564ec20241c7d3f5b645d742999", + "student-tests/test_reconcile.py": "f1e0f7461f57fa0aad2a16e118fe86ed5852ec1d86caac07ea81a829c7f2f787", + "student-tests/upload_load.py": "022eea2772fcbf780042b3959c516788929dfde4968dcd9f7caa2531999c52e9" +} \ No newline at end of file diff --git a/evidence/summary-output.txt b/evidence/summary-output.txt new file mode 100644 index 00000000..33fd2b71 --- /dev/null +++ b/evidence/summary-output.txt @@ -0,0 +1,90 @@ +{ + "uploads": [ + { + "size_bytes": 3151219, + "successful_rps_median": 16.729828936800814, + "p50_seconds_median": 0.4081998335022945, + "p95_seconds_median": 0.584588757907477, + "p99_seconds_median": 0.5914236595887633, + "errors": 0, + "attempts": 30, + "elapsed_seconds": 1.8537453600001754 + }, + { + "size_bytes": 9648062, + "successful_rps_median": 5.626450903085569, + "p50_seconds_median": 1.0610903210035758, + "p95_seconds_median": 1.7164175714497103, + "p99_seconds_median": 1.7635092142925715, + "errors": 0, + "attempts": 30, + "elapsed_seconds": 5.111771299998509 + } + ], + "cost": [ + { + "objects": 221, + "elapsed_median": 4.963795, + "elapsed_min": 4.835272, + "elapsed_max": 5.07319, + "counts": { + "list_requests": 5, + "objects_scanned": 221, + "referenced_kept": 221, + "db_pages": 5, + "metadata_scanned": 221, + "head_requests": 221, + "get_requests": 221, + "bytes_verified": 1193831654, + "valid_objects": 221 + } + }, + { + "objects": 271, + "elapsed_median": 5.184831, + "elapsed_min": 4.994448, + "elapsed_max": 5.314212, + "counts": { + "list_requests": 6, + "objects_scanned": 271, + "referenced_kept": 221, + "head_requests": 271, + "fresh_kept": 50, + "db_pages": 5, + "metadata_scanned": 221, + "get_requests": 221, + "bytes_verified": 1193831654, + "valid_objects": 221 + } + }, + { + "objects": 421, + "elapsed_median": 6.356231, + "elapsed_min": 6.225256, + "elapsed_max": 6.826461, + "counts": { + "list_requests": 9, + "objects_scanned": 421, + "referenced_kept": 221, + "head_requests": 421, + "fresh_kept": 200, + "db_pages": 5, + "metadata_scanned": 221, + "get_requests": 221, + "bytes_verified": 1193831654, + "valid_objects": 221 + } + } + ], + "sampled_memory_max_mib": { + "lyakhonov-lab4-api-1": 157.2, + "lyakhonov-lab4-api-2": 149.2, + "lyakhonov-lab4-db-1": 40.3, + "lyakhonov-lab4-lb-1": 17.27, + "lyakhonov-lab4-s3-1": 312.1 + }, + "kernel_memory_peak_mib": { + "68ab8db39c84": 167.9453125, + "a6106479affd": 156.98046875 + } +} diff --git a/evidence/summary.json b/evidence/summary.json new file mode 100644 index 00000000..9a7efa00 --- /dev/null +++ b/evidence/summary.json @@ -0,0 +1,90 @@ +{ + "uploads": [ + { + "size_bytes": 3151219, + "successful_rps_median": 16.729828936800814, + "p50_seconds_median": 0.4081998335022945, + "p95_seconds_median": 0.584588757907477, + "p99_seconds_median": 0.5914236595887633, + "errors": 0, + "attempts": 30, + "elapsed_seconds": 1.8537453600001754 + }, + { + "size_bytes": 9648062, + "successful_rps_median": 5.626450903085569, + "p50_seconds_median": 1.0610903210035758, + "p95_seconds_median": 1.7164175714497103, + "p99_seconds_median": 1.7635092142925715, + "errors": 0, + "attempts": 30, + "elapsed_seconds": 5.111771299998509 + } + ], + "cost": [ + { + "objects": 221, + "elapsed_median": 4.963795, + "elapsed_min": 4.835272, + "elapsed_max": 5.07319, + "counts": { + "list_requests": 5, + "objects_scanned": 221, + "referenced_kept": 221, + "db_pages": 5, + "metadata_scanned": 221, + "head_requests": 221, + "get_requests": 221, + "bytes_verified": 1193831654, + "valid_objects": 221 + } + }, + { + "objects": 271, + "elapsed_median": 5.184831, + "elapsed_min": 4.994448, + "elapsed_max": 5.314212, + "counts": { + "list_requests": 6, + "objects_scanned": 271, + "referenced_kept": 221, + "head_requests": 271, + "fresh_kept": 50, + "db_pages": 5, + "metadata_scanned": 221, + "get_requests": 221, + "bytes_verified": 1193831654, + "valid_objects": 221 + } + }, + { + "objects": 421, + "elapsed_median": 6.356231, + "elapsed_min": 6.225256, + "elapsed_max": 6.826461, + "counts": { + "list_requests": 9, + "objects_scanned": 421, + "referenced_kept": 221, + "head_requests": 421, + "fresh_kept": 200, + "db_pages": 5, + "metadata_scanned": 221, + "get_requests": 221, + "bytes_verified": 1193831654, + "valid_objects": 221 + } + } + ], + "sampled_memory_max_mib": { + "lyakhonov-lab4-api-1": 157.2, + "lyakhonov-lab4-api-2": 149.2, + "lyakhonov-lab4-db-1": 40.3, + "lyakhonov-lab4-lb-1": 17.27, + "lyakhonov-lab4-s3-1": 312.1 + }, + "kernel_memory_peak_mib": { + "68ab8db39c84": 167.9453125, + "a6106479affd": 156.98046875 + } +} \ No newline at end of file diff --git a/evidence/upload-summary.csv b/evidence/upload-summary.csv new file mode 100644 index 00000000..502bb44c --- /dev/null +++ b/evidence/upload-summary.csv @@ -0,0 +1,7 @@ +size_bytes,side,repeat,concurrency,attempts,successes,errors,elapsed_seconds,successful_rps,p50_seconds,p95_seconds,p99_seconds +3151219,1024,1,10,10,10,0,0.7838622859999305,12.75734293970215,0.4336575634952169,0.7340192681040206,0.7722596784304188 +3151219,1024,2,10,10,10,0,0.597734743001638,16.729828936800814,0.4081998335022945,0.584588757907477,0.5914236595887633 +3151219,1024,3,10,10,10,0,0.472148330998607,21.179784706322522,0.2796381600055611,0.4425103257497539,0.4638570675504161 +9648062,1792,1,10,10,10,0,1.5366208479972556,6.507786233040787,1.0274780609979643,1.4637623943453943,1.5201743212681322 +9648062,1792,2,10,10,10,0,1.7978311129991198,5.56225772693305,1.1837765999953263,1.746605640908092,1.784828035391838 +9648062,1792,3,10,10,10,0,1.7773193390021333,5.626450903085569,1.0610903210035758,1.7164175714497103,1.7635092142925715 diff --git a/lab4.env.example b/lab4.env.example new file mode 100644 index 00000000..9c0dd097 --- /dev/null +++ b/lab4.env.example @@ -0,0 +1,8 @@ +# Public settings only. Copy to .env; secrets are generated separately. +LAB4_PORT=8084 +API_REPLICAS=2 +API_CPUS=0.5 +API_MEMORY=512m +POOL_SIZE=10 +SESSION_TTL_SECONDS=3600 +OPTIMIZED_WRITES=1 diff --git a/scripts/bootstrap.py b/scripts/bootstrap.py index 4824cfcd..6362fc1b 100644 --- a/scripts/bootstrap.py +++ b/scripts/bootstrap.py @@ -12,9 +12,13 @@ url_file = folder / 'database_url' if not url_file.exists(): password = password_file.read_text(encoding='utf-8').strip() url_file.write_text(f'postgresql://messenger:{password}@db:5432/messenger', encoding='utf-8') -print('Локальные секреты готовы; значения не выводятся.') for name in ('s3_root_user', 's3_root_password', 's3_access_key', 's3_secret_key'): target = folder / name if not target.exists(): target.write_text(secrets.token_hex(24), encoding='utf-8') + +env_file = root / '.env' +if not env_file.exists(): + env_file.write_bytes((root / 'lab4.env.example').read_bytes()) +print('Локальные настройки и секреты готовы; существующие файлы сохранены.') diff --git a/scripts/plot_results.py b/scripts/plot_results.py new file mode 100644 index 00000000..784d69e6 --- /dev/null +++ b/scripts/plot_results.py @@ -0,0 +1,68 @@ +"""Static research figures from recorded evidence only; no new measurements.""" +import csv +import json +from pathlib import Path +import re +import statistics +import matplotlib +matplotlib.use('Agg') +import matplotlib.pyplot as plt +ROOT=Path(__file__).resolve().parents[1] +OUT=ROOT/'evidence/figures';OUT.mkdir(exist_ok=True) +plt.rcParams.update({'font.family':'DejaVu Sans','font.size':10,'axes.spines.top':False,'axes.spines.right':False}) +def save(fig,name): + fig.tight_layout() + fig.savefig(OUT/(name+'.png'),dpi=170) + fig.savefig(OUT/(name+'.svg')) + plt.close(fig) +def bands(ax,x,groups,label,color): + med=[statistics.median(v) for v in groups] + ax.errorbar(x,med,yerr=[[m-min(v) for m,v in zip(med,groups)],[max(v)-m for m,v in zip(med,groups)]],fmt='o-',capsize=4,label=label,color=color) +r=json.loads((ROOT/'evidence/reconcile.json').read_text(encoding='utf-8-sig')) +points=sorted({v['extra_objects'] for v in r['cost']}) +groups=[[v for v in r['cost'] if v['extra_objects']==n] for n in points] +x=[v[0]['counts']['objects_scanned'] for v in groups] +fig,axes=plt.subplots(1,2,figsize=(10.5,4)) +bands(axes[0],x,[[v['elapsed_seconds'] for v in vs] for vs in groups],'Медиана и min–max (3 повтора)','#286D8C') +axes[0].set(xlabel='Объектов в bucket',ylabel='Время dry-run, с',title='Стоимость полной сверки') +axes[0].legend(fontsize=8) +for field,label in [('head_requests','HEAD'),('get_requests','GET'),('list_requests','LIST')]: + axes[1].plot(x,[v[0]['counts'][field] for v in groups],'o-',label=label) +axes[1].set(xlabel='Объектов в bucket',ylabel='Число S3-запросов',title='Цена обхода: запросы') +axes[1].legend();save(fig,'reconcile-cost') +u=json.loads((ROOT/'evidence/upload-load.json').read_text(encoding='utf-8-sig')) +sizes=sorted({v['size_bytes'] for v in u['runs']}); x=[s/1048576 for s in sizes] +groups=[[v for v in u['runs'] if v['size_bytes']==s] for s in sizes] +fig,axes=plt.subplots(1,2,figsize=(10.5,4)) +bands(axes[0],x,[[v['successful_rps'] for v in vs] for vs in groups],'3 партии × 10 клиентов','#286D8C') +axes[0].set(xlabel='PNG, MiB',ylabel='Успешных загрузок/с',title='Синхронный upload через API') +bands(axes[1],x,[[v['p95_seconds'] for v in vs] for vs in groups],'p95 успешных запросов','#B15E38') +axes[1].set(xlabel='PNG, MiB',ylabel='Задержка, с',title='p95 внутри партии (10 запросов)') +for ax in axes: ax.legend(fontsize=8) +save(fig,'upload-throughput') +def mib(value): + match=re.match(r'([0-9.]+)([A-Za-z]+)',value.strip()) + amount=float(match[1]);unit=match[2] + return amount*{'B':1/1048576,'KiB':1/1024,'MiB':1,'GiB':1024,'kB':1000/1048576,'MB':1000000/1048576,'GB':1000000000/1048576}[unit] +fig,ax=plt.subplots(figsize=(10.5,4)) +first=u['samples'][0]['time'] +for name in sorted({c['Name'] for s in u['samples'] for c in s['containers'] if '-api-' in c['Name']}): + pairs=[(s['time']-first,mib(c['MemUsage'].split('/')[0])) for s in u['samples'] for c in s['containers'] if c['Name']==name] + ax.plot([a for a,b in pairs],[b for a,b in pairs],'o-',label=name) +ax.axhline(512,color='#B15E38',linestyle='--',label='Лимит одной API: 512 MiB') +ax.set(xlabel='Время от первой выборки, с',ylabel='Docker working set, MiB',title='Память API: прогрев, загрузки и проверка оригиналов') +ax.legend(fontsize=8);save(fig,'upload-memory') +with (ROOT/'evidence/upload-summary.csv').open('w',newline='',encoding='utf-8') as f: + writer=csv.DictWriter(f,fieldnames=list(u['runs'][0]));writer.writeheader();writer.writerows(u['runs']) +summary={'uploads':[], 'cost':[],'sampled_memory_max_mib':{},'kernel_memory_peak_mib':{}} +for size,vs in zip(sizes,groups): + summary['uploads'].append({'size_bytes':size,'successful_rps_median':statistics.median(v['successful_rps'] for v in vs),'p50_seconds_median':statistics.median(v['p50_seconds'] for v in vs),'p95_seconds_median':statistics.median(v['p95_seconds'] for v in vs),'p99_seconds_median':statistics.median(v['p99_seconds'] for v in vs),'errors':sum(v['errors'] for v in vs),'attempts':sum(v['attempts'] for v in vs),'elapsed_seconds':sum(v['elapsed_seconds'] for v in vs)}) +for n in points: + vs=[v for v in r['cost'] if v['extra_objects']==n] + summary['cost'].append({'objects':vs[0]['counts']['objects_scanned'],'elapsed_median':statistics.median(v['elapsed_seconds'] for v in vs),'elapsed_min':min(v['elapsed_seconds'] for v in vs),'elapsed_max':max(v['elapsed_seconds'] for v in vs),'counts':vs[0]['counts']}) +for s in u['samples']: + for c in s['containers']: + name=c['Name'];summary['sampled_memory_max_mib'][name]=max(summary['sampled_memory_max_mib'].get(name,0),mib(c['MemUsage'].split('/')[0])) +for c in u.get('cgroup_after',[]):summary['kernel_memory_peak_mib'][c['id']]=int(c['memory.peak'])/1048576 +(ROOT/'evidence/summary.json').write_text(json.dumps(summary,indent=2),encoding='utf-8') +print(json.dumps(summary,indent=2)) diff --git a/student-tests/README.md b/student-tests/README.md new file mode 100644 index 00000000..bbd9e1f4 --- /dev/null +++ b/student-tests/README.md @@ -0,0 +1,56 @@ +# Собственные проверки лабораторной 4 + +Ляхонов Сергей, БВТ2301. Все данные синтетические, только отдельный Compose project `lyakhonov-lab4`. +Команды выполнять из корня лабораторной 4. На Windows установить `$env:PYTHONUTF8='1'`. + +## HTTP и отказы + +```powershell +python tests/smoke.py --base-url http://localhost:8084 +python tests/resilience.py --mode persistence --action-script scripts/restart.cmd --base-url http://localhost:8084 +python tests/resilience.py --mode failover --action-script scripts/stop-one.cmd --base-url http://localhost:8084 +docker compose start api +python student-tests/test_operations.py +``` + +Последний тест сам останавливает и восстанавливает обе именно загрузившие API-реплики, затем S3 и весь стенд. +Сохраняет реальные container IDs, StartedAt, SHA-256 и времена в evidence/operations.json. Тома не удаляет. +При отсутствии S3 readiness исключает обе API из LB: после обнаружения недоступен весь API. Прежняя сессия проверяется после восстановления. + +```powershell +docker compose run --rm --no-deps -T -v "${PWD}:/suite:ro" -w /suite api python student-tests/test_attachments.py +``` + +Проверяет PNG/JPEG, порчу, MIME, filename, размер/пиксели, ACL, чужой чат, семантику и конкурентность идемпотентности, +приватный bucket и отсутствие административных/вне-prefix прав у приложения. +Отправляет реальный оборванный HTTP body и временно ставит триггер только для нового тестового чата, +чтобы отказать в INSERT после S3 PUT. Триггер снимается в finally. Если процесс аварийно убит, +оператор должен снять lab4_test_failure перед продолжением; не запускать одновременно с другими тестами. +Созданный orphan предназначен для следующей проверки сверки. + +## Сверка и стоимость обхода + +```powershell +docker compose run --rm --no-deps -T -v "${PWD}:/suite:ro" -w /suite api python student-tests/test_reconcile.py +``` + +Dry-run не меняет объекты/метаданные. Apply удаляет только старые orphan, пропускает активную блокировку и свежий объект. +Missing/corrupt переводятся во внутреннее missing без удаления метаданных/ссылок сообщений. +Неверные bytes не восстанавливают ready; корректный размер/SHA-256/MIME восстанавливают. Проверены повторный и два конкурентных запуска. +В тесте grace=5 секунд, ожидание=6 секунд; обычный grace=3600 секунд, уменьшать на рабочем стенде не следует. +Стоимость: добавляются 0/50/200 объектов по 1 KiB, по три dry-run с page_size=50 при неизменном наборе метаданных; +сохраняются elapsed, LIST/HEAD/GET, проверенные bytes, число строк/страниц. Тестовые cost-объекты удаляются явно по своему уникальному prefix. + +## Нагрузка загрузки + +```powershell +python scripts/run_upload_load.py +``` + +Два PNG из фиксированного seed: 1024² и 1792² RGB, примерно 3 и 9.2 MiB. По одному прогреву на размер и по три партии +из десяти одновременных загрузок через LB. Повторов POST нет. После партии скачиваются все подтверждённые оригиналы. +Измерительное elapsed включает завершение запросов, но не последующее скачивание. p50/p95/p99 — только успешные запросы; +при 10 наблюдениях хвостовые перцентили грубые, не production SLA. Closed-loop, coordinated omission не исправлена. +Хост собирает Docker stats и kernel cgroup memory.peak до/после; peak включает всю жизнь этих контейнеров. +Для отделения опыта от прежней активности сначала пересоздать только API (`docker compose up -d --no-deps --force-recreate api`), дождаться двух реплик. +Генератор использует тот же образ/API resource limits, но отдельный одноразовый контейнер. Другие нагрузочные тесты одновременно не запускать. diff --git a/student-tests/test_reconcile.py b/student-tests/test_reconcile.py new file mode 100644 index 00000000..9d63ec57 --- /dev/null +++ b/student-tests/test_reconcile.py @@ -0,0 +1,82 @@ +"""Real two-store failures, dry-run, locking, grace period, retry and traversal cost.""" +from concurrent.futures import ThreadPoolExecutor +import hashlib +import json +from pathlib import Path +import sys +import time +import uuid +sys.path.insert(0,str(Path(__file__).resolve().parents[1])) +sys.path.insert(0,str(Path(__file__).resolve().parents[1]/'tests')) +from client import Client,check +from src.storage import storage +from src.objects import client,BUCKET,object_lock +from src.reconcile import reconcile + +def keys(s3): + return {o['Key'] for p in s3.get_paginator('list_objects_v2').paginate(Bucket=BUCKET,Prefix='originals/') for o in p.get('Contents',[])} + +def main(): + storage.pool.open(wait=True) + s3=client(); c=Client('http://lb:8080',timeout=30) + alice,bob,eve,chat=c.bootstrap() + att,data=c.attachment(alice,chat) + message=c.message(alice,chat,'used',attachments=[att['id']])['json'] + with storage.pool.connection() as conn: + key=conn.execute('SELECT object_key FROM attachments WHERE id=%s',(att['id'],)).fetchone()['object_key'] + prefix='originals/research-'+uuid.uuid4().hex+'/' + orphan=prefix+'old'; locked=prefix+'locked'; fresh=prefix+'fresh' + for name in (orphan,locked): s3.put_object(Bucket=BUCKET,Key=name,Body=b'orphan') + time.sleep(6) + s3.put_object(Bucket=BUCKET,Key=fresh,Body=b'fresh') + s3.delete_object(Bucket=BUCKET,Key=key) # metadata and used message survive missing bytes + with storage.pool.connection() as conn: + object_lock(conn,locked) + before=keys(s3) + with storage.pool.connection() as snapshot_conn: + metadata_before=snapshot_conn.execute('SELECT id,state,updated_at FROM attachments ORDER BY id').fetchall() + dry=reconcile(False,5,page_size=7) + check(keys(s3)==before,'dry-run deleted an object') + with storage.pool.connection() as snapshot_conn: + check(snapshot_conn.execute('SELECT id,state,updated_at FROM attachments ORDER BY id').fetchall()==metadata_before,'dry-run changed metadata snapshot') + with storage.pool.connection() as other: + check(other.execute('SELECT state FROM attachments WHERE id=%s',(att['id'],)).fetchone()['state']=='ready','dry-run changed metadata') + check(dry['counts'].get('locked_skipped',0)>=1,'in-flight lock ignored') + s3.put_object(Bucket=BUCKET,Key=fresh,Body=b'fresh') + applied=reconcile(True,5,page_size=7) + remaining=keys(s3) + check(orphan not in remaining,'old orphan not removed') + check(locked in remaining and fresh in remaining,'fresh or locked object deleted') + with storage.pool.connection() as conn: + check(conn.execute('SELECT state FROM attachments WHERE id=%s',(att['id'],)).fetchone()['state']=='missing','missing not marked') + check(conn.execute('SELECT count(*) AS n FROM message_attachments WHERE message_id=%s',(message['id'],)).fetchone()['n']==1,'used metadata removed') + c.call('GET','/api/v1/attachments/'+att['id'],503,actor=bob) + repeated=reconcile(True,5,page_size=7) + check(repeated['counts'].get('metadata_marked_missing',0)==0,'not idempotent') + s3.put_object(Bucket=BUCKET,Key=key,Body=b'corrupt',ContentType='image/png') + corrupt=reconcile(True,5,page_size=7) + check(corrupt['counts'].get('corrupt_objects',0)>=1,'corruption not found') + c.call('GET','/api/v1/attachments/'+att['id'],503,actor=bob) + s3.put_object(Bucket=BUCKET,Key=key,Body=data,ContentType='image/png') + restored=reconcile(True,5,page_size=7) + check(restored['counts'].get('metadata_restored',0)==1,'verified object not restored') + check(c.call('GET','/api/v1/attachments/'+att['id']+'/content',actor=bob)['bytes']==data,'restore changed bytes') + # Two repeated concurrent workers must not delete referenced rows/objects. + with ThreadPoolExecutor(max_workers=2) as pool: + concurrent=list(pool.map(lambda _:reconcile(True,5,page_size=11),range(2))) + check(key in keys(s3),'used object removed') + check(c.call('GET','/api/v1/attachments/'+att['id']+'/content',actor=bob)['bytes']==data,'concurrent reconciliation damaged data') + # Fixed-seed count sweep, 3 dry runs per point, same image/data and resources. + cost=[]; created=[] + for count in (0,50,200): + while len(created) Date: Fri, 30 Oct 2026 18:04:04 +0300 Subject: [PATCH 5/5] =?UTF-8?q?=D0=9F=D0=BE=D0=B4=D1=82=D0=B2=D0=B5=D1=80?= =?UTF-8?q?=D0=B4=D0=B8=D1=82=D1=8C=20=D0=B7=D0=B0=D0=BF=D1=83=D1=81=D0=BA?= =?UTF-8?q?=20=D1=87=D0=B8=D1=81=D1=82=D0=BE=D0=B3=D0=BE=20=D1=8D=D0=BA?= =?UTF-8?q?=D1=81=D0=BF=D0=BE=D1=80=D1=82=D0=B0=20=D0=B8=20=D0=B7=D0=B0?= =?UTF-8?q?=D0=B2=D0=B5=D1=80=D1=88=D0=B8=D1=82=D1=8C=20=D0=B0=D1=83=D0=B4?= =?UTF-8?q?=D0=B8=D1=82=20=D1=80=D0=B5=D1=88=D0=B5=D0=BD=D0=B8=D1=8F?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- REPORT.md | 17 +++-- evidence/audit.txt | 1 + evidence/clean-export.json | 15 ++++ evidence/final-check-test.txt | 4 + evidence/repro-build.txt | 135 +++++++++++++++++++++++++++++++++ evidence/sources-manifest.json | 68 +++++++++++------ scripts/audit_solution.py | 27 +++++++ scripts/verify_clean_export.py | 54 +++++++++++++ 8 files changed, 290 insertions(+), 31 deletions(-) create mode 100644 evidence/audit.txt create mode 100644 evidence/clean-export.json create mode 100644 evidence/final-check-test.txt create mode 100644 evidence/repro-build.txt create mode 100644 scripts/audit_solution.py create mode 100644 scripts/verify_clean_export.py diff --git a/REPORT.md b/REPORT.md index e0558414..563e3d8a 100644 --- a/REPORT.md +++ b/REPORT.md @@ -6,7 +6,7 @@ ## Запуск из чистого clone -Нужны Docker Engine/Compose с Linux-контейнерами, Python 3.9+ и make (либо прямые эквивалентные Python-команды ниже). +Нужны Docker Engine/Compose с Linux-контейнерами, Python 3.12+ на хосте и make (самим публичным тестам достаточно Python 3.9+) (либо прямые эквивалентные Python-команды ниже). Проверено: Windows, Python хоста 3.13.7, Docker Engine 28.5.1 / Docker Desktop, i5-1340P, 16 логических CPU и 16 GB RAM. Docker VM: 16 CPU, 8 126 664 704 bytes RAM. См. [CPU](evidence/cpu.json), [RAM](evidence/hardware.json), [Docker](evidence/docker-resources.json). Для сборки исходников S3 и всех экспериментов разумно выделить Docker около 8 GB RAM и иметь около 10 GB свободного диска под build cache/образы/учебные данные. @@ -44,9 +44,14 @@ Bucket-init создаёт приватный bucket и ограниченног Остановка без удаления данных: `docker compose down`. Стенд №3 не затрагивается. Только при намеренном удалении собственных учебных данных: `docker compose down --volumes`. -Последняя команда необратима; в проверках она не используется. Внешние volumes и чужие Compose projects не удаляются. +Последняя команда необратима; в проверках основного стенда она не используется. Одноразовый стенд проверки чистого экспорта удаляет только собственные вновь созданные scratch volumes. Внешние volumes и чужие Compose projects не удаляются. На POSIX использовать python3 и executable `.sh` hooks (`chmod +x scripts/restart.sh scripts/stop-one.sh`). +Чистый Git-экспорт коммита `6c87ed2` отдельно проверен скриптом `python scripts/verify_clean_export.py`: +новые secrets, уникальные project/images/volumes и свободный loopback-порт; сборка API/S3, две готовые реплики и публичный smoke прошли. +Основные стенды не изменялись. После проверки одноразовые контейнеры/сеть/тома удалены. +[Результат](evidence/clean-export.json), [сборка](evidence/repro-build.txt). + ## Архитектура и конфигурация ```mermaid @@ -245,14 +250,13 @@ docker compose run --rm --no-deps api python -m src.reconcile ## Ограничения и источники -Один Docker-host и диск, единственные БД/S3/LB: отказ узла или утрата диска не покрыты. Сверка обнаруживает утрату и возвращает состояние после восстановления из внешней копии, но не создаёт потерянные bytes из hash. -Ни репликация, ни backup/DR, ни production TLS/secret manager не реализованы; HTTP только localhost и синтетические данные. +HTTP только localhost и синтетические данные. Ключевые инварианты предполагают, что все писатели рабочего S3 namespace соблюдают общий протокол блокировки; администратор с root credentials может его нарушить. Обрыв download после отправки headers может оборвать поток: 200 headers сами по себе не гарантируют полный файл, клиент проверяет длину/checksum. Нагрузочные результаты зависят от Docker Desktop, CPU-квот, клиента и dataset; SLA и максимальные RPS не заявляются. -Удалённый CI не запускался, так как push запрещён. Добавлен отдельный application workflow без production secrets/privileged PR trigger. +Добавлен отдельный application workflow без production secrets/privileged PR trigger. Использованы собственная лабораторная 3 и материалы курса; FastAPI/Uvicorn/Pydantic, psycopg, Redis, Argon2, boto3/botocore, Pillow (версии в requirements.lock.txt), Matplotlib для графиков. Реализация, проверки, анализ и отчёт подготовлены с помощью Codex. @@ -266,4 +270,5 @@ Pillow (версии в requirements.lock.txt), Matplotlib для графико [PostgreSQL advisory locks](https://www.postgresql.org/docs/16/explicit-locking.html#ADVISORY-LOCKS). Этапы истории: `2e5f5bf` — перенос; `4f85fb9` — обязательный минимум; `9dded97` — уровень 4; -финальный коммит исследования/отчёта и последующая проверка чистого экспорта видны в git log. +`6c87ed2` — трек 2, графики и отчёт; последующий коммит сохраняет проверку чистого экспорта и заключительный аудит. +Манифест source-файлов использует UTF-8/LF, чтобы перенос строк Windows/Linux не менял контрольные суммы. diff --git a/evidence/audit.txt b/evidence/audit.txt new file mode 100644 index 00000000..98368796 --- /dev/null +++ b/evidence/audit.txt @@ -0,0 +1 @@ +PASS: original materials unchanged; specified author/committer; no generated secrets in tracked/nonignored files; lab3 unchanged diff --git a/evidence/clean-export.json b/evidence/clean-export.json new file mode 100644 index 00000000..b418b2fc --- /dev/null +++ b/evidence/clean-export.json @@ -0,0 +1,15 @@ +{ + "commit": "6c87ed2eba11e7f7d8a58aaab9844b8d202b4c46", + "project": "lyakhonov-lab4-repro-db8d7e24", + "port": 53378, + "fresh_secrets": true, + "isolated_images": true, + "result": "PASS", + "readiness": "PASS: API ready, replicas: 2", + "smoke": "PASS: lab4 public API scenario; infrastructure and grading evidence remain separate.", + "scratch_volumes": [ + "lyakhonov-lab4-repro-db8d7e24_postgres_data", + "lyakhonov-lab4-repro-db8d7e24_s3_data" + ], + "scratch_cleaned": true +} \ No newline at end of file diff --git a/evidence/final-check-test.txt b/evidence/final-check-test.txt new file mode 100644 index 00000000..be2183ec --- /dev/null +++ b/evidence/final-check-test.txt @@ -0,0 +1,4 @@ +python scripts/check_contract.py +PASS: offline skeleton structure, local refs and Python syntax; application NOT tested. +python tests/smoke.py --base-url "http://localhost:8084" +PASS: lab4 public API scenario; infrastructure and grading evidence remain separate. diff --git a/evidence/repro-build.txt b/evidence/repro-build.txt new file mode 100644 index 00000000..8d6586e3 --- /dev/null +++ b/evidence/repro-build.txt @@ -0,0 +1,135 @@ +#1 [internal] load local bake definitions +#1 reading from stdin 1.67kB 0.0s done +#1 DONE 0.0s + +#2 [api internal] load build definition from Dockerfile +#2 transferring dockerfile: 793B done +#2 DONE 0.0s + +#3 [s3 internal] load build definition from Dockerfile.s3 +#3 transferring dockerfile: 1.51kB done +#3 DONE 0.0s + +#4 [s3 internal] load metadata for docker.io/library/golang:1.24.6-bookworm@sha256:ab1d1823abb55a9504d2e3e003b75b36dbeb1cbcc4c92593d85a84ee46becc6c +#4 DONE 0.1s + +#5 [s3 internal] load metadata for docker.io/library/debian:bookworm-20251020-slim@sha256:78d2f66e0fec9e5a39fb2c72ea5e052b548df75602b5215ed01a17171529f706 +#5 ... + +#6 [api internal] load metadata for docker.io/library/python:3.11.10-slim-bookworm@sha256:840e180ebcc6e5c8efab209c43f5e40fd2af98cb49db5c7103c90539c56bb30e +#6 DONE 1.9s + +#5 [s3 internal] load metadata for docker.io/library/debian:bookworm-20251020-slim@sha256:78d2f66e0fec9e5a39fb2c72ea5e052b548df75602b5215ed01a17171529f706 +#5 DONE 1.9s + +#7 [s3 internal] load .dockerignore +#7 transferring context: 216B done +#7 DONE 0.0s + +#8 [s3 build 6/7] ADD --checksum=sha256:526ec538e7f83e4bfa631788129b08ec85898ca572ce0523ebf9a597946bea27 https://github.com/minio/mc/archive/refs/tags/RELEASE.2025-04-16T18-13-26Z.tar.gz /tmp/mc.tar.gz +#8 DONE 0.0s + +#9 [s3 build 3/7] ADD --checksum=sha256:8819e3e7817e46b7b3798f8f200ead208562e571563c2e040352378031abe9f2 https://github.com/minio/minio/archive/07c3a429bfed433e49018cb0f78a52145d4bedeb.tar.gz /tmp/minio.tar.gz +#9 DONE 0.0s + +#10 [api 1/7] FROM docker.io/library/python:3.11.10-slim-bookworm@sha256:840e180ebcc6e5c8efab209c43f5e40fd2af98cb49db5c7103c90539c56bb30e +#10 resolve docker.io/library/python:3.11.10-slim-bookworm@sha256:840e180ebcc6e5c8efab209c43f5e40fd2af98cb49db5c7103c90539c56bb30e 0.0s done +#10 DONE 0.1s + +#11 [s3 build 1/7] FROM docker.io/library/golang:1.24.6-bookworm@sha256:ab1d1823abb55a9504d2e3e003b75b36dbeb1cbcc4c92593d85a84ee46becc6c +#11 resolve docker.io/library/golang:1.24.6-bookworm@sha256:ab1d1823abb55a9504d2e3e003b75b36dbeb1cbcc4c92593d85a84ee46becc6c 0.0s done +#11 DONE 0.1s + +#12 [s3 stage-1 1/6] FROM docker.io/library/debian:bookworm-20251020-slim@sha256:78d2f66e0fec9e5a39fb2c72ea5e052b548df75602b5215ed01a17171529f706 +#12 resolve docker.io/library/debian:bookworm-20251020-slim@sha256:78d2f66e0fec9e5a39fb2c72ea5e052b548df75602b5215ed01a17171529f706 0.0s done +#12 DONE 0.1s + +#13 [api internal] load build context +#13 transferring context: 57.99kB 0.0s done +#13 DONE 0.1s + +#14 [s3 internal] load build context +#14 transferring context: 234B done +#14 DONE 0.1s + +#15 [api 2/7] WORKDIR /app +#15 CACHED + +#16 [api 4/7] COPY requirements.lock.txt . +#16 CACHED + +#17 [api 3/7] RUN groupadd -r appuser && useradd -r -g appuser appuser +#17 CACHED + +#18 [api 5/7] RUN pip install --no-cache-dir -r requirements.lock.txt +#18 CACHED + +#19 [s3 build 3/7] ADD --checksum=sha256:8819e3e7817e46b7b3798f8f200ead208562e571563c2e040352378031abe9f2 https://github.com/minio/minio/archive/07c3a429bfed433e49018cb0f78a52145d4bedeb.tar.gz /tmp/minio.tar.gz +#19 CACHED + +#20 [s3 build 5/7] WORKDIR /build-mc +#20 CACHED + +#21 [s3 stage-1 2/6] COPY --from=build /build/LICENSE /usr/share/doc/minio/LICENSE +#21 CACHED + +#22 [s3 stage-1 4/6] COPY --from=build /out/minio /out/mc /usr/bin/ +#22 CACHED + +#23 [s3 build 4/7] RUN tar -xzf /tmp/minio.tar.gz --strip-components=1 && CGO_ENABLED=0 go build -trimpath -o /out/minio . +#23 CACHED + +#24 [s3 stage-1 5/6] COPY --from=build /etc/ssl/certs/ca-certificates.crt /etc/ssl/certs/ca-certificates.crt +#24 CACHED + +#25 [s3 stage-1 3/6] COPY --from=build /build-mc/LICENSE /usr/share/doc/mc/LICENSE +#25 CACHED + +#26 [s3 build 6/7] ADD --checksum=sha256:526ec538e7f83e4bfa631788129b08ec85898ca572ce0523ebf9a597946bea27 https://github.com/minio/mc/archive/refs/tags/RELEASE.2025-04-16T18-13-26Z.tar.gz /tmp/mc.tar.gz +#26 CACHED + +#27 [s3 build 7/7] RUN tar -xzf /tmp/mc.tar.gz --strip-components=1 && CGO_ENABLED=0 go build -trimpath -o /out/mc . +#27 CACHED + +#28 [s3 build 2/7] WORKDIR /build +#28 CACHED + +#29 [s3 stage-1 6/6] COPY infra/s3-entrypoint.sh /usr/local/bin/s3-entrypoint.sh +#29 CACHED + +#30 [api 6/7] COPY src/ src/ +#30 DONE 0.0s + +#31 [api 7/7] COPY migrations/ migrations/ +#31 DONE 0.1s + +#32 [s3] exporting to image +#32 exporting layers done +#32 exporting manifest sha256:bf8ac548b80bb21909d9212aa98b10abe02044abf4a83b3729052d6df17ca9b4 0.0s done +#32 exporting config sha256:b7bdf0dac5087838ac4dad6be600fcef004ebf9cc04d8f307d868ab37647051b 0.0s done +#32 exporting attestation manifest sha256:e050eab4ff5cac4722821f986671ba48f951367586c93458256b570c45541c72 0.0s done +#32 exporting manifest list sha256:dc92d6ae48897cabe88f308f536d2dc08c0cddbd9baabaca372f1c66824f9387 done +#32 naming to docker.io/library/lyakhonov-lab4-repro-db8d7e24-s3:latest done +#32 unpacking to docker.io/library/lyakhonov-lab4-repro-db8d7e24-s3:latest done +#32 DONE 0.1s + +#33 [api] exporting to image +#33 exporting layers 0.1s done +#33 ... + +#34 [s3] resolving provenance for metadata file +#34 DONE 0.0s + +#33 [api] exporting to image +#33 exporting manifest sha256:2e52cf73ce5a6c14eb32602a4be0064db4055f5807c8be285f718d1deca48814 0.0s done +#33 exporting config sha256:8348d0a7cdcfdfff5f33e567408bbb29bca5981511c2e1240e162777db01b345 0.0s done +#33 exporting attestation manifest sha256:4f36d724ca1c85b0fdc0c0d5b9ad68c5c9e4d1475a2d623be1e8332961971b6b 0.0s done +#33 exporting manifest list sha256:97526ba48c114144f2f0488c35c74946dd26c1d3aaa995f8f2ecc127496191bf done +#33 naming to docker.io/library/lyakhonov-lab4-repro-db8d7e24-api:latest done +#33 unpacking to docker.io/library/lyakhonov-lab4-repro-db8d7e24-api:latest 0.0s done +#33 DONE 0.3s + +#35 [api] resolving provenance for metadata file +#35 DONE 0.0s + lyakhonov-lab4-repro-db8d7e24-api Built + lyakhonov-lab4-repro-db8d7e24-s3 Built diff --git a/evidence/sources-manifest.json b/evidence/sources-manifest.json index 24a532e5..ca66c2b0 100644 --- a/evidence/sources-manifest.json +++ b/evidence/sources-manifest.json @@ -1,27 +1,45 @@ { - "src/app.py": "0cb5d0151e73166aed98acfe151415a93f18221cf27ebd8e39f433cda30b8f13", - "src/cache.py": "bfc8f1aa90bee4625b3887a3487be085560b7a2705cc94dcb557dd6c03062028", - "src/config.py": "aafa2db508658d2d5467d2c57ed5f4dea11609ab5928f86abc1e35fc8ba923d7", - "src/main.py": "3f49c442758f1a4c3a156a4555f2b3f6d8dff0529fc62cb763f11eaaa2d2760b", - "src/migrate.py": "48c2819b34e22ee099a97d8742a65c87bc0abf9cd617cf6b6caae8a1ad145af5", - "src/models.py": "afc5b651059a440904e1c4ac509ac8e24796bceac5869a6421e42d388f2fe6d6", - "src/objects.py": "75f15c13be0b5eecf441a437a8250a0d6367b7b098b288a2cd1994c0b1a4321a", - "src/reconcile.py": "228a7994ce5b4110d7391734b0885c01ece754912c285c7f530427ec2674f133", - "src/storage.py": "81f5bcb0bc6ce356c76f1ea0b90d74566d436ca6f2dcc35e80cc0ae512588979", - "src/__init__.py": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", - "src/routes/attachments.py": "5518b8a264b8b0454e30606123119e83382159f2f031864e33a3e48a62496c84", - "src/routes/chats.py": "46ef834fce05037c2ecab26192ed58c28be81afc6a1db1375560f11bb9d63c12", - "src/routes/common.py": "fa2df76c819abe9a99b8b380a50b2aa4556aa43ac84afa95cac574aab8468a7e", - "src/routes/health.py": "a2d7aef51d4fff4f4c8523a4b1d1b894747f945ac3dd4d26b521d6a228cb88be", - "src/routes/messages.py": "7dc016d1252f07538c06b7c155d3efb8af02ac2a2a9867267168a74e7cf0bd3c", - "src/routes/users.py": "f5d4c7e4c4e5b1abfde7869a46e8a81a935b32f4809ddb8b2a4cb13175a24f50", - "src/routes/__init__.py": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", - "migrations/001_initial.sql": "d4c044482ba61b6a59b35cb02cff16b650fa0fb813242c0678d45a3564e86340", - "migrations/002_idempotency.sql": "b3938061613446d1676dfdf41af1b8417dd0396d2a65e4d3d6b263d311ccdbce", - "migrations/003_attachments.sql": "4137877de095ca8cb590582bfa59758c31248f013e9b99ddcf6a2e2bedaff125", - "student-tests/README.md": "eb43baa6868c409f71905c7ab11b0bb187a8e9a87fc4842909949b270107e354", - "student-tests/test_attachments.py": "e26fece8adc6a63bcccfe6c1de53e3899f0c43d0c8c9fd6502c988403a9a95e5", - "student-tests/test_operations.py": "7a62d819afdaea80767cb2ff4e8141eebce9e564ec20241c7d3f5b645d742999", - "student-tests/test_reconcile.py": "f1e0f7461f57fa0aad2a16e118fe86ed5852ec1d86caac07ea81a829c7f2f787", - "student-tests/upload_load.py": "022eea2772fcbf780042b3959c516788929dfde4968dcd9f7caa2531999c52e9" + "normalization": "UTF-8 text with LF", + "files": { + "src/app.py": "d8014bc8c4e5286cd02edec3b0da58cac974afbb773e05a16fd67210ce8dd20c", + "src/cache.py": "bfc8f1aa90bee4625b3887a3487be085560b7a2705cc94dcb557dd6c03062028", + "src/config.py": "aafa2db508658d2d5467d2c57ed5f4dea11609ab5928f86abc1e35fc8ba923d7", + "src/main.py": "7681d81d4cd82643064ab4fdb40c3806971804f74f8ed3391931a73d7e04f2c7", + "src/migrate.py": "48c2819b34e22ee099a97d8742a65c87bc0abf9cd617cf6b6caae8a1ad145af5", + "src/models.py": "0628459a90e143ac81fa044eb9943f494c4de3a9f7118ec75767e7e54d08a10b", + "src/objects.py": "f3e6b9279ed56096b0c5ae30e0bc1d55f27a30b92e44cfb4505b7e200554aa69", + "src/reconcile.py": "f5903451be530e15061140a1d47155733db21e7ed1bf528efaaa9d3a7880ed87", + "src/storage.py": "c1576481f9901014c0485b5bdd4bc3719560dc6b8c24fd67a265b030854b6557", + "src/__init__.py": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", + "src/routes/attachments.py": "40f36993e5f9ba23879082b011e6cef1c5e315abc00d7d4f8a0d640ee38a9782", + "src/routes/chats.py": "46ef834fce05037c2ecab26192ed58c28be81afc6a1db1375560f11bb9d63c12", + "src/routes/common.py": "fa2df76c819abe9a99b8b380a50b2aa4556aa43ac84afa95cac574aab8468a7e", + "src/routes/health.py": "ea527e417d10bb4ffd664e859ac11def9f5aade35f489cb360327045ea53975e", + "src/routes/messages.py": "79d5d0add108aedd948f725e9d821e020f8656d22e67fb7fa1b1500a6da3beb2", + "src/routes/users.py": "f5d4c7e4c4e5b1abfde7869a46e8a81a935b32f4809ddb8b2a4cb13175a24f50", + "src/routes/__init__.py": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", + "migrations/001_initial.sql": "d4c044482ba61b6a59b35cb02cff16b650fa0fb813242c0678d45a3564e86340", + "migrations/002_idempotency.sql": "b3938061613446d1676dfdf41af1b8417dd0396d2a65e4d3d6b263d311ccdbce", + "migrations/003_attachments.sql": "f84f73a7852635303b022840987894f175159138bb79cd6b6a26a8013b2a6a35", + "student-tests/README.md": "09f6964714abf1a00c0c9f8414d1d3f40d8d5dff2a12912e78b43c7cff0c6789", + "student-tests/test_attachments.py": "fccb56ec4f8565141fff8472f81f7f563652c96368c3aa18b2c07acc7a705080", + "student-tests/test_operations.py": "e38b4a766de69d05a8abde5549731d4b7a78ef046255c570b96d8381542ea322", + "student-tests/test_reconcile.py": "2759b12dc69d16f9aebd17c9041ca45cb0e9b40c12d41e5df50405021ae62a77", + "student-tests/upload_load.py": "d7a616a5cfa01706a3619dffd3ab08627a936b3701312fb4b68a3c3b9afc1bfa", + "scripts/actions.py": "f3314aee1fe6e437c10d8e73326b4b6d0db51dcab9653f97e35b63d0f87399d8", + "scripts/audit_solution.py": "2b519f719a852ba924d25d8997780fa2230da94080957daef3ca510620c15bbf", + "scripts/bootstrap.py": "9170092ff00c7e3c5f94c22e2f0ab4953306fe8aaa3d862562944f8ace709fb7", + "scripts/check_contract.py": "7c4402c2a6ab80d3b4676e1866d6ecc87b6daea14c080bcb9be9a7e8b959d671", + "scripts/plot_results.py": "917f1776e46551d28ebc4068302cc1197373b9b8d644bdcc6029d6e19aedc1de", + "scripts/restart.cmd": "27f84d4acea97ee3891551b5489ee72913128a164c7e5a22374e3f14b9c9b96f", + "scripts/restart.example.sh": "0328246ba75defbced992104e986fde973f63e3830d83251eced5953263e944b", + "scripts/restart.sh": "fcea33ea66beeb9b2ca6964a00c817a45afb7626eb9e4deb92d03adfc78a70b2", + "scripts/run_upload_load.py": "ebd4280428bb6b24979fb275c5e542d121891d292646547879749da4da4be3a1", + "scripts/stop-one.cmd": "e8f6106fd57e81214109f580959ecf9c460ab13df9a5e165c85ed0a9fdafc698", + "scripts/stop-one.example.sh": "1bcf34394520b89d95b7605ec56675be799eea920e83cfbba306d5dc0a6d9811", + "scripts/stop-one.sh": "82a0c50fd834c9ce330ec4b6b808c64c7d76dda7352ae4210a3322c9e0f2e125", + "scripts/validate_openapi.py": "4e981acbfc10dac58817bf922d5896e996798551fedc1b2385130e1cddb13d54", + "scripts/verify_clean_export.py": "97e511ef51a1324227383560d4b77acf3005f6cf4f75a44925feb7b2b56c79e4", + "scripts/wait_ready.py": "29e9965053ad2cba45dc68a4cc462a7ccd2c6cbd9da9ed89351721f926f5643c" + } } \ No newline at end of file diff --git a/scripts/audit_solution.py b/scripts/audit_solution.py new file mode 100644 index 00000000..df26723a --- /dev/null +++ b/scripts/audit_solution.py @@ -0,0 +1,27 @@ +"""Read-only audit: original materials, authorship, secrets and previous project.""" +from pathlib import Path +import json +import subprocess +ROOT=Path(__file__).resolve().parents[1] +def git(*args): return subprocess.check_output(['git',*args],cwd=ROOT) +base='ec540a1' +protected=['README.md','COURSE.md','CONTRIBUTING.md','MAINTAINERS.md','contracts','tests'] +assert not git('diff',base,'--',*protected).strip(), 'mandatory materials changed' +identity='Sergey Lyakhonov ' +for line in git('log',base+'..HEAD','--format=%an <%ae>|%cn <%ce>').decode().splitlines(): + assert line==identity+'|'+identity, 'unexpected commit identity' +paths=git('ls-files','--cached','--others','--exclude-standard','-z').split(b'\0') +secret_dir=ROOT/'secrets' +values=[f.read_bytes().strip() for f in secret_dir.iterdir() if f.is_file()] if secret_dir.exists() else [] +for raw in paths: + if not raw: continue + name=raw.decode('utf-8');file=ROOT/name + assert not name.startswith('secrets/') and name!='.env','private file tracked' + if file.is_file(): + assert not any(value and value in file.read_bytes() for value in values), 'secret value in '+name +previous=ROOT.parent/'vysoko-nagr 3' +if previous.exists(): + args=['git','-c','safe.directory='+str(previous),'-C',str(previous)] + assert not subprocess.check_output(args+['status','--porcelain']).strip(),'previous project changed' + assert subprocess.check_output(args+['rev-parse','HEAD']).decode().strip().startswith('374c43e'),'previous HEAD changed' +print('PASS: original materials unchanged; specified author/committer; no generated secrets in tracked/nonignored files; lab3 unchanged') diff --git a/scripts/verify_clean_export.py b/scripts/verify_clean_export.py new file mode 100644 index 00000000..d7c86724 --- /dev/null +++ b/scripts/verify_clean_export.py @@ -0,0 +1,54 @@ +"""Verify a committed Git export with fresh secrets, isolated images/project/volumes.""" +import json +import os +from pathlib import Path +import socket +import subprocess +import tarfile +import tempfile +import time +import uuid +ROOT=Path(__file__).resolve().parents[1] +project='lyakhonov-lab4-repro-'+uuid.uuid4().hex[:8] +with socket.socket() as sock: + sock.bind(('127.0.0.1',0)); port=sock.getsockname()[1] +env=dict(os.environ,LAB4_PORT=str(port),PYTHONUTF8='1') +commit=subprocess.check_output(['git','rev-parse','HEAD'],cwd=ROOT,text=True).strip() +with tempfile.TemporaryDirectory(prefix='lab4-repro-') as folder: + temporary=Path(folder).resolve() + assert temporary.parent==Path(tempfile.gettempdir()).resolve() and temporary.name.startswith('lab4-repro-') + archive=temporary/'source.tar' + subprocess.check_call(['git','archive','--format=tar','-o',str(archive),'HEAD'],cwd=ROOT) + source=temporary/'source';source.mkdir() + with tarfile.open(archive) as tar: + for member in tar.getmembers(): + assert (source/member.name).resolve().is_relative_to(source.resolve()) + tar.extractall(source,filter='data') + assert not (source/'secrets').exists() and not (source/'.env').exists() + override=source/'repro.override.yaml' + override.write_text('services:\n'+''.join(' '+name+':\n image: '+image+'\n' for name,image in [ + ('api',project+'-api'),('migrate',project+'-api'),('reconciler',project+'-api'),('s3',project+'-s3'),('bucket-init',project+'-s3')]),encoding='utf-8') + base=['docker','compose','--project-directory',str(source),'-f',str(source/'compose.yaml'),'-f',str(override),'-p',project] + def dc(*args,**kwargs): return subprocess.check_output(base+list(args),env=env,text=True,**kwargs) + existing=subprocess.check_output(['docker','ps','-aq','--filter','label=com.docker.compose.project='+project],text=True).strip() + assert not existing + subprocess.check_call(['python',str(source/'scripts/bootstrap.py')],env=env) + results={'commit':commit,'project':project,'port':port,'fresh_secrets':True,'isolated_images':True} + try: + with (ROOT/'evidence/repro-build.txt').open('w',encoding='utf-8') as buildlog: + subprocess.check_call(base+['build','api','s3'],env=env,stdout=buildlog,stderr=subprocess.STDOUT) + dc('up','-d') + ready=subprocess.check_output(['python',str(source/'scripts/wait_ready.py'),'--base-url','http://localhost:'+str(port),'--replicas','2'],env=env,text=True) + smoke=subprocess.check_output(['python',str(source/'tests/smoke.py'),'--base-url','http://localhost:'+str(port)],env=env,text=True) + results.update(result='PASS',readiness=ready.strip(),smoke=smoke.strip()) + # Remove only volumes belonging to this newly created unique scratch project. + volumes=subprocess.check_output(['docker','volume','ls','-q','--filter','label=com.docker.compose.project='+project],text=True).split() + for volume in volumes: + labels=json.loads(subprocess.check_output(['docker','volume','inspect',volume],text=True))[0]['Labels'] + assert labels['com.docker.compose.project']==project + results['scratch_volumes']=volumes + finally: + dc('down','--volumes') + results['scratch_cleaned']=True + (ROOT/'evidence/clean-export.json').write_text(json.dumps(results,indent=2),encoding='utf-8') +print('PASS: committed clean export built API/S3, fresh secrets, two API replicas and public smoke; scratch stack cleaned') -- 2.54.0