local-triage 0.0.0-stage → 0.10.0-dev.32
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.
- package/LICENSE +21 -0
- package/README.md +90 -2
- package/THIRD-PARTY-NOTICES.md +48 -0
- package/app/__init__.py +3 -0
- package/app/affiliation.py +137 -0
- package/app/ask.py +300 -0
- package/app/build_info.py +98 -0
- package/app/capec.py +168 -0
- package/app/capec_view.py +27 -0
- package/app/codecmp.py +59 -0
- package/app/config.py +411 -0
- package/app/context.py +1451 -0
- package/app/cvss.py +357 -0
- package/app/db.py +6234 -0
- package/app/defect.py +670 -0
- package/app/defect_check.py +323 -0
- package/app/defect_drafts.py +612 -0
- package/app/defect_dto.py +149 -0
- package/app/defect_fields.py +248 -0
- package/app/defect_form.py +124 -0
- package/app/defect_links.py +107 -0
- package/app/defect_local_text.py +103 -0
- package/app/defect_references.py +164 -0
- package/app/defect_where.py +147 -0
- package/app/ecosystem.py +51 -0
- package/app/executors.py +660 -0
- package/app/feeds.py +1231 -0
- package/app/guard.py +164 -0
- package/app/hub_block_builder.py +200 -0
- package/app/hub_block_version.py +220 -0
- package/app/hub_defects.py +4469 -0
- package/app/hub_effects.py +421 -0
- package/app/hub_entity_versions.py +108 -0
- package/app/hub_import.py +2054 -0
- package/app/hub_onboarding.py +114 -0
- package/app/hub_ops.py +330 -0
- package/app/hub_pull.py +1195 -0
- package/app/hub_state.py +255 -0
- package/app/hub_status.py +237 -0
- package/app/hub_sync.py +619 -0
- package/app/hub_sync_api.py +241 -0
- package/app/hub_sync_compare.py +1054 -0
- package/app/hub_sync_contract.py +75 -0
- package/app/hub_template_model.py +74 -0
- package/app/hub_text_scale.py +159 -0
- package/app/journal.py +250 -0
- package/app/llm.py +850 -0
- package/app/llm_chat.py +596 -0
- package/app/llm_http.py +319 -0
- package/app/llm_messages.py +401 -0
- package/app/llm_net.py +764 -0
- package/app/llm_ollama.py +571 -0
- package/app/lockfile.py +505 -0
- package/app/logsafe.py +54 -0
- package/app/main.py +367 -0
- package/app/mask_display.py +132 -0
- package/app/masking.py +814 -0
- package/app/metrics.py +194 -0
- package/app/model_traffic.py +519 -0
- package/app/models.py +483 -0
- package/app/navigation.py +121 -0
- package/app/osv.py +279 -0
- package/app/package_identity.py +189 -0
- package/app/package_transition.py +824 -0
- package/app/profile_gate.py +71 -0
- package/app/prompts.py +1108 -0
- package/app/provider_keys.py +189 -0
- package/app/providers.py +511 -0
- package/app/routes/__init__.py +10 -0
- package/app/routes/api.py +153 -0
- package/app/routes/capec.py +186 -0
- package/app/routes/common.py +407 -0
- package/app/routes/components.py +1499 -0
- package/app/routes/cwe.py +168 -0
- package/app/routes/decision_selected.py +153 -0
- package/app/routes/defect_add.py +223 -0
- package/app/routes/defect_card_routes.py +363 -0
- package/app/routes/defect_selected.py +342 -0
- package/app/routes/feeds.py +155 -0
- package/app/routes/findings.py +2736 -0
- package/app/routes/hub.py +402 -0
- package/app/routes/hub_bulk.py +288 -0
- package/app/routes/hub_defect_routes.py +1945 -0
- package/app/routes/hub_status_routes.py +1132 -0
- package/app/routes/hub_sync_routes.py +463 -0
- package/app/routes/journal.py +132 -0
- package/app/routes/projects.py +1601 -0
- package/app/routes/providers.py +336 -0
- package/app/routes/references.py +26 -0
- package/app/routes/runs.py +219 -0
- package/app/routes/sca.py +2722 -0
- package/app/routes/settings.py +163 -0
- package/app/run_errors.py +151 -0
- package/app/sca.py +1662 -0
- package/app/sca_contract.py +1289 -0
- package/app/sca_research.py +1089 -0
- package/app/sca_research_net.py +1007 -0
- package/app/sca_text.py +965 -0
- package/app/serve.py +70 -0
- package/app/settings_store.py +262 -0
- package/app/static/app.css +2802 -0
- package/app/static/app.js +3772 -0
- package/app/static/capec-license.txt +9 -0
- package/app/static/favicon.svg +1 -0
- package/app/static/fonts/Golos-Text_DemiBold.woff2 +0 -0
- package/app/static/fonts/Golos-Text_Regular.woff2 +0 -0
- package/app/static/fonts/OFL.txt +90 -0
- package/app/static/navigation.js +234 -0
- package/app/static/observability.js +121 -0
- package/app/static/theme.js +49 -0
- package/app/storage/__init__.py +16 -0
- package/app/storage/local_state.py +246 -0
- package/app/storage/migrate.py +110 -0
- package/app/storage/migrations/postgresql/0001_baseline.sql +896 -0
- package/app/storage/migrations/postgresql/0002_feeds_and_secrets.sql +55 -0
- package/app/storage/migrations/postgresql/0003_project_mask_display.sql +5 -0
- package/app/storage/migrations/postgresql/0004_package_identity.sql +36 -0
- package/app/storage/postgresql.py +573 -0
- package/app/storage/schema.py +619 -0
- package/app/storage/sql.py +57 -0
- package/app/storage/tools.py +254 -0
- package/app/telemetry.py +307 -0
- package/app/templates/base.html +91 -0
- package/app/templates/capec/context.html +3 -0
- package/app/templates/capec/detail.html +27 -0
- package/app/templates/capec/index.html +128 -0
- package/app/templates/components/_archive.html +11 -0
- package/app/templates/components/archived.html +19 -0
- package/app/templates/components/batch.html +35 -0
- package/app/templates/components/detail.html +332 -0
- package/app/templates/components/index.html +338 -0
- package/app/templates/components/research_preview.html +80 -0
- package/app/templates/components/research_run.html +54 -0
- package/app/templates/cwe/bdu.html +56 -0
- package/app/templates/cwe/detail.html +233 -0
- package/app/templates/cwe/index.html +97 -0
- package/app/templates/error.html +8 -0
- package/app/templates/feeds/index.html +65 -0
- package/app/templates/findings/card.html +639 -0
- package/app/templates/findings/decision_selected.html +41 -0
- package/app/templates/findings/defect_add.html +46 -0
- package/app/templates/findings/defect_selected.html +47 -0
- package/app/templates/findings/list.html +153 -0
- package/app/templates/findings/send_selected.html +53 -0
- package/app/templates/findings/trace.html +72 -0
- package/app/templates/journal/detail.html +19 -0
- package/app/templates/journal/index.html +19 -0
- package/app/templates/macros.html +440 -0
- package/app/templates/navigation-fields.html +1 -0
- package/app/templates/navigation.html +11 -0
- package/app/templates/projects/_identity_summary.html +42 -0
- package/app/templates/projects/defect_card.html +153 -0
- package/app/templates/projects/defect_create_preview.html +17 -0
- package/app/templates/projects/defect_fields_diff.html +6 -0
- package/app/templates/projects/defect_fields_form.html +40 -0
- package/app/templates/projects/defect_references.html +17 -0
- package/app/templates/projects/defect_sync_preview.html +28 -0
- package/app/templates/projects/defect_update_actions.html +6 -0
- package/app/templates/projects/defect_update_preview.html +24 -0
- package/app/templates/projects/defects.html +126 -0
- package/app/templates/projects/delete.html +31 -0
- package/app/templates/projects/external.html +61 -0
- package/app/templates/projects/folders.html +64 -0
- package/app/templates/projects/hub_accepted.html +10 -0
- package/app/templates/projects/hub_assignment.html +50 -0
- package/app/templates/projects/hub_pending.html +20 -0
- package/app/templates/projects/hub_pending_list.html +17 -0
- package/app/templates/projects/hub_state_note.html +23 -0
- package/app/templates/projects/hub_step_note.html +5 -0
- package/app/templates/projects/hub_sync.html +105 -0
- package/app/templates/projects/hub_sync_confirm.html +32 -0
- package/app/templates/projects/hub_sync_worker.html +5 -0
- package/app/templates/projects/hub_text_rules.html +64 -0
- package/app/templates/projects/identity_report.html +74 -0
- package/app/templates/projects/list.html +90 -0
- package/app/templates/projects/project.html +433 -0
- package/app/templates/reference-missing.html +14 -0
- package/app/templates/runs/run.html +166 -0
- package/app/templates/sca/card.html +476 -0
- package/app/templates/sca/index.html +321 -0
- package/app/templates/settings/hub_url.html +31 -0
- package/app/templates/settings/index.html +216 -0
- package/app/templates/settings/provider.html +229 -0
- package/app/templates/settings/providers.html +37 -0
- package/app/templates/worklists.html +52 -0
- package/app/textsafe.py +117 -0
- package/app/timing.py +245 -0
- package/app/triage.py +1743 -0
- package/app/view.py +430 -0
- package/app/worklists.py +204 -0
- package/examples/demo/demo-hub-report-v2.xlsx +0 -0
- package/examples/demo/demo-hub-report.xlsx +0 -0
- package/examples/demo/repos/billing-core/pom.xml +30 -0
- package/examples/demo/repos/billing-core/src/main/java/org/example/billing/Invoice.java +9 -0
- package/examples/demo/repos/billing-core/src/main/java/org/example/billing/InvoiceRepository.java +51 -0
- package/examples/demo/repos/billing-core/src/main/java/org/example/billing/InvoiceStatus.java +11 -0
- package/examples/demo/repos/billing-core/src/main/java/org/example/billing/config/DatabaseSettings.java +18 -0
- package/examples/demo/repos/billing-core/src/main/java/org/example/billing/payment/PaymentTokenService.java +35 -0
- package/examples/demo/repos/billing-core/src/main/java/org/example/billing/web/InvoiceExportController.java +57 -0
- package/examples/demo/repos/catalog-api/catalog_api/__init__.py +1 -0
- package/examples/demo/repos/catalog-api/catalog_api/products.py +24 -0
- package/examples/demo/repos/catalog-api/catalog_api/tasks.py +24 -0
- package/examples/demo/repos/catalog-api/catalog_api/views.py +17 -0
- package/examples/demo/repos/catalog-api/requirements.txt +3 -0
- package/npm/build.json +5 -0
- package/npm/cli.js +346 -0
- package/npm/files.manifest +224 -0
- package/npm/lib/binding.js +64 -0
- package/npm/lib/cluster.js +330 -0
- package/npm/lib/env.js +88 -0
- package/npm/lib/fsx.js +125 -0
- package/npm/lib/http.js +53 -0
- package/npm/lib/metrics.js +73 -0
- package/npm/lib/paths.js +150 -0
- package/npm/lib/pg.js +351 -0
- package/npm/lib/proc.js +101 -0
- package/npm/lib/python.js +133 -0
- package/npm/lib/stand.js +46 -0
- package/npm/lib/supervisor.js +1141 -0
- package/npm/lib/version.js +21 -0
- package/npm/requirements.txt +476 -0
- package/npm-shrinkwrap.json +111 -0
- package/package.json +37 -4
|
@@ -0,0 +1,1141 @@
|
|
|
1
|
+
'use strict';
|
|
2
|
+
// Держатель учебного стенда (ADR-0155). Окно npx (npm/cli.js) – только интерфейс:
|
|
3
|
+
// оно запускает этот процесс без консоли и печатает его ход. Держатель занимает служебный порт (замок стенда держит
|
|
4
|
+
// ОС), ставит Python, ведёт PostgreSQL, запускает приложение, пишет сведения о компьютере и останавливает всё сам,
|
|
5
|
+
// когда закрывается его stdin: Ctrl+C, закрытие окна или гибель окна.
|
|
6
|
+
//
|
|
7
|
+
// Строки для окна: обычный текст – печатается как есть; «@@ready <адрес>» – стенд готов, «@@phase <фаза>» – смена фазы.
|
|
8
|
+
|
|
9
|
+
const crypto = require('node:crypto');
|
|
10
|
+
const fs = require('node:fs');
|
|
11
|
+
const http = require('node:http');
|
|
12
|
+
const net = require('node:net');
|
|
13
|
+
const path = require('node:path');
|
|
14
|
+
const { spawn } = require('node:child_process');
|
|
15
|
+
|
|
16
|
+
const binding = require('./binding');
|
|
17
|
+
const cluster = require('./cluster');
|
|
18
|
+
const fsx = require('./fsx');
|
|
19
|
+
const { getJson } = require('./http');
|
|
20
|
+
const envs = require('./env');
|
|
21
|
+
const metrics = require('./metrics');
|
|
22
|
+
const pg = require('./pg');
|
|
23
|
+
const python = require('./python');
|
|
24
|
+
const stand = require('./stand');
|
|
25
|
+
const { StandError, canonical, pathMargin } = require('./paths');
|
|
26
|
+
const { npmVersionOf } = require('./version');
|
|
27
|
+
const { run, tail, settle } = require('./proc');
|
|
28
|
+
|
|
29
|
+
const APP_STOP_MS = 25000; // сколько ждать штатной остановки приложения после закрытия его stdin
|
|
30
|
+
const READY_MS = 60000; // ожидание готовности /healthz
|
|
31
|
+
const LOCK_STALE_MS = 20000; // STALE_S замка папки данных (app/lockfile.py)
|
|
32
|
+
const RESTARTS = 3; // перезапусков приложения после готовности за RESTART_WINDOW_MS (Д15)
|
|
33
|
+
const RESTART_WINDOW_MS = 600000;
|
|
34
|
+
const APP_PORT_FIRST = 8765;
|
|
35
|
+
const APP_PORT_TRIES = 30;
|
|
36
|
+
|
|
37
|
+
const opts = JSON.parse(process.argv[2] || '{}');
|
|
38
|
+
const home = opts.home;
|
|
39
|
+
const codeDir = opts.codeDir;
|
|
40
|
+
const packageDir = opts.packageDir;
|
|
41
|
+
const version = opts.appVersion;
|
|
42
|
+
const dirs = {
|
|
43
|
+
base: path.join(home, version), logs: path.join(home, 'logs'), tmp: path.join(home, 'tmp'), data: path.join(home, 'data'),
|
|
44
|
+
secrets: path.join(home, 'secrets'), pg: path.join(home, 'pg'),
|
|
45
|
+
};
|
|
46
|
+
const dataDir = path.join(dirs.pg, 'data');
|
|
47
|
+
const binDir = path.join(dirs.pg, `bin-${pg.PG_RELEASE}`);
|
|
48
|
+
|
|
49
|
+
let phase = 'installing';
|
|
50
|
+
let message = '';
|
|
51
|
+
let appPort = 0;
|
|
52
|
+
let appUrl = '';
|
|
53
|
+
let pgPort = 0;
|
|
54
|
+
let password = '';
|
|
55
|
+
let py = '';
|
|
56
|
+
let appRoot = '';
|
|
57
|
+
let child = null;
|
|
58
|
+
let stopping = false;
|
|
59
|
+
let stopCollector = () => {};
|
|
60
|
+
let lockServer = null;
|
|
61
|
+
let state = null;
|
|
62
|
+
let logFile = null;
|
|
63
|
+
const apps = new Set(); // запущенные процессы приложения, пока не завершились
|
|
64
|
+
let tempServer = null; // временный сервер на pg/next во время обновления схемы
|
|
65
|
+
let pgStarted = false; // рабочий PostgreSQL запущен или найден этим держателем
|
|
66
|
+
|
|
67
|
+
class Cancelled extends Error {}
|
|
68
|
+
|
|
69
|
+
/** Остановка началась: дальнейшие шаги запуска не выполняются. */
|
|
70
|
+
function checkStop() {
|
|
71
|
+
if (stopping) throw new Cancelled('остановка');
|
|
72
|
+
}
|
|
73
|
+
const token = crypto.randomBytes(16).toString('hex');
|
|
74
|
+
const restarts = [];
|
|
75
|
+
|
|
76
|
+
process.stdout.on('error', () => {});
|
|
77
|
+
process.stderr.on('error', () => {});
|
|
78
|
+
|
|
79
|
+
function stamp() {
|
|
80
|
+
return new Date().toISOString();
|
|
81
|
+
}
|
|
82
|
+
|
|
83
|
+
function log(line) {
|
|
84
|
+
if (!logFile) return;
|
|
85
|
+
try { fs.appendFileSync(logFile, `${stamp()} ${line}\n`); } catch { /* журнал недоступен – ход всё равно виден в окне */ }
|
|
86
|
+
}
|
|
87
|
+
|
|
88
|
+
function say(text) {
|
|
89
|
+
for (const line of String(text).split(/\r?\n/)) {
|
|
90
|
+
try { process.stdout.write(`${line}\n`); } catch { /* окно закрыто */ }
|
|
91
|
+
log(line);
|
|
92
|
+
}
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
function setPhase(next, text = '') {
|
|
96
|
+
phase = next;
|
|
97
|
+
message = text;
|
|
98
|
+
try { process.stdout.write(`@@phase ${next}\n`); } catch { /* окно закрыто */ }
|
|
99
|
+
log(`фаза: ${next}${text ? ` – ${text}` : ''}`);
|
|
100
|
+
}
|
|
101
|
+
|
|
102
|
+
// ---------------------------------------------------------------- замок стенда: служебный порт
|
|
103
|
+
|
|
104
|
+
function status() {
|
|
105
|
+
return { stand: 'local-triage', id: state ? state.data.id : '', version, mode: opts.local ? 'local-only' : 'external',
|
|
106
|
+
code_dir: codeDir, code_dir_real: codeReal ? canonical(codeReal) : '', home, phase, message, stopping, app_port: appPort,
|
|
107
|
+
url: appUrl, pid: process.pid };
|
|
108
|
+
}
|
|
109
|
+
|
|
110
|
+
function holdLock(port) {
|
|
111
|
+
return new Promise((resolve, reject) => {
|
|
112
|
+
const server = http.createServer((req, res) => {
|
|
113
|
+
if (req.headers.host !== `127.0.0.1:${port}` || req.url !== '/status' || req.method !== 'GET') {
|
|
114
|
+
res.writeHead(404);
|
|
115
|
+
res.end();
|
|
116
|
+
return;
|
|
117
|
+
}
|
|
118
|
+
res.writeHead(200, { 'Content-Type': 'application/json; charset=utf-8', 'Cache-Control': 'no-store' });
|
|
119
|
+
res.end(JSON.stringify(status()));
|
|
120
|
+
});
|
|
121
|
+
server.once('error', reject);
|
|
122
|
+
server.listen({ port, host: '127.0.0.1', exclusive: true }, () => resolve(server));
|
|
123
|
+
});
|
|
124
|
+
}
|
|
125
|
+
|
|
126
|
+
// ---------------------------------------------------------------- служебные команды приложения
|
|
127
|
+
|
|
128
|
+
function toolEnv(port) {
|
|
129
|
+
return envs.appEnv({ dataDir: dirs.data, tmpDir: dirs.tmp, codeDir, codeReal, libpq: envs.libpqEnv(port, password), external: false,
|
|
130
|
+
build: opts.build || {}, token });
|
|
131
|
+
}
|
|
132
|
+
|
|
133
|
+
async function tools(args, port, timeoutMs = 300000) {
|
|
134
|
+
const result = await run(py, ['-E', '-s', '-X', 'utf8', '-m', 'app.storage.tools', ...args],
|
|
135
|
+
{ cwd: appRoot, env: toolEnv(port), timeoutMs });
|
|
136
|
+
let answer = null;
|
|
137
|
+
try { answer = JSON.parse(result.stdout); } catch { answer = null; }
|
|
138
|
+
return { code: result.code, answer, result };
|
|
139
|
+
}
|
|
140
|
+
|
|
141
|
+
async function toolOk(args, port, what) {
|
|
142
|
+
const { code, answer, result } = await tools(args, port);
|
|
143
|
+
if (code !== 0 || !answer) {
|
|
144
|
+
throw new StandError(`${what}: ${answer && answer.error ? answer.error : tail(result.stderr || result.stdout, 10)}`);
|
|
145
|
+
}
|
|
146
|
+
return answer;
|
|
147
|
+
}
|
|
148
|
+
|
|
149
|
+
// ---------------------------------------------------------------- PostgreSQL
|
|
150
|
+
|
|
151
|
+
function pgEnv() {
|
|
152
|
+
return envs.pgToolEnv(dirs.tmp);
|
|
153
|
+
}
|
|
154
|
+
|
|
155
|
+
/** Порт можно занять: пробная привязка (порт мог зарезервировать Windows, отвечать при этом некому). */
|
|
156
|
+
function canBind(port, host = '127.0.0.1') {
|
|
157
|
+
return new Promise((resolve) => {
|
|
158
|
+
const server = net.createServer();
|
|
159
|
+
server.once('error', () => resolve(false));
|
|
160
|
+
server.listen({ port, host, exclusive: true }, () => server.close(() => resolve(true)));
|
|
161
|
+
});
|
|
162
|
+
}
|
|
163
|
+
|
|
164
|
+
function freePort(host = '127.0.0.1') {
|
|
165
|
+
return new Promise((resolve, reject) => {
|
|
166
|
+
const server = net.createServer();
|
|
167
|
+
server.once('error', reject);
|
|
168
|
+
server.listen({ port: 0, host, exclusive: true }, () => {
|
|
169
|
+
const { port } = server.address();
|
|
170
|
+
server.close(() => resolve(port));
|
|
171
|
+
});
|
|
172
|
+
});
|
|
173
|
+
}
|
|
174
|
+
|
|
175
|
+
function portAnswers(port) {
|
|
176
|
+
return new Promise((resolve) => {
|
|
177
|
+
const socket = net.connect({ port, host: '127.0.0.1' });
|
|
178
|
+
const done = (value) => { socket.destroy(); resolve(value); };
|
|
179
|
+
socket.setTimeout(800, () => done(false));
|
|
180
|
+
socket.once('connect', () => done(true));
|
|
181
|
+
socket.once('error', () => done(false));
|
|
182
|
+
});
|
|
183
|
+
}
|
|
184
|
+
|
|
185
|
+
function pgStatus(dir) {
|
|
186
|
+
return run(pg.exe(binDir, 'pg_ctl'), pg.statusArgs(dir), { env: pgEnv(), cwd: home, timeoutMs: 60000 });
|
|
187
|
+
}
|
|
188
|
+
|
|
189
|
+
/** postmaster.pid каталога: первая строка – номер процесса, четвёртая – порт. Нет файла – null. */
|
|
190
|
+
function pidFile(dir) {
|
|
191
|
+
try {
|
|
192
|
+
const lines = fs.readFileSync(path.join(dir, 'postmaster.pid'), 'utf8').split(/\r?\n/);
|
|
193
|
+
return { pid: Number(lines[0]) || 0, port: Number(lines[3]) || 0 };
|
|
194
|
+
} catch (error) {
|
|
195
|
+
if (error.code === 'ENOENT') return null;
|
|
196
|
+
return { pid: 0, port: 0, unreadable: true }; // файл есть, но не прочитан: остановку он не доказывает
|
|
197
|
+
}
|
|
198
|
+
}
|
|
199
|
+
|
|
200
|
+
const STARTING = /starting up|not yet accepting connections|in recovery mode/i;
|
|
201
|
+
let whoamiError = '';
|
|
202
|
+
|
|
203
|
+
/**
|
|
204
|
+
* Сервер на каталоге (ревью сборки А, круг 3 и проверка агентами):
|
|
205
|
+
* running – отвечает, и это он; foreign – на порту другой каталог; starting – процесс жив и ещё восстанавливается;
|
|
206
|
+
* unconfirmed – отвечает, но каталог не подтвердить (чаще всего не подходит пароль); elsewhere – сохранённый порт молчит,
|
|
207
|
+
* а сервер отвечает на порту из postmaster.pid; stale – pg_ctl status видит живой процесс из postmaster.pid, но
|
|
208
|
+
* PostgreSQL нигде не отвечает (номер процесса после сбоя достался другой программе); down – не работает.
|
|
209
|
+
* Порт неизвестен (stand.json утрачен) – всё равно pg_ctl status: работающий сервер не принимается за остановленный.
|
|
210
|
+
*/
|
|
211
|
+
let codeReal = ''; // физический путь папки кода, проверенный при запуске (Д10)
|
|
212
|
+
let dataState = ''; // последний результат serverOn для pg/data: итог остановки берётся отсюда, а не из голого pg_ctl status
|
|
213
|
+
|
|
214
|
+
async function serverOn(dir, port) {
|
|
215
|
+
try {
|
|
216
|
+
const who = await classify(dir, port);
|
|
217
|
+
if (dir === dataDir) dataState = who;
|
|
218
|
+
return who;
|
|
219
|
+
} catch (error) {
|
|
220
|
+
if (dir === dataDir) dataState = 'error';
|
|
221
|
+
throw error;
|
|
222
|
+
}
|
|
223
|
+
}
|
|
224
|
+
|
|
225
|
+
async function classify(dir, port) {
|
|
226
|
+
whoamiError = '';
|
|
227
|
+
if (port) {
|
|
228
|
+
const { code, answer } = await tools(['whoami', '--expect-data-dir', dir], port, 60000);
|
|
229
|
+
if (code === 0) return 'running';
|
|
230
|
+
if (code === 1) return 'foreign';
|
|
231
|
+
whoamiError = answer && answer.error ? String(answer.error) : '';
|
|
232
|
+
}
|
|
233
|
+
const st = await pgStatus(dir);
|
|
234
|
+
if (st.code === 3) return 'down';
|
|
235
|
+
// 4 – каталог не признан кластером: pg_ctl ничего не проверял; ни «остановлен», ни «работает» (ревью круга 6)
|
|
236
|
+
if (st.code === 4) return 'notcluster';
|
|
237
|
+
if (st.code !== 0) {
|
|
238
|
+
throw new StandError(`pg_ctl status для ${dir} не ответил штатно (код ${st.code}): состояние сервера неизвестно, ничего ` +
|
|
239
|
+
'не изменено. Запустите стенд снова; если повторится – переустановите: npx local-triage --reinstall.');
|
|
240
|
+
}
|
|
241
|
+
if (STARTING.test(whoamiError)) return 'starting';
|
|
242
|
+
const pf = pidFile(dir);
|
|
243
|
+
if (port && (await portAnswers(port))) {
|
|
244
|
+
if (pf && pf.port && pf.port !== port) {
|
|
245
|
+
const there = await tools(['whoami', '--expect-data-dir', dir], pf.port, 60000);
|
|
246
|
+
if (there.code === 0) return 'elsewhere';
|
|
247
|
+
}
|
|
248
|
+
return 'unconfirmed';
|
|
249
|
+
}
|
|
250
|
+
if (pf && pf.port && pf.port !== port && (await portAnswers(pf.port))) return 'elsewhere';
|
|
251
|
+
return 'stale';
|
|
252
|
+
}
|
|
253
|
+
|
|
254
|
+
/** Ожидание конца восстановления после сбоя: pg_ctl start -w мог выйти по сроку, а сервер ещё поднимается. */
|
|
255
|
+
async function awaitStartup(dir, port, ms = 300000) {
|
|
256
|
+
const deadline = Date.now() + ms;
|
|
257
|
+
let who = 'starting';
|
|
258
|
+
let told = false;
|
|
259
|
+
while (who === 'starting' && Date.now() < deadline && !stopping) {
|
|
260
|
+
if (!told) {
|
|
261
|
+
say('PostgreSQL восстанавливается после прерванной работы – жду…');
|
|
262
|
+
told = true;
|
|
263
|
+
}
|
|
264
|
+
await new Promise((r) => setTimeout(r, 2000));
|
|
265
|
+
who = await serverOn(dir, port);
|
|
266
|
+
}
|
|
267
|
+
return who;
|
|
268
|
+
}
|
|
269
|
+
|
|
270
|
+
function unconfirmedError(dir, port) {
|
|
271
|
+
const auth = /password authentication failed/i.test(whoamiError);
|
|
272
|
+
return new StandError(`На порту ${port} отвечает PostgreSQL, но подтвердить, что это сервер стенда с каталогом ${dir}, не удалось – ` +
|
|
273
|
+
`${auth ? 'не подходит пароль в secrets/pg.pw' : `ответ: ${whoamiError || 'нет ответа'}`}. Ничего не изменено: порт, ` +
|
|
274
|
+
`журнал и сервер оставлены как были. ${auth ? 'Верните прежний файл пароля или остановите' : 'Остановите'} сервер ` +
|
|
275
|
+
`вручную: "${pg.exe(binDir, 'pg_ctl')}" stop -D "${dir}" -m fast`);
|
|
276
|
+
}
|
|
277
|
+
|
|
278
|
+
function staleError(dir) {
|
|
279
|
+
const pf = pidFile(dir) || { pid: 0 };
|
|
280
|
+
return new StandError(`В ${dir} лежит postmaster.pid процесса ${pf.pid}: процесс работает, но PostgreSQL ни на каком ` +
|
|
281
|
+
'порту не отвечает. Вероятно, файл остался после сбоя, а номер процесса достался другой программе. Проверьте, что ' +
|
|
282
|
+
`процесс ${pf.pid} – не postgres (Диспетчер задач или ps), удалите файл postmaster.pid и запустите стенд снова.`);
|
|
283
|
+
}
|
|
284
|
+
|
|
285
|
+
function stateError(who, dir, port) {
|
|
286
|
+
if (who === 'unconfirmed') return unconfirmedError(dir, port);
|
|
287
|
+
if (who === 'starting') {
|
|
288
|
+
return new StandError(`PostgreSQL на ${dir} восстанавливается дольше 5 минут. Подождите и запустите стенд снова; журнал – ` +
|
|
289
|
+
`${path.join(dirs.logs, 'postgres.log')}.`);
|
|
290
|
+
}
|
|
291
|
+
return staleError(dir);
|
|
292
|
+
}
|
|
293
|
+
|
|
294
|
+
/**
|
|
295
|
+
* Точно ли сервер на каталоге не работает (раздел 3.4): pg_ctl status «не запущен» и postmaster.pid нет – или он остался
|
|
296
|
+
* после сбоя: процесса из него нет (pg_ctl status проверяет это сам) и на его порту никто не отвечает. Сам файл обёртка
|
|
297
|
+
* не трогает: устаревший снимает PostgreSQL при запуске, а копия pg/next удаляется целиком.
|
|
298
|
+
*/
|
|
299
|
+
async function surelyDown(dir) {
|
|
300
|
+
const st = await pgStatus(dir);
|
|
301
|
+
// только штатное «не запущен» (3); код 4 – каталог не признан кластером, pg_ctl ничего не проверял: неопределённо,
|
|
302
|
+
// каталог не удаляется и не переносится (Д3, ревью кругов 4–5)
|
|
303
|
+
if (st.code !== 3) return false;
|
|
304
|
+
const pf = pidFile(dir);
|
|
305
|
+
if (!pf) return true;
|
|
306
|
+
if (pf.unreadable) return false;
|
|
307
|
+
return !(pf.port && (await portAnswers(pf.port)));
|
|
308
|
+
}
|
|
309
|
+
|
|
310
|
+
/** «Точно остановлен» с записью итога для основного каталога: shutdown не скажет «оставлен работать» про остановленный. */
|
|
311
|
+
async function confirmDown(dir) {
|
|
312
|
+
const down = await surelyDown(dir);
|
|
313
|
+
if (down && dir === dataDir) dataState = 'down';
|
|
314
|
+
return down;
|
|
315
|
+
}
|
|
316
|
+
|
|
317
|
+
/** Остановка только подтверждённого сервера: каталог сверяется по порту до сигнала. */
|
|
318
|
+
async function stopServer(dir, port) {
|
|
319
|
+
let who = await serverOn(dir, port);
|
|
320
|
+
if (who === 'starting') who = await awaitStartup(dir, port, 120000);
|
|
321
|
+
if (who === 'notcluster') return confirmDown(dir); // только «точно остановлен», иначе каталог не трогается
|
|
322
|
+
if (who === 'elsewhere') return stopServer(dir, pidFile(dir).port);
|
|
323
|
+
if (who === 'stale' || who === 'starting') {
|
|
324
|
+
say(stateError(who, dir, port).message);
|
|
325
|
+
return false;
|
|
326
|
+
}
|
|
327
|
+
if (who === 'foreign') {
|
|
328
|
+
say(`На порту ${port} отвечает сервер с другим каталогом данных: сигнал остановки не посылается.`);
|
|
329
|
+
return false;
|
|
330
|
+
}
|
|
331
|
+
if (who === 'unconfirmed') {
|
|
332
|
+
say(`Сервер на ${dir} работает, но его каталог не подтверждён: сигнал остановки не посылается.`);
|
|
333
|
+
return false;
|
|
334
|
+
}
|
|
335
|
+
if (who === 'down') return confirmDown(dir);
|
|
336
|
+
const binary = pg.exe(binDir, 'pg_ctl');
|
|
337
|
+
const fast = await run(binary, pg.stopArgs(dir, 'fast'), { env: pgEnv(), cwd: home, timeoutMs: 60000 });
|
|
338
|
+
if (fast.code !== 0) {
|
|
339
|
+
// за 30 с сервер на каталоге мог смениться: сигнал – только снова подтверждённому
|
|
340
|
+
const again = await serverOn(dir, port);
|
|
341
|
+
if (again === 'running') {
|
|
342
|
+
say('PostgreSQL не остановился штатно за 30 с – останавливаю немедленно.');
|
|
343
|
+
await run(binary, pg.stopArgs(dir, 'immediate'), { env: pgEnv(), cwd: home, timeoutMs: 60000 });
|
|
344
|
+
} else if (again !== 'down') {
|
|
345
|
+
say(`Сервер на ${dir} после штатной остановки не подтверждён: немедленная остановка не посылается.`);
|
|
346
|
+
return false;
|
|
347
|
+
}
|
|
348
|
+
}
|
|
349
|
+
return confirmDown(dir);
|
|
350
|
+
}
|
|
351
|
+
|
|
352
|
+
async function ensureStopped(dir, port) {
|
|
353
|
+
const known = port || (pidFile(dir) || {}).port || 0; // порт утрачен вместе со stand.json – он есть в postmaster.pid
|
|
354
|
+
if (known) return stopServer(dir, known);
|
|
355
|
+
return surelyDown(dir);
|
|
356
|
+
}
|
|
357
|
+
|
|
358
|
+
async function startServer(dir, port, logName = 'postgres.log') {
|
|
359
|
+
// до записи журнала и настроек – только штатное «не запущен» (3): работающий сервер или каталог, который pg_ctl не
|
|
360
|
+
// признаёт кластером (4), не трогаются (ревью круга 7)
|
|
361
|
+
const pre = await pgStatus(dir);
|
|
362
|
+
if (pre.code === 4) {
|
|
363
|
+
throw new StandError(`pg_ctl не признаёт каталог ${dir} кластером: запуск остановлен, журнал и настройки не тронуты.`);
|
|
364
|
+
}
|
|
365
|
+
if (pre.code !== 3) {
|
|
366
|
+
throw new StandError(`PostgreSQL на ${dir} уже работает, хотя по порту ${port} его не видно: журнал и настройки сервера ` +
|
|
367
|
+
'не тронуты. Закройте прежние процессы postgres этого стенда или перезагрузите компьютер и запустите стенд снова.');
|
|
368
|
+
}
|
|
369
|
+
const logPath = logName === 'postgres.log' ? pg.rotateLog(dirs.logs) : path.join(dirs.logs, logName);
|
|
370
|
+
pg.writeConf(dir, port);
|
|
371
|
+
const result = await run(pg.exe(binDir, 'pg_ctl'), pg.startArgs(dir, logPath),
|
|
372
|
+
{ env: pgEnv(), cwd: home, stdio: 'ignore', timeoutMs: 120000 });
|
|
373
|
+
let who = await serverOn(dir, port);
|
|
374
|
+
if (who === 'starting') who = await awaitStartup(dir, port);
|
|
375
|
+
if (who === 'running') {
|
|
376
|
+
if (result.code !== 0) {
|
|
377
|
+
const late = await pgStatus(dir);
|
|
378
|
+
log(`pg_ctl start вышел с кодом ${result.code}, сервер подтверждён по порту, pg_ctl status – ${late.code}`);
|
|
379
|
+
}
|
|
380
|
+
return;
|
|
381
|
+
}
|
|
382
|
+
if (who === 'notcluster') {
|
|
383
|
+
throw new StandError(`pg_ctl не признаёт каталог ${dir} кластером: запуск остановлен, каталог не изменён.`);
|
|
384
|
+
}
|
|
385
|
+
if (who === 'unconfirmed' || who === 'starting' || who === 'stale' || who === 'elsewhere') {
|
|
386
|
+
// процесс работает, а каталог не подтверждён: сигнал остановки ему не посылается, и об этом сказано прямо
|
|
387
|
+
if (dir === dataDir) pgStarted = false;
|
|
388
|
+
throw stateError(who, dir, port);
|
|
389
|
+
}
|
|
390
|
+
const st = await pgStatus(dir);
|
|
391
|
+
let journal = '';
|
|
392
|
+
try { journal = tail(fs.readFileSync(logPath, 'utf8'), 15); } catch { journal = ''; }
|
|
393
|
+
const hint = /lock file .* already exists|shared memory block .* still in use/i.test(journal)
|
|
394
|
+
? '\nПрежний процесс postgres этого стенда ещё работает: закройте его или перезагрузите компьютер.' : '';
|
|
395
|
+
throw new StandError(`PostgreSQL не запустился (pg_ctl start – код ${result.code}, pg_ctl status – ${st.code}).\n${journal}${hint}`);
|
|
396
|
+
}
|
|
397
|
+
|
|
398
|
+
async function initCluster() {
|
|
399
|
+
for (const name of fs.readdirSync(dirs.pg)) {
|
|
400
|
+
// дерево initdb на Windows живёт дольше родителя: удаление с повтором до 30 с
|
|
401
|
+
if (name.startsWith('data.init-')) fsx.rmSync(path.join(dirs.pg, name), { recursive: true, force: true });
|
|
402
|
+
}
|
|
403
|
+
const target = path.join(dirs.pg, `data.init-${process.pid}`);
|
|
404
|
+
const pw = pg.ensurePassword(dirs.secrets, false);
|
|
405
|
+
password = pw.password;
|
|
406
|
+
const logPath = path.join(dirs.logs, `initdb-${stamp().replace(/[:.]/g, '-')}.log`);
|
|
407
|
+
const fd = fs.openSync(logPath, 'w');
|
|
408
|
+
say('Создаю базу PostgreSQL…');
|
|
409
|
+
let result;
|
|
410
|
+
try {
|
|
411
|
+
result = await run(pg.exe(binDir, 'initdb'), pg.initdbArgs(target, pw.file), { env: pgEnv(), cwd: home, fd, timeoutMs: 300000 });
|
|
412
|
+
} finally {
|
|
413
|
+
fs.closeSync(fd);
|
|
414
|
+
}
|
|
415
|
+
if (result.code !== 0) {
|
|
416
|
+
let journal = '';
|
|
417
|
+
try { journal = tail(fs.readFileSync(logPath, 'utf8'), 15); } catch { journal = ''; }
|
|
418
|
+
throw new StandError(`initdb не создал кластер (код ${result.code}).\n${journal}`);
|
|
419
|
+
}
|
|
420
|
+
fsx.renameSync(target, dataDir);
|
|
421
|
+
}
|
|
422
|
+
|
|
423
|
+
/** --new-database: прежний кластер и его пароль уходят в pg/backups, дальше – как первая установка. */
|
|
424
|
+
async function setAsideCluster() {
|
|
425
|
+
if (fs.existsSync(dataDir)) {
|
|
426
|
+
// прежний сервер мог пережить держатель: переносится только кластер, который точно не работает
|
|
427
|
+
if (pg.passwordReadable(dirs.secrets)) password = pg.ensurePassword(dirs.secrets, true).password;
|
|
428
|
+
if (!(await ensureStopped(dataDir, state.data.pg_port || 0))) {
|
|
429
|
+
throw new StandError(`Не удалось установить, что сервер на ${dataDir} остановлен: прежняя база не тронута. Закройте ` +
|
|
430
|
+
'процессы postgres этого стенда и запустите стенд с --new-database снова.');
|
|
431
|
+
}
|
|
432
|
+
}
|
|
433
|
+
const pw = path.join(dirs.secrets, 'pg.pw');
|
|
434
|
+
const backups = path.join(dirs.pg, 'backups');
|
|
435
|
+
// прошлый перенос прерван: остаток (база или пароль) доносится в ту же копию, новое имя не заводится
|
|
436
|
+
let name = unfinishedReplaced(backups);
|
|
437
|
+
if (!name && !fs.existsSync(dataDir) && !fs.existsSync(pw)) {
|
|
438
|
+
// переносить нечего: первая установка – и выбранная папка кода действует уже сейчас (ревью круга 6)
|
|
439
|
+
stand.save(state, { phase: 'none', pg_port: 0, code_dir: codeDir, code_dir_real: canonical(codeDir) });
|
|
440
|
+
return;
|
|
441
|
+
}
|
|
442
|
+
let shown = clusterVersion();
|
|
443
|
+
try { shown = npmVersionOf(shown); } catch { /* версия неизвестна – как есть */ }
|
|
444
|
+
const meta = (extra) => ({ kind: 'replaced', app_version: clusterVersion(), npm_version: shown, ...extra });
|
|
445
|
+
if (!name) {
|
|
446
|
+
fs.mkdirSync(backups, { recursive: true });
|
|
447
|
+
name = cluster.uniqueBackupName(dirs.pg, `${stamp().replace(/[-:]/g, '').replace('T', '-').slice(0, 13)}-replaced-v${shown}`);
|
|
448
|
+
fs.mkdirSync(path.join(backups, name)); // эксклюзивно: прежняя копия с тем же именем не открывается заново
|
|
449
|
+
// метаданные – до переносов: прерванный перенос находится по ним и доводится в эту же копию
|
|
450
|
+
fs.writeFileSync(path.join(backups, `${name}.json`), `${JSON.stringify(meta({ state: 'moving', password_file: '',
|
|
451
|
+
created: new Date().toISOString() }), null, 1)}\n`, { flag: 'wx' });
|
|
452
|
+
}
|
|
453
|
+
const target = path.join(backups, name);
|
|
454
|
+
if (fs.existsSync(dataDir)) fsx.renameSync(dataDir, path.join(target, 'data'));
|
|
455
|
+
const copy = path.join(target, 'pg.pw');
|
|
456
|
+
if (fs.existsSync(pw)) {
|
|
457
|
+
// пароль – копией: права до записи, на место – целым; действующий пароль кластера – этот, а несовпадающая копия
|
|
458
|
+
// (след сбоя прежней версии) отодвигается, но не удаляется
|
|
459
|
+
if (fs.existsSync(copy) && !fs.readFileSync(copy).equals(fs.readFileSync(pw))) {
|
|
460
|
+
fsx.renameSync(copy, path.join(target, `pg.pw.prev-${stamp().replace(/[:.]/g, '-')}`));
|
|
461
|
+
}
|
|
462
|
+
if (!fs.existsSync(copy)) fsx.writeSecret(copy, fs.readFileSync(pw), (file) => pg.restrictToUser(file));
|
|
463
|
+
cluster.fsyncDir(target);
|
|
464
|
+
if (!fs.readFileSync(copy).equals(fs.readFileSync(pw))) { // единственный действующий пароль – только после сверки копии
|
|
465
|
+
throw new StandError(`Копия пароля ${copy} не совпала с ${pw}: исходный файл оставлен. Запустите стенд с --new-database снова.`);
|
|
466
|
+
}
|
|
467
|
+
fsx.rmSync(pw, { force: true });
|
|
468
|
+
}
|
|
469
|
+
// новая привязка – до отметки «done»: прерванный после неё запуск уже не ищет незавершённый перенос (ревью круга 6)
|
|
470
|
+
stand.save(state, { code_dir: codeDir, code_dir_real: canonical(codeDir) });
|
|
471
|
+
const before = stand.readJson(path.join(backups, `${name}.json`)) || {};
|
|
472
|
+
stand.writeJsonAtomic(path.join(backups, `${name}.json`), {
|
|
473
|
+
...meta({}), app_version: before.app_version || clusterVersion(), npm_version: before.npm_version || shown,
|
|
474
|
+
state: 'done', password_file: fs.existsSync(copy) ? `${name}/pg.pw` : '', created: before.created || new Date().toISOString(),
|
|
475
|
+
});
|
|
476
|
+
// прежняя база ушла в копию: с этого момента действует папка кода нового запуска (ревью круга 5)
|
|
477
|
+
stand.save(state, { phase: 'none', pg_port: 0, code_dir: codeDir, code_dir_real: canonical(codeDir) });
|
|
478
|
+
password = '';
|
|
479
|
+
say(`Прежняя база перенесена в ${target}; создаю новую.`);
|
|
480
|
+
}
|
|
481
|
+
|
|
482
|
+
/** Копия --new-database, перенос в которую прервался: метаданные с state «moving» и папка на месте. */
|
|
483
|
+
function unfinishedReplaced(backups) {
|
|
484
|
+
let names = [];
|
|
485
|
+
try { names = fs.readdirSync(backups); } catch { return ''; }
|
|
486
|
+
for (const file of names.filter((n) => n.endsWith('.json') && !n.endsWith('.files.json')).sort()) {
|
|
487
|
+
const name = file.slice(0, -'.json'.length);
|
|
488
|
+
const meta = stand.readJson(path.join(backups, file)) || {};
|
|
489
|
+
const dir = path.join(backups, name);
|
|
490
|
+
if (meta.kind !== 'replaced' || meta.state !== 'moving' || !fs.existsSync(dir)) continue;
|
|
491
|
+
// продолжать – только если перенос начался: в копии уже есть база или пароль, либо pg/data уже нет; пустая копия
|
|
492
|
+
// (прервано сразу после создания) убирается, новая получит своё время и версию (проверка агентами, круг 7)
|
|
493
|
+
if (fs.existsSync(path.join(dir, 'data')) || fs.existsSync(path.join(dir, 'pg.pw')) || !fs.existsSync(dataDir)) return name;
|
|
494
|
+
try {
|
|
495
|
+
fs.rmdirSync(dir);
|
|
496
|
+
fs.rmSync(path.join(backups, file), { force: true });
|
|
497
|
+
} catch { /* не пуста – оставить как есть */ }
|
|
498
|
+
}
|
|
499
|
+
return '';
|
|
500
|
+
}
|
|
501
|
+
|
|
502
|
+
/** Версия стенда, работавшего с этой базой: метка самого кластера главнее stand.json – после ручного возврата копии
|
|
503
|
+
* рядом может лежать stand.json другой версии (ревью круга 5). */
|
|
504
|
+
function clusterVersion() {
|
|
505
|
+
try {
|
|
506
|
+
const own = fs.readFileSync(path.join(dataDir, 'local-triage.version'), 'utf8').trim();
|
|
507
|
+
if (own) return own;
|
|
508
|
+
} catch { /* метки нет */ }
|
|
509
|
+
return state.data.last_good_version || 'unknown';
|
|
510
|
+
}
|
|
511
|
+
|
|
512
|
+
function lost(why) {
|
|
513
|
+
return new StandError(`${why} Это прежняя установка стенда, и пустую базу вместо неё стенд сам не создаёт. Прежние базы – в ` +
|
|
514
|
+
`${path.join(dirs.pg, 'backups')}. Начать с новой базы: запустите стенд с ключом --new-database.`);
|
|
515
|
+
}
|
|
516
|
+
|
|
517
|
+
/** Прежние копии есть. Нет папки – нет копий; не прочиталась – отказ: иначе прежняя установка стала бы первой. */
|
|
518
|
+
function backupsPresent() {
|
|
519
|
+
try {
|
|
520
|
+
return fs.readdirSync(path.join(dirs.pg, 'backups')).length > 0;
|
|
521
|
+
} catch (error) {
|
|
522
|
+
if (error.code === 'ENOENT') return false;
|
|
523
|
+
throw new StandError(`Папка прежних копий ${path.join(dirs.pg, 'backups')} не читается (${error.code}): стенд не решает, ` +
|
|
524
|
+
'первая это установка или прежняя. Проверьте права на папку и запустите стенд снова.');
|
|
525
|
+
}
|
|
526
|
+
}
|
|
527
|
+
|
|
528
|
+
async function preparePostgres() {
|
|
529
|
+
pg.installBinaries(pg.nativeDir(packageDir), binDir, process.platform, { force: Boolean(opts.reinstall) });
|
|
530
|
+
fs.mkdirSync(dirs.pg, { recursive: true });
|
|
531
|
+
// пароль прежнего кластера – до разбора состояния: подтвердить каталог временного сервера без него нельзя
|
|
532
|
+
const pwFile = path.join(dirs.secrets, 'pg.pw');
|
|
533
|
+
if (fs.existsSync(pwFile)) {
|
|
534
|
+
if (pg.passwordReadable(dirs.secrets)) password = pg.ensurePassword(dirs.secrets, true).password;
|
|
535
|
+
else if (fs.existsSync(dataDir) && !opts.newDatabase) {
|
|
536
|
+
throw new StandError(`Файл пароля базы ${pwFile} повреждён, а кластер на месте: к базе не подключиться. Начать с новой ` +
|
|
537
|
+
'базы: запустите стенд с ключом --new-database (прежняя база останется в pg/backups).');
|
|
538
|
+
}
|
|
539
|
+
}
|
|
540
|
+
await cluster.recover(dirs.pg, { ensureStopped, verify: (dir, required) => pg.checkMajor(dir, required) }, say);
|
|
541
|
+
checkStop();
|
|
542
|
+
if (opts.newDatabase) {
|
|
543
|
+
if (fs.existsSync(dataDir)) pg.checkCluster(dataDir); // чужая мажорная версия – отказ до изменения папки (§3.4)
|
|
544
|
+
await setAsideCluster();
|
|
545
|
+
}
|
|
546
|
+
if (!fs.existsSync(dataDir)) {
|
|
547
|
+
// база уже создавалась (db-created) или работала (ready): пропавший каталог – утрата, а не первая установка
|
|
548
|
+
if (state.data.phase === 'ready' || state.data.phase === 'db-created') throw lost(`Каталога базы ${dataDir} нет.`);
|
|
549
|
+
stand.save(state, { phase: 'none' });
|
|
550
|
+
await initCluster();
|
|
551
|
+
}
|
|
552
|
+
pg.checkCluster(dataDir);
|
|
553
|
+
password = pg.ensurePassword(dirs.secrets, true).password;
|
|
554
|
+
pgPort = state.data.pg_port || 0;
|
|
555
|
+
let who = await serverOn(dataDir, pgPort);
|
|
556
|
+
if (who === 'elsewhere') { // сохранённый порт устарел (stand.json утрачен или старый): сервер – на порту из postmaster.pid
|
|
557
|
+
pgPort = pidFile(dataDir).port;
|
|
558
|
+
who = await serverOn(dataDir, pgPort);
|
|
559
|
+
}
|
|
560
|
+
if (who === 'starting') who = await awaitStartup(dataDir, pgPort);
|
|
561
|
+
if (who === 'notcluster') {
|
|
562
|
+
throw new StandError(`pg_ctl не признаёт каталог ${dataDir} кластером: стенд его не меняет. Пришлите журнал преподавателю.`);
|
|
563
|
+
}
|
|
564
|
+
if (who === 'starting' || who === 'stale' || who === 'elsewhere' || who === 'unconfirmed') {
|
|
565
|
+
throw stateError(who, dataDir, pgPort);
|
|
566
|
+
}
|
|
567
|
+
if (who === 'foreign') {
|
|
568
|
+
throw new StandError(`На порту базы ${pgPort} отвечает другой сервер PostgreSQL. Закройте его или запустите стенд с другой ` +
|
|
569
|
+
'служебной папкой (--home).');
|
|
570
|
+
}
|
|
571
|
+
if (who === 'running') {
|
|
572
|
+
pgStarted = true;
|
|
573
|
+
if (pgPort !== state.data.pg_port) stand.save(state, { pg_port: pgPort }); // порт из postmaster.pid – запомнить
|
|
574
|
+
say('PostgreSQL этого стенда уже работает – подключаюсь к нему.');
|
|
575
|
+
} else {
|
|
576
|
+
if (!pgPort || !(await canBind(pgPort))) pgPort = await freePort(); // занят или зарезервирован – новый (круг 7)
|
|
577
|
+
stand.save(state, { pg_port: pgPort });
|
|
578
|
+
checkStop();
|
|
579
|
+
say('Запускаю PostgreSQL…');
|
|
580
|
+
pgStarted = true; // остановка с этого момента проверит сервер (с подтверждением каталога), даже если запуск не дошёл
|
|
581
|
+
await startServer(dataDir, pgPort);
|
|
582
|
+
}
|
|
583
|
+
pgStarted = true;
|
|
584
|
+
checkStop();
|
|
585
|
+
const create = state.data.phase === 'none' || state.data.phase === 'db-creating';
|
|
586
|
+
if (state.data.phase === 'none') stand.save(state, { phase: 'db-creating' });
|
|
587
|
+
const { code, answer, result } = await tools(['ensure-database', '--expect-data-dir', dataDir, ...(create ? ['--create'] : [])], pgPort);
|
|
588
|
+
if (code === 1 && answer && answer.match === false) {
|
|
589
|
+
throw new StandError(`Сервер на порту ${pgPort} – не кластер этого стенда (${answer.data_directory}): записи не было.`);
|
|
590
|
+
}
|
|
591
|
+
if (code === 1 && answer && !answer.exists) throw lost('Базы triage в кластере нет.');
|
|
592
|
+
if (code !== 0 || !answer) throw new StandError(`База не подготовлена: ${answer && answer.error ? answer.error : tail(result.stderr, 8)}`);
|
|
593
|
+
if (create) stand.save(state, { phase: 'db-created' });
|
|
594
|
+
// один ответ: 0 – готова или пуста, 1 – migrate, newer, foreign; ошибка команды – отказ сразу (§3.4, ревью круга 6)
|
|
595
|
+
const first = await tools(['status'], pgPort);
|
|
596
|
+
if (!first.answer || first.answer.error || (first.code !== 0 && first.code !== 1)) {
|
|
597
|
+
throw new StandError(`Состояние схемы базы не прочитано: ${first.answer && first.answer.error ? first.answer.error
|
|
598
|
+
: tail(first.result.stderr || first.result.stdout, 8)}`);
|
|
599
|
+
}
|
|
600
|
+
const st = first.answer;
|
|
601
|
+
if (st.state === 'empty' && state.data.phase === 'ready') throw lost('База пуста.');
|
|
602
|
+
if (st.state === 'newer') {
|
|
603
|
+
throw new StandError(`Схема базы (${st.schema}) новее этой версии стенда (${st.expected}). Запустите новую версию: npx local-triage@latest.`);
|
|
604
|
+
}
|
|
605
|
+
if (st.state === 'foreign') throw new StandError('В базе triage нет схемы приложения: это чужая база.');
|
|
606
|
+
if (st.state === 'migrate') {
|
|
607
|
+
const backup = await cluster.updateSchema(dirs.pg, {
|
|
608
|
+
port: pgPort, schema: st.schema, expected: st.expected, fromVersion: clusterVersion(), toVersion: version,
|
|
609
|
+
passwordFile: path.join(dirs.secrets, 'pg.pw'),
|
|
610
|
+
}, {
|
|
611
|
+
summary: (port) => toolOk(['summary'], port, 'Сводка базы не снята'),
|
|
612
|
+
stop: async (dir, port) => {
|
|
613
|
+
if (!(await stopServer(dir, port))) throw new StandError(`Сервер на ${dir} не остановлен.`);
|
|
614
|
+
if (tempServer && tempServer.dir === dir) tempServer = null;
|
|
615
|
+
},
|
|
616
|
+
start: async (dir, port) => {
|
|
617
|
+
if (dir !== dataDir) tempServer = { dir, port };
|
|
618
|
+
await startServer(dir, port, dir === dataDir ? 'postgres.log' : 'postgres-next.log');
|
|
619
|
+
},
|
|
620
|
+
status: (port) => tools(['status'], port).then((r) => r.answer || {}),
|
|
621
|
+
migrate: (port) => toolOk(['migrate'], port, 'Миграция схемы не выполнена'),
|
|
622
|
+
syncOnly: async (dir) => {
|
|
623
|
+
const r = await run(pg.exe(binDir, 'initdb'), pg.syncOnlyArgs(dir), { env: pgEnv(), cwd: home, timeoutMs: 600000 });
|
|
624
|
+
if (r.code !== 0) throw new StandError(`initdb --sync-only: код ${r.code}`);
|
|
625
|
+
},
|
|
626
|
+
freePort: () => freePort(),
|
|
627
|
+
restrict: (file) => pg.restrictToUser(file),
|
|
628
|
+
}, say);
|
|
629
|
+
say(`Схема обновлена; база до обновления – ${path.join(dirs.pg, 'backups', backup)}.`);
|
|
630
|
+
// шаг 7: рабочий сервер на новом каталоге – база на месте и схема этой сборки, только потом приложение
|
|
631
|
+
const again = await tools(['ensure-database', '--expect-data-dir', dataDir], pgPort);
|
|
632
|
+
if (again.code !== 0) throw new StandError('После обновления схемы база triage не найдена на рабочем сервере.');
|
|
633
|
+
const now = await tools(['status'], pgPort);
|
|
634
|
+
if (!now.answer || now.answer.state !== 'ok') {
|
|
635
|
+
throw new StandError(`После обновления схемы база в состоянии «${now.answer ? now.answer.state : 'неизвестно'}».`);
|
|
636
|
+
}
|
|
637
|
+
}
|
|
638
|
+
}
|
|
639
|
+
|
|
640
|
+
// ---------------------------------------------------------------- файлы приложения
|
|
641
|
+
|
|
642
|
+
function manifestFiles() {
|
|
643
|
+
const file = path.join(packageDir, 'npm', 'files.manifest');
|
|
644
|
+
const lines = fs.readFileSync(file, 'utf8').split(/\r?\n/).map((l) => l.trim()).filter((l) => l && !l.startsWith('#'));
|
|
645
|
+
return lines.filter((l) => l.startsWith('app/') || l.startsWith('examples/'));
|
|
646
|
+
}
|
|
647
|
+
|
|
648
|
+
/** <версия>/app-root – копия app/ и examples/ из пакета; build.json – рядом с app/ (app/build_info.py). */
|
|
649
|
+
function syncAppRoot() {
|
|
650
|
+
const target = path.join(dirs.base, 'app-root');
|
|
651
|
+
const files = manifestFiles();
|
|
652
|
+
const digest = crypto.createHash('sha256');
|
|
653
|
+
const build = path.join(packageDir, 'npm', 'build.json');
|
|
654
|
+
for (const name of files.concat(fs.existsSync(build) ? ['npm/build.json'] : [])) {
|
|
655
|
+
digest.update(name).update('\0').update(fs.readFileSync(path.join(packageDir, name))).update('\0');
|
|
656
|
+
}
|
|
657
|
+
const fingerprint = digest.digest('hex');
|
|
658
|
+
const marker = path.join(dirs.base, 'app-root.json');
|
|
659
|
+
const intact = () => files.every((name) => {
|
|
660
|
+
try { return fs.readFileSync(path.join(target, name)).equals(fs.readFileSync(path.join(packageDir, name))); } catch { return false; }
|
|
661
|
+
}) && (!fs.existsSync(build) || (() => {
|
|
662
|
+
try { return fs.readFileSync(path.join(target, 'build.json')).equals(fs.readFileSync(build)); } catch { return false; }
|
|
663
|
+
})());
|
|
664
|
+
// отпечаток – по источнику, поэтому и сама копия сверяется: пропавший или усечённый файл – пересборка (ревью круга 6)
|
|
665
|
+
if (!opts.reinstall && fs.existsSync(target) && (stand.readJson(marker) || {}).sha256 === fingerprint && intact()) return target;
|
|
666
|
+
fsx.removeLeftovers(path.dirname(target), path.basename(target));
|
|
667
|
+
const tmp = `${target}.tmp-${process.pid}`;
|
|
668
|
+
for (const name of files) {
|
|
669
|
+
fs.mkdirSync(path.dirname(path.join(tmp, name)), { recursive: true });
|
|
670
|
+
fs.copyFileSync(path.join(packageDir, name), path.join(tmp, name));
|
|
671
|
+
}
|
|
672
|
+
if (fs.existsSync(build)) fs.copyFileSync(build, path.join(tmp, 'build.json'));
|
|
673
|
+
const old = `${target}.old-${process.pid}`;
|
|
674
|
+
if (fs.existsSync(target)) fsx.renameSync(target, old);
|
|
675
|
+
try {
|
|
676
|
+
fsx.renameSync(tmp, target);
|
|
677
|
+
} catch (error) {
|
|
678
|
+
if (fs.existsSync(old) && !fs.existsSync(target)) fsx.renameSync(old, target); // прежняя копия – на место
|
|
679
|
+
throw error;
|
|
680
|
+
}
|
|
681
|
+
try { fsx.rmSync(old, { recursive: true, force: true }, 5000); } catch { /* удалится при следующем запуске */ }
|
|
682
|
+
stand.writeJsonAtomic(marker, { sha256: fingerprint, files: files.length });
|
|
683
|
+
return target;
|
|
684
|
+
}
|
|
685
|
+
|
|
686
|
+
function clusterMarked() {
|
|
687
|
+
return [dataDir, path.join(dirs.pg, 'next')].some((dir) => fs.existsSync(path.join(dir, 'local-triage.version')) ||
|
|
688
|
+
fs.existsSync(path.join(dir, binding.FILE)));
|
|
689
|
+
}
|
|
690
|
+
|
|
691
|
+
function bindingError(bound) {
|
|
692
|
+
const moved = canonical(bound.path) === canonical(codeDir) && bound.real && bound.real !== canonical(codeDir);
|
|
693
|
+
if (moved) {
|
|
694
|
+
return new StandError(`Папка кода ${codeDir} теперь указывает на ${canonical(codeDir)}, а база привязана к ${bound.real}. ` +
|
|
695
|
+
'Верните ссылку на прежнюю папку или запустите стенд с --code-dir прежней папки.');
|
|
696
|
+
}
|
|
697
|
+
return new StandError(`Папка кода этой базы – ${bound.path}. Сменить её нельзя: проекты стенда ссылаются на неё. Запустите ` +
|
|
698
|
+
`стенд с этой папкой (npx local-triage --code-dir "${bound.path}"); другая папка кода – это другой стенд (ключ --home).`);
|
|
699
|
+
}
|
|
700
|
+
|
|
701
|
+
/** Запись о начатой публикации демо – в служебной папке: только по ней стенд узнаёт свой временный каталог и свою метку. */
|
|
702
|
+
function demoRecordFile() {
|
|
703
|
+
return path.join(home, 'demo-publish.json');
|
|
704
|
+
}
|
|
705
|
+
|
|
706
|
+
/**
|
|
707
|
+
* Остаток прерванной публикации демо (ревью кругов 3–7): удаляется только каталог из записи этой служебной папки, если в
|
|
708
|
+
* его метке тот же токен, а процесс-владелец не живёт. Чужие каталоги и файлы по имени не опознаются и не трогаются.
|
|
709
|
+
*/
|
|
710
|
+
function demoLeftovers() {
|
|
711
|
+
const record = stand.readJson(demoRecordFile());
|
|
712
|
+
if (!record || !record.dir || !record.token) return;
|
|
713
|
+
let mark = '';
|
|
714
|
+
try { mark = fs.readFileSync(path.join(String(record.dir), fsx.MARK), 'utf8').trim(); } catch { mark = ''; }
|
|
715
|
+
let alive = false;
|
|
716
|
+
try { process.kill(Number(record.pid), 0); alive = true; } catch (error) { alive = error.code === 'EPERM'; }
|
|
717
|
+
if (alive && Number(record.pid) !== process.pid) return; // другой держатель ещё публикует
|
|
718
|
+
if (mark === record.token) {
|
|
719
|
+
try { fsx.rmSync(String(record.dir), { recursive: true, force: true }, 5000); } catch { return; }
|
|
720
|
+
}
|
|
721
|
+
const published = path.join(codeDir, 'local-triage-demo', fsx.MARK);
|
|
722
|
+
try { if (fs.readFileSync(published, 'utf8').trim() === record.token) fs.rmSync(published); } catch { /* метки нет */ }
|
|
723
|
+
try { fs.rmSync(demoRecordFile(), { force: true }); } catch { /* в следующий раз */ }
|
|
724
|
+
}
|
|
725
|
+
|
|
726
|
+
/**
|
|
727
|
+
* Демо-проект – в папку кода целиком: уникальный временный каталог (mkdtemp), запись о публикации в служебной папке и
|
|
728
|
+
* метка с токеном – до копирования, публикация переименованием, метка и запись снимаются после.
|
|
729
|
+
*/
|
|
730
|
+
function publishDemo(demo, target) {
|
|
731
|
+
const tmp = fs.mkdtempSync(path.join(codeDir, DEMO_TMP));
|
|
732
|
+
const token = `local-triage ${process.pid} ${crypto.randomBytes(8).toString('hex')}`;
|
|
733
|
+
stand.writeJsonAtomic(demoRecordFile(), { dir: tmp, token, pid: process.pid });
|
|
734
|
+
fs.writeFileSync(path.join(tmp, fsx.MARK), `${token}\n`);
|
|
735
|
+
try {
|
|
736
|
+
fs.cpSync(demo, tmp, { recursive: true });
|
|
737
|
+
fsx.renameSync(tmp, target);
|
|
738
|
+
} catch (error) {
|
|
739
|
+
try { fsx.rmSync(tmp, { recursive: true, force: true }, 5000); } catch { /* разберёт demoLeftovers */ }
|
|
740
|
+
if (!fs.existsSync(target)) throw error; // демо опубликовал другой стенд с той же папкой кода – своя копия не нужна
|
|
741
|
+
try { fs.rmSync(demoRecordFile(), { force: true }); } catch { /* разберёт demoLeftovers */ }
|
|
742
|
+
return;
|
|
743
|
+
}
|
|
744
|
+
try { fs.rmSync(path.join(target, fsx.MARK), { force: true }); } catch { /* снимется при следующем запуске */ }
|
|
745
|
+
try { fs.rmSync(demoRecordFile(), { force: true }); } catch { /* разберёт demoLeftovers */ }
|
|
746
|
+
}
|
|
747
|
+
|
|
748
|
+
const DEMO_TMP = '.local-triage-demo-';
|
|
749
|
+
|
|
750
|
+
/** Папка кода и служебная не вложены одна в другую (физические пути): служебные каталоги стенд чистит и заменяет. */
|
|
751
|
+
function checkFoldersApart() {
|
|
752
|
+
const inside = (a, b) => a === b || a.startsWith(b.endsWith(path.sep) ? b : b + path.sep);
|
|
753
|
+
const [c, h] = [canonical(codeDir), canonical(home)];
|
|
754
|
+
if (inside(c, h) || inside(h, c)) {
|
|
755
|
+
throw new StandError(`Папка кода ${codeDir} и служебная папка ${home} вложены друг в друга: служебные каталоги стенд ` +
|
|
756
|
+
'чистит и заменяет, а приложение видит всё внутри папки кода. Выберите папки, не вложенные одна в другую.');
|
|
757
|
+
}
|
|
758
|
+
}
|
|
759
|
+
|
|
760
|
+
function prepareCodeDir() {
|
|
761
|
+
// привязку папки кода знает кластер (pg/data, pg/next или копия, названная меткой переключения) – она главнее
|
|
762
|
+
// stand.json: тот мог быть утрачен или записан запуском, который потом отказал (Д10, ревью круга 4). Новая привязка
|
|
763
|
+
// пишется в stand.json только когда стенд дошёл до готовности
|
|
764
|
+
const bound = binding.current(home);
|
|
765
|
+
if (bound && !opts.newDatabase && !binding.matches(bound, codeDir)) throw bindingError(bound);
|
|
766
|
+
checkFoldersApart();
|
|
767
|
+
fs.mkdirSync(codeDir, { recursive: true });
|
|
768
|
+
codeReal = fs.realpathSync.native(codeDir); // физический путь – на всё время работы держателя
|
|
769
|
+
const demo = path.join(appRoot, 'examples', 'demo', 'repos');
|
|
770
|
+
const target = path.join(codeDir, 'local-triage-demo');
|
|
771
|
+
demoLeftovers(); // своя метка в опубликованном демо и свой временный каталог – по записи публикации
|
|
772
|
+
if (fs.existsSync(demo) && !fs.existsSync(target)) publishDemo(demo, target);
|
|
773
|
+
const margin = pathMargin(codeDir);
|
|
774
|
+
if (process.platform === 'win32') {
|
|
775
|
+
say(`Папка кода: ${margin.path} (запас длины пути для самого длинного файла примеров – ${margin.margin} знаков).`);
|
|
776
|
+
if (margin.margin < 0) say('Путь длинный: часть файлов примеров не откроется без политики LongPathsEnabled; лучше короткая папка кода (--code-dir).');
|
|
777
|
+
} else {
|
|
778
|
+
say(`Папка кода: ${margin.path}`);
|
|
779
|
+
}
|
|
780
|
+
}
|
|
781
|
+
|
|
782
|
+
// ---------------------------------------------------------------- приложение
|
|
783
|
+
|
|
784
|
+
function appLogStream() {
|
|
785
|
+
const day = stamp().slice(0, 10);
|
|
786
|
+
const stream = fs.createWriteStream(path.join(dirs.logs, `app-${day}.log`), { flags: 'a' });
|
|
787
|
+
// журнал недоступен: приложение работает дальше, держатель не падает в обход остановки базы (ревью круга 5)
|
|
788
|
+
stream.on('error', (error) => log(`журнал приложения не пишется: ${error.message}`));
|
|
789
|
+
return stream;
|
|
790
|
+
}
|
|
791
|
+
|
|
792
|
+
function lockBeat() {
|
|
793
|
+
try {
|
|
794
|
+
const data = JSON.parse(fs.readFileSync(path.join(dirs.data, 'telemetry', 'instance.lock'), 'utf8'));
|
|
795
|
+
return String(data.beat || '');
|
|
796
|
+
} catch {
|
|
797
|
+
return '';
|
|
798
|
+
}
|
|
799
|
+
}
|
|
800
|
+
|
|
801
|
+
/** Прежний процесс приложения убит, а отметка его замка ещё свежая: ждать, пока она перестанет меняться (код 75). */
|
|
802
|
+
async function waitLockStale() {
|
|
803
|
+
say('Прежний процесс приложения ещё держит папку данных – жду, пока его отметка устареет…');
|
|
804
|
+
let last = lockBeat();
|
|
805
|
+
let quietSince = Date.now();
|
|
806
|
+
const deadline = Date.now() + 120000;
|
|
807
|
+
while (Date.now() < deadline) {
|
|
808
|
+
await new Promise((r) => setTimeout(r, 2000));
|
|
809
|
+
const beat = lockBeat();
|
|
810
|
+
if (beat !== last) {
|
|
811
|
+
last = beat;
|
|
812
|
+
quietSince = Date.now();
|
|
813
|
+
} else if (Date.now() - quietSince > LOCK_STALE_MS + 2000) {
|
|
814
|
+
return;
|
|
815
|
+
}
|
|
816
|
+
}
|
|
817
|
+
throw new StandError('Папку данных держит другой работающий экземпляр приложения: его отметка продолжает обновляться. ' +
|
|
818
|
+
'Закройте его и запустите стенд снова.');
|
|
819
|
+
}
|
|
820
|
+
|
|
821
|
+
function spawnApp(port) {
|
|
822
|
+
const env = envs.appEnv({ dataDir: dirs.data, tmpDir: dirs.tmp, codeDir, codeReal, libpq: envs.libpqEnv(pgPort, password),
|
|
823
|
+
external: !opts.local, build: opts.build || {}, token });
|
|
824
|
+
const proc = spawn(py, ['-E', '-s', '-X', 'utf8', '-m', 'app.serve', '--host', '127.0.0.1', '--port', String(port)],
|
|
825
|
+
{ cwd: appRoot, env, windowsHide: true, stdio: ['pipe', 'pipe', 'pipe'] });
|
|
826
|
+
const out = appLogStream();
|
|
827
|
+
proc.bound = false;
|
|
828
|
+
const watch = (chunk) => {
|
|
829
|
+
out.write(chunk);
|
|
830
|
+
if (!proc.bound && /Uvicorn running on http:\/\/127\.0\.0\.1:\d+/.test(String(chunk))) proc.bound = true;
|
|
831
|
+
};
|
|
832
|
+
proc.stdout.on('data', watch);
|
|
833
|
+
proc.stderr.on('data', watch);
|
|
834
|
+
proc.stdin.on('error', () => {});
|
|
835
|
+
proc.exited = new Promise((resolve) => {
|
|
836
|
+
let done = false;
|
|
837
|
+
const finish = (code) => {
|
|
838
|
+
if (done) return;
|
|
839
|
+
done = true;
|
|
840
|
+
out.end();
|
|
841
|
+
resolve(code);
|
|
842
|
+
};
|
|
843
|
+
proc.on('exit', (code) => finish(code));
|
|
844
|
+
// процесс не создан (нет интерпретатора): попытка завершена, держатель не падает в обход остановки базы
|
|
845
|
+
proc.on('error', (error) => {
|
|
846
|
+
proc.failed = true;
|
|
847
|
+
log(`приложение не запустилось: ${error.message}`);
|
|
848
|
+
finish(-1);
|
|
849
|
+
});
|
|
850
|
+
});
|
|
851
|
+
apps.add(proc);
|
|
852
|
+
proc.exited.then(() => apps.delete(proc));
|
|
853
|
+
return proc;
|
|
854
|
+
}
|
|
855
|
+
|
|
856
|
+
function healthz(port, ms = 3000) {
|
|
857
|
+
return getJson(port, '/healthz', Math.max(200, ms)).then((r) => (r.state === 'ok' ? r.data : null));
|
|
858
|
+
}
|
|
859
|
+
|
|
860
|
+
async function waitReady(proc, port) {
|
|
861
|
+
const deadline = Date.now() + READY_MS;
|
|
862
|
+
while (Date.now() < deadline) {
|
|
863
|
+
if (proc.exitCode !== null || proc.failed) return false;
|
|
864
|
+
const answer = await healthz(port, Math.min(3000, deadline - Date.now()));
|
|
865
|
+
if (proc.bound && answer && answer.stand && answer.stand.token === token && ['ok', 'hub_write_paused'].includes(answer.status)) {
|
|
866
|
+
if (answer.status === 'hub_write_paused') {
|
|
867
|
+
say('В базе отмечена пауза записи в Hub; в стенде Hub выключен, на работу с находками это не влияет.');
|
|
868
|
+
}
|
|
869
|
+
return true;
|
|
870
|
+
}
|
|
871
|
+
await new Promise((r) => setTimeout(r, 500));
|
|
872
|
+
}
|
|
873
|
+
return false;
|
|
874
|
+
}
|
|
875
|
+
|
|
876
|
+
function appLogTail() {
|
|
877
|
+
try { return tail(fs.readFileSync(path.join(dirs.logs, `app-${stamp().slice(0, 10)}.log`), 'utf8'), 15); } catch { return ''; }
|
|
878
|
+
}
|
|
879
|
+
|
|
880
|
+
/** Запуск приложения: свободный порт с 8765 (порт, где отвечает чужой процесс, пропускается), коды 75 и 76. */
|
|
881
|
+
async function startApp() {
|
|
882
|
+
let port = opts.port || appPort || APP_PORT_FIRST;
|
|
883
|
+
const firstPort = port;
|
|
884
|
+
for (let attempt = 0; attempt < APP_PORT_TRIES && port <= 65535; attempt += 1) {
|
|
885
|
+
checkStop();
|
|
886
|
+
if (await portAnswers(port)) {
|
|
887
|
+
if (opts.port && port === opts.port) { // и при перезапуске: явный порт не меняется (ревью круга 9)
|
|
888
|
+
throw new StandError(`Порт ${port}, заданный ключом --port, занят другой программой. Освободите его или выберите другой.`);
|
|
889
|
+
}
|
|
890
|
+
port += 1;
|
|
891
|
+
continue;
|
|
892
|
+
}
|
|
893
|
+
checkStop();
|
|
894
|
+
const proc = spawnApp(port);
|
|
895
|
+
const ready = await Promise.race([waitReady(proc, port), proc.exited.then(() => false)]);
|
|
896
|
+
if (ready) return { proc, port };
|
|
897
|
+
if (proc.exitCode === null) {
|
|
898
|
+
await killTree(proc);
|
|
899
|
+
throw new StandError(`Приложение не ответило за ${READY_MS / 1000} с.\n${appLogTail()}`);
|
|
900
|
+
}
|
|
901
|
+
if (proc.exitCode === 75) {
|
|
902
|
+
await waitLockStale();
|
|
903
|
+
continue;
|
|
904
|
+
}
|
|
905
|
+
if (proc.exitCode === 76) {
|
|
906
|
+
if (opts.port && port === opts.port) {
|
|
907
|
+
throw new StandError(`Порт ${port}, заданный ключом --port, занять нельзя (зарезервирован системой или занят). ` +
|
|
908
|
+
'Выберите другой порт.');
|
|
909
|
+
}
|
|
910
|
+
port += 1;
|
|
911
|
+
continue;
|
|
912
|
+
}
|
|
913
|
+
throw new StandError(`Приложение не запустилось (код ${proc.exitCode}).\n${appLogTail()}`);
|
|
914
|
+
}
|
|
915
|
+
throw new StandError(`Свободного порта для приложения не нашлось (${firstPort}–${Math.min(65535, port - 1)}).`);
|
|
916
|
+
}
|
|
917
|
+
|
|
918
|
+
/**
|
|
919
|
+
* Принудительная остановка приложения вместе с дочерними процессами: python.exe окружения uv на Windows – перенаправитель,
|
|
920
|
+
* а сервер работает в его дочернем процессе базового интерпретатора.
|
|
921
|
+
*/
|
|
922
|
+
async function killTree(proc) {
|
|
923
|
+
if (proc.exitCode !== null) return;
|
|
924
|
+
if (process.platform === 'win32') {
|
|
925
|
+
await run('taskkill.exe', ['/pid', String(proc.pid), '/t', '/f'], { timeoutMs: 30000 });
|
|
926
|
+
} else {
|
|
927
|
+
proc.kill('SIGKILL');
|
|
928
|
+
}
|
|
929
|
+
await Promise.race([proc.exited, new Promise((r) => setTimeout(r, 10000))]);
|
|
930
|
+
}
|
|
931
|
+
|
|
932
|
+
function exitText(code) {
|
|
933
|
+
return code === null || code < 0 || code > 255 ? 'процесс завершён извне' : `код ${code}`;
|
|
934
|
+
}
|
|
935
|
+
|
|
936
|
+
async function waitPortFree(port, ms = 15000) {
|
|
937
|
+
const deadline = Date.now() + ms;
|
|
938
|
+
while (Date.now() < deadline && (await portAnswers(port))) await new Promise((r) => setTimeout(r, 500));
|
|
939
|
+
}
|
|
940
|
+
|
|
941
|
+
function watchApp(proc) {
|
|
942
|
+
proc.exited.then(async (raw) => {
|
|
943
|
+
if (stopping || proc !== child) return;
|
|
944
|
+
const code = exitText(raw);
|
|
945
|
+
setPhase('restarting', `приложение остановилось (${code})`); // прежний адрес больше не выдаётся как готовый
|
|
946
|
+
appUrl = '';
|
|
947
|
+
await waitPortFree(appPort); // прежний процесс ещё может держать порт: перезапуск – на том же адресе
|
|
948
|
+
if (stopping) return;
|
|
949
|
+
const now = Date.now();
|
|
950
|
+
while (restarts.length && now - restarts[0] > RESTART_WINDOW_MS) restarts.shift();
|
|
951
|
+
if (restarts.length >= RESTARTS) {
|
|
952
|
+
setPhase('failed', `приложение остановилось (${code}) и перезапуски не помогли`);
|
|
953
|
+
say(`Приложение остановилось (${code}), перезапуски не помогли. Журнал: ${dirs.logs}\n${appLogTail()}`);
|
|
954
|
+
return;
|
|
955
|
+
}
|
|
956
|
+
restarts.push(now);
|
|
957
|
+
say(`Приложение остановилось (${code}) – перезапускаю…`);
|
|
958
|
+
try {
|
|
959
|
+
const started = await startApp();
|
|
960
|
+
child = started.proc;
|
|
961
|
+
appPort = started.port;
|
|
962
|
+
appUrl = `http://127.0.0.1:${appPort}/`;
|
|
963
|
+
watchApp(child);
|
|
964
|
+
setPhase('ready');
|
|
965
|
+
say(`Стенд снова работает: ${appUrl}`);
|
|
966
|
+
} catch (error) {
|
|
967
|
+
if (stopping || error instanceof Cancelled) return; // остановку доводит shutdown
|
|
968
|
+
setPhase('failed', error.message);
|
|
969
|
+
say(error.message);
|
|
970
|
+
}
|
|
971
|
+
});
|
|
972
|
+
}
|
|
973
|
+
|
|
974
|
+
// ---------------------------------------------------------------- остановка
|
|
975
|
+
|
|
976
|
+
let stopIssues = 0; // что остановить не удалось: последнее сообщение и код выхода говорят об этом
|
|
977
|
+
|
|
978
|
+
|
|
979
|
+
async function stopApps() {
|
|
980
|
+
for (const proc of [...apps]) { // в том числе запущенное, но ещё не готовое приложение
|
|
981
|
+
if (proc.exitCode !== null || proc.failed) continue;
|
|
982
|
+
try { proc.stdin.end(); } catch { /* канал уже закрыт */ }
|
|
983
|
+
const done = await Promise.race([proc.exited.then(() => true), new Promise((r) => setTimeout(() => r(false), APP_STOP_MS))]);
|
|
984
|
+
if (!done) {
|
|
985
|
+
say('Приложение не остановилось за 25 с – останавливаю принудительно.');
|
|
986
|
+
await killTree(proc);
|
|
987
|
+
}
|
|
988
|
+
if (proc.exitCode === null) stopIssues += 1;
|
|
989
|
+
}
|
|
990
|
+
}
|
|
991
|
+
|
|
992
|
+
async function shutdown(code = 0, fromMain = false) {
|
|
993
|
+
if (stopping) return;
|
|
994
|
+
stopping = true;
|
|
995
|
+
if (phase !== 'failed') setPhase('stopping'); // причина отказа остаётся видна ждущему окну
|
|
996
|
+
say('Останавливаю стенд…');
|
|
997
|
+
stopCollector();
|
|
998
|
+
await stopApps();
|
|
999
|
+
await settle(60000); // установщик, initdb, pg_ctl, начатые до остановки
|
|
1000
|
+
// цепочка запуска могла быть между шагами (выбор порта, запуск сервера): дождаться её отмены до проверки серверов
|
|
1001
|
+
if (!fromMain) await Promise.race([mainRun, new Promise((r) => setTimeout(r, 120000))]);
|
|
1002
|
+
await settle(30000);
|
|
1003
|
+
await stopApps(); // приложение могло стартовать, пока цепочка запуска доходила до проверки остановки
|
|
1004
|
+
const tryStop = async (dir, port) => {
|
|
1005
|
+
try {
|
|
1006
|
+
return await stopServer(dir, port);
|
|
1007
|
+
} catch (error) {
|
|
1008
|
+
say(`Сервер на ${dir}: ${error.message}`);
|
|
1009
|
+
return false;
|
|
1010
|
+
}
|
|
1011
|
+
};
|
|
1012
|
+
if (tempServer && py) {
|
|
1013
|
+
const stopped = await tryStop(tempServer.dir, tempServer.port);
|
|
1014
|
+
say(stopped ? 'Временный сервер обновления схемы остановлен.' : 'Временный сервер обновления схемы остановить не удалось.');
|
|
1015
|
+
if (!stopped) stopIssues += 1;
|
|
1016
|
+
}
|
|
1017
|
+
if (pgStarted && pgPort && fs.existsSync(dataDir) && py) {
|
|
1018
|
+
const stopped = await tryStop(dataDir, pgPort);
|
|
1019
|
+
say(stopped ? 'PostgreSQL остановлен.' : 'PostgreSQL остановить не удалось: подробности выше.');
|
|
1020
|
+
if (!stopped) stopIssues += 1;
|
|
1021
|
+
}
|
|
1022
|
+
if (!(pgStarted && pgPort) && fs.existsSync(dataDir) && !fs.existsSync(pg.exe(binDir, 'pg_ctl')) && !dataState) {
|
|
1023
|
+
dataState = 'error'; // проверить состояние нечем: честное «не установлено», сигнала нет (ревью круга 8)
|
|
1024
|
+
}
|
|
1025
|
+
const nextDir = path.join(dirs.pg, 'next');
|
|
1026
|
+
if (!tempServer && fs.existsSync(nextDir) && fs.existsSync(pg.exe(binDir, 'pg_ctl'))) {
|
|
1027
|
+
let code = -1;
|
|
1028
|
+
try { code = (await pgStatus(nextDir)).code; } catch { code = -1; }
|
|
1029
|
+
if (code === 0) {
|
|
1030
|
+
say(`На ${nextDir} (прерванное обновление схемы) работает процесс PostgreSQL: сигнал остановки не посылался.`);
|
|
1031
|
+
stopIssues += 1;
|
|
1032
|
+
} else if (code !== 3) {
|
|
1033
|
+
say(`Работает ли PostgreSQL на ${nextDir} (прерванное обновление схемы), не установлено: сигнал не посылался.`);
|
|
1034
|
+
stopIssues += 1;
|
|
1035
|
+
}
|
|
1036
|
+
}
|
|
1037
|
+
if (!(pgStarted && pgPort) && !py && fs.existsSync(dataDir) && fs.existsSync(pg.exe(binDir, 'pg_ctl'))) {
|
|
1038
|
+
// отказ до подготовки Python: подтвердить каталог по SQL нечем
|
|
1039
|
+
try {
|
|
1040
|
+
const st = await pgStatus(dataDir);
|
|
1041
|
+
if (st.code === 0) dataState = 'process';
|
|
1042
|
+
else if (st.code === 4) dataState = 'notcluster';
|
|
1043
|
+
else if (st.code !== 3) dataState = 'error';
|
|
1044
|
+
} catch { dataState = 'error'; }
|
|
1045
|
+
}
|
|
1046
|
+
if (!(pgStarted && pgPort) && fs.existsSync(dataDir)) {
|
|
1047
|
+
// сервер не запускался этим держателем: что с ним, говорит последняя проверка каталога; её не было (отказ раньше,
|
|
1048
|
+
// например без файла пароля) – одна проверка сейчас, сигнал не посылается
|
|
1049
|
+
if (!dataState && py) {
|
|
1050
|
+
try { await serverOn(dataDir, state.data.pg_port || (pidFile(dataDir) || {}).port || 0); } catch { dataState = 'error'; }
|
|
1051
|
+
}
|
|
1052
|
+
if (dataState === 'running') {
|
|
1053
|
+
say('PostgreSQL стенда оставлен работать: сигнал остановки ему не посылался.');
|
|
1054
|
+
stopIssues += 1;
|
|
1055
|
+
} else if (['unconfirmed', 'starting', 'elsewhere', 'process'].includes(dataState)) {
|
|
1056
|
+
say('На каталоге базы работает процесс PostgreSQL, но по SQL он не подтверждён: сигнал остановки не посылался.');
|
|
1057
|
+
stopIssues += 1;
|
|
1058
|
+
} else if (['stale', 'foreign', 'error', 'notcluster'].includes(dataState)) {
|
|
1059
|
+
say('Работает ли PostgreSQL стенда, не установлено: сигнал остановки не посылался.');
|
|
1060
|
+
stopIssues += 1;
|
|
1061
|
+
}
|
|
1062
|
+
}
|
|
1063
|
+
if (stopIssues) {
|
|
1064
|
+
say('Стенд остановлен не полностью: часть процессов оставлена работать, подробности выше.');
|
|
1065
|
+
if (code === 0) code = 1;
|
|
1066
|
+
} else {
|
|
1067
|
+
say('Стенд остановлен.');
|
|
1068
|
+
}
|
|
1069
|
+
if (lockServer) lockServer.close();
|
|
1070
|
+
setTimeout(() => process.exit(code), 200);
|
|
1071
|
+
}
|
|
1072
|
+
|
|
1073
|
+
// ---------------------------------------------------------------- ход запуска
|
|
1074
|
+
|
|
1075
|
+
async function main() {
|
|
1076
|
+
try {
|
|
1077
|
+
lockServer = await holdLock(opts.lockPort);
|
|
1078
|
+
} catch (error) {
|
|
1079
|
+
if (error && error.code === 'EADDRINUSE') process.exit(3); // другое окно успело первым: CLI подключится к нему
|
|
1080
|
+
say(`Служебный порт стенда ${opts.lockPort} недоступен (${error && error.code ? error.code : error}): вероятно, Windows ` +
|
|
1081
|
+
'зарезервировала его для Hyper-V, WSL или Docker. Запустите стенд с другой служебной папкой: npx local-triage --home <папка>.');
|
|
1082
|
+
process.exit(4);
|
|
1083
|
+
}
|
|
1084
|
+
checkFoldersApart(); // до любых записей и чисток: ни один файл в папке кода ещё не тронут (ревью кругов 7–8)
|
|
1085
|
+
for (const dir of Object.values(dirs)) fs.mkdirSync(dir, { recursive: true });
|
|
1086
|
+
logFile = path.join(dirs.logs, `supervisor-${stamp().slice(0, 10)}.log`);
|
|
1087
|
+
pg.pruneLogs(dirs.logs);
|
|
1088
|
+
process.stdin.on('end', () => shutdown(0));
|
|
1089
|
+
process.stdin.on('close', () => shutdown(0));
|
|
1090
|
+
process.stdin.on('error', () => shutdown(0));
|
|
1091
|
+
process.stdin.resume();
|
|
1092
|
+
for (const sig of ['SIGINT', 'SIGTERM', 'SIGHUP', 'SIGBREAK']) {
|
|
1093
|
+
try { process.on(sig, () => shutdown(0)); } catch { /* сигнала нет на платформе */ }
|
|
1094
|
+
}
|
|
1095
|
+
state = stand.load(home);
|
|
1096
|
+
// stand.json утрачен, а прежние базы есть – это прежняя установка (раздел 3.2): отмечается до первой записи файла,
|
|
1097
|
+
// чтобы прерванный запуск не превратил её в первую; явный --new-database – выбор оператора
|
|
1098
|
+
if (!state.existed && (backupsPresent() || clusterMarked()) && !opts.newDatabase) stand.save(state, { phase: 'ready' });
|
|
1099
|
+
let npmShown = version;
|
|
1100
|
+
try { npmShown = npmVersionOf(version); } catch { /* как есть */ }
|
|
1101
|
+
say(`Учебный стенд «Локальный триаж» ${version} (пакет npm ${npmShown}). Служебная папка: ${home}`);
|
|
1102
|
+
if (typeof process.getuid === 'function' && process.getuid() === 0) {
|
|
1103
|
+
throw new StandError('Стенд не запускается от root: PostgreSQL от root не работает. Запустите от обычного пользователя.');
|
|
1104
|
+
}
|
|
1105
|
+
pg.platformPackage();
|
|
1106
|
+
py = await python.ensurePython({ home, version, requirements: path.join(packageDir, 'npm', 'requirements.txt'),
|
|
1107
|
+
env: envs.pythonInstallEnv(dirs.tmp), say, reinstall: Boolean(opts.reinstall) });
|
|
1108
|
+
checkStop();
|
|
1109
|
+
appRoot = syncAppRoot();
|
|
1110
|
+
prepareCodeDir();
|
|
1111
|
+
setPhase('starting');
|
|
1112
|
+
await preparePostgres();
|
|
1113
|
+
const after = binding.fromCluster(home);
|
|
1114
|
+
if (after && !opts.newDatabase && !binding.matches(after, codeDir)) throw bindingError(after);
|
|
1115
|
+
checkStop();
|
|
1116
|
+
stopCollector = metrics.startCollector(dirs.data, (error) => log(`сведения о компьютере не записаны: ${error.message}`));
|
|
1117
|
+
say('Запускаю приложение…');
|
|
1118
|
+
const started = await startApp();
|
|
1119
|
+
child = started.proc;
|
|
1120
|
+
appPort = started.port;
|
|
1121
|
+
appUrl = `http://127.0.0.1:${appPort}/`;
|
|
1122
|
+
watchApp(child);
|
|
1123
|
+
stand.save(state, { phase: 'ready', app_port: appPort, last_good_version: version, code_dir: codeDir,
|
|
1124
|
+
code_dir_real: canonical(codeDir) });
|
|
1125
|
+
// версия рядом с самим кластером: имя копии обновления знает её и при утраченном stand.json
|
|
1126
|
+
try { fs.writeFileSync(path.join(dataDir, 'local-triage.version'), `${version}\n`); } catch { /* не критично */ }
|
|
1127
|
+
try { fs.writeFileSync(path.join(dataDir, binding.FILE), binding.fileText(codeDir)); } catch { /* не критично */ }
|
|
1128
|
+
setPhase('ready');
|
|
1129
|
+
say(`Стенд работает: ${appUrl}`);
|
|
1130
|
+
try { process.stdout.write(`@@ready ${appUrl}\n`); } catch { /* окно закрыто */ }
|
|
1131
|
+
}
|
|
1132
|
+
|
|
1133
|
+
const mainRun = main().then(() => null, (error) => error);
|
|
1134
|
+
mainRun.then(async (error) => {
|
|
1135
|
+
if (!error || error instanceof Cancelled || stopping) return; // остановку доводит shutdown
|
|
1136
|
+
const text = error instanceof StandError ? error.message : `Сбой стенда: ${error && error.stack ? error.stack : error}`;
|
|
1137
|
+
setPhase('failed', text.split('\n')[0]);
|
|
1138
|
+
say(text);
|
|
1139
|
+
say(`Журналы: ${dirs.logs}`);
|
|
1140
|
+
await shutdown(1, true);
|
|
1141
|
+
});
|