@rcpooley/concord 0.1.0
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 +318 -0
- package/bin/concord.service +69 -0
- package/dist/age.d.ts +20 -0
- package/dist/age.d.ts.map +1 -0
- package/dist/age.js +58 -0
- package/dist/age.js.map +1 -0
- package/dist/cli/main.d.ts +3 -0
- package/dist/cli/main.d.ts.map +1 -0
- package/dist/cli/main.js +301 -0
- package/dist/cli/main.js.map +1 -0
- package/dist/daemon.d.ts +4 -0
- package/dist/daemon.d.ts.map +1 -0
- package/dist/daemon.js +394 -0
- package/dist/daemon.js.map +1 -0
- package/dist/eval-config.d.ts +2 -0
- package/dist/eval-config.d.ts.map +1 -0
- package/dist/eval-config.js +45 -0
- package/dist/eval-config.js.map +1 -0
- package/dist/exec.d.ts +168 -0
- package/dist/exec.d.ts.map +1 -0
- package/dist/exec.js +313 -0
- package/dist/exec.js.map +1 -0
- package/dist/git.d.ts +59 -0
- package/dist/git.d.ts.map +1 -0
- package/dist/git.js +265 -0
- package/dist/git.js.map +1 -0
- package/dist/hook.d.ts +37 -0
- package/dist/hook.d.ts.map +1 -0
- package/dist/hook.js +89 -0
- package/dist/hook.js.map +1 -0
- package/dist/index.d.ts +18 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +15 -0
- package/dist/index.js.map +1 -0
- package/dist/init.d.ts +76 -0
- package/dist/init.d.ts.map +1 -0
- package/dist/init.js +236 -0
- package/dist/init.js.map +1 -0
- package/dist/loader.d.ts +35 -0
- package/dist/loader.d.ts.map +1 -0
- package/dist/loader.js +230 -0
- package/dist/loader.js.map +1 -0
- package/dist/module.d.ts +116 -0
- package/dist/module.d.ts.map +1 -0
- package/dist/module.js +100 -0
- package/dist/module.js.map +1 -0
- package/dist/modules/apt/index.d.ts +45 -0
- package/dist/modules/apt/index.d.ts.map +1 -0
- package/dist/modules/apt/index.js +249 -0
- package/dist/modules/apt/index.js.map +1 -0
- package/dist/modules/apt/schema.d.ts +63 -0
- package/dist/modules/apt/schema.d.ts.map +1 -0
- package/dist/modules/apt/schema.js +75 -0
- package/dist/modules/apt/schema.js.map +1 -0
- package/dist/modules/checkout/index.d.ts +88 -0
- package/dist/modules/checkout/index.d.ts.map +1 -0
- package/dist/modules/checkout/index.js +382 -0
- package/dist/modules/checkout/index.js.map +1 -0
- package/dist/modules/checkout/schema.d.ts +52 -0
- package/dist/modules/checkout/schema.d.ts.map +1 -0
- package/dist/modules/checkout/schema.js +132 -0
- package/dist/modules/checkout/schema.js.map +1 -0
- package/dist/modules/cloudflare/api.d.ts +64 -0
- package/dist/modules/cloudflare/api.d.ts.map +1 -0
- package/dist/modules/cloudflare/api.js +98 -0
- package/dist/modules/cloudflare/api.js.map +1 -0
- package/dist/modules/cloudflare/index.d.ts +74 -0
- package/dist/modules/cloudflare/index.d.ts.map +1 -0
- package/dist/modules/cloudflare/index.js +374 -0
- package/dist/modules/cloudflare/index.js.map +1 -0
- package/dist/modules/cloudflare/schema.d.ts +62 -0
- package/dist/modules/cloudflare/schema.d.ts.map +1 -0
- package/dist/modules/cloudflare/schema.js +85 -0
- package/dist/modules/cloudflare/schema.js.map +1 -0
- package/dist/modules/docker/index.d.ts +83 -0
- package/dist/modules/docker/index.d.ts.map +1 -0
- package/dist/modules/docker/index.js +470 -0
- package/dist/modules/docker/index.js.map +1 -0
- package/dist/modules/docker/registry.d.ts +35 -0
- package/dist/modules/docker/registry.d.ts.map +1 -0
- package/dist/modules/docker/registry.js +95 -0
- package/dist/modules/docker/registry.js.map +1 -0
- package/dist/modules/docker/render.d.ts +45 -0
- package/dist/modules/docker/render.d.ts.map +1 -0
- package/dist/modules/docker/render.js +162 -0
- package/dist/modules/docker/render.js.map +1 -0
- package/dist/modules/docker/schema.d.ts +231 -0
- package/dist/modules/docker/schema.d.ts.map +1 -0
- package/dist/modules/docker/schema.js +335 -0
- package/dist/modules/docker/schema.js.map +1 -0
- package/dist/modules/docker/sweeper.d.ts +64 -0
- package/dist/modules/docker/sweeper.d.ts.map +1 -0
- package/dist/modules/docker/sweeper.js +94 -0
- package/dist/modules/docker/sweeper.js.map +1 -0
- package/dist/modules/file/index.d.ts +79 -0
- package/dist/modules/file/index.d.ts.map +1 -0
- package/dist/modules/file/index.js +305 -0
- package/dist/modules/file/index.js.map +1 -0
- package/dist/modules/file/schema.d.ts +45 -0
- package/dist/modules/file/schema.d.ts.map +1 -0
- package/dist/modules/file/schema.js +114 -0
- package/dist/modules/file/schema.js.map +1 -0
- package/dist/modules/index.d.ts +20 -0
- package/dist/modules/index.d.ts.map +1 -0
- package/dist/modules/index.js +11 -0
- package/dist/modules/index.js.map +1 -0
- package/dist/modules/porkbun/api.d.ts +36 -0
- package/dist/modules/porkbun/api.d.ts.map +1 -0
- package/dist/modules/porkbun/api.js +62 -0
- package/dist/modules/porkbun/api.js.map +1 -0
- package/dist/modules/porkbun/index.d.ts +50 -0
- package/dist/modules/porkbun/index.d.ts.map +1 -0
- package/dist/modules/porkbun/index.js +236 -0
- package/dist/modules/porkbun/index.js.map +1 -0
- package/dist/modules/porkbun/schema.d.ts +38 -0
- package/dist/modules/porkbun/schema.d.ts.map +1 -0
- package/dist/modules/porkbun/schema.js +39 -0
- package/dist/modules/porkbun/schema.js.map +1 -0
- package/dist/modules/script/index.d.ts +43 -0
- package/dist/modules/script/index.d.ts.map +1 -0
- package/dist/modules/script/index.js +116 -0
- package/dist/modules/script/index.js.map +1 -0
- package/dist/modules/script/schema.d.ts +25 -0
- package/dist/modules/script/schema.d.ts.map +1 -0
- package/dist/modules/script/schema.js +63 -0
- package/dist/modules/script/schema.js.map +1 -0
- package/dist/modules/systemd/index.d.ts +93 -0
- package/dist/modules/systemd/index.d.ts.map +1 -0
- package/dist/modules/systemd/index.js +394 -0
- package/dist/modules/systemd/index.js.map +1 -0
- package/dist/modules/systemd/render.d.ts +41 -0
- package/dist/modules/systemd/render.d.ts.map +1 -0
- package/dist/modules/systemd/render.js +252 -0
- package/dist/modules/systemd/render.js.map +1 -0
- package/dist/modules/systemd/schema.d.ts +293 -0
- package/dist/modules/systemd/schema.d.ts.map +1 -0
- package/dist/modules/systemd/schema.js +302 -0
- package/dist/modules/systemd/schema.js.map +1 -0
- package/dist/modules/systemd/sweeper.d.ts +31 -0
- package/dist/modules/systemd/sweeper.d.ts.map +1 -0
- package/dist/modules/systemd/sweeper.js +77 -0
- package/dist/modules/systemd/sweeper.js.map +1 -0
- package/dist/plans.d.ts +132 -0
- package/dist/plans.d.ts.map +1 -0
- package/dist/plans.js +315 -0
- package/dist/plans.js.map +1 -0
- package/dist/records.d.ts +37 -0
- package/dist/records.d.ts.map +1 -0
- package/dist/records.js +100 -0
- package/dist/records.js.map +1 -0
- package/dist/registry.d.ts +38 -0
- package/dist/registry.d.ts.map +1 -0
- package/dist/registry.js +31 -0
- package/dist/registry.js.map +1 -0
- package/dist/runner.d.ts +48 -0
- package/dist/runner.d.ts.map +1 -0
- package/dist/runner.js +150 -0
- package/dist/runner.js.map +1 -0
- package/dist/scheduler.d.ts +36 -0
- package/dist/scheduler.d.ts.map +1 -0
- package/dist/scheduler.js +77 -0
- package/dist/scheduler.js.map +1 -0
- package/dist/schema.d.ts +762 -0
- package/dist/schema.d.ts.map +1 -0
- package/dist/schema.js +185 -0
- package/dist/schema.js.map +1 -0
- package/dist/secret.d.ts +24 -0
- package/dist/secret.d.ts.map +1 -0
- package/dist/secret.js +3 -0
- package/dist/secret.js.map +1 -0
- package/dist/ui.d.ts +62 -0
- package/dist/ui.d.ts.map +1 -0
- package/dist/ui.js +288 -0
- package/dist/ui.js.map +1 -0
- package/package.json +57 -0
package/dist/daemon.js
ADDED
|
@@ -0,0 +1,394 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
/**
|
|
3
|
+
* The Concord daemon — the top-level process, and the only one.
|
|
4
|
+
*
|
|
5
|
+
* It replaces `concord.timer` + `concord-run`. That pair existed to produce a
|
|
6
|
+
* working reconciler process every 15 minutes, which is why it carried
|
|
7
|
+
* build-before-swap and a last-known-good fallback. A long-running process
|
|
8
|
+
* needs none of that: it is already running, so a failed build is harmless —
|
|
9
|
+
* you simply do not restart it. Updating Concord is a deliberate, manual step
|
|
10
|
+
* (install the new version, restart the service), never something that
|
|
11
|
+
* happens to you.
|
|
12
|
+
*
|
|
13
|
+
* TWO RULES, both learned the hard way:
|
|
14
|
+
*
|
|
15
|
+
* 1. **Nothing here comes from the config repo.** Every setting is an
|
|
16
|
+
* environment variable, placed once at install time. The config repo is
|
|
17
|
+
* what Concord DEPLOYS; it must never decide how Concord RUNS. Putting a
|
|
18
|
+
* trigger in config once already made the mechanism that fixes a broken
|
|
19
|
+
* config depend on the config being right.
|
|
20
|
+
*
|
|
21
|
+
* 2. **Nothing short of SIGTERM may stop the loop.** A config that will not
|
|
22
|
+
* parse and a module that throws are both ordinary, expected events: log
|
|
23
|
+
* them and try again next tick. A daemon that exits on a bad config would
|
|
24
|
+
* hand the config repo the power to take Concord down — rule 1 again, by
|
|
25
|
+
* another route.
|
|
26
|
+
*/
|
|
27
|
+
import { execFileSync } from 'node:child_process';
|
|
28
|
+
import { existsSync, mkdirSync, readFileSync } from 'node:fs';
|
|
29
|
+
import { homedir } from 'node:os';
|
|
30
|
+
import { join } from 'node:path';
|
|
31
|
+
import { loadConfig, RECONCILER_ROOT, syncConfigRepo } from './loader.js';
|
|
32
|
+
import { run } from './runner.js';
|
|
33
|
+
import { Scheduler } from './scheduler.js';
|
|
34
|
+
import { startHookListener } from './hook.js';
|
|
35
|
+
import { PlanService } from './plans.js';
|
|
36
|
+
import { appendCapped, newRecordId, RecordStore } from './records.js';
|
|
37
|
+
import { startUi } from './ui.js';
|
|
38
|
+
const HOME = process.env.CONCORD_HOME ?? join(homedir(), '.concord');
|
|
39
|
+
const STATE_DIR = join(HOME, 'state');
|
|
40
|
+
const CONFIG_DIR = process.env.CONCORD_CONFIG_DIR ?? join(HOME, 'config');
|
|
41
|
+
/** Compiled-in default. An env var can override it; the config repo cannot. */
|
|
42
|
+
const DEFAULT_INTERVAL_S = 900;
|
|
43
|
+
/** The reconcile in flight, if any. Its record collects every line logged. */
|
|
44
|
+
let currentRun = null;
|
|
45
|
+
function log(scope, message) {
|
|
46
|
+
const ts = new Date().toISOString().replace('T', ' ').slice(0, 19);
|
|
47
|
+
const line = `${ts} ${scope.padEnd(22)} ${message}`;
|
|
48
|
+
console.log(line);
|
|
49
|
+
if (currentRun)
|
|
50
|
+
appendCapped(currentRun.log, line);
|
|
51
|
+
}
|
|
52
|
+
function die(message) {
|
|
53
|
+
console.error(`concord: ${message}`);
|
|
54
|
+
process.exit(1);
|
|
55
|
+
}
|
|
56
|
+
function intervalSeconds() {
|
|
57
|
+
const raw = process.env.CONCORD_INTERVAL_SECONDS;
|
|
58
|
+
if (!raw)
|
|
59
|
+
return DEFAULT_INTERVAL_S;
|
|
60
|
+
const n = Number(raw);
|
|
61
|
+
if (!Number.isFinite(n) || n < 30) {
|
|
62
|
+
die(`CONCORD_INTERVAL_SECONDS=${raw} is not a number of seconds >= 30`);
|
|
63
|
+
}
|
|
64
|
+
return n;
|
|
65
|
+
}
|
|
66
|
+
// ------------------------------------------------------------- scheduling ---
|
|
67
|
+
const scheduler = new Scheduler();
|
|
68
|
+
/**
|
|
69
|
+
* Why the next cycle runs. The first request since the last cycle started
|
|
70
|
+
* names it; coalesced requests after that are the same run.
|
|
71
|
+
*/
|
|
72
|
+
let pendingTrigger = 'startup';
|
|
73
|
+
/** Ask for a reconcile. The seam the webhook listener will attach to. */
|
|
74
|
+
export function requestRun(reason) {
|
|
75
|
+
pendingTrigger ??= reason;
|
|
76
|
+
const verdict = scheduler.request();
|
|
77
|
+
log('daemon', verdict === 'queued' ? `${reason} — run in flight, queued one more` : `${reason} — waking`);
|
|
78
|
+
return verdict;
|
|
79
|
+
}
|
|
80
|
+
// -------------------------------------------------------------- staleness ---
|
|
81
|
+
/**
|
|
82
|
+
* Say when the running code is out of date, and never act on it.
|
|
83
|
+
*
|
|
84
|
+
* Manual updates trade automatic upgrades for the certainty that nothing
|
|
85
|
+
* changes under you. The cost is a fix that is released and then forgotten,
|
|
86
|
+
* with the fleet quietly reconciling against old code. This refuses to let that
|
|
87
|
+
* be invisible without taking the decision back.
|
|
88
|
+
*
|
|
89
|
+
* Two install shapes, checked differently:
|
|
90
|
+
* - a git checkout (development, or a host deployed with `concord-deploy`):
|
|
91
|
+
* compare HEAD with the tip of its branch on the remote;
|
|
92
|
+
* - an npm install: compare the installed version with the registry's latest.
|
|
93
|
+
*/
|
|
94
|
+
const reconcilerState = {};
|
|
95
|
+
/** Bounded, quiet child process. A nicety — never the thing that blocks a cycle. */
|
|
96
|
+
function quiet(command, args, cwd) {
|
|
97
|
+
return execFileSync(command, args, {
|
|
98
|
+
cwd,
|
|
99
|
+
encoding: 'utf8',
|
|
100
|
+
stdio: ['ignore', 'pipe', 'pipe'],
|
|
101
|
+
timeout: 60_000,
|
|
102
|
+
}).trim();
|
|
103
|
+
}
|
|
104
|
+
function reportStaleness() {
|
|
105
|
+
try {
|
|
106
|
+
if (existsSync(join(RECONCILER_ROOT, '.git')))
|
|
107
|
+
reportGitStaleness();
|
|
108
|
+
else
|
|
109
|
+
reportNpmStaleness();
|
|
110
|
+
}
|
|
111
|
+
catch {
|
|
112
|
+
// No network, no registry entry, or not a recognisable install. None of
|
|
113
|
+
// them is worth a line every cycle.
|
|
114
|
+
}
|
|
115
|
+
}
|
|
116
|
+
function reportGitStaleness() {
|
|
117
|
+
const git = (...args) => quiet('git', args, RECONCILER_ROOT);
|
|
118
|
+
const head = git('rev-parse', 'HEAD');
|
|
119
|
+
const branch = git('rev-parse', '--abbrev-ref', 'HEAD');
|
|
120
|
+
const remote = git('ls-remote', 'origin', branch).split(/\s+/)[0];
|
|
121
|
+
reconcilerState.sha = head;
|
|
122
|
+
if (!remote || remote === head) {
|
|
123
|
+
delete reconcilerState.behind;
|
|
124
|
+
log('daemon', `reconciler ${head.slice(0, 8)} (up to date)`);
|
|
125
|
+
return;
|
|
126
|
+
}
|
|
127
|
+
let behind = '';
|
|
128
|
+
try {
|
|
129
|
+
git('fetch', '--quiet', '--depth', '50', 'origin', branch);
|
|
130
|
+
behind = ` — ${git('rev-list', '--count', `HEAD..${remote}`)} commit(s) behind`;
|
|
131
|
+
}
|
|
132
|
+
catch {
|
|
133
|
+
/* counting is a nicety; the mismatch is the point */
|
|
134
|
+
}
|
|
135
|
+
reconcilerState.behind = `not the tip of ${branch}${behind}`;
|
|
136
|
+
log('daemon', `⚠ reconciler ${head.slice(0, 8)} is NOT the tip of ${branch}${behind}`);
|
|
137
|
+
log('daemon', ' update the reconciler on this host to pick it up');
|
|
138
|
+
}
|
|
139
|
+
function reportNpmStaleness() {
|
|
140
|
+
const pkg = JSON.parse(readFileSync(join(RECONCILER_ROOT, 'package.json'), 'utf8'));
|
|
141
|
+
reconcilerState.version = pkg.version;
|
|
142
|
+
const latest = quiet('npm', ['view', pkg.name, 'version'], RECONCILER_ROOT);
|
|
143
|
+
if (!latest || compareVersions(latest, pkg.version) <= 0) {
|
|
144
|
+
delete reconcilerState.behind;
|
|
145
|
+
log('daemon', `reconciler ${pkg.version} (up to date)`);
|
|
146
|
+
return;
|
|
147
|
+
}
|
|
148
|
+
reconcilerState.behind = `${latest} is available`;
|
|
149
|
+
log('daemon', `⚠ reconciler ${pkg.version} is out of date — ${latest} is published`);
|
|
150
|
+
log('daemon', ` update with \`npm install -g ${pkg.name}@${latest}\`, then restart the service`);
|
|
151
|
+
}
|
|
152
|
+
/** Compare `x.y.z` release versions numerically. Pre-release tags are ignored. */
|
|
153
|
+
function compareVersions(a, b) {
|
|
154
|
+
const parse = (v) => v.split('-')[0].split('.').map((n) => Number(n) || 0);
|
|
155
|
+
const [pa, pb] = [parse(a), parse(b)];
|
|
156
|
+
for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
|
|
157
|
+
const d = (pa[i] ?? 0) - (pb[i] ?? 0);
|
|
158
|
+
if (d !== 0)
|
|
159
|
+
return Math.sign(d);
|
|
160
|
+
}
|
|
161
|
+
return 0;
|
|
162
|
+
}
|
|
163
|
+
// -------------------------------------------------------------- reconcile ---
|
|
164
|
+
async function reconcileOnce() {
|
|
165
|
+
// main() refuses to start the loop without these.
|
|
166
|
+
const repo = process.env.CONCORD_CONFIG_REPO;
|
|
167
|
+
const ageKey = process.env.CONCORD_AGE_KEY;
|
|
168
|
+
const sha = syncConfigRepo(repo, CONFIG_DIR);
|
|
169
|
+
if (currentRun)
|
|
170
|
+
currentRun.sha = sha;
|
|
171
|
+
log('concord', `config repo at ${sha.slice(0, 12)}`);
|
|
172
|
+
const { modules, hosts, settings } = await loadConfig(CONFIG_DIR);
|
|
173
|
+
const hostNames = Object.keys(hosts);
|
|
174
|
+
log('concord', `${modules.length} module(s), ${hostNames.length} host(s): ${hostNames.join(', ')}`);
|
|
175
|
+
const result = await run({
|
|
176
|
+
modules,
|
|
177
|
+
ageKey,
|
|
178
|
+
stateRoot: STATE_DIR,
|
|
179
|
+
configDir: CONFIG_DIR,
|
|
180
|
+
apply: true,
|
|
181
|
+
log,
|
|
182
|
+
hosts,
|
|
183
|
+
settings,
|
|
184
|
+
});
|
|
185
|
+
if (currentRun)
|
|
186
|
+
currentRun.totalOps = result.totalOps;
|
|
187
|
+
if (result.failed) {
|
|
188
|
+
const broken = result.modules.find((m) => m.error);
|
|
189
|
+
log('concord', `ABORTED at ${broken.kind}:${broken.id}. Convergence is UNKNOWN.`);
|
|
190
|
+
settle('aborted', `ABORTED at ${broken.kind}:${broken.id}: ${broken.error ?? ''}`);
|
|
191
|
+
if (result.skipped.length)
|
|
192
|
+
log('concord', ` not evaluated: ${result.skipped.join(', ')}`);
|
|
193
|
+
return;
|
|
194
|
+
}
|
|
195
|
+
const unknown = result.unreachable.length
|
|
196
|
+
? ` — ${result.unreachable.length} module(s) NOT checked (host unreachable): ${result.unreachable.join(', ')}`
|
|
197
|
+
: '';
|
|
198
|
+
const warned = result.warnings.length ? ` — ${result.warnings.length} warning(s)` : '';
|
|
199
|
+
if (result.totalOps === 0) {
|
|
200
|
+
const line = unknown || warned ? `no changes where checked${unknown}${warned}` : 'converged — no changes';
|
|
201
|
+
log('concord', line);
|
|
202
|
+
settle('converged', line);
|
|
203
|
+
}
|
|
204
|
+
else {
|
|
205
|
+
const line = `${result.totalOps} change(s) across the fleet${unknown}${warned}`;
|
|
206
|
+
log('concord', line);
|
|
207
|
+
settle('changed', line);
|
|
208
|
+
}
|
|
209
|
+
for (const w of result.warnings)
|
|
210
|
+
log('concord', ` ! ${w.scope}: ${w.message}`);
|
|
211
|
+
}
|
|
212
|
+
/**
|
|
213
|
+
* One cycle. Never throws — see rule 2.
|
|
214
|
+
*
|
|
215
|
+
* An unparseable config and a module that blew up are both ordinary events
|
|
216
|
+
* here. The timer used to absorb them by virtue of the process exiting and
|
|
217
|
+
* being started again; a daemon has to absorb them itself.
|
|
218
|
+
*/
|
|
219
|
+
async function cycle() {
|
|
220
|
+
await scheduler.cycle(async () => {
|
|
221
|
+
currentRun = {
|
|
222
|
+
id: newRecordId('run'),
|
|
223
|
+
trigger: pendingTrigger ?? 'interval',
|
|
224
|
+
status: 'running',
|
|
225
|
+
startedAt: new Date().toISOString(),
|
|
226
|
+
log: [],
|
|
227
|
+
};
|
|
228
|
+
pendingTrigger = null;
|
|
229
|
+
runs.save(currentRun);
|
|
230
|
+
try {
|
|
231
|
+
reportStaleness();
|
|
232
|
+
await reconcileOnce();
|
|
233
|
+
}
|
|
234
|
+
catch (err) {
|
|
235
|
+
const message = err instanceof Error ? err.message : String(err);
|
|
236
|
+
log('concord', `ERROR: ${err instanceof Error ? (err.stack ?? err.message) : String(err)}`);
|
|
237
|
+
log('concord', 'the daemon stays up and will try again next tick');
|
|
238
|
+
settle('error', `ERROR: ${message.split('\n')[0]}`);
|
|
239
|
+
}
|
|
240
|
+
finally {
|
|
241
|
+
const done = currentRun;
|
|
242
|
+
currentRun = null;
|
|
243
|
+
if (done.status === 'running')
|
|
244
|
+
done.status = 'error';
|
|
245
|
+
done.finishedAt = new Date().toISOString();
|
|
246
|
+
runs.save(done);
|
|
247
|
+
runs.prune();
|
|
248
|
+
}
|
|
249
|
+
});
|
|
250
|
+
}
|
|
251
|
+
/** Record how the reconcile in flight ended. The log already has the detail. */
|
|
252
|
+
function settle(status, summary) {
|
|
253
|
+
if (!currentRun)
|
|
254
|
+
return;
|
|
255
|
+
currentRun.status = status;
|
|
256
|
+
// One line, and a short one: errors can carry a whole HTML error page. The
|
|
257
|
+
// log keeps the full text.
|
|
258
|
+
const line = summary.replace(/\s+/g, ' ').trim();
|
|
259
|
+
currentRun.summary = line.length > 300 ? `${line.slice(0, 299)}…` : line;
|
|
260
|
+
}
|
|
261
|
+
// ------------------------------------------------------------ history, UI ---
|
|
262
|
+
const runs = new RecordStore(join(HOME, 'runs'), 200);
|
|
263
|
+
const startedAt = new Date().toISOString();
|
|
264
|
+
let nextRunAt;
|
|
265
|
+
/**
|
|
266
|
+
* Start the UI/API listener and the plan service behind it. Optional in the
|
|
267
|
+
* same way the webhook is: `CONCORD_UI_SOCKET=off` and neither exists, and the
|
|
268
|
+
* reconcile loop is exactly what it was.
|
|
269
|
+
*/
|
|
270
|
+
function startUiAndPlans(interval) {
|
|
271
|
+
const socketPath = process.env.CONCORD_UI_SOCKET ?? '/run/concord/ui.sock';
|
|
272
|
+
if (socketPath === 'off') {
|
|
273
|
+
log('daemon', 'CONCORD_UI_SOCKET=off — no UI, no plans');
|
|
274
|
+
return;
|
|
275
|
+
}
|
|
276
|
+
const repoUrl = process.env.CONCORD_CONFIG_REPO;
|
|
277
|
+
const plans = new PlanService({
|
|
278
|
+
repoUrl,
|
|
279
|
+
root: join(HOME, 'plans'),
|
|
280
|
+
reconcileRunning: () => scheduler.running,
|
|
281
|
+
log,
|
|
282
|
+
command: ({ configDir, home, resultPath }) => ({
|
|
283
|
+
command: process.execPath,
|
|
284
|
+
args: [join(RECONCILER_ROOT, 'dist', 'cli', 'main.js'), 'plan', '--no-sync', '--result', resultPath],
|
|
285
|
+
// Its own CONCORD_HOME, so its state (docker's git mirrors) never races
|
|
286
|
+
// the daemon's; the age key and everything else come through as-is.
|
|
287
|
+
env: { ...process.env, CONCORD_HOME: home, CONCORD_CONFIG_DIR: configDir },
|
|
288
|
+
}),
|
|
289
|
+
});
|
|
290
|
+
startUi({
|
|
291
|
+
socketPath,
|
|
292
|
+
plans,
|
|
293
|
+
log,
|
|
294
|
+
status: () => ({
|
|
295
|
+
startedAt,
|
|
296
|
+
intervalSeconds: interval,
|
|
297
|
+
reconciler: { ...reconcilerState },
|
|
298
|
+
reconciling: scheduler.running,
|
|
299
|
+
...(nextRunAt && !scheduler.running ? { nextRunAt } : {}),
|
|
300
|
+
configRepo: repoUrl,
|
|
301
|
+
}),
|
|
302
|
+
runs: {
|
|
303
|
+
list: (limit) => runs.list(limit).map((saved) => {
|
|
304
|
+
// The one in flight lives in memory; its file lags.
|
|
305
|
+
const { log: _log, ...summary } = currentRun?.id === saved.id ? currentRun : saved;
|
|
306
|
+
return summary;
|
|
307
|
+
}),
|
|
308
|
+
get: (id) => (currentRun?.id === id ? currentRun : runs.get(id)),
|
|
309
|
+
},
|
|
310
|
+
});
|
|
311
|
+
}
|
|
312
|
+
// ------------------------------------------------------------------- main ---
|
|
313
|
+
async function main() {
|
|
314
|
+
const interval = intervalSeconds();
|
|
315
|
+
mkdirSync(STATE_DIR, { recursive: true });
|
|
316
|
+
log('daemon', `starting — reconciling every ${interval}s`);
|
|
317
|
+
// Not configured yet — the normal state straight after install. Wait rather
|
|
318
|
+
// than exit: a unit that restarts on failure would turn an exit into a
|
|
319
|
+
// restart loop, and there is nothing to retry until someone edits the
|
|
320
|
+
// environment file and restarts the service.
|
|
321
|
+
const missing = ['CONCORD_CONFIG_REPO', 'CONCORD_AGE_KEY'].filter((k) => !process.env[k]);
|
|
322
|
+
if (missing.length) {
|
|
323
|
+
await waitUnconfigured(missing);
|
|
324
|
+
return;
|
|
325
|
+
}
|
|
326
|
+
log('daemon', `config repo ${process.env.CONCORD_CONFIG_REPO}`);
|
|
327
|
+
// A manual poke, and the same path the webhook uses.
|
|
328
|
+
process.on('SIGHUP', () => requestRun('SIGHUP'));
|
|
329
|
+
// The listener is OPTIONAL. Without a secret there is no webhook, and the
|
|
330
|
+
// daemon reconciles on its interval exactly as before — which is the whole
|
|
331
|
+
// reason a missing or broken route is survivable.
|
|
332
|
+
const secret = process.env.CONCORD_HOOK_SECRET;
|
|
333
|
+
if (secret) {
|
|
334
|
+
startHookListener({
|
|
335
|
+
socketPath: process.env.CONCORD_HOOK_SOCKET ?? '/run/concord/hook.sock',
|
|
336
|
+
secret,
|
|
337
|
+
onPush: requestRun,
|
|
338
|
+
log,
|
|
339
|
+
});
|
|
340
|
+
}
|
|
341
|
+
else {
|
|
342
|
+
log('daemon', 'no CONCORD_HOOK_SECRET — running on the interval only');
|
|
343
|
+
}
|
|
344
|
+
try {
|
|
345
|
+
startUiAndPlans(interval);
|
|
346
|
+
}
|
|
347
|
+
catch (err) {
|
|
348
|
+
// A UI that cannot start is a missing UI, never a missing reconcile.
|
|
349
|
+
log('daemon', `UI/plans not started: ${err instanceof Error ? err.message : String(err)}`);
|
|
350
|
+
}
|
|
351
|
+
for (const sig of ['SIGTERM', 'SIGINT']) {
|
|
352
|
+
process.on(sig, () => {
|
|
353
|
+
if (scheduler.stopping)
|
|
354
|
+
return;
|
|
355
|
+
log('daemon', `${sig} — finishing the current cycle, then exiting`);
|
|
356
|
+
scheduler.stop();
|
|
357
|
+
});
|
|
358
|
+
}
|
|
359
|
+
while (!scheduler.stopping) {
|
|
360
|
+
await cycle();
|
|
361
|
+
if (scheduler.stopping)
|
|
362
|
+
break;
|
|
363
|
+
if (scheduler.takeRerun()) {
|
|
364
|
+
log('daemon', 'a run was requested mid-cycle — going straight round again');
|
|
365
|
+
continue;
|
|
366
|
+
}
|
|
367
|
+
nextRunAt = new Date(Date.now() + interval * 1000).toISOString();
|
|
368
|
+
await scheduler.sleep(interval);
|
|
369
|
+
nextRunAt = undefined;
|
|
370
|
+
}
|
|
371
|
+
log('daemon', 'stopped');
|
|
372
|
+
process.exit(0);
|
|
373
|
+
}
|
|
374
|
+
/**
|
|
375
|
+
* Idle until stopped. No loop, no webhook, no UI: with no config repo there is
|
|
376
|
+
* nothing to reconcile, plan or show. Settings are read once at start, so the
|
|
377
|
+
* way out is a restart, never a reload.
|
|
378
|
+
*/
|
|
379
|
+
async function waitUnconfigured(missing) {
|
|
380
|
+
log('daemon', `not configured — ${missing.join(' and ')} ${missing.length > 1 ? 'are' : 'is'} unset`);
|
|
381
|
+
log('daemon', ` set ${missing.length > 1 ? 'them' : 'it'} in the service's environment file, then restart the service`);
|
|
382
|
+
process.on('SIGHUP', () => log('daemon', 'SIGHUP ignored — not configured; restart the service after setting the environment'));
|
|
383
|
+
for (const sig of ['SIGTERM', 'SIGINT']) {
|
|
384
|
+
process.on(sig, () => {
|
|
385
|
+
log('daemon', `${sig} — exiting`);
|
|
386
|
+
process.exit(0);
|
|
387
|
+
});
|
|
388
|
+
}
|
|
389
|
+
// A pending promise alone does not keep Node alive; a timer does.
|
|
390
|
+
setInterval(() => { }, 2 ** 30);
|
|
391
|
+
return new Promise(() => { });
|
|
392
|
+
}
|
|
393
|
+
main().catch((err) => die(err instanceof Error ? (err.stack ?? err.message) : String(err)));
|
|
394
|
+
//# sourceMappingURL=daemon.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"daemon.js","sourceRoot":"","sources":["../src/daemon.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"eval-config.d.ts","sourceRoot":"","sources":["../src/eval-config.ts"],"names":[],"mappings":""}
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Evaluate a config repo's `concord.ts` and print its default export as JSON.
|
|
3
|
+
*
|
|
4
|
+
* node dist/eval-config.js <configDir>
|
|
5
|
+
*
|
|
6
|
+
* Runs as a SHORT-LIVED CHILD of the loader, never inside the daemon.
|
|
7
|
+
* tsx transpiles through esbuild's sync API: a worker thread plus a long-lived
|
|
8
|
+
* `esbuild` child process, created once per process and never recreated. When a
|
|
9
|
+
* signal killed that helper, every later config load in the daemon threw "The
|
|
10
|
+
* service is no longer running" until someone restarted it — while the daemon
|
|
11
|
+
* logged that it would try again next tick. A fresh process per evaluation has
|
|
12
|
+
* no helper to lose, and a config that hangs costs one cycle, not the daemon.
|
|
13
|
+
*
|
|
14
|
+
* Crossing the boundary as JSON is free because the config is already plain
|
|
15
|
+
* data.
|
|
16
|
+
*/
|
|
17
|
+
import { join } from 'node:path';
|
|
18
|
+
import { pathToFileURL } from 'node:url';
|
|
19
|
+
import { tsImport } from 'tsx/esm/api';
|
|
20
|
+
// stdout is the result channel. A debugging console.log in the config must not
|
|
21
|
+
// corrupt it — in-process evaluation always tolerated one.
|
|
22
|
+
console.log = console.info = console.debug = console.error;
|
|
23
|
+
try {
|
|
24
|
+
const dir = process.argv[2];
|
|
25
|
+
if (!dir)
|
|
26
|
+
throw new Error('usage: node dist/eval-config.js <configDir>');
|
|
27
|
+
const mod = (await tsImport(pathToFileURL(join(dir, 'concord.ts')).href, import.meta.url));
|
|
28
|
+
// A config repo without `"type": "module"` in its package.json is transpiled
|
|
29
|
+
// as CommonJS, and the ESM interop then nests the export one level deeper
|
|
30
|
+
// (`mod.default.default`). Tolerate both shapes — otherwise the failure
|
|
31
|
+
// surfaces as a baffling "schemaVersion undefined" rather than anything
|
|
32
|
+
// pointing at module format.
|
|
33
|
+
const raw = mod.default && mod.default.default !== undefined && mod.default.schemaVersion === undefined
|
|
34
|
+
? mod.default.default
|
|
35
|
+
: mod.default;
|
|
36
|
+
// `?? null`: JSON.stringify(undefined) is not a string. The loader names a
|
|
37
|
+
// missing default export. Exit explicitly after the flush — tsx's hooks
|
|
38
|
+
// thread keeps the process alive otherwise.
|
|
39
|
+
process.stdout.write(JSON.stringify(raw ?? null), () => process.exit(0));
|
|
40
|
+
}
|
|
41
|
+
catch (err) {
|
|
42
|
+
const text = err instanceof Error ? (err.stack ?? err.message) : String(err);
|
|
43
|
+
process.stderr.write(`${text}\n`, () => process.exit(1));
|
|
44
|
+
}
|
|
45
|
+
//# sourceMappingURL=eval-config.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"eval-config.js","sourceRoot":"","sources":["../src/eval-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAEtC,+EAA+E;AAC/E,2DAA2D;AAC3D,OAAO,CAAC,GAAG,GAAG,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAA;AAE1D,IAAI,CAAC;IACH,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IAC3B,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAA;IAExE,MAAM,GAAG,GAAG,CAAC,MAAM,QAAQ,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAExF,CAAA;IAED,6EAA6E;IAC7E,0EAA0E;IAC1E,wEAAwE;IACxE,wEAAwE;IACxE,6BAA6B;IAC7B,MAAM,GAAG,GACP,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,IAAI,GAAG,CAAC,OAAO,CAAC,aAAa,KAAK,SAAS;QACzF,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO;QACrB,CAAC,CAAC,GAAG,CAAC,OAAO,CAAA;IAEjB,2EAA2E;IAC3E,wEAAwE;IACxE,4CAA4C;IAC5C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;AAC1E,CAAC;AAAC,OAAO,GAAG,EAAE,CAAC;IACb,MAAM,IAAI,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IAC5E,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;AAC1D,CAAC"}
|
package/dist/exec.d.ts
ADDED
|
@@ -0,0 +1,168 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Host execution — the seam a remote transport slots into.
|
|
3
|
+
*
|
|
4
|
+
* Every host operation in every module goes through this interface, which is
|
|
5
|
+
* why adding SSH required no module changes: `apt`, `file`, `systemd`, `script`
|
|
6
|
+
* and `container` touch nothing else. (`porkbun` drives a remote API and never
|
|
7
|
+
* touches it at all — that is the line between a host-scoped module and
|
|
8
|
+
* an API-driving one.)
|
|
9
|
+
*
|
|
10
|
+
* Two rules hold for every call shape below: **no child may run forever**, and
|
|
11
|
+
* **a child that did not exit normally is reported as what happened to it** —
|
|
12
|
+
* timed out, killed by a signal — never as "exit 1".
|
|
13
|
+
*/
|
|
14
|
+
export interface ExecResult {
|
|
15
|
+
stdout: string;
|
|
16
|
+
status: number;
|
|
17
|
+
}
|
|
18
|
+
export interface ExecOptions {
|
|
19
|
+
timeoutMs?: number;
|
|
20
|
+
}
|
|
21
|
+
/** Ceiling on every host command unless the caller raises it. A stalled apt
|
|
22
|
+
* mirror or a hung ssh must fail the cycle, never hang the daemon. */
|
|
23
|
+
export declare const DEFAULT_TIMEOUT_MS = 600000;
|
|
24
|
+
export interface Exec {
|
|
25
|
+
/** Human-readable, for errors. */
|
|
26
|
+
readonly host: string;
|
|
27
|
+
/** Never throws on a non-zero exit — inspect `status`. */
|
|
28
|
+
run(cmd: string, args: string[], opts?: ExecOptions): ExecResult;
|
|
29
|
+
/** Throws with the command's own stderr on failure. */
|
|
30
|
+
sudo(args: string[], input?: string, opts?: ExecOptions): string;
|
|
31
|
+
/** stdout AND stderr merged — some tools report to stderr (docker compose). */
|
|
32
|
+
sudoCombined(args: string[], opts?: ExecOptions): {
|
|
33
|
+
output: string;
|
|
34
|
+
status: number;
|
|
35
|
+
};
|
|
36
|
+
/** Run a bash script. The body is passed via stdin, never spliced into a command. */
|
|
37
|
+
runScript(script: string, opts?: {
|
|
38
|
+
sudo?: boolean;
|
|
39
|
+
} & ExecOptions): {
|
|
40
|
+
output: string;
|
|
41
|
+
status: number;
|
|
42
|
+
};
|
|
43
|
+
readFileMaybe(path: string): string;
|
|
44
|
+
sudoReadFileMaybe(path: string): string;
|
|
45
|
+
statMaybe(path: string): {
|
|
46
|
+
uid: string;
|
|
47
|
+
gid: string;
|
|
48
|
+
mode: string;
|
|
49
|
+
mtime: number;
|
|
50
|
+
type: string;
|
|
51
|
+
} | null;
|
|
52
|
+
writeFileAsRoot(path: string, content: string, mode: string): void;
|
|
53
|
+
/** Cheap liveness probe. Lets an `optional` host be skipped rather than fail the run. */
|
|
54
|
+
reachable(): boolean;
|
|
55
|
+
}
|
|
56
|
+
export declare const sleep: (ms: number) => Promise<void>;
|
|
57
|
+
/**
|
|
58
|
+
* A script body, as `bash -s` receives it on stdin.
|
|
59
|
+
*
|
|
60
|
+
* `bash -s` reads its script from the same stdin that every command in it
|
|
61
|
+
* inherits, and it reads line by line as it goes. So a command that reads stdin
|
|
62
|
+
* (`ssh`, `docker exec -i`, `read`, `cat`) silently eats the rest of the script
|
|
63
|
+
* — and the script still exits 0, because the last command that DID run
|
|
64
|
+
* succeeded. A brace group is parsed in full before any of it runs, and
|
|
65
|
+
* `</dev/null` gives the commands inside it an empty stdin of their own. The
|
|
66
|
+
* closing brace sits on its own line so a body ending in a heredoc terminator
|
|
67
|
+
* or a comment still closes.
|
|
68
|
+
*/
|
|
69
|
+
export declare const scriptInput: (body: string) => string;
|
|
70
|
+
/**
|
|
71
|
+
* Exit status + human note for a child that may not have exited on its own.
|
|
72
|
+
* Shell conventions, so the numbers read like `timeout(1)` and bash:
|
|
73
|
+
* 124 = timed out, 128+n = killed by signal n, 127 = could not be run.
|
|
74
|
+
*
|
|
75
|
+
* A signal-killed child has `status: null`. Mapping that to 1 with empty output
|
|
76
|
+
* is how an operator's `systemctl kill` read as a flaky upload.
|
|
77
|
+
*/
|
|
78
|
+
export declare function settle(r: {
|
|
79
|
+
status: number | null;
|
|
80
|
+
signal: NodeJS.Signals | null;
|
|
81
|
+
error?: Error;
|
|
82
|
+
}, timeoutMs: number): {
|
|
83
|
+
status: number;
|
|
84
|
+
note: string;
|
|
85
|
+
};
|
|
86
|
+
/** `exit N`, or the note unbracketed — `timed out after 600s`, `killed by SIGHUP`. */
|
|
87
|
+
export declare function describeExit(status: number, note: string): string;
|
|
88
|
+
export declare class LocalExec implements Exec {
|
|
89
|
+
readonly host: string;
|
|
90
|
+
constructor(host: string);
|
|
91
|
+
/** Always. If local exec is broken there is nothing left to reconcile with. */
|
|
92
|
+
reachable(): boolean;
|
|
93
|
+
run(cmd: string, args: string[], opts?: ExecOptions): ExecResult;
|
|
94
|
+
sudo(args: string[], input?: string, opts?: ExecOptions): string;
|
|
95
|
+
sudoCombined(args: string[], opts?: ExecOptions): {
|
|
96
|
+
output: string;
|
|
97
|
+
status: number;
|
|
98
|
+
};
|
|
99
|
+
runScript(script: string, opts?: {
|
|
100
|
+
sudo?: boolean;
|
|
101
|
+
} & ExecOptions): {
|
|
102
|
+
output: string;
|
|
103
|
+
status: number;
|
|
104
|
+
};
|
|
105
|
+
readFileMaybe(path: string): string;
|
|
106
|
+
sudoReadFileMaybe(path: string): string;
|
|
107
|
+
statMaybe(path: string): {
|
|
108
|
+
uid: string;
|
|
109
|
+
gid: string;
|
|
110
|
+
mode: string;
|
|
111
|
+
mtime: number;
|
|
112
|
+
type: string;
|
|
113
|
+
} | null;
|
|
114
|
+
writeFileAsRoot(path: string, content: string, mode: string): void;
|
|
115
|
+
}
|
|
116
|
+
export interface SshTarget {
|
|
117
|
+
host: string;
|
|
118
|
+
ip: string;
|
|
119
|
+
user: string;
|
|
120
|
+
port?: number;
|
|
121
|
+
/** Private key material. Written to a 0600 temp file for the process lifetime. */
|
|
122
|
+
key?: string;
|
|
123
|
+
}
|
|
124
|
+
/**
|
|
125
|
+
* Remote execution over SSH.
|
|
126
|
+
*
|
|
127
|
+
* Connections are MULTIPLEXED (ControlMaster/ControlPersist): one TCP session
|
|
128
|
+
* per host, reused for every exec. Without it a module issuing dozens of execs
|
|
129
|
+
* pays a full handshake each time — roughly 100 ms versus 5 ms. This is the
|
|
130
|
+
* reason a worker process is unnecessary, since latency was its only real
|
|
131
|
+
* advantage.
|
|
132
|
+
*
|
|
133
|
+
* Commands are passed as ARGV to ssh, and script bodies over stdin, so nothing
|
|
134
|
+
* is spliced into a remote shell string. Shell quoting has been the single most
|
|
135
|
+
* common source of bugs in this project.
|
|
136
|
+
*/
|
|
137
|
+
export declare class SshExec implements Exec {
|
|
138
|
+
#private;
|
|
139
|
+
private readonly target;
|
|
140
|
+
readonly host: string;
|
|
141
|
+
constructor(target: SshTarget);
|
|
142
|
+
/** Release the multiplexed connection and remove the key file. */
|
|
143
|
+
close(): void;
|
|
144
|
+
reachable(): boolean;
|
|
145
|
+
run(cmd: string, args: string[], opts?: ExecOptions): ExecResult;
|
|
146
|
+
sudo(args: string[], input?: string, opts?: ExecOptions): string;
|
|
147
|
+
sudoCombined(args: string[], opts?: ExecOptions): {
|
|
148
|
+
output: string;
|
|
149
|
+
status: number;
|
|
150
|
+
};
|
|
151
|
+
runScript(script: string, opts?: {
|
|
152
|
+
sudo?: boolean;
|
|
153
|
+
} & ExecOptions): {
|
|
154
|
+
output: string;
|
|
155
|
+
status: number;
|
|
156
|
+
};
|
|
157
|
+
readFileMaybe(path: string): string;
|
|
158
|
+
sudoReadFileMaybe(path: string): string;
|
|
159
|
+
statMaybe(path: string): {
|
|
160
|
+
uid: string;
|
|
161
|
+
gid: string;
|
|
162
|
+
mode: string;
|
|
163
|
+
mtime: number;
|
|
164
|
+
type: string;
|
|
165
|
+
} | null;
|
|
166
|
+
writeFileAsRoot(path: string, content: string, mode: string): void;
|
|
167
|
+
}
|
|
168
|
+
//# sourceMappingURL=exec.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../src/exec.ts"],"names":[],"mappings":"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"}
|