@astrofoundry/pi-astro 0.40.25 → 0.40.26
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.
|
@@ -43,6 +43,8 @@ describe("approvals", () => {
|
|
|
43
43
|
expect(isRisky("edge", ["vps", "reboot", "--confirm", "--help"])).toBe(false);
|
|
44
44
|
expect(isRisky("proxmox", ["guests"])).toBe(false);
|
|
45
45
|
expect(isRisky("proxmox", ["set", "107", "memory=768"])).toBe(true);
|
|
46
|
+
expect(isRisky("proxmox", ["space-x", "set", "105", "memory=768"])).toBe(true);
|
|
47
|
+
expect(isRisky("proxmox", ["space-x", "guests"])).toBe(false);
|
|
46
48
|
expect(isRisky("proxmox", ["shutdown", "107", "--confirm"])).toBe(true);
|
|
47
49
|
expect(isRisky("security", ["decisions"])).toBe(false);
|
|
48
50
|
expect(isRisky("inference", ["nexus-restart", "embed"])).toBe(true);
|
|
@@ -42,7 +42,7 @@ export const RISKY: Readonly<Record<string, readonly RegExp[]>> = {
|
|
|
42
42
|
],
|
|
43
43
|
edge: [/^vps\s+deploy-nginx\b/],
|
|
44
44
|
backup: [/^(vzdump-run|host-backup-run|arcane-backup-run|gcs-run|restic-check-run|restic-restore|restore-clean)\b/],
|
|
45
|
-
proxmox: [/^(set|snapshot-create|start)\b/],
|
|
45
|
+
proxmox: [/^(space-x\s+)?(set|snapshot-create|start)\b/],
|
|
46
46
|
inference: [/^(nexus-restart|nexus-start)\b/],
|
|
47
47
|
// media has no entry: trendarr cannot delete anything, and adds and queue toggles run on the caller's request.
|
|
48
48
|
};
|
package/package.json
CHANGED
package/skills/proxmox/SKILL.md
CHANGED
|
@@ -1,12 +1,14 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: proxmox
|
|
3
|
-
description: How the proxmox specialist operates Proxmox VE on Pulsar through the proxmox tool.
|
|
3
|
+
description: How the proxmox specialist operates Proxmox VE on Pulsar (37) and SPACE-X (Mira) through the proxmox tool.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Proxmox specialist
|
|
7
7
|
|
|
8
8
|
Pulsar (`10.0.10.37`, Proxmox VE 9 on Debian 13, node name `pulsar`) runs every guest: VM 100 `arcane` (Docker platform), LXC 101 `hermes` (being retired by the operator; no specialist operates it), LXC 102 `backup` (GCS pusher), VM 103 `identity` (Zitadel), VM 104 `dmz` (Pomerium), LXC 105 `tailscale`, VM 106 `observability`, LXC 107 `technitium2`, LXC 108 `radius`. Storage `local-lvm` holds the disks, `unas-backup` the vzdump archives. The `proxmox` tool talks to the API with a token whose role allows audit everywhere and, on guests, power, snapshots, and CPU/memory/option/network settings; nothing else. `["--help"]` lists the commands.
|
|
9
9
|
|
|
10
|
+
SPACE-X (`10.1.10.37`, Proxmox VE 9 at Mira, node name `space-x`) runs LXC 100 `technitium3` (DNS cluster node) and LXC 105 `tailscale` (Mira's subnet router). Put `space-x` before any command to run it there, for example `["space-x", "guests"]`; without it every command runs on Pulsar. SPACE-X has the same restricted user `spc-proxmox@pve!cortex` with its own token, and the same forced-command key as Pulsar. SPACE-X has no backup storage yet.
|
|
11
|
+
|
|
10
12
|
## API commands
|
|
11
13
|
|
|
12
14
|
| Command | Effect |
|
|
@@ -23,6 +23,46 @@ interface ProxmoxConfig extends Record<string, string> {
|
|
|
23
23
|
|
|
24
24
|
const SHAPE = { apiUrl: "string", certSha256: "string", node: "string", pulsarHost: "string", pulsarUser: "string" } as const;
|
|
25
25
|
|
|
26
|
+
interface SpaceXConfig extends Record<string, string> {
|
|
27
|
+
spacexApiUrl: string;
|
|
28
|
+
spacexCertSha256: string;
|
|
29
|
+
spacexNode: string;
|
|
30
|
+
spacexHost: string;
|
|
31
|
+
spacexUser: string;
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
const SPACEX_SHAPE = { spacexApiUrl: "string", spacexCertSha256: "string", spacexNode: "string", spacexHost: "string", spacexUser: "string" } as const;
|
|
35
|
+
|
|
36
|
+
/** Pulsar at 37 is the default host; a leading `space-x` selects Mira's host. */
|
|
37
|
+
export const HOSTS = ["pulsar", "space-x"] as const;
|
|
38
|
+
export type HostName = (typeof HOSTS)[number];
|
|
39
|
+
|
|
40
|
+
/** One Proxmox host: its API, token fields, and forced-command SSH target. */
|
|
41
|
+
interface Target {
|
|
42
|
+
name: HostName;
|
|
43
|
+
apiUrl: string;
|
|
44
|
+
certSha256: string;
|
|
45
|
+
node: string;
|
|
46
|
+
sshHost: string;
|
|
47
|
+
sshUser: string;
|
|
48
|
+
tokenIdField: string;
|
|
49
|
+
tokenSecretField: string;
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
export function splitHost(args: string[]): { host: HostName; rest: string[] } {
|
|
53
|
+
return args[0] === "space-x" ? { host: "space-x", rest: args.slice(1) } : { host: "pulsar", rest: args };
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
function readTarget(host: HostName): Target {
|
|
57
|
+
if (host === "space-x") {
|
|
58
|
+
const c = readConfig<SpaceXConfig>(SERVICE, SPACEX_SHAPE);
|
|
59
|
+
// SPACE-X trusts the same forced-command key as Pulsar (SSH_KEY_PULSAR); its API token is its own.
|
|
60
|
+
return { name: host, apiUrl: c.spacexApiUrl, certSha256: c.spacexCertSha256, node: c.spacexNode, sshHost: c.spacexHost, sshUser: c.spacexUser, tokenIdField: "PVE_SPACEX_TOKEN_ID", tokenSecretField: "PVE_SPACEX_TOKEN_SECRET" };
|
|
61
|
+
}
|
|
62
|
+
const c = readConfig<ProxmoxConfig>(SERVICE, SHAPE);
|
|
63
|
+
return { name: host, apiUrl: c.apiUrl, certSha256: c.certSha256, node: c.node, sshHost: c.pulsarHost, sshUser: c.pulsarUser, tokenIdField: "PVE_TOKEN_ID", tokenSecretField: "PVE_TOKEN_SECRET" };
|
|
64
|
+
}
|
|
65
|
+
|
|
26
66
|
const TIMEOUT_MS = 30_000;
|
|
27
67
|
const TASK_POLL_MS = 2_000;
|
|
28
68
|
const VMID = /^\d{3,9}$/;
|
|
@@ -50,7 +90,9 @@ export const HOST_COMMANDS: Readonly<Record<string, { args: number; help: string
|
|
|
50
90
|
export const GUEST_EXEC = ["status", "journal", "df", "updates"];
|
|
51
91
|
const SINCE = /^[A-Za-z0-9 :\-+]{1,40}$/;
|
|
52
92
|
|
|
53
|
-
const HELP = `proxmox specialist (Proxmox VE on Pulsar)
|
|
93
|
+
const HELP = `proxmox specialist (Proxmox VE on Pulsar at 37 and SPACE-X at Mira)
|
|
94
|
+
|
|
95
|
+
[space-x] <command> every command below runs on Pulsar, or on SPACE-X with the space-x prefix
|
|
54
96
|
|
|
55
97
|
guests every VM and container: vmid, name, type, status, resources (JSON)
|
|
56
98
|
guest <vmid> current status and configuration of one guest (JSON)
|
|
@@ -90,9 +132,9 @@ interface GuestResource {
|
|
|
90
132
|
tags?: string;
|
|
91
133
|
}
|
|
92
134
|
|
|
93
|
-
async function api(config:
|
|
94
|
-
const tokenId = readSecret(SERVICE,
|
|
95
|
-
const secret = readSecret(SERVICE,
|
|
135
|
+
async function api(config: Target, method: string, path: string, form?: Record<string, string>): Promise<unknown> {
|
|
136
|
+
const tokenId = readSecret(SERVICE, config.tokenIdField);
|
|
137
|
+
const secret = readSecret(SERVICE, config.tokenSecretField);
|
|
96
138
|
const body = form === undefined ? undefined : new URLSearchParams(form).toString();
|
|
97
139
|
const response = await pinnedRequest(new URL(`/api2/json${path}`, config.apiUrl), {
|
|
98
140
|
method,
|
|
@@ -147,7 +189,7 @@ export function needsConfirm(args: string[]): string[] {
|
|
|
147
189
|
return args.filter((_, i) => i !== index);
|
|
148
190
|
}
|
|
149
191
|
|
|
150
|
-
async function guestResource(config:
|
|
192
|
+
async function guestResource(config: Target, vmid: number): Promise<GuestResource> {
|
|
151
193
|
const resources = (await api(config, "GET", "/cluster/resources?type=vm")) as GuestResource[];
|
|
152
194
|
const guest = resources.find((r) => r.vmid === vmid);
|
|
153
195
|
if (!guest) throw new UsageError(`no guest with vmid ${vmid}`);
|
|
@@ -166,7 +208,7 @@ interface TaskStatus {
|
|
|
166
208
|
endtime?: number;
|
|
167
209
|
}
|
|
168
210
|
|
|
169
|
-
async function waitTask(config:
|
|
211
|
+
async function waitTask(config: Target, upid: string, timeoutMs: number): Promise<TaskStatus> {
|
|
170
212
|
const deadline = Date.now() + timeoutMs;
|
|
171
213
|
for (;;) {
|
|
172
214
|
const status = (await api(config, "GET", `/nodes/${config.node}/tasks/${encodeURIComponent(upid)}/status`)) as TaskStatus;
|
|
@@ -176,7 +218,7 @@ async function waitTask(config: ProxmoxConfig, upid: string, timeoutMs: number):
|
|
|
176
218
|
}
|
|
177
219
|
}
|
|
178
220
|
|
|
179
|
-
async function runTask(config:
|
|
221
|
+
async function runTask(config: Target, method: string, path: string, form: Record<string, string> | undefined, label: string): Promise<number> {
|
|
180
222
|
const upid = (await api(config, method, path, form)) as string;
|
|
181
223
|
const status = await waitTask(config, upid, 300_000);
|
|
182
224
|
printJson({ action: label, upid, exitstatus: status.exitstatus, endtime: status.endtime });
|
|
@@ -184,7 +226,7 @@ async function runTask(config: ProxmoxConfig, method: string, path: string, form
|
|
|
184
226
|
return 0;
|
|
185
227
|
}
|
|
186
228
|
|
|
187
|
-
async function apiCommand(config:
|
|
229
|
+
async function apiCommand(config: Target, args: string[]): Promise<number> {
|
|
188
230
|
const [name, ...rest] = args;
|
|
189
231
|
switch (name) {
|
|
190
232
|
case "guests": {
|
|
@@ -293,12 +335,12 @@ export function buildHostRemote(args: string[]): string {
|
|
|
293
335
|
return [name, ...rest].join(" ");
|
|
294
336
|
}
|
|
295
337
|
|
|
296
|
-
async function host(config:
|
|
338
|
+
async function host(config: Target, args: string[]): Promise<number> {
|
|
297
339
|
const remote = buildHostRemote(args);
|
|
298
340
|
const result = await sshFixed(
|
|
299
341
|
{
|
|
300
|
-
host: config.
|
|
301
|
-
user: config.
|
|
342
|
+
host: config.sshHost,
|
|
343
|
+
user: config.sshUser,
|
|
302
344
|
keyFile: secretPath(SERVICE, "SSH_KEY_PULSAR"),
|
|
303
345
|
knownHostsFile: join(specialistsHome(), "config", "known_hosts"),
|
|
304
346
|
},
|
|
@@ -315,14 +357,15 @@ export async function command(args: string[]): Promise<number> {
|
|
|
315
357
|
printRaw(HELP);
|
|
316
358
|
return 0;
|
|
317
359
|
}
|
|
318
|
-
const
|
|
319
|
-
|
|
360
|
+
const { host: hostName, rest } = splitHost(args);
|
|
361
|
+
const config = readTarget(hostName);
|
|
362
|
+
if (rest[0] === "fingerprint") {
|
|
320
363
|
const probe = await pinnedRequest(new URL("/", config.apiUrl), { method: "GET", headers: {}, expectedFingerprint: null, timeoutMs: TIMEOUT_MS });
|
|
321
364
|
printJson({ host: new URL(config.apiUrl).host, fingerprint256: probe.fingerprint });
|
|
322
365
|
return 0;
|
|
323
366
|
}
|
|
324
|
-
if (
|
|
325
|
-
return apiCommand(config,
|
|
367
|
+
if (rest[0] !== undefined && rest[0] in HOST_COMMANDS) return host(config, rest);
|
|
368
|
+
return apiCommand(config, rest);
|
|
326
369
|
}
|
|
327
370
|
|
|
328
371
|
if (process.argv[1] && import.meta.url === new URL(`file://${process.argv[1]}`).href) {
|
|
@@ -12,7 +12,7 @@ import { MAX_ADD_IDS, MAX_EXCLUDE_IDS, buildTrendarrCall, interpretRun, parseImd
|
|
|
12
12
|
import { ServiceError, UsageError } from "./lib/errors.ts";
|
|
13
13
|
import { safeRepoPath, safeWritePath } from "./lib/repo.ts";
|
|
14
14
|
import { appGetPath, buildPulsarRemote, cloudPath, deviceNetworkWrite, NAT_PATH, natWrite, parseQuery, parseSiteArgs, unifiPath, unifiWrite, command as networkCommand } from "./network/run.ts";
|
|
15
|
-
import { buildHostRemote, needsConfirm, parseSetPairs, parseVmid, validateApiPath as validatePvePath, command as proxmoxCommand } from "./proxmox/run.ts";
|
|
15
|
+
import { buildHostRemote, splitHost, needsConfirm, parseSetPairs, parseVmid, validateApiPath as validatePvePath, command as proxmoxCommand } from "./proxmox/run.ts";
|
|
16
16
|
import { banLength, buildObsRemote, compactDecisions, parseGoDuration, summariseAlerts, summariseVulns, summariseWazuh, vulnEvents, wazuhEvents, command as securityCommand } from "./security/run.ts";
|
|
17
17
|
|
|
18
18
|
describe("arcane wrapper", () => {
|
|
@@ -600,6 +600,8 @@ describe("proxmox wrapper", () => {
|
|
|
600
600
|
});
|
|
601
601
|
|
|
602
602
|
it("maps host commands to fixed remote strings", () => {
|
|
603
|
+
expect(splitHost(["space-x", "guests"])).toEqual({ host: "space-x", rest: ["guests"] });
|
|
604
|
+
expect(splitHost(["guests"])).toEqual({ host: "pulsar", rest: ["guests"] });
|
|
603
605
|
expect(buildHostRemote(["host-status"])).toBe("host-status");
|
|
604
606
|
expect(buildHostRemote(["guest-exec", "101", "df"])).toBe("guest-exec 101 df");
|
|
605
607
|
expect(() => buildHostRemote(["guest-exec", "101", "rm"])).toThrow(/action/);
|