Control Server (FastAPI) с WEB UI (Jinja2 + HTMX) и JSON API для группового администрирования устройств RouterOS 7 через REST. - Устройства: список, статус (модель, канал, версии ROS/FW, uptime, доступные обновления), примечания, пароли шифруются (Fernet); фоновый опрос каждые 30 с и быстрое обнаружение недоступности (таймаут соединения 4 с). - Группы устройств и фильтры (устройства, резервные копии). - Резервные копии: .backup и .rsc (show-sensitive) создаются через REST, скачиваются сервером и загружаются в S3 (Yandex Object Storage). - Обновление ROS/FW и выбор канала, групповые операции задачами. - Интерфейс по утверждённому макету: светлая/тёмная темы, окна, шрифты IBM Plex локально. Docker Compose, SQLite в томе, минимальный набор тестов. - Планы и итоги каждого изменения — в docs/changes/. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
62 lines
2.1 KiB
Python
62 lines
2.1 KiB
Python
"""Yandex Object Storage (S3-совместимый): ListObjectsV2, GetObject, PutObject, DeleteObject."""
|
|
import asyncio
|
|
from functools import lru_cache
|
|
|
|
import boto3
|
|
from botocore.config import Config
|
|
|
|
from app.config import get_settings
|
|
|
|
|
|
@lru_cache
|
|
def _client():
|
|
s = get_settings()
|
|
return boto3.client(
|
|
"s3",
|
|
endpoint_url=s.s3_endpoint,
|
|
region_name=s.s3_region,
|
|
aws_access_key_id=s.s3_access_key,
|
|
aws_secret_access_key=s.s3_secret_key,
|
|
config=Config(signature_version="s3v4"),
|
|
)
|
|
|
|
|
|
def device_prefix(device_name: str) -> str:
|
|
return f"{get_settings().s3_prefix}/{device_name}/"
|
|
|
|
|
|
def key_allowed(key: str) -> bool:
|
|
"""Ключ должен лежать под префиксом бэкапов (защита от произвольных ключей бакета)."""
|
|
return key.startswith(get_settings().s3_prefix + "/") and ".." not in key
|
|
|
|
|
|
def presign_get(key: str, expires: int = 300) -> str:
|
|
return _client().generate_presigned_url(
|
|
"get_object", Params={"Bucket": get_settings().s3_bucket, "Key": key}, ExpiresIn=expires
|
|
)
|
|
|
|
|
|
def _list(prefix: str) -> list[dict]:
|
|
paginator = _client().get_paginator("list_objects_v2")
|
|
items = []
|
|
for page in paginator.paginate(Bucket=get_settings().s3_bucket, Prefix=prefix):
|
|
for o in page.get("Contents", []):
|
|
items.append({"key": o["Key"], "size": o["Size"], "last_modified": o["LastModified"]})
|
|
return sorted(items, key=lambda i: i["last_modified"], reverse=True)
|
|
|
|
|
|
async def list_backups(device_name: str | None = None) -> list[dict]:
|
|
prefix = device_prefix(device_name) if device_name else get_settings().s3_prefix + "/"
|
|
return await asyncio.to_thread(_list, prefix)
|
|
|
|
|
|
async def upload_file(path, key: str) -> None:
|
|
"""PutObject: загрузка файла в бакет от имени Control Server."""
|
|
await asyncio.to_thread(_client().upload_file, str(path), get_settings().s3_bucket, key)
|
|
|
|
|
|
async def delete_object(key: str) -> None:
|
|
await asyncio.to_thread(
|
|
_client().delete_object, Bucket=get_settings().s3_bucket, Key=key
|
|
)
|