ServerKit is a lightweight, modern server control panel for managing web applications, databases, and services on your VPS or dedicated server. Built with Python/Flask backend and React frontend.
Python astracloudflarecontrol-panelcyberpaneldnsfablehosting-control-panelhosting-panelkimi-k3server-managementserverkitubuntu-web-panelwebserver
Check free disk before a deploy stops anything
Juan Denis03b4d3b751e5
diff --git a/backend/app/services/deploy_preflight_service.py b/backend/app/services/deploy_preflight_service.pyindex 17fe8ada..d0c6f119 100644--- a/backend/app/services/deploy_preflight_service.py+++ b/backend/app/services/deploy_preflight_service.py@@ -32,7 +32,9 @@ The checks, in the order they run (a broken compose makes the rest meaningless):"""import logging+import osimport re+import shutilfrom dataclasses import dataclass, fieldfrom typing import Any, Callable, Dict, List, Optional, Set@@ -49,6 +51,15 @@ KIND_COMPOSE_INVALID = 'compose_invalid'KIND_IMAGE_UNRESOLVED = 'image_unresolved'KIND_BUILD_FAILED = 'build_failed'KIND_PORT_CONFLICT = 'port_conflict'+KIND_DISK_LOW = 'disk_low'++# Free space a pull/build needs (plan 85 D4). Under the floor the deploy is+# refused — images cannot fit and a full disk also stops the panel's database+# writing. Under the warning line it proceeds with a warning.+DISK_BLOCK_BYTES = 512 * 1024 ** 2+DISK_WARN_BYTES = 2 * 1024 ** 3+DISK_WARN_FRACTION = 0.05+DOCKER_DATA_ROOT = '/var/lib/docker'LogFn = Optional[Callable[[str], None]]@@ -157,6 +168,11 @@ def preflight_compose_project(project_path: str, compose_file: str = None, *,what = label or (compose_file or 'docker-compose.yml')_emit(log, f'Preflight: validating {what} before stopping the running containers')+ # 0. free disk ------------------------------------------------------------+ _check_disk(project_path, result, log)+ if not result.ok:+ return result+# 1. compose validity -----------------------------------------------------try:validation = DockerService.validate_compose_file(project_path, compose_file)@@ -197,6 +213,37 @@ def preflight_compose_project(project_path: str, compose_file: str = None, *,return result+def _disk_usage(path: str):+ return shutil.disk_usage(path)+++def _check_disk(project_path: str, result: PreflightResult, log: LogFn = None) -> None:+ """Refuse a deploy the disk cannot hold; warn when it is getting close.+ Measured where images land (Docker's data root), else the project.+ Adds a finding only when space is short, so a healthy disk is silent."""+ from app.services.disk_reclaim_service import human_bytes+ path = DOCKER_DATA_ROOT if os.path.isdir(DOCKER_DATA_ROOT) else project_path+ try:+ du = _disk_usage(path)+ except OSError:+ return+ warn_at = max(DISK_WARN_BYTES, int(du.total * DISK_WARN_FRACTION))+ if du.free < DISK_BLOCK_BYTES:+ result.add(PreflightFinding(+ kind=KIND_DISK_LOW,+ message=(f'Only {human_bytes(du.free)} free on {path}: not enough to pull '+ 'or build images. Free up space from Storage, then deploy again.'),+ detail=f'free={du.free} total={du.total}',+ ), log)+ elif du.free < warn_at:+ result.add(PreflightFinding(+ kind=KIND_DISK_LOW, severity=ADVISORY,+ message=(f'Only {human_bytes(du.free)} free on {path}; a large build may '+ 'fail. Storage shows what is using the disk.'),+ detail=f'free={du.free} total={du.total}',+ ), log)++def _compose_config(project_path: str, compose_file: str = None) -> Optional[Dict[str, Any]]:"""Parsed ``docker compose config``, or None when it cannot be read.diff --git a/backend/tests/test_deploy_preflight.py b/backend/tests/test_deploy_preflight.pyindex 02879b90..97921f5d 100644--- a/backend/tests/test_deploy_preflight.py+++ b/backend/tests/test_deploy_preflight.py@@ -418,3 +418,36 @@ def test_an_unreadable_project_is_unknown_not_empty(app, monkeypatch):monkeypatch.setattr(DockerService, 'run_compose', classmethod(lambda cls, cmd, cwd=None, **kw: {'success': True, 'output': '', 'stderr': '', 'returncode': 0}))assert preflight.published_host_ports('/srv/app') == set()+++# ── plan 85 D4: free disk ───────────────────────────────────────────────────++def _disk(monkeypatch, free, total=25 * 1024 ** 3):+ from collections import namedtuple+ Usage = namedtuple('Usage', 'total used free')+ monkeypatch.setattr(preflight, '_disk_usage', lambda path: Usage(total, total - free, free))+++def test_a_nearly_full_disk_blocks_before_anything_stops(monkeypatch):+ _disk(monkeypatch, free=100 * 1024 ** 2)+ monkeypatch.setattr(preflight.DockerService, 'validate_compose_file',+ lambda *a, **k: pytest.fail('must stop before compose validation'))+ result = preflight.preflight_compose_project('/tmp/app')+ assert not result.ok+ assert result.blockers[0].kind == preflight.KIND_DISK_LOW+ assert 'Storage' in result.error+++def test_low_disk_is_a_warning_not_a_blocker(monkeypatch):+ _disk(monkeypatch, free=1 * 1024 ** 3)+ result = preflight.PreflightResult()+ preflight._check_disk('/tmp/app', result)+ assert result.ok+ assert [f.severity for f in result.findings] == [preflight.ADVISORY]+++def test_a_healthy_disk_adds_nothing(monkeypatch):+ _disk(monkeypatch, free=20 * 1024 ** 3)+ result = preflight.PreflightResult()+ preflight._check_disk('/tmp/app', result)+ assert result.findings == []