diff --git a/src/app/api/health.py b/src/app/api/health.py index 26333c50..9676c2bd 100644 --- a/src/app/api/health.py +++ b/src/app/api/health.py @@ -24,20 +24,21 @@ def liveness() -> Health: response_model=Health, ) def readiness() -> Health: - """200, если PostgreSQL и (в режиме redis) Redis доступны. + """200, если PostgreSQL, Redis (в режиме redis) и S3 доступны. - При недоступности зависимости исключение вылетает наверх, и main.py - конвертирует его в 503 с телом Error из contracts/openapi.json. + При недоступности зависимости выбрасываем RuntimeError("*_unavailable"), + main.py конвертирует его в 503 с телом Error из contracts/openapi.json. + Все проверки — с короткими таймаутами, чтобы не зависать надолго. """ with _db.connection() as conn, conn.cursor() as cur: cur.execute("SELECT 1") cur.fetchone() # Redis (в режиме redis) if _store() == "redis": - # _redis_client() сам поднимает RuntimeError("redis_unavailable") - # при ошибке; main.runtime_error_handler → 503 Error. _redis_client().ping() # S3: HEAD несуществующего ключа. 404/None → S3 доступен. + # Короткий таймаут клиента гарантирует быстрый ответ, а ошибка + # преобразуется в RuntimeError("s3_unavailable") → 503. try: _s3.head_object("attachments/__health_probe__") except Exception as exc: # noqa: BLE001 diff --git a/src/app/main.py b/src/app/main.py index c9bc7cb0..128f4d64 100644 --- a/src/app/main.py +++ b/src/app/main.py @@ -150,6 +150,9 @@ async def runtime_error_handler(request: Request, exc: RuntimeError): if "redis_unavailable" in text: logger.error("event=redis_unavailable request_id=%s", request_id) return _error_response(503, "Зависимость недоступна", request_id, request.url.path) + if "s3_unavailable" in text: + logger.error("event=s3_unavailable request_id=%s", request_id) + return _error_response(503, "Зависимость недоступна", request_id, request.url.path) logger.error("event=runtime_error type=%s request_id=%s", type(exc).__name__, request_id) return _error_response(500, "Внутренняя ошибка", request_id, request.url.path) diff --git a/src/app/storage/s3.py b/src/app/storage/s3.py index badbd7f8..29a03c15 100644 --- a/src/app/storage/s3.py +++ b/src/app/storage/s3.py @@ -21,14 +21,24 @@ def _bucket() -> str: def client(): - """Клиент с прикладными credentials (не admin).""" + """Клиент с прикладными credentials (не admin). + + Явные короткие таймауты: connect/read — чтобы при недоступности S3 + запросы падали быстро и LB отдавал 503, а не 504 по своему timeout. + """ return boto3.client( "s3", endpoint_url=_endpoint(), region_name=os.environ.get("S3_REGION", "us-east-1"), aws_access_key_id=os.environ["S3_APP_KEY_ID"], aws_secret_access_key=os.environ["S3_APP_SECRET_KEY"], - config=Config(signature_version="s3v4", s3={"addressing_style": "path"}), + config=Config( + signature_version="s3v4", + s3={"addressing_style": "path"}, + connect_timeout=2, + read_timeout=3, + retries={"max_attempts": 0}, + ), )