UI: навигация, документация, favicon; журнал развёртывания; валидация формы

- Меню API: ссылка «Теги образов», обёртка прокрутки пилюль, z-index и padding против обрезки hover - Документация: ширина колонки как у дашборда (72rem) - Favicon SVG + GET /favicon.ico, link в base.html - provision_log.json, GET .../provision-log, кнопка в таблице кластеров - Валидация create: имя, workers, тег kindest; модалка alert - Прочие правки из сессии (clusters, job_store, стили, шаблоны)
2026-04-04 08:15:15 +03:00
parent 6f3daa33ec
commit 4546f50aef
19 changed files with 723 additions and 103 deletions
@@ -75,11 +75,13 @@ def validate_cluster_name(name: str) -> bool:


 def normalize_k8s_version(raw: str) -> str:
-    """Превратить ввод в тег образа kindest/node (например 1.29.4 → v1.29.4)."""
-    s = raw.strip()
+    """Превратить ввод в тег образа kindest/node (1.29.4 → v1.29.4) или ``latest``."""
+    s = raw.strip().lower()
    if not s:
        return "v1.29.4"
-    s = s.lower().removeprefix("v")
+    if s in ("latest", "vlatest"):
+        return "latest"
+    s = s.removeprefix("v")
    return f"v{s}"


@@ -451,7 +453,7 @@ def create_cluster_non_interactive(
    """
    Создать кластер kind без диалогов.

-    ``kubernetes_version_tag`` — тег kindest/node (например ``v1.29.4``), см. ``normalize_tag_v_prefix``.
+    ``kubernetes_version_tag`` — тег kindest/node: ``latest``, ``v1.29.4`` и т.д. (см. ``normalize_tag_v_prefix``).

    ``job_id`` — если задан, обновляется прогресс и проверяется отмена (см. ``job_store``).

@@ -915,6 +917,8 @@ def kubectl_pods_all_namespaces(*, kubeconfig: str | Path) -> tuple[int, str]:

 def cluster_summary_for_api(name: str) -> dict[str, object]:
    """Сводка по кластеру для JSON API (без блокирующих долгих вызовов)."""
+    from core.provision_log import provision_log_file_path
+
    meta = read_meta_json(name) or {}
    saved_kc = clusters_dir() / name / "kubeconfig"
    in_kind = name in list_registered_kind_clusters()
@@ -924,5 +928,6 @@ def cluster_summary_for_api(name: str) -> dict[str, object]:
        "has_local_kubeconfig": saved_kc.is_file(),
        "kubeconfig_path": str(saved_kc) if saved_kc.is_file() else None,
        "meta": meta,
+        "has_provision_log": provision_log_file_path(name).is_file(),
    }
    return out
@@ -44,6 +44,8 @@ _cancel_events: dict[str, threading.Event] = {}
 _progress: dict[str, tuple[str, int]] = {}
 # Хвост логов для активных заданий (kind create и т.д.); после завершения копируется в JobRecord.log_lines
 _job_log_deques: dict[str, deque[str]] = {}
+# Полный журнал без лимита строк (только для зарегистрированных job_id) — пишется в clusters/<имя>/provision_log.json
+_job_uncapped_logs: dict[str, list[str]] = {}
 # Активный дочерний процесс (pull / kind create) — для принудительной отмены
 _process_lock = threading.Lock()
 _active_subprocess_by_job: dict[str, subprocess.Popen] = {}
@@ -71,6 +73,19 @@ def _max_job_log_lines() -> int:
        return 500


+def register_uncapped_job_log(job_id: str) -> None:
+    """Включить накопление полного журнала по ``job_id`` (создание/старт кластера → JSON в каталоге кластера)."""
+    with _thread_lock:
+        _job_uncapped_logs[job_id] = []
+
+
+def take_uncapped_log_finalize(job_id: str) -> list[str]:
+    """Забрать полный журнал и снять регистрацию (вызывать один раз при завершении задания)."""
+    with _thread_lock:
+        lst = _job_uncapped_logs.pop(job_id, None)
+        return list(lst) if lst else []
+
+
 def append_log_sync(job_id: str, line: str) -> None:
    """Добавить строку в журнал задания (вызывается из worker-thread во время долгих команд)."""
    text = (line or "").rstrip()
@@ -78,6 +93,9 @@ def append_log_sync(job_id: str, line: str) -> None:
        return
    cap = _max_job_log_lines()
    with _thread_lock:
+        uncapped = _job_uncapped_logs.get(job_id)
+        if uncapped is not None:
+            uncapped.append(text)
        if job_id not in _job_log_deques:
            _job_log_deques[job_id] = deque(maxlen=cap)
        _job_log_deques[job_id].append(text)
@@ -116,6 +134,7 @@ def end_job_tracking(job_id: str) -> None:
        _cancel_events.pop(job_id, None)
        _progress.pop(job_id, None)
        _job_log_deques.pop(job_id, None)
+        _job_uncapped_logs.pop(job_id, None)


 def set_progress_sync(job_id: str, stage: str, percent: int) -> None:
@@ -0,0 +1,74 @@
+"""Сохранение полного журнала развёртывания кластера в ``clusters/<имя>/provision_log.json``.
+
+Автор: Сергей Антропов
+Сайт: https://devops.org.ru
+"""
+
+from __future__ import annotations
+
+import json
+import logging
+from datetime import datetime, timezone
+from pathlib import Path
+from typing import Any
+
+from kind_k8s_paths import clusters_dir
+
+logger = logging.getLogger("kind_k8s.provision_log")
+
+PROVISION_LOG_FILENAME = "provision_log.json"
+PROVISION_LOG_VERSION = 1
+
+
+def provision_log_file_path(cluster_name: str) -> Path:
+    """Путь к JSON с журналом операции для кластера ``cluster_name``."""
+    return clusters_dir() / cluster_name.strip() / PROVISION_LOG_FILENAME
+
+
+def write_cluster_provision_log(
+    *,
+    cluster_name: str,
+    job_id: str,
+    job_kind: str,
+    status: str,
+    message: str | None,
+    lines: list[str],
+    result: dict[str, Any] | None,
+) -> Path | None:
+    """
+    Атомарно записать полный журнал (все строки без обрезки буфера задания).
+
+    Возвращает путь к файлу или ``None``, если каталог кластера не существует.
+    """
+    name = cluster_name.strip()
+    cdir = clusters_dir() / name
+    if not cdir.is_dir():
+        logger.debug("Каталог кластера отсутствует, provision_log не пишем: %s", cdir)
+        return None
+
+    path = cdir / PROVISION_LOG_FILENAME
+    payload: dict[str, Any] = {
+        "version": PROVISION_LOG_VERSION,
+        "job_id": job_id,
+        "kind": job_kind,
+        "cluster_name": name,
+        "finished_at_utc": datetime.now(timezone.utc).isoformat(),
+        "status": status,
+        "message": message,
+        "lines": list(lines),
+        "result": result,
+    }
+    tmp = path.with_suffix(path.suffix + ".tmp")
+    try:
+        text = json.dumps(payload, ensure_ascii=False, indent=2, default=str)
+        tmp.write_text(text, encoding="utf-8")
+        tmp.replace(path)
+        logger.info("Сохранён журнал развёртывания: %s (%s строк)", path, len(lines))
+        return path
+    except OSError as e:
+        logger.warning("Не удалось записать %s: %s", path, e)
+        try:
+            tmp.unlink(missing_ok=True)
+        except OSError:
+            pass
+        return None