Sergey Antropoff
6f3daa33ec
- Шапка: логотип Kubernetes, ссылка на главную, выпадающее меню API (Swagger/ReDoc/Health), переключатель светлой/тёмной темы (localStorage). - Светлая тема в синей гамме; выравнивание кнопки темы в ряду с пилюлями. - Дашборд: единая карточка ошибки health/stats, подсказка Docker/Podman, поле container_cli в GET /stats, total_workers_from_meta всегда число (0 без meta). - Правки кластеров, job_store, compose, документация и частичные шаблоны.
139 lines
6.2 KiB
Python
139 lines
6.2 KiB
Python
"""Модели запросов/ответов REST API веб-интерфейса.
|
||
|
||
Автор: Сергей Антропов
|
||
Сайт: https://devops.org.ru
|
||
"""
|
||
|
||
from __future__ import annotations
|
||
|
||
from typing import Any, Literal
|
||
|
||
from pydantic import BaseModel, Field
|
||
|
||
|
||
class ClusterCreateRequest(BaseModel):
|
||
"""Тело POST /api/v1/clusters — создание кластера."""
|
||
|
||
name: str = Field(..., min_length=1, max_length=63, description="DNS-имя кластера (a-z0-9-)")
|
||
kubernetes_version: str = Field(
|
||
...,
|
||
min_length=1,
|
||
description="Версия Kubernetes / тег kindest/node, например 1.29.4 или v1.29.4",
|
||
)
|
||
workers: int = Field(2, ge=0, le=20, description="Число worker-нод (0–20)")
|
||
|
||
|
||
class ClusterCreateAccepted(BaseModel):
|
||
"""Ответ 202 — задание поставлено в очередь."""
|
||
|
||
job_id: str
|
||
status: Literal["queued"] = "queued"
|
||
message: str = "Создание кластера выполняется в фоне; опросите GET /api/v1/jobs/{job_id}"
|
||
|
||
|
||
class JobView(BaseModel):
|
||
"""Статус фонового задания."""
|
||
|
||
job_id: str
|
||
kind: str
|
||
status: Literal["queued", "running", "success", "failed", "cancelled"]
|
||
cluster_name: str | None
|
||
created_at_utc: str
|
||
message: str | None = None
|
||
result: dict[str, Any] | None = None
|
||
progress_stage: str | None = Field(default=None, description="Текущий этап операции (пока задание активно)")
|
||
progress_percent: int | None = Field(default=None, description="Прогресс 0–100 для индикатора в UI")
|
||
progress_log: list[str] = Field(
|
||
default_factory=list,
|
||
description="Хвост журнала (скачивание образа, длительные команды, этапы); при опросе GET /jobs/{id}",
|
||
)
|
||
|
||
|
||
class ClusterSummary(BaseModel):
|
||
"""Элемент списка кластеров."""
|
||
|
||
name: str
|
||
registered_in_kind: bool
|
||
kind_nodes_running: bool = Field(
|
||
default=False,
|
||
description="Запущены контейнеры узлов kind (имя-control-plane, имя-worker…; docker/podman ps)",
|
||
)
|
||
has_local_kubeconfig: bool
|
||
meta: dict[str, Any] = Field(default_factory=dict)
|
||
|
||
|
||
class KindNodeResourceStat(BaseModel):
|
||
"""Одна нода kind (контейнер): снимок ``docker stats`` / ``podman stats``."""
|
||
|
||
container_name: str
|
||
cpu_percent: str | None = Field(default=None, description="Доля CPU, напр. 1.23%")
|
||
memory_usage: str | None = Field(default=None, description="Использование / лимит, напр. 120MiB / 7.7GiB")
|
||
memory_percent: str | None = Field(default=None, description="Процент памяти от лимита контейнера")
|
||
net_io: str | None = Field(default=None, description="Сетевой I/O (накопительно за жизнь контейнера)")
|
||
block_io: str | None = Field(default=None, description="Блочный I/O")
|
||
pids: int | None = Field(default=None, description="Число процессов в контейнере")
|
||
|
||
|
||
class KindClusterResources(BaseModel):
|
||
"""Ресурсы узлов одного кластера kind (только запущенные контейнеры)."""
|
||
|
||
cluster_name: str
|
||
nodes: list[KindNodeResourceStat] = Field(default_factory=list)
|
||
note: str | None = Field(default=None, description="Пояснение, если узлов нет или ошибка списка")
|
||
|
||
|
||
class AggregateResourcesSummary(BaseModel):
|
||
"""Сводка по всем запущенным узлам kind для донат-диаграмм на главной."""
|
||
|
||
nodes_count: int = Field(0, description="Число учтённых контейнеров-нод")
|
||
cpu_ring: float = Field(0, ge=0, le=100, description="Заполнение кольца «средний CPU», 0–100")
|
||
cpu_label: str = Field("—", description="Подпись в центре доната")
|
||
memory_percent_ring: float = Field(0, ge=0, le=100)
|
||
memory_percent_label: str = Field("—")
|
||
memory_used_ratio_ring: float = Field(0, ge=0, le=100, description="Доля занятой RAM от лимита по строке MemUsage")
|
||
memory_used_ratio_label: str = Field("—")
|
||
network_ring: float = Field(0, ge=0, le=100, description="Индикатор суммарного сетевого I/O (условная шкала)")
|
||
network_label: str = Field("—")
|
||
disk_ring: float = Field(0, ge=0, le=100, description="Индикатор суммарного блочного I/O")
|
||
disk_label: str = Field("—")
|
||
|
||
|
||
class StatsResponse(BaseModel):
|
||
"""Краткая статистика для дашборда."""
|
||
|
||
container_cli: str = Field(
|
||
description="CLI движка контейнеров (docker или podman): узлы kind и метрики собираются через него",
|
||
)
|
||
kind_clusters_count: int
|
||
local_cluster_dirs_count: int
|
||
total_workers_from_meta: int = Field(
|
||
0,
|
||
ge=0,
|
||
description="Сумма worker_nodes по meta.json каталогов; 0 если ни в одном meta нет поля или данных",
|
||
)
|
||
jobs_total: int
|
||
jobs_recent_failed: int
|
||
cluster_resources: list[KindClusterResources] = Field(
|
||
default_factory=list,
|
||
description="CPU/RAM/I/O узлов kind по данным container CLI",
|
||
)
|
||
cluster_resources_error: str | None = Field(
|
||
default=None,
|
||
description="Глобальная ошибка сбора метрик (например CLI не найден)",
|
||
)
|
||
aggregate_cluster_resources: AggregateResourcesSummary = Field(
|
||
default_factory=AggregateResourcesSummary,
|
||
description="Агрегаты по узлам для донатов на главной странице",
|
||
)
|
||
|
||
|
||
class ClusterWorkloadsResponse(BaseModel):
|
||
"""Вывод kubectl по кластеру (узлы и поды)."""
|
||
|
||
cluster_name: str
|
||
nodes_rc: int | None = None
|
||
nodes_output: str | None = None
|
||
pods_rc: int | None = None
|
||
pods_output: str | None = None
|
||
error: str | None = None
|