standkit 0.12.2__tar.gz → 0.12.3__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {standkit-0.12.2/standkit.egg-info → standkit-0.12.3}/PKG-INFO +1 -1
- {standkit-0.12.2 → standkit-0.12.3}/docs/CHANGELOG.md +49 -0
- {standkit-0.12.2 → standkit-0.12.3}/pyproject.toml +1 -1
- {standkit-0.12.2 → standkit-0.12.3}/standkit/health.py +15 -1
- {standkit-0.12.2 → standkit-0.12.3}/standkit/models.py +64 -1
- {standkit-0.12.2 → standkit-0.12.3/standkit.egg-info}/PKG-INFO +1 -1
- {standkit-0.12.2 → standkit-0.12.3}/standkit_hub/client.py +34 -14
- {standkit-0.12.2 → standkit-0.12.3}/standkit_hub/server.py +10 -0
- {standkit-0.12.2 → standkit-0.12.3}/standkit_hub/web/app.js +66 -10
- {standkit-0.12.2 → standkit-0.12.3}/standkit_hub/web/index.html +12 -0
- {standkit-0.12.2 → standkit-0.12.3}/standkit_hub/web/style.css +12 -0
- {standkit-0.12.2 → standkit-0.12.3}/tests/test_health.py +121 -0
- {standkit-0.12.2 → standkit-0.12.3}/LICENSE +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/MANIFEST.in +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/README.md +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/SECURITY.md +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/docs/ARCHITECTURE.md +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/docs/BACKLOG.md +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/docs/COOKBOOK_LINUX.md +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/docs/GAPs/GAP-001-registry-fields-out-of-hub-form.md +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/docs/GAPs/GAP-002-http-probe-down-not-explained.md +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/docs/GAPs/GAP-003-redis-endpoint-in-extra.md +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/docs/GAPs/GAP-004-cookbook-hub-register-form.md +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/docs/GAPs/GAP-005-cookbook-hub-side-secrets.md +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/docs/GAPs/GAP-006-log-dir-case-and-separator.md +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/docs/GAPs/GAP-007-agent-paths-raw-traceback.md +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/docs/GAPs/GAP-008-agent-cert-trust-on-hub.md +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/docs/GAPs/README.md +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/docs/HOSTING.md +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/docs/README.md +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/docs/REMOTE_STANDS.md +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/docs/ROADMAP.md +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/docs/adr/0001-hosting-backends.md +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/docs/adr/0002-k8s-backend.md +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/docs/adr/0003-remote-log-browsing.md +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/docs/adr/0004-iis-site-scoped-lifecycle.md +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/docs/adr/0005-companion-transport-in-mit-core.md +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/docs/adr/0006-hub-elevated-restart.md +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/docs/adr/0007-hub-exit-idle-and-plain-restart.md +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/docs/research/companion-v2-cicd-thin-agent.md +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/projects.sample.json +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/setup.cfg +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/standkit/__init__.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/standkit/adopt.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/standkit/cli_resolve.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/standkit/hosting.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/standkit/lifecycle.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/standkit/logs.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/standkit/platform.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/standkit/registry.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/standkit/secrets.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/standkit.egg-info/SOURCES.txt +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/standkit.egg-info/dependency_links.txt +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/standkit.egg-info/entry_points.txt +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/standkit.egg-info/requires.txt +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/standkit.egg-info/top_level.txt +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/standkit_agent/__init__.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/standkit_agent/__main__.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/standkit_agent/audit.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/standkit_agent/security.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/standkit_agent/server.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/standkit_companion/__init__.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/standkit_companion/__main__.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/standkit_companion/backend.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/standkit_companion/context.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/standkit_companion/cookbook.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/standkit_companion/ed25519.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/standkit_companion/errors.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/standkit_companion/fsutil.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/standkit_companion/mcp_mutex.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/standkit_companion/patterns.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/standkit_companion/releases.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/standkit_companion/revocations.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/standkit_companion/runner.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/standkit_companion/signature.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/standkit_companion/state.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/standkit_hub/__init__.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/standkit_hub/__main__.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/standkit_hub/agent_control.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/standkit_hub/assets/bpmkit-icon.ico +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/standkit_hub/assets/icon.png +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/standkit_hub/config.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/standkit_hub/consent_api.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/standkit_hub/elevated_op.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/standkit_hub/elevation.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/standkit_hub/hub_logging.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/standkit_hub/instance.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/standkit_hub/license_api.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/standkit_hub/logs_browser.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/standkit_hub/mutex.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/standkit_hub/pick_dialog.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/standkit_hub/poller.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/standkit_hub/redis_min.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/standkit_hub/security.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/standkit_hub/shortcut.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/standkit_hub/web/bpmkit-logo-dark.svg +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/standkit_hub/web/bpmkit-logo.svg +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/standkit_hub/web/cookbook.html +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/standkit_hub/web/favicon.png +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/standkit_hub/web/favicon.svg +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/standkit_hub/web/manifest.webmanifest +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/tests/test_adopt.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/tests/test_agent_security.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/tests/test_agent_server_integration.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/tests/test_agent_startup_preflight.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/tests/test_companion_backend.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/tests/test_companion_context.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/tests/test_companion_cookbook.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/tests/test_companion_fsutil.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/tests/test_companion_mcp_mutex.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/tests/test_companion_patterns.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/tests/test_companion_releases.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/tests/test_companion_revocations.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/tests/test_companion_runner.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/tests/test_companion_signature.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/tests/test_hosting.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/tests/test_hub_agent_control.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/tests/test_hub_client_tls.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/tests/test_hub_companion_api.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/tests/test_hub_config.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/tests/test_hub_consent_api.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/tests/test_hub_elevated_op.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/tests/test_hub_elevation.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/tests/test_hub_elevation_ui.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/tests/test_hub_exit_idle_restart.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/tests/test_hub_fast_paint.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/tests/test_hub_instance.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/tests/test_hub_license_api.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/tests/test_hub_logging.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/tests/test_hub_logs_browser.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/tests/test_hub_main_elevated.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/tests/test_hub_mutex.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/tests/test_hub_pick_dialog.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/tests/test_hub_pwa_and_compact.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/tests/test_hub_redis_min.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/tests/test_hub_register.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/tests/test_hub_server.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/tests/test_hub_settings_field_help.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/tests/test_hub_shortcut.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/tests/test_hub_single_instance.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/tests/test_lifecycle.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/tests/test_logs.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/tests/test_models.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/tests/test_no_window.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/tests/test_platform_sid.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/tests/test_registry.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/tests/test_registry_resolver.py +0 -0
- {standkit-0.12.2 → standkit-0.12.3}/tests/test_secrets.py +0 -0
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: standkit
|
|
3
|
-
Version: 0.12.
|
|
3
|
+
Version: 0.12.3
|
|
4
4
|
Summary: Свободное ядро (MIT) для управления жизненным циклом локальных и удалённых стендов BPMSoft: headless start/stop/restart, health-пробы, логи, реестр стендов. Часть экосистемы BPMkit.
|
|
5
5
|
Author: standkit contributors
|
|
6
6
|
License-Expression: MIT
|
|
@@ -5,6 +5,55 @@
|
|
|
5
5
|
|
|
6
6
|
## [Unreleased]
|
|
7
7
|
|
|
8
|
+
## [0.12.3] — 2026-09-19
|
|
9
|
+
|
|
10
|
+
### Добавлено
|
|
11
|
+
|
|
12
|
+
- **Транспорт `http` — удалённый стенд без агента (GAP-277).** Кейс владельца
|
|
13
|
+
11.09.2026: стенд, к которому есть только веб-адрес и пароль (`survey9`,
|
|
14
|
+
`https://…:443`), регистрировался как `agent`, потому что других значений в
|
|
15
|
+
`Transport` не было. Хаб опрашивал несуществующего агента, строка висела
|
|
16
|
+
«агент · unknown» с активными кнопками пуск/стоп/рестарт и именем базы,
|
|
17
|
+
состояние которой никто не проверял, — отличить «агент упал» от «агента нет
|
|
18
|
+
и не будет» было невозможно.
|
|
19
|
+
|
|
20
|
+
Значение `http` при этом УЖЕ принимал валидатор `stand_register` на стороне
|
|
21
|
+
MCP (GAP-267 W0), и комментарий там обещал, что оно «зеркалит
|
|
22
|
+
`standkit.models.Transport`». Обещание было ложным: запись создавалась, а
|
|
23
|
+
диспетчер падал на ней в `NotImplementedError`. Теперь зеркало настоящее.
|
|
24
|
+
|
|
25
|
+
- `Transport.HTTP` в модели; `Stand.validate()` не требует у такой записи
|
|
26
|
+
`stand_dir` (его нет по построению — GAP-267 W0 прямо его запрещает) и
|
|
27
|
+
отвергает локальный `stand_host`: у удалённого стенда `127.0.0.1` означает
|
|
28
|
+
«адрес не задан».
|
|
29
|
+
- **Состояние — по честной HTTP-пробе** того же `health.check_stand`, что у
|
|
30
|
+
локальных стендов (`up`/`down` + причина с URL), вместо вечного `unknown`.
|
|
31
|
+
- Пробы процесса, БД и Redis помечаются `SKIPPED` с объяснением «не
|
|
32
|
+
проверяется без агента», а не `UNKNOWN`: `unknown` читается оператором как
|
|
33
|
+
«не смогли узнать, возможно что-то сломалось», и ровно этой подменой
|
|
34
|
+
смысла гэп и был заведён.
|
|
35
|
+
- Кнопки пуск/стоп/рестарт/очистка Redis **выключены** с подсказкой «без
|
|
36
|
+
агента управление процессом недоступно»; тот же текст отдаёт и API вместо
|
|
37
|
+
прежнего «транспорт пока не реализован (TODO)» — управлять процессом
|
|
38
|
+
удалённого стенда, о котором известен только адрес, нечем в принципе, а не
|
|
39
|
+
«пока».
|
|
40
|
+
- Колонка «Транспорт» — «удалённый · http · <хост>»; колонки БД и Redis —
|
|
41
|
+
«—» с той же подсказкой (имя базы из реестра больше не выдаётся за
|
|
42
|
+
проверенный факт).
|
|
43
|
+
- Форма «Зарегистрировать стенд» получила вариант «http — удалённый, без
|
|
44
|
+
агента» с пояснением, чего у такого стенда не будет.
|
|
45
|
+
|
|
46
|
+
### Изменено
|
|
47
|
+
|
|
48
|
+
- **Обратная совместимость записей `agent` без `agent_url` (GAP-277, п.1
|
|
49
|
+
плана).** Такая запись появилась до того, как у диспетчера был транспорт
|
|
50
|
+
`http`, — так регистрировали именно «удалённый стенд, к которому есть только
|
|
51
|
+
адрес», и она давала вечный `unknown`. Теперь она трактуется как `http`
|
|
52
|
+
(`Stand.effective_transport`) и получает честную пробу, а в строке
|
|
53
|
+
показывается предупреждение «запись agent без адреса». Поле реестра при этом
|
|
54
|
+
**не переписывается молча** — интерпретация живёт в рантайме, и оператор
|
|
55
|
+
видит, почему состояние выведено, а не взято буквально.
|
|
56
|
+
|
|
8
57
|
## [0.12.2] — 2026-09-19
|
|
9
58
|
|
|
10
59
|
### Исправлено
|
|
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
|
|
|
4
4
|
|
|
5
5
|
[project]
|
|
6
6
|
name = "standkit"
|
|
7
|
-
version = "0.12.
|
|
7
|
+
version = "0.12.3"
|
|
8
8
|
description = "Свободное ядро (MIT) для управления жизненным циклом локальных и удалённых стендов BPMSoft: headless start/stop/restart, health-пробы, логи, реестр стендов. Часть экосистемы BPMkit."
|
|
9
9
|
readme = "README.md"
|
|
10
10
|
license = "MIT"
|
|
@@ -36,7 +36,7 @@ from dataclasses import dataclass
|
|
|
36
36
|
from pathlib import Path
|
|
37
37
|
from typing import Optional
|
|
38
38
|
|
|
39
|
-
from standkit.models import HostKind, ProbeState, Stand, StandStatus
|
|
39
|
+
from standkit.models import Transport, HostKind, ProbeState, Stand, StandStatus
|
|
40
40
|
|
|
41
41
|
# --- таймауты проб ---------------------------------------------------------
|
|
42
42
|
#
|
|
@@ -431,6 +431,16 @@ def check_stand(
|
|
|
431
431
|
status = StandStatus(name=stand.name)
|
|
432
432
|
|
|
433
433
|
def _probe_process() -> tuple[ProbeState, Optional[str]]:
|
|
434
|
+
# Транспорт http — удалённый стенд БЕЗ агента (GAP-277): процессом
|
|
435
|
+
# управлять нечем и проверять его нечем. Это SKIPPED («проба сознательно
|
|
436
|
+
# не выполнялась»), а не UNKNOWN: UNKNOWN читается оператором как «не
|
|
437
|
+
# смогли узнать, возможно что-то сломалось», и ровно этой подменой
|
|
438
|
+
# смысла гэп и был заведён.
|
|
439
|
+
if stand.effective_transport == Transport.HTTP:
|
|
440
|
+
return ProbeState.SKIPPED, (
|
|
441
|
+
"без агента управление процессом недоступно: у стенда на транспорте "
|
|
442
|
+
"http известен только веб-адрес"
|
|
443
|
+
)
|
|
434
444
|
if stand.host_kind in (HostKind.IIS, HostKind.DOCKER, HostKind.K8S):
|
|
435
445
|
# Проба «процесс» для iis/docker/k8s консультируется с бэкендом
|
|
436
446
|
# хостинга (состояние App Pool / контейнера / деплоймента), а не с
|
|
@@ -499,6 +509,8 @@ def check_stand(
|
|
|
499
509
|
def _probe_db() -> tuple[ProbeState, Optional[str]]:
|
|
500
510
|
# У БД-пробы объяснять пока нечего: адрес есть — проверяем порт, нет —
|
|
501
511
|
# UNKNOWN. Пару возвращает ради единого протокола сборки деталей.
|
|
512
|
+
if stand.effective_transport == Transport.HTTP:
|
|
513
|
+
return ProbeState.SKIPPED, "не проверяется без агента"
|
|
502
514
|
if not (stand.db_host and stand.db_port):
|
|
503
515
|
return ProbeState.UNKNOWN, None
|
|
504
516
|
if deep_db:
|
|
@@ -510,6 +522,8 @@ def check_stand(
|
|
|
510
522
|
# Поля модели в приоритете, ``extra`` — фолбэк: до 0.8.0 адрес Redis
|
|
511
523
|
# жил только в нетипизированном extra, и реестры, заполненные раньше,
|
|
512
524
|
# обязаны продолжать работать без правок (GAP-003).
|
|
525
|
+
if stand.effective_transport == Transport.HTTP:
|
|
526
|
+
return ProbeState.SKIPPED, "не проверяется без агента"
|
|
513
527
|
redis_host = str(stand.redis_host or stand.extra.get("redis_host") or "").strip()
|
|
514
528
|
raw_port = stand.redis_port or stand.extra.get("redis_port") or 0
|
|
515
529
|
try:
|
|
@@ -10,6 +10,10 @@ projects.sample.json в корне репозитория) плюс универ
|
|
|
10
10
|
- "agent" — стенд управляется через удалённый standkit_agent по HTTP
|
|
11
11
|
(используются agent_url / agent_secret_ref, а для TLS-канала до агента —
|
|
12
12
|
agent_ca / agent_verify_tls);
|
|
13
|
+
- "http" — удалённый стенд БЕЗ агента: известен только веб-адрес стенда и
|
|
14
|
+
учётная запись администратора (кейс владельца «нужно работать с удалённым
|
|
15
|
+
стендом, имея только пароль», GAP-267 W0 / GAP-277). Управлять процессом
|
|
16
|
+
такого стенда нечем — доступна только HTTP-проба самого стенда;
|
|
13
17
|
- "ssh" / "winrm" — зарезервировано под будущие транспорты, СХЕМОЙ допускается,
|
|
14
18
|
логика НЕ реализована (бэклог, см. docs/ARCHITECTURE.md).
|
|
15
19
|
"""
|
|
@@ -26,6 +30,13 @@ class Transport(str, Enum):
|
|
|
26
30
|
|
|
27
31
|
LOCAL = "local"
|
|
28
32
|
AGENT = "agent"
|
|
33
|
+
# Удалённый стенд без агента: только веб-адрес + учётка (GAP-277).
|
|
34
|
+
# Значение УЖЕ принимает валидатор stand_register на стороне MCP
|
|
35
|
+
# (BPMkit/server/bpmkit/tools/projects.py, GAP-267 W0) и комментарий там
|
|
36
|
+
# обещает, что оно «зеркалит standkit.models.Transport» — до этой правки
|
|
37
|
+
# обещание было ложным: запись создавалась, а диспетчер падал на ней в
|
|
38
|
+
# NotImplementedError и показывал «агент · unknown».
|
|
39
|
+
HTTP = "http"
|
|
29
40
|
# Задел на будущее — схема допускает значения, реализации пока нет.
|
|
30
41
|
SSH = "ssh"
|
|
31
42
|
WINRM = "winrm"
|
|
@@ -214,6 +225,36 @@ class Stand:
|
|
|
214
225
|
result.update(self.extra)
|
|
215
226
|
return result
|
|
216
227
|
|
|
228
|
+
@property
|
|
229
|
+
def effective_transport(self) -> Transport:
|
|
230
|
+
"""
|
|
231
|
+
Транспорт, по которому НА САМОМ ДЕЛЕ можно дотянуться до стенда.
|
|
232
|
+
|
|
233
|
+
Единственное отличие от поля ``transport`` — обратная совместимость
|
|
234
|
+
(GAP-277, п.1 плана): запись ``transport=agent`` БЕЗ ``agent_url``
|
|
235
|
+
появилась до того, как у диспетчера был транспорт ``http``, — так
|
|
236
|
+
регистрировали именно «удалённый стенд, к которому есть только адрес».
|
|
237
|
+
Агента по такой записи не существует, поэтому опрос уходил в никуда и
|
|
238
|
+
строка висела «агент · unknown». Трактуем её как ``http``: это
|
|
239
|
+
возвращает честную HTTP-пробу вместо вечного unknown.
|
|
240
|
+
|
|
241
|
+
Поле реестра при этом НЕ переписывается молча — интерпретация живёт в
|
|
242
|
+
рантайме, а UI показывает предупреждение (см. ``transport_warning``).
|
|
243
|
+
"""
|
|
244
|
+
if self.transport == Transport.AGENT and not (self.agent_url or "").strip():
|
|
245
|
+
return Transport.HTTP
|
|
246
|
+
return self.transport
|
|
247
|
+
|
|
248
|
+
@property
|
|
249
|
+
def transport_warning(self) -> Optional[str]:
|
|
250
|
+
"""Текст предупреждения для UI, когда запись трактуется не буквально."""
|
|
251
|
+
if self.transport == Transport.AGENT and not (self.agent_url or "").strip():
|
|
252
|
+
return (
|
|
253
|
+
"в реестре указан transport=agent, но адрес агента (agent_url) не задан — "
|
|
254
|
+
"запись читается как удалённый стенд без агента (http)"
|
|
255
|
+
)
|
|
256
|
+
return None
|
|
257
|
+
|
|
217
258
|
def validate(self) -> list[str]:
|
|
218
259
|
"""
|
|
219
260
|
Минимальная валидация записи. Возвращает список текстов ошибок
|
|
@@ -223,7 +264,29 @@ class Stand:
|
|
|
223
264
|
errors: list[str] = []
|
|
224
265
|
if not self.name:
|
|
225
266
|
errors.append("name не может быть пустым")
|
|
226
|
-
|
|
267
|
+
# У стенда на транспорте http локальной папки нет ПО ПОСТРОЕНИЮ
|
|
268
|
+
# (GAP-267 W0 прямо запрещает stand_dir у такой записи), поэтому
|
|
269
|
+
# требовать её здесь значило бы объявить невалидной каждую корректную
|
|
270
|
+
# запись «только адрес и пароль».
|
|
271
|
+
if self.effective_transport == Transport.HTTP and self.transport == Transport.HTTP:
|
|
272
|
+
if self.stand_dir:
|
|
273
|
+
errors.append(
|
|
274
|
+
"transport=http несовместим с stand_dir: у стенда, доступного "
|
|
275
|
+
"только по HTTP-API, нет локальной папки"
|
|
276
|
+
)
|
|
277
|
+
# stand_host/stand_port НЕ проверяются на «заполненность»: у них
|
|
278
|
+
# есть дефолты (127.0.0.1:5000), поэтому пустыми они не бывают и
|
|
279
|
+
# проверка была бы декоративной. Осмысленность адреса для
|
|
280
|
+
# УДАЛЁННОГО стенда ловится на входе — валидатором stand_register
|
|
281
|
+
# (GAP-267 W0), который видит, задал ли адрес человек, — и самой
|
|
282
|
+
# HTTP-пробой, которая честно покажет down.
|
|
283
|
+
if str(self.stand_host).strip() in ("127.0.0.1", "localhost"):
|
|
284
|
+
errors.append(
|
|
285
|
+
"transport=http со stand_host=127.0.0.1/localhost: у удалённого "
|
|
286
|
+
"стенда без агента адрес обязан быть внешним — локальный означает, "
|
|
287
|
+
"что адрес не задан"
|
|
288
|
+
)
|
|
289
|
+
elif not self.stand_dir:
|
|
227
290
|
errors.append("stand_dir не может быть пустым")
|
|
228
291
|
if str(self.stand_scheme).lower() not in ("http", "https"):
|
|
229
292
|
errors.append("stand_scheme должен быть http или https")
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: standkit
|
|
3
|
-
Version: 0.12.
|
|
3
|
+
Version: 0.12.3
|
|
4
4
|
Summary: Свободное ядро (MIT) для управления жизненным циклом локальных и удалённых стендов BPMSoft: headless start/stop/restart, health-пробы, логи, реестр стендов. Часть экосистемы BPMkit.
|
|
5
5
|
Author: standkit contributors
|
|
6
6
|
License-Expression: MIT
|
|
@@ -25,7 +25,7 @@ import urllib.error
|
|
|
25
25
|
import urllib.request
|
|
26
26
|
from concurrent.futures import ThreadPoolExecutor
|
|
27
27
|
from dataclasses import dataclass
|
|
28
|
-
from typing import Optional
|
|
28
|
+
from typing import NoReturn, Optional
|
|
29
29
|
|
|
30
30
|
from standkit import health, lifecycle
|
|
31
31
|
from standkit.models import Stand, StandStatus, Transport
|
|
@@ -239,6 +239,26 @@ def _agent_request(
|
|
|
239
239
|
STATUS_ALL_MAX_WORKERS = 8
|
|
240
240
|
|
|
241
241
|
|
|
242
|
+
def _raise_unsupported(stand: Stand, name: str) -> NoReturn:
|
|
243
|
+
"""
|
|
244
|
+
Отказ по операции, которой у этого транспорта нет.
|
|
245
|
+
|
|
246
|
+
Для ``http`` (удалённый стенд без агента, GAP-277) это НЕ «пока не
|
|
247
|
+
реализовано»: управлять процессом удалённого стенда, о котором известен
|
|
248
|
+
только веб-адрес, нечем в принципе, и обещание «TODO» вводило в
|
|
249
|
+
заблуждение. Текст отказа совпадает с подсказкой у выключенных кнопок
|
|
250
|
+
диспетчера, чтобы ответ был один и тот же, откуда бы его ни получили.
|
|
251
|
+
"""
|
|
252
|
+
if stand.effective_transport == Transport.HTTP:
|
|
253
|
+
raise NotImplementedError(
|
|
254
|
+
f"стенд '{name}': без агента управление процессом недоступно "
|
|
255
|
+
"(транспорт http — известен только веб-адрес стенда)"
|
|
256
|
+
)
|
|
257
|
+
raise NotImplementedError(
|
|
258
|
+
f"Транспорт {stand.transport.value!r} для стенда '{name}' пока не реализован (TODO)"
|
|
259
|
+
)
|
|
260
|
+
|
|
261
|
+
|
|
242
262
|
class FederatedClient:
|
|
243
263
|
"""
|
|
244
264
|
Единая точка входа для хаба: даёт список стендов реестра со статусами,
|
|
@@ -262,7 +282,15 @@ class FederatedClient:
|
|
|
262
282
|
pf = lifecycle.pidfile_path(stand)
|
|
263
283
|
return health.check_stand(stand, pidfile=pf)
|
|
264
284
|
|
|
265
|
-
|
|
285
|
+
# Транспорт http — удалённый стенд без агента (GAP-277): опрашиваем
|
|
286
|
+
# его РОВНО тем же health.check_stand, что и локальные, — проба HTTP
|
|
287
|
+
# там уже умеет ходить по stand_host/stand_port/stand_scheme, а
|
|
288
|
+
# process/db/redis сама вернёт SKIPPED. Никакого pidfile: локального
|
|
289
|
+
# процесса у такого стенда нет.
|
|
290
|
+
if stand.effective_transport == Transport.HTTP:
|
|
291
|
+
return health.check_stand(stand)
|
|
292
|
+
|
|
293
|
+
if stand.effective_transport == Transport.AGENT:
|
|
266
294
|
if not stand.agent_url or not stand.agent_secret_ref:
|
|
267
295
|
raise RemoteCallError(stand.agent_url or "?", "не задан agent_url/agent_secret_ref")
|
|
268
296
|
token = get_secret(stand.agent_secret_ref)
|
|
@@ -271,9 +299,7 @@ class FederatedClient:
|
|
|
271
299
|
)
|
|
272
300
|
return StandStatus.from_dict(data)
|
|
273
301
|
|
|
274
|
-
|
|
275
|
-
f"Транспорт {stand.transport.value!r} для стенда '{name}' пока не реализован (TODO)"
|
|
276
|
-
)
|
|
302
|
+
_raise_unsupported(stand, name)
|
|
277
303
|
|
|
278
304
|
def _status_or_error(self, name: str) -> StandStatus:
|
|
279
305
|
"""
|
|
@@ -343,9 +369,7 @@ class FederatedClient:
|
|
|
343
369
|
candidate = data.get("candidate") if isinstance(data, dict) else None
|
|
344
370
|
return candidate if isinstance(candidate, dict) else None
|
|
345
371
|
|
|
346
|
-
|
|
347
|
-
f"Транспорт {stand.transport.value!r} для стенда '{name}' пока не реализован (TODO)"
|
|
348
|
-
)
|
|
372
|
+
_raise_unsupported(stand, name)
|
|
349
373
|
|
|
350
374
|
def _agent_action(self, stand: Stand, name: str, action: str, *, query: str = "") -> dict:
|
|
351
375
|
"""POST к агенту стенда с резолвом токена из secretstore (секрет наружу не отдаётся)."""
|
|
@@ -385,9 +409,7 @@ class FederatedClient:
|
|
|
385
409
|
data = self._agent_action(stand, name, action, query=query)
|
|
386
410
|
return data.get("pid") if isinstance(data, dict) else None
|
|
387
411
|
|
|
388
|
-
|
|
389
|
-
f"Транспорт {stand.transport.value!r} для стенда '{name}' пока не реализован (TODO)"
|
|
390
|
-
)
|
|
412
|
+
_raise_unsupported(stand, name)
|
|
391
413
|
|
|
392
414
|
def logs(self, name: str, n: int = 100) -> list[str]:
|
|
393
415
|
stand = self.registry.get(name)
|
|
@@ -406,6 +428,4 @@ class FederatedClient:
|
|
|
406
428
|
)
|
|
407
429
|
return list(data.get("lines", []))
|
|
408
430
|
|
|
409
|
-
|
|
410
|
-
f"Транспорт {stand.transport.value!r} для стенда '{name}' пока не реализован (TODO)"
|
|
411
|
-
)
|
|
431
|
+
_raise_unsupported(stand, name)
|
|
@@ -584,6 +584,16 @@ def _stand_entry(name: str, stand: Stand, status) -> dict:
|
|
|
584
584
|
# НА КАКУЮ машину уходит управление. У локальных стендов поля нет (``None``),
|
|
585
585
|
# а не пустая строка — «не применимо» и «не заполнено» это разные вещи.
|
|
586
586
|
"agent": (stand.agent_url or None) if stand.transport == Transport.AGENT else None,
|
|
587
|
+
# Хост удалённого стенда без агента (GAP-277) — для колонки
|
|
588
|
+
# «удалённый · http · <хост>». У прочих транспортов ключа нет.
|
|
589
|
+
"remote_host": (
|
|
590
|
+
(stand.stand_host or None)
|
|
591
|
+
if stand.effective_transport == Transport.HTTP
|
|
592
|
+
else None
|
|
593
|
+
),
|
|
594
|
+
# Предупреждение по записи, которую диспетчер трактует не буквально
|
|
595
|
+
# (legacy agent без agent_url → http, GAP-277). None — трактовка прямая.
|
|
596
|
+
"transport_warning": stand.transport_warning,
|
|
587
597
|
"status": status_dict,
|
|
588
598
|
# ``reason`` у http/redis — тот же приём, что у process.reason: без него
|
|
589
599
|
# наружу уходил голый "down"/"—", и оператор не мог отличить закрытый
|
|
@@ -886,16 +886,57 @@
|
|
|
886
886
|
return `<b class="stand-name">${escapeHtml(s.name)}</b>${hostChip(s)}`;
|
|
887
887
|
}
|
|
888
888
|
|
|
889
|
+
const REMOTE_HTTP_TITLE =
|
|
890
|
+
"Удалённый стенд без агента: известен только веб-адрес. Состояние — по HTTP-пробе; " +
|
|
891
|
+
"управление процессом, БД и Redis недоступны.";
|
|
892
|
+
|
|
893
|
+
// Из "https://host:443" (или голого host) делает host для колонки транспорта:
|
|
894
|
+
// в неё не помещается полный URL, а нужен ответ на вопрос «где стенд живёт».
|
|
895
|
+
function hostOf(value) {
|
|
896
|
+
const text = String(value || "");
|
|
897
|
+
try {
|
|
898
|
+
if (text.includes("://")) return new URL(text).hostname;
|
|
899
|
+
} catch (e) {
|
|
900
|
+
/* мусор в адресе не должен ронять отрисовку строки */
|
|
901
|
+
}
|
|
902
|
+
return text;
|
|
903
|
+
}
|
|
904
|
+
|
|
889
905
|
// Транспорт agent значит «стендом управляет агент на другой машине» — без
|
|
890
906
|
// имени этой машины строка не отвечает на единственный вопрос, ради которого
|
|
891
907
|
// на неё смотрят: где стенд физически живёт.
|
|
892
908
|
function transportCell(s) {
|
|
909
|
+
// Транспорт http (GAP-277) — удалённый стенд БЕЗ агента. Слово «агент» в
|
|
910
|
+
// этой строке было прямой дезинформацией: агента нет и не будет, поэтому
|
|
911
|
+
// пользователь не мог отличить «агент упал» от «агента здесь нет».
|
|
912
|
+
// Legacy-запись agent без agent_url сервер отдаёт с transport_warning и
|
|
913
|
+
// remote_host — показываем её как http, но с явным предупреждением, а не
|
|
914
|
+
// молча (реестр мы не переписывали, и оператор должен знать почему).
|
|
915
|
+
const warn = s.transport_warning || "";
|
|
916
|
+
if (s.transport === "http" || warn) {
|
|
917
|
+
const rhost = s.remote_host || (s.http && s.http.url) || "";
|
|
918
|
+
const title = warn ? `${REMOTE_HTTP_TITLE} ${warn}` : REMOTE_HTTP_TITLE;
|
|
919
|
+
const label = "удалённый · http";
|
|
920
|
+
const body = rhost ? `${label} · ${escapeHtml(hostOf(rhost))}` : label;
|
|
921
|
+
const badge = warn
|
|
922
|
+
? ` <span class="badge badge-warn" title="${escapeAttr(warn)}">запись agent без адреса</span>`
|
|
923
|
+
: "";
|
|
924
|
+
return `<span title="${escapeAttr(title)}">${body}</span>${badge}`;
|
|
925
|
+
}
|
|
893
926
|
if (s.transport !== "agent") return escapeHtml(s.transport || "—");
|
|
894
927
|
const host = s.agent || (s.process && s.process.agent) || "";
|
|
895
928
|
return host ? `агент · ${escapeHtml(host)}` : "агент";
|
|
896
929
|
}
|
|
897
930
|
|
|
898
931
|
function dbCell(s) {
|
|
932
|
+
// Имя базы из реестра у стенда без агента (GAP-277) — ничем не
|
|
933
|
+
// подтверждённая строка: её состояние никто не проверял. Показывать её
|
|
934
|
+
// цветом пробы значит выдавать запись реестра за факт.
|
|
935
|
+
if (s.transport === "http" || s.transport_warning) {
|
|
936
|
+
return `<span class="value-cell value-skipped" title="${escapeAttr(
|
|
937
|
+
"не проверяется без агента"
|
|
938
|
+
)}">—</span>`;
|
|
939
|
+
}
|
|
899
940
|
const db = s.db || {};
|
|
900
941
|
const engine = db.type || s.db_type || "";
|
|
901
942
|
const icon = DB_ICONS[engine] || "";
|
|
@@ -912,7 +953,12 @@
|
|
|
912
953
|
// недоступен» (GAP-003, п.4) — раньше обе ситуации выглядели одинаково, с
|
|
913
954
|
// жёстко зашитым «Redis не настроен у стенда». Этот текст остался фолбэком
|
|
914
955
|
// на случай ответа без reason (старый агент или снапшот без проб).
|
|
915
|
-
function redisCell(redis) {
|
|
956
|
+
function redisCell(redis, stand) {
|
|
957
|
+
if (stand && (stand.transport === "http" || stand.transport_warning)) {
|
|
958
|
+
return `<span class="value-cell value-skipped" title="${escapeAttr(
|
|
959
|
+
"не проверяется без агента"
|
|
960
|
+
)}">—</span>`;
|
|
961
|
+
}
|
|
916
962
|
const num = redis && redis.number;
|
|
917
963
|
const reason = reasonAttrs(redis && redis.reason);
|
|
918
964
|
if (num === null || num === undefined) {
|
|
@@ -1021,21 +1067,31 @@
|
|
|
1021
1067
|
return html;
|
|
1022
1068
|
}
|
|
1023
1069
|
|
|
1070
|
+
const NO_AGENT_TITLE = "без агента управление процессом недоступно";
|
|
1071
|
+
|
|
1024
1072
|
function actionButtons(s) {
|
|
1025
1073
|
const processState = s.process ? s.process.state : "unknown";
|
|
1026
1074
|
const isStarting = startingStands.has(s.name);
|
|
1027
|
-
|
|
1028
|
-
|
|
1029
|
-
|
|
1075
|
+
// Удалённый стенд без агента (GAP-277): кнопки процесса не «пока серые»,
|
|
1076
|
+
// а неприменимы в принципе — активная кнопка, которая ничего не может
|
|
1077
|
+
// сделать, и была жалобой владельца.
|
|
1078
|
+
const noAgent = s.transport === "http" || !!s.transport_warning;
|
|
1079
|
+
const startDisabled = noAgent || processState === "ok" || isStarting;
|
|
1080
|
+
const stopDisabled = noAgent || processState === "down";
|
|
1081
|
+
const restartDisabled = noAgent || processState === "down";
|
|
1030
1082
|
const redisNumber = s.redis && s.redis.number;
|
|
1031
1083
|
const redisKnown = redisNumber !== null && redisNumber !== undefined;
|
|
1032
|
-
const redisDisabled = !redisKnown;
|
|
1033
|
-
const redisTitle =
|
|
1084
|
+
const redisDisabled = noAgent || !redisKnown;
|
|
1085
|
+
const redisTitle = noAgent
|
|
1086
|
+
? NO_AGENT_TITLE
|
|
1087
|
+
: redisKnown
|
|
1088
|
+
? "Очистить Redis"
|
|
1089
|
+
: "redis не настроен у стенда";
|
|
1034
1090
|
const name = escapeHtml(s.name);
|
|
1035
1091
|
return `
|
|
1036
|
-
<button class="icon-btn icon-btn-play" data-action="start" data-name="${name}" title="Запустить"${startDisabled ? " disabled" : ""}>${ICON_PLAY}</button>
|
|
1037
|
-
<button class="icon-btn icon-btn-stop" data-action="stop" data-name="${name}" title="Остановить"${stopDisabled ? " disabled" : ""}>${ICON_STOP}</button>
|
|
1038
|
-
<button class="icon-btn icon-btn-restart" data-action="restart" data-name="${name}" title="Перезапустить"${restartDisabled ? " disabled" : ""}>${ICON_RESTART}</button>
|
|
1092
|
+
<button class="icon-btn icon-btn-play" data-action="start" data-name="${name}" title="${escapeAttr(noAgent ? NO_AGENT_TITLE : "Запустить")}"${startDisabled ? " disabled" : ""}>${ICON_PLAY}</button>
|
|
1093
|
+
<button class="icon-btn icon-btn-stop" data-action="stop" data-name="${name}" title="${escapeAttr(noAgent ? NO_AGENT_TITLE : "Остановить")}"${stopDisabled ? " disabled" : ""}>${ICON_STOP}</button>
|
|
1094
|
+
<button class="icon-btn icon-btn-restart" data-action="restart" data-name="${name}" title="${escapeAttr(noAgent ? NO_AGENT_TITLE : "Перезапустить")}"${restartDisabled ? " disabled" : ""}>${ICON_RESTART}</button>
|
|
1039
1095
|
<button class="icon-btn icon-btn-redis" data-action="redis-clear" data-name="${name}" title="${escapeHtml(redisTitle)}"${redisDisabled ? " disabled" : ""}>${ICON_REDIS_CLEAR}</button>
|
|
1040
1096
|
`;
|
|
1041
1097
|
}
|
|
@@ -1160,7 +1216,7 @@
|
|
|
1160
1216
|
<td>${processCell(s)}</td>
|
|
1161
1217
|
<td>${httpCell(http)}</td>
|
|
1162
1218
|
<td>${dbCell(s)}</td>
|
|
1163
|
-
<td>${redisCell(redis)}</td>
|
|
1219
|
+
<td>${redisCell(redis, s)}</td>
|
|
1164
1220
|
<td class="row-actions">${actionButtons(s)}</td>
|
|
1165
1221
|
`;
|
|
1166
1222
|
tr.addEventListener("click", (evt) => {
|
|
@@ -228,6 +228,9 @@
|
|
|
228
228
|
<select name="transport">
|
|
229
229
|
<option value="local" selected>local</option>
|
|
230
230
|
<option value="agent">agent</option>
|
|
231
|
+
<!-- GAP-277: удалённый стенд, к которому есть только веб-адрес
|
|
232
|
+
и учётка. Процессом такого стенда управлять нечем. -->
|
|
233
|
+
<option value="http">http — удалённый, без агента</option>
|
|
231
234
|
</select>
|
|
232
235
|
</label>
|
|
233
236
|
<label>Хостинг
|
|
@@ -240,6 +243,15 @@
|
|
|
240
243
|
</label>
|
|
241
244
|
</div>
|
|
242
245
|
|
|
246
|
+
<div class="register-conditional" data-when-transport="http" hidden>
|
|
247
|
+
<p class="field-hint">
|
|
248
|
+
Удалённый стенд без агента: диспетчер знает только его веб-адрес
|
|
249
|
+
(поля «Хост стенда» / «Порт» / «Схема» ниже) и показывает состояние
|
|
250
|
+
по HTTP-пробе. Папка стенда не указывается — её нет; запуск,
|
|
251
|
+
остановка, перезапуск, БД и Redis для такого стенда недоступны.
|
|
252
|
+
</p>
|
|
253
|
+
</div>
|
|
254
|
+
|
|
243
255
|
<div class="register-conditional" data-when-transport="agent" hidden>
|
|
244
256
|
<label>Agent URL
|
|
245
257
|
<input type="text" name="agent_url" placeholder="https://host:8765" />
|
|
@@ -1062,6 +1062,18 @@ body.hub-offline .stands-table-wrap {
|
|
|
1062
1062
|
cursor: help;
|
|
1063
1063
|
}
|
|
1064
1064
|
|
|
1065
|
+
/* «запись agent без адреса» (GAP-277) — запись реестра, которую диспетчер
|
|
1066
|
+
трактует как удалённый стенд без агента. Та же контурная предупреждающая
|
|
1067
|
+
форма, что у «вне диспетчера»: это не авария и не норма, а сообщение о том,
|
|
1068
|
+
что показанное состояние выведено, а не взято из записи буквально. */
|
|
1069
|
+
.badge-warn {
|
|
1070
|
+
background: transparent;
|
|
1071
|
+
color: var(--bpmkit-unknown);
|
|
1072
|
+
border: 1px solid var(--bpmkit-unknown);
|
|
1073
|
+
font-weight: 500;
|
|
1074
|
+
cursor: help;
|
|
1075
|
+
}
|
|
1076
|
+
|
|
1065
1077
|
/* Строка кнопки «Определить автоматически» в форме регистрации (host_kind=iis). */
|
|
1066
1078
|
.iis-detect-row {
|
|
1067
1079
|
display: flex;
|
|
@@ -726,3 +726,124 @@ def test_probe_redis_garbage_port_is_unknown_not_crash():
|
|
|
726
726
|
status = check_stand(stand)
|
|
727
727
|
assert status.redis == ProbeState.UNKNOWN
|
|
728
728
|
assert "не задан" in status.details["redis_reason"]
|
|
729
|
+
|
|
730
|
+
|
|
731
|
+
# --- GAP-277: удалённый стенд без агента (transport=http) ---------------------
|
|
732
|
+
#
|
|
733
|
+
# Суть гэпа не в том, что проб «не хватает», а в том, что диспетчер ВРАЛ:
|
|
734
|
+
# показывал «агент · unknown» с активными кнопками и именем непроверенной БД.
|
|
735
|
+
# Поэтому тесты проверяют не только «HTTP-проба отработала», но и что
|
|
736
|
+
# остальные три пробы честно помечены SKIPPED, а не UNKNOWN.
|
|
737
|
+
|
|
738
|
+
|
|
739
|
+
def _http_stand(**kw) -> Stand:
|
|
740
|
+
data = dict(
|
|
741
|
+
name="survey9",
|
|
742
|
+
transport=Transport.HTTP,
|
|
743
|
+
stand_host="stand.example.test",
|
|
744
|
+
stand_port=_find_closed_port(),
|
|
745
|
+
stand_scheme="http",
|
|
746
|
+
)
|
|
747
|
+
data.update(kw)
|
|
748
|
+
return Stand(**data)
|
|
749
|
+
|
|
750
|
+
|
|
751
|
+
def test_http_transport_skips_process_db_redis_probes():
|
|
752
|
+
"""Процесс/БД/Redis у стенда без агента — SKIPPED с объяснением."""
|
|
753
|
+
stand = _http_stand(
|
|
754
|
+
stand_host="127.0.0.1", db_host="127.0.0.1", db_port=5432,
|
|
755
|
+
redis_host="127.0.0.1", redis_port=6379,
|
|
756
|
+
)
|
|
757
|
+
status = check_stand(stand)
|
|
758
|
+
|
|
759
|
+
assert status.process is ProbeState.SKIPPED
|
|
760
|
+
assert status.db is ProbeState.SKIPPED
|
|
761
|
+
assert status.redis is ProbeState.SKIPPED
|
|
762
|
+
# UNKNOWN читается как «не смогли узнать»; здесь смысл другой — «проверять
|
|
763
|
+
# нечем по построению», и это должно быть сказано словами.
|
|
764
|
+
assert "без агента" in status.details["process_reason"]
|
|
765
|
+
assert status.details["db_reason"] == "не проверяется без агента"
|
|
766
|
+
assert status.details["redis_reason"] == "не проверяется без агента"
|
|
767
|
+
|
|
768
|
+
|
|
769
|
+
def test_http_transport_still_probes_http_honestly():
|
|
770
|
+
"""HTTP-проба выполняется по-настоящему: закрытый порт → DOWN, а не unknown."""
|
|
771
|
+
status = check_stand(_http_stand(stand_host="127.0.0.1"))
|
|
772
|
+
assert status.http is ProbeState.DOWN
|
|
773
|
+
assert "URL:" in status.details["http_reason"]
|
|
774
|
+
|
|
775
|
+
|
|
776
|
+
def test_http_transport_http_probe_ok_on_live_server():
|
|
777
|
+
"""Живой адрес → up (ровно тот же путь, что у локальных стендов)."""
|
|
778
|
+
server = http.server.ThreadingHTTPServer(("127.0.0.1", 0), _QuietHandler)
|
|
779
|
+
threading.Thread(target=server.serve_forever, daemon=True).start()
|
|
780
|
+
try:
|
|
781
|
+
stand = _http_stand(stand_host="127.0.0.1", stand_port=server.server_address[1])
|
|
782
|
+
status = check_stand(stand)
|
|
783
|
+
assert status.http is ProbeState.OK
|
|
784
|
+
assert status.process is ProbeState.SKIPPED
|
|
785
|
+
finally:
|
|
786
|
+
server.shutdown()
|
|
787
|
+
server.server_close()
|
|
788
|
+
|
|
789
|
+
|
|
790
|
+
def test_legacy_agent_without_url_reads_as_http():
|
|
791
|
+
"""
|
|
792
|
+
Обратная совместимость (п.1 плана GAP-277): запись agent БЕЗ agent_url —
|
|
793
|
+
это и есть «удалённый стенд, к которому есть только адрес». До правки она
|
|
794
|
+
давала вечный unknown, потому что опрос уходил к несуществующему агенту.
|
|
795
|
+
"""
|
|
796
|
+
stand = Stand(
|
|
797
|
+
name="legacy",
|
|
798
|
+
transport=Transport.AGENT,
|
|
799
|
+
stand_host="127.0.0.1",
|
|
800
|
+
stand_port=_find_closed_port(),
|
|
801
|
+
)
|
|
802
|
+
assert stand.effective_transport is Transport.HTTP
|
|
803
|
+
assert stand.transport_warning and "agent_url" in stand.transport_warning
|
|
804
|
+
# Поле реестра при этом НЕ переписано — трактовка живёт в рантайме.
|
|
805
|
+
assert stand.transport is Transport.AGENT
|
|
806
|
+
|
|
807
|
+
status = check_stand(stand)
|
|
808
|
+
assert status.process is ProbeState.SKIPPED
|
|
809
|
+
assert status.http is ProbeState.DOWN
|
|
810
|
+
|
|
811
|
+
|
|
812
|
+
def test_agent_with_url_keeps_agent_semantics():
|
|
813
|
+
"""Настоящая agent-запись не должна пострадать от совместимости выше."""
|
|
814
|
+
stand = Stand(
|
|
815
|
+
name="real-agent",
|
|
816
|
+
transport=Transport.AGENT,
|
|
817
|
+
agent_url="https://host:8765",
|
|
818
|
+
stand_dir="/srv/stand",
|
|
819
|
+
)
|
|
820
|
+
assert stand.effective_transport is Transport.AGENT
|
|
821
|
+
assert stand.transport_warning is None
|
|
822
|
+
|
|
823
|
+
|
|
824
|
+
def test_http_stand_validation_rules():
|
|
825
|
+
"""
|
|
826
|
+
Валидация записи http: stand_dir запрещён (его нет по построению), адрес
|
|
827
|
+
обязателен. Без этого каждая корректная запись «только адрес и пароль»
|
|
828
|
+
считалась бы невалидной из-за общего требования stand_dir.
|
|
829
|
+
"""
|
|
830
|
+
assert _http_stand().validate() == []
|
|
831
|
+
|
|
832
|
+
# Локальный адрес у УДАЛЁННОГО стенда — это «адрес не задан» (у поля есть
|
|
833
|
+
# дефолт 127.0.0.1, поэтому пустым оно не бывает и проверять «заполнено ли»
|
|
834
|
+
# бессмысленно).
|
|
835
|
+
errors = _http_stand(stand_host="127.0.0.1").validate()
|
|
836
|
+
assert any("stand_host" in e for e in errors)
|
|
837
|
+
|
|
838
|
+
errors = _http_stand(stand_dir="C:/stand").validate()
|
|
839
|
+
assert any("stand_dir" in e for e in errors)
|
|
840
|
+
|
|
841
|
+
|
|
842
|
+
class _QuietHandler(http.server.BaseHTTPRequestHandler):
|
|
843
|
+
def do_GET(self): # noqa: N802
|
|
844
|
+
self.send_response(200)
|
|
845
|
+
self.end_headers()
|
|
846
|
+
self.wfile.write(b"ok")
|
|
847
|
+
|
|
848
|
+
def log_message(self, *args): # тишина в выводе тестов
|
|
849
|
+
pass
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|