@homeflare/alchemy 0.11.0 → 0.13.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/README.md +3 -3
- package/dist/caddy/admin-guard.d.ts +1 -1
- package/dist/caddy/index.js.map +2 -2
- package/dist/cloudflare/client.d.ts +1 -1
- package/dist/cloudflare/index.js.map +2 -2
- package/dist/cloudflare/lock-rules.d.ts +1 -1
- package/dist/forgejo/branch-protection-form.d.ts +1 -1
- package/dist/forgejo/branch-protection.d.ts +1 -1
- package/dist/forgejo/index.js.map +10 -10
- package/dist/forgejo/org-actions-secrets.d.ts +1 -1
- package/dist/forgejo/org-label.d.ts +1 -1
- package/dist/forgejo/org-team.d.ts +1 -1
- package/dist/forgejo/repo-webhook.d.ts +1 -1
- package/dist/forgejo/repository.d.ts +2 -2
- package/dist/forgejo/repository.d.ts.map +1 -1
- package/dist/forgejo/resource.d.ts +2 -2
- package/dist/forgejo/team-member.d.ts +1 -1
- package/dist/openbao/auth-role.d.ts +1 -1
- package/dist/openbao/bao-http.d.ts +4 -4
- package/dist/openbao/cloudflare-permission-groups.d.ts +1 -1
- package/dist/openbao/cloudflare-role-form.d.ts +2 -2
- package/dist/openbao/cloudflare-role-form.d.ts.map +1 -1
- package/dist/openbao/cloudflare-roles-expand.d.ts +1 -1
- package/dist/openbao/digest.d.ts +1 -1
- package/dist/openbao/forgejo-bootstrap-parse.d.ts +2 -2
- package/dist/openbao/forgejo-bootstrap-parse.d.ts.map +1 -1
- package/dist/openbao/forgejo-bootstrap.d.ts +1 -1
- package/dist/openbao/index.js.map +14 -14
- package/dist/openbao/mount.d.ts +1 -1
- package/dist/openbao/pki-role.d.ts +1 -1
- package/dist/openbao/policy.d.ts +2 -2
- package/dist/openbao/proxmox-role-form.d.ts +2 -2
- package/dist/openbao/proxmox-role-form.d.ts.map +1 -1
- package/dist/openbao/proxmox-role.d.ts +10 -10
- package/dist/openbao/ssh-role.d.ts +3 -3
- package/dist/proxmox/acl.d.ts +2 -2
- package/dist/proxmox/acl.d.ts.map +1 -1
- package/dist/proxmox/alertmanager-body.d.ts +54 -0
- package/dist/proxmox/alertmanager-body.d.ts.map +1 -0
- package/dist/proxmox/api-token-form.d.ts +2 -2
- package/dist/proxmox/api-token.d.ts +11 -11
- package/dist/proxmox/ceph-daemon-form.d.ts +3 -3
- package/dist/proxmox/ceph-daemon.d.ts +19 -19
- package/dist/proxmox/ceph-daemon.d.ts.map +1 -1
- package/dist/proxmox/ceph-flag.d.ts +5 -5
- package/dist/proxmox/ceph-fs-wire.d.ts +5 -5
- package/dist/proxmox/ceph-fs.d.ts +16 -16
- package/dist/proxmox/ceph-osd-tree.d.ts +16 -16
- package/dist/proxmox/ceph-osd.d.ts +5 -5
- package/dist/proxmox/ceph-pool-form.d.ts +13 -13
- package/dist/proxmox/ceph-pool-form.d.ts.map +1 -1
- package/dist/proxmox/ceph-pool.d.ts +3 -3
- package/dist/proxmox/client.d.ts +2 -2
- package/dist/proxmox/credential-literals.d.ts +36 -0
- package/dist/proxmox/credential-literals.d.ts.map +1 -0
- package/dist/proxmox/credentials.d.ts +8 -8
- package/dist/proxmox/credentials.d.ts.map +1 -1
- package/dist/proxmox/fake-pbs-notify.d.ts +23 -0
- package/dist/proxmox/fake-pbs-notify.d.ts.map +1 -0
- package/dist/proxmox/fake-pve.d.ts +5 -0
- package/dist/proxmox/fake-pve.d.ts.map +1 -1
- package/dist/proxmox/firewall-alias-form.d.ts +1 -1
- package/dist/proxmox/firewall-alias.d.ts +1 -1
- package/dist/proxmox/generated/pbs.d.ts +279 -1
- package/dist/proxmox/generated/pbs.d.ts.map +1 -1
- package/dist/proxmox/generated/pve.d.ts +58 -1
- package/dist/proxmox/generated/pve.d.ts.map +1 -1
- package/dist/proxmox/group.d.ts +8 -8
- package/dist/proxmox/ha-resource.d.ts +3 -2
- package/dist/proxmox/ha-resource.d.ts.map +1 -1
- package/dist/proxmox/ha-rule-form.d.ts +5 -5
- package/dist/proxmox/ha-rule.d.ts +3 -3
- package/dist/proxmox/index.d.ts +14 -0
- package/dist/proxmox/index.d.ts.map +1 -1
- package/dist/proxmox/index.js +935 -223
- package/dist/proxmox/index.js.map +69 -56
- package/dist/proxmox/lease-cache.d.ts +4 -4
- package/dist/proxmox/lxc-harness.d.ts +1 -1
- package/dist/proxmox/lxc-props.d.ts +2 -2
- package/dist/proxmox/lxc.d.ts +3 -3
- package/dist/proxmox/members.d.ts +3 -3
- package/dist/proxmox/network-apply-read.d.ts +5 -5
- package/dist/proxmox/network-apply.d.ts +9 -9
- package/dist/proxmox/node-network-form.d.ts +6 -6
- package/dist/proxmox/node-network.d.ts +17 -17
- package/dist/proxmox/node-network.d.ts.map +1 -1
- package/dist/proxmox/notification-matcher-form.d.ts +100 -0
- package/dist/proxmox/notification-matcher-form.d.ts.map +1 -0
- package/dist/proxmox/notification-matcher.d.ts +46 -0
- package/dist/proxmox/notification-matcher.d.ts.map +1 -0
- package/dist/proxmox/notification-target.d.ts +3 -2
- package/dist/proxmox/notification-target.d.ts.map +1 -1
- package/dist/proxmox/pbs-datastore-guard.d.ts +1 -1
- package/dist/proxmox/pbs-datastore.d.ts +10 -10
- package/dist/proxmox/pbs-notification-matcher.d.ts +53 -0
- package/dist/proxmox/pbs-notification-matcher.d.ts.map +1 -0
- package/dist/proxmox/pbs-notification-target-form.d.ts +63 -0
- package/dist/proxmox/pbs-notification-target-form.d.ts.map +1 -0
- package/dist/proxmox/pbs-notification-target-lifecycle.d.ts +100 -0
- package/dist/proxmox/pbs-notification-target-lifecycle.d.ts.map +1 -0
- package/dist/proxmox/pbs-notification-target-wire.d.ts +30 -0
- package/dist/proxmox/pbs-notification-target-wire.d.ts.map +1 -0
- package/dist/proxmox/pbs-notification-target.d.ts +123 -0
- package/dist/proxmox/pbs-notification-target.d.ts.map +1 -0
- package/dist/proxmox/pbs-prune-job.d.ts +2 -2
- package/dist/proxmox/pbs-sync-job.d.ts +4 -4
- package/dist/proxmox/pbs-verify-job.d.ts +1 -1
- package/dist/proxmox/pool.d.ts +4 -4
- package/dist/proxmox/provision-baseline.d.ts +74 -0
- package/dist/proxmox/provision-baseline.d.ts.map +1 -0
- package/dist/proxmox/provision-bootstrap.d.ts +33 -0
- package/dist/proxmox/provision-bootstrap.d.ts.map +1 -0
- package/dist/proxmox/provision-cli-fake.d.ts +38 -0
- package/dist/proxmox/provision-cli-fake.d.ts.map +1 -0
- package/dist/proxmox/provision-declare.d.ts +25 -0
- package/dist/proxmox/provision-declare.d.ts.map +1 -0
- package/dist/proxmox/replication-job.d.ts +9 -8
- package/dist/proxmox/replication-job.d.ts.map +1 -1
- package/dist/proxmox/resource.d.ts +6 -5
- package/dist/proxmox/resource.d.ts.map +1 -1
- package/dist/proxmox/sdn-apply-read.d.ts +7 -7
- package/dist/proxmox/sdn-apply.d.ts +1 -1
- package/dist/proxmox/sdn-subnet-form.d.ts +1 -1
- package/dist/proxmox/sdn-subnet.d.ts +5 -5
- package/dist/proxmox/sdn-vnet.d.ts +5 -6
- package/dist/proxmox/sdn-vnet.d.ts.map +1 -1
- package/dist/proxmox/storage.d.ts +4 -3
- package/dist/proxmox/storage.d.ts.map +1 -1
- package/dist/proxmox/user.d.ts +3 -2
- package/dist/proxmox/user.d.ts.map +1 -1
- package/dist/proxmox/values.d.ts +1 -1
- package/dist/proxmox/write-only.d.ts +35 -0
- package/dist/proxmox/write-only.d.ts.map +1 -0
- package/dist/proxmox/zfs-pool-write.d.ts +1 -1
- package/dist/proxmox/zfs-pool.d.ts +5 -5
- package/dist/talos/credentials.d.ts +1 -1
- package/dist/talos/credentials.d.ts.map +1 -1
- package/dist/talos/index.js.map +1 -1
- package/dist/verify/fake-engine.d.ts +5 -0
- package/dist/verify/fake-engine.d.ts.map +1 -1
- package/docs/adopt-verify.md +21 -5
- package/docs/adopted-deploys.md +9 -1
- package/docs/ownership.md +26 -1
- package/docs/pbs-alertmanager-body.md +73 -0
- package/docs/pbs-notifications.md +163 -0
- package/docs/provision-baseline.md +106 -0
- package/docs/proxmox-lxc-adopt.md +2 -2
- package/docs/proxmox-lxc.md +5 -4
- package/docs/proxmox.md +9 -0
- package/package.json +1 -1
- package/src/caddy/admin-guard.ts +1 -1
- package/src/caddy/local-admin.ts +1 -1
- package/src/cloudflare/client.ts +1 -1
- package/src/cloudflare/lock-rules.ts +1 -1
- package/src/forgejo/branch-protection-form.ts +1 -1
- package/src/forgejo/branch-protection.ts +1 -1
- package/src/forgejo/client.ts +1 -1
- package/src/forgejo/org-actions-secrets.ts +1 -1
- package/src/forgejo/org-label.ts +1 -1
- package/src/forgejo/org-team.ts +1 -1
- package/src/forgejo/repo-webhook.ts +1 -1
- package/src/forgejo/repository.ts +2 -2
- package/src/forgejo/resource.ts +2 -2
- package/src/forgejo/team-member.ts +1 -1
- package/src/openbao/README.md +4 -4
- package/src/openbao/auth-role.ts +1 -1
- package/src/openbao/bao-http.test.ts +2 -2
- package/src/openbao/bao-http.ts +6 -6
- package/src/openbao/bao-status.test.ts +1 -1
- package/src/openbao/bao-status.ts +1 -1
- package/src/openbao/cloudflare-group-scope.test.ts +1 -1
- package/src/openbao/cloudflare-permission-groups.test.ts +1 -1
- package/src/openbao/cloudflare-permission-groups.ts +3 -3
- package/src/openbao/cloudflare-policy.ts +1 -1
- package/src/openbao/cloudflare-role-form.ts +2 -2
- package/src/openbao/cloudflare-roles-expand.ts +1 -1
- package/src/openbao/digest.ts +1 -1
- package/src/openbao/forgejo-bootstrap-parse.test.ts +3 -3
- package/src/openbao/forgejo-bootstrap-parse.ts +2 -2
- package/src/openbao/forgejo-bootstrap.ts +4 -4
- package/src/openbao/kubernetes-role-form.test.ts +5 -5
- package/src/openbao/mount.ts +1 -1
- package/src/openbao/pki-role.ts +1 -1
- package/src/openbao/policy-wire.test.ts +3 -3
- package/src/openbao/policy.ts +2 -2
- package/src/openbao/proxmox-role-form.ts +5 -5
- package/src/openbao/proxmox-role.ts +11 -11
- package/src/openbao/ssh-role.ts +3 -3
- package/src/proxmox/acl.ts +4 -4
- package/src/proxmox/adopt-noop.test.ts +6 -6
- package/src/proxmox/alertmanager-body.ts +125 -0
- package/src/proxmox/api-token-form.ts +4 -4
- package/src/proxmox/api-token.ts +13 -13
- package/src/proxmox/ceph-daemon-form.ts +3 -3
- package/src/proxmox/ceph-daemon.ts +20 -20
- package/src/proxmox/ceph-flag.ts +7 -7
- package/src/proxmox/ceph-fs-wire.ts +7 -7
- package/src/proxmox/ceph-fs.ts +18 -18
- package/src/proxmox/ceph-osd-tree.ts +16 -16
- package/src/proxmox/ceph-osd.ts +6 -6
- package/src/proxmox/ceph-pool-adopt.test.ts +14 -14
- package/src/proxmox/ceph-pool-form.ts +13 -13
- package/src/proxmox/ceph-pool.ts +6 -6
- package/src/proxmox/client.test.ts +3 -3
- package/src/proxmox/client.ts +3 -3
- package/src/proxmox/credential-literals.test.ts +148 -0
- package/src/proxmox/credential-literals.ts +74 -0
- package/src/proxmox/credentials.test.ts +6 -8
- package/src/proxmox/credentials.ts +8 -8
- package/src/proxmox/fake-pbs-notify.ts +108 -0
- package/src/proxmox/fake-pve.ts +12 -2
- package/src/proxmox/firewall-alias-form.ts +1 -1
- package/src/proxmox/firewall-alias.ts +1 -1
- package/src/proxmox/generated/pbs.ts +330 -1
- package/src/proxmox/generated/pve.ts +63 -1
- package/src/proxmox/group.ts +10 -10
- package/src/proxmox/ha-resource.ts +3 -2
- package/src/proxmox/ha-rule-form.ts +5 -5
- package/src/proxmox/ha-rule.ts +3 -3
- package/src/proxmox/index.test.ts +10 -0
- package/src/proxmox/index.ts +32 -0
- package/src/proxmox/lease-cache.test.ts +19 -19
- package/src/proxmox/lease-cache.ts +4 -4
- package/src/proxmox/lxc-adopt.test.ts +3 -3
- package/src/proxmox/lxc-create-form.ts +1 -1
- package/src/proxmox/lxc-guards.test.ts +4 -4
- package/src/proxmox/lxc-harness.ts +3 -3
- package/src/proxmox/lxc-judge.test.ts +5 -5
- package/src/proxmox/lxc-lifecycle.ts +1 -1
- package/src/proxmox/lxc-props.ts +2 -2
- package/src/proxmox/lxc-read.test.ts +3 -3
- package/src/proxmox/lxc-strict-adopt.test.ts +1 -1
- package/src/proxmox/lxc-volume.test.ts +9 -9
- package/src/proxmox/lxc-volume.ts +1 -1
- package/src/proxmox/lxc-wire.ts +1 -1
- package/src/proxmox/lxc.ts +3 -3
- package/src/proxmox/members.test.ts +1 -1
- package/src/proxmox/members.ts +3 -3
- package/src/proxmox/metric-server-otel.ts +2 -2
- package/src/proxmox/network-apply-read.ts +10 -10
- package/src/proxmox/network-apply.ts +10 -10
- package/src/proxmox/node-network-form.ts +7 -7
- package/src/proxmox/node-network.ts +18 -18
- package/src/proxmox/notification-matcher-form.ts +221 -0
- package/src/proxmox/notification-matcher.test.ts +234 -0
- package/src/proxmox/notification-matcher.ts +76 -0
- package/src/proxmox/notification-target.ts +3 -2
- package/src/proxmox/pbs-datastore-guard.ts +1 -1
- package/src/proxmox/pbs-datastore.ts +10 -10
- package/src/proxmox/pbs-notification-matcher.ts +81 -0
- package/src/proxmox/pbs-notification-target-drift.test.ts +83 -0
- package/src/proxmox/pbs-notification-target-form.ts +229 -0
- package/src/proxmox/pbs-notification-target-lifecycle.ts +177 -0
- package/src/proxmox/pbs-notification-target-state.test.ts +191 -0
- package/src/proxmox/pbs-notification-target-wire.ts +112 -0
- package/src/proxmox/pbs-notification-target.test.ts +226 -0
- package/src/proxmox/pbs-notification-target.ts +139 -0
- package/src/proxmox/pbs-notifications-stack.test.ts +94 -0
- package/src/proxmox/pbs-prune-job.ts +2 -2
- package/src/proxmox/pbs-sync-job.ts +4 -4
- package/src/proxmox/pbs-verify-job.ts +1 -1
- package/src/proxmox/pool.test.ts +2 -2
- package/src/proxmox/pool.ts +4 -4
- package/src/proxmox/provision-baseline.test.ts +87 -0
- package/src/proxmox/provision-baseline.ts +162 -0
- package/src/proxmox/provision-bootstrap.test.ts +132 -0
- package/src/proxmox/provision-bootstrap.ts +135 -0
- package/src/proxmox/provision-cli-fake.ts +217 -0
- package/src/proxmox/provision-declare.test.ts +111 -0
- package/src/proxmox/provision-declare.ts +103 -0
- package/src/proxmox/replication-job.ts +9 -8
- package/src/proxmox/resource.ts +9 -9
- package/src/proxmox/sdn-apply-read.test.ts +16 -16
- package/src/proxmox/sdn-apply-read.ts +7 -7
- package/src/proxmox/sdn-apply.ts +3 -3
- package/src/proxmox/sdn-subnet-form.ts +1 -1
- package/src/proxmox/sdn-subnet.ts +5 -5
- package/src/proxmox/sdn-vnet.ts +5 -6
- package/src/proxmox/storage.ts +4 -3
- package/src/proxmox/user.ts +3 -2
- package/src/proxmox/values.test.ts +2 -2
- package/src/proxmox/values.ts +1 -1
- package/src/proxmox/write-only.test.ts +75 -0
- package/src/proxmox/write-only.ts +106 -0
- package/src/proxmox/zfs-pool-write.ts +1 -1
- package/src/proxmox/zfs-pool.ts +6 -6
- package/src/talos/credentials.ts +3 -3
- package/src/talos/values.test.ts +9 -9
- package/src/verify/cli.test.ts +1 -1
- package/src/verify/fake-engine.ts +8 -1
|
@@ -11,13 +11,13 @@
|
|
|
11
11
|
* `CephOsdProps` is a cycle on paper only: it is erased before anything runs.
|
|
12
12
|
*
|
|
13
13
|
* ⛔ `GET /nodes/{node}/ceph/osd` ANSWERS A TREE, NOT A LIST, AND IT IS THE WHOLE CLUSTER'S TREE.
|
|
14
|
-
* MEASURED 2026-09-13: asked of
|
|
15
|
-
* leaves include osd.0 and osd.5 on
|
|
14
|
+
* MEASURED 2026-09-13: asked of node-b it answers `{"flags":…,"root":{"children":[…]}}` whose
|
|
15
|
+
* leaves include osd.0 and osd.5 on node-d; asked of node-c it answers the identical six leaves. The
|
|
16
16
|
* `{node}` in the path chooses WHO ANSWERS, not what is listed. A provider that read it as "the
|
|
17
|
-
* OSDs on this node" would find osd.0 through
|
|
17
|
+
* OSDs on this node" would find osd.0 through node-b and then report it as living there.
|
|
18
18
|
*
|
|
19
19
|
* ⛔ AND THE SINGLE-OBJECT PATH CANNOT BE USED INSTEAD — THIS WALK EXISTS BECAUSE IT LIES.
|
|
20
|
-
* MEASURED: `GET /nodes/
|
|
20
|
+
* MEASURED: `GET /nodes/node-b/ceph/osd/99`, an id with no OSD behind it, answers HTTP 200 with
|
|
21
21
|
* `[{"name":"metadata"},{"name":"lv-info"}]` — byte for byte what `…/osd/2` answers for a real
|
|
22
22
|
* one. It is a directory index (its schema says `permissions: {"user":"all"}`), not a read of
|
|
23
23
|
* the OSD. Point `PveSpec.path` at it and every declared OSD is "present": `diff` reports
|
|
@@ -25,18 +25,18 @@
|
|
|
25
25
|
* stops this package recording objects that do not exist — passes on an OSD that was never
|
|
26
26
|
* built. The only endpoint that can tell present from absent is the tree.
|
|
27
27
|
*
|
|
28
|
-
* ★ MEASURED ON
|
|
28
|
+
* ★ MEASURED ON C1 ON 2026-09-13, `GET /nodes/node-b/ceph/osd`. Six leaves, all `up` and `in`, Ceph
|
|
29
29
|
* 20.2.2 tentacle:
|
|
30
30
|
*
|
|
31
|
-
* id name host
|
|
32
|
-
* 0 osd.0
|
|
33
|
-
* 5 osd.5
|
|
34
|
-
* 1 osd.1
|
|
35
|
-
* 4 osd.4
|
|
36
|
-
* 2 osd.2
|
|
37
|
-
* 3 osd.3
|
|
31
|
+
* id name host device_class crush_weight reweight pgs status
|
|
32
|
+
* 0 osd.0 node-d ssd 1.86299133300781 1 99 up
|
|
33
|
+
* 5 osd.5 node-d ssd 1.86299133300781 1 94 up
|
|
34
|
+
* 1 osd.1 node-c ssd 1.86299133300781 1 96 up
|
|
35
|
+
* 4 osd.4 node-c ssd 1.81939697265625 1 97 up
|
|
36
|
+
* 2 osd.2 node-b ssd 1.81939697265625 1 88 up
|
|
37
|
+
* 3 osd.3 node-b ssd 1.81939697265625 1 105 up
|
|
38
38
|
*
|
|
39
|
-
* `{ node: '
|
|
39
|
+
* `{ node: 'node-b', osdid: 2, host: 'node-b', device_class: 'ssd' }` plans `noop` against that row.
|
|
40
40
|
* That is the acceptance test this file was written to pass.
|
|
41
41
|
*
|
|
42
42
|
* ⚠️ EVERY OTHER COLUMN IS REPORTED AND NEVER COMPARED, FOR FOUR DIFFERENT REASONS. `pgs` is the
|
|
@@ -63,8 +63,8 @@ type CrushNode = Record<string, unknown>;
|
|
|
63
63
|
/**
|
|
64
64
|
* Every OSD leaf under the tree root, at any depth.
|
|
65
65
|
*
|
|
66
|
-
* ⚠️ RECURSIVE BECAUSE THE TREE IS NOT THREE LEVELS DEEP BY LAW.
|
|
67
|
-
* root(`default`) -> host(
|
|
66
|
+
* ⚠️ RECURSIVE BECAUSE THE TREE IS NOT THREE LEVELS DEEP BY LAW. C1 measures as
|
|
67
|
+
* root(`default`) -> host(node-b|node-c|node-d) -> osd, but CRUSH admits datacenter, rack and chassis
|
|
68
68
|
* buckets between them, and an OSD created outside a host bucket hangs off the root. Reaching
|
|
69
69
|
* in as `root.children[].children[]` would read this cluster correctly and answer "absent" —
|
|
70
70
|
* i.e. "the replica is gone" — on the first cluster that has a rack in it.
|
|
@@ -128,7 +128,7 @@ export interface CephOsdAttributes {
|
|
|
128
128
|
* ⚠️ THE TELEMETRY IS DELIBERATELY DROPPED, NOT FORGOTTEN. The leaf also carries `bytes_used`,
|
|
129
129
|
* `percent_used`, `apply_latency_ms` and `commit_latency_ms`. MEASURED, AND THE MEASUREMENT SAYS
|
|
130
130
|
* THE OPPOSITE OF WHAT YOU WOULD EXPECT: across two reads minutes apart, all four were identical
|
|
131
|
-
* on every OSD, and both latencies read 0 —
|
|
131
|
+
* on every OSD, and both latencies read 0 — C1 was idle, so nothing was caught in the act. That
|
|
132
132
|
* these move is therefore REASONED, from what they count, not observed. Alchemy persists
|
|
133
133
|
* attributes; on a cluster doing work, keeping them would rewrite all six resources' state on
|
|
134
134
|
* every deploy and record a number that is stale by the time anybody reads it. What is kept is
|
|
@@ -11,7 +11,7 @@
|
|
|
11
11
|
*
|
|
12
12
|
* A PVE method with no permissions block is refused to every identity except `root@pam`, so an
|
|
13
13
|
* OpenBao-minted `hf-provision@pve!…` token is answered 403 however wide its role — widening
|
|
14
|
-
*
|
|
14
|
+
* the provision role cannot fix it. Compare the sibling families, which DO carry a check and
|
|
15
15
|
* therefore do work with a token: `ceph/fs`, `ceph/mon` and `disks/zfs` all want `Sys.Modify`.
|
|
16
16
|
*
|
|
17
17
|
* ⚠️ SO THE WRITE PATH IS HONEST RATHER THAN USEFUL. It is written out properly in
|
|
@@ -19,7 +19,7 @@
|
|
|
19
19
|
* operator running as root@pam. Through this package's credential it will 403, and a 403 is a
|
|
20
20
|
* better answer than a `delete` that silently does nothing while the plan claims otherwise.
|
|
21
21
|
*
|
|
22
|
-
* ★ WHAT IT IS ACTUALLY FOR, THEN: ASSERTION. It turns "
|
|
22
|
+
* ★ WHAT IT IS ACTUALLY FOR, THEN: ASSERTION. It turns "node-b, node-c and node-d each hold two ssd OSDs"
|
|
23
23
|
* into a line a plan checks, and it gives Ceph-backed resources something real to depend on —
|
|
24
24
|
* read `osd.osdid` into an `rbd` storage's props and Alchemy orders that storage after the
|
|
25
25
|
* assertion, so a stack can no longer report a healthy Ceph storage on a cluster whose OSDs are
|
|
@@ -46,8 +46,8 @@ import type { WithTarget } from './resource.ts';
|
|
|
46
46
|
export type { CephOsdAttributes };
|
|
47
47
|
export interface CephOsdProps extends WithTarget {
|
|
48
48
|
/**
|
|
49
|
-
* Which node ANSWERS the read — not where the OSD lives. MEASURED: the tree
|
|
50
|
-
* tree
|
|
49
|
+
* Which node ANSWERS the read — not where the OSD lives. MEASURED: the tree node-b returns and the
|
|
50
|
+
* tree node-c returns are the same six leaves, node-d's included. Point this at any node that is up;
|
|
51
51
|
* `host` is the field that says where the disk is.
|
|
52
52
|
*/
|
|
53
53
|
node: string;
|
|
@@ -56,7 +56,7 @@ export interface CephOsdProps extends WithTarget {
|
|
|
56
56
|
/**
|
|
57
57
|
* The CRUSH host bucket this OSD must sit in. Undeclared means unmanaged, as in storage.ts.
|
|
58
58
|
*
|
|
59
|
-
* ⚠️ DECLARING IT IS AN ASSERTION WITH NO REPAIR. If osd.2 turns up under
|
|
59
|
+
* ⚠️ DECLARING IT IS AN ASSERTION WITH NO REPAIR. If osd.2 turns up under node-c, the plan reports
|
|
60
60
|
* work every time and the deploy fails, because moving an OSD between failure domains is a
|
|
61
61
|
* `ceph osd crush move` this provider will not perform. That is the intent: a replica in the
|
|
62
62
|
* wrong failure domain is not something to converge quietly past.
|
|
@@ -4,34 +4,34 @@
|
|
|
4
4
|
* ★ SPLIT OUT OF ceph-pool.ts TO KEEP BOTH FILES UNDER THE 250-LINE CAP, and the seam is
|
|
5
5
|
* "does this touch the cluster" — the same one metric-server-form.ts draws, just with more on
|
|
6
6
|
* this side because this family needs it. Here: the declared shape, the reported shape, and the
|
|
7
|
-
* coercions that turn one into the other. There: reading
|
|
7
|
+
* coercions that turn one into the other. There: reading C1, deciding a diff, and the four
|
|
8
8
|
* handlers. Nothing in this file makes a call or decides an action.
|
|
9
9
|
* ⚠️ THE PROPS LIVE HERE RATHER THAN IN THE RESOURCE FILE, which is the one place this pair
|
|
10
10
|
* differs from metric-server / notification-target. There is no `import type` cycle back as a
|
|
11
11
|
* result; ceph-pool.ts re-exports both interfaces so the public surface is unchanged.
|
|
12
12
|
*
|
|
13
13
|
* ⛔ POST AND PUT DO NOT TAKE THE SAME PARAMETERS, AND BOTH EXTRAS ARE DESTRUCTIVE. MEASURED from
|
|
14
|
-
* the cluster's own schema (/usr/share/pve-docs/api-viewer/apidoc.js on
|
|
14
|
+
* the cluster's own schema (/usr/share/pve-docs/api-viewer/apidoc.js on node-b, pve-manager 9.2.11,
|
|
15
15
|
* 2026-09-13): POST adds `add_storages` and `erasure-coding` to the shared set, PUT takes
|
|
16
16
|
* neither. Both are refused below, so what is left between the two bodies is `name`, which PUT
|
|
17
17
|
* reads from the path, and `pg_num`.
|
|
18
18
|
*
|
|
19
19
|
* ⛔ `pg_num` IS IN THE CREATE BODY AND NOT IN THE UPDATE BODY, AND THAT IS THE MOST IMPORTANT
|
|
20
|
-
* LINE IN THIS FILE. MEASURED in PVE::API2::Ceph::Pool::createpool on
|
|
20
|
+
* LINE IN THIS FILE. MEASURED in PVE::API2::Ceph::Pool::createpool on node-b: a POST carrying no
|
|
21
21
|
* `pg_num` gets 128 substituted (`$param->{pg_num} //= 128`), and PVE::Ceph::Tools::create_pool
|
|
22
22
|
* then runs `osd pool create` — which Ceph answers with SUCCESS for a pool that already exists,
|
|
23
23
|
* before applying the rest of the body to it. So a create fired at a live pool SETS its pg_num,
|
|
24
24
|
* and lowering pg_num starts a PG MERGE: hours of backfill across every OSD, on a cluster whose
|
|
25
|
-
* Ceph traffic shares vmbr1.
|
|
25
|
+
* Ceph traffic shares vmbr1.42 with everything else. ceph-pool.ts guards the create for exactly
|
|
26
26
|
* that reason; this half simply never offers pg_num to an update.
|
|
27
27
|
*/
|
|
28
28
|
import type { WithTarget } from './resource.ts';
|
|
29
29
|
export interface CephPoolProps extends WithTarget {
|
|
30
30
|
/**
|
|
31
|
-
* ⚠️ WHICH NODE THE CALL GOES THROUGH, NOT WHERE THE POOL LIVES. A pool is cluster-wide:
|
|
32
|
-
*
|
|
31
|
+
* ⚠️ WHICH NODE THE CALL GOES THROUGH, NOT WHERE THE POOL LIVES. A pool is cluster-wide: node-b and
|
|
32
|
+
* node-c answer byte-identically for `rbd-c1` (measured). The endpoint is node-scoped only
|
|
33
33
|
* because PVE talks to the local RADOS socket, so this is a door, not a location — it is never
|
|
34
|
-
* compared, and moving a declaration from
|
|
34
|
+
* compared, and moving a declaration from node-b to node-c plans noop. Point it at a node you expect
|
|
35
35
|
* to be up: a node that is down makes the read fail, and a failed read reads as "absent".
|
|
36
36
|
*/
|
|
37
37
|
node: string;
|
|
@@ -49,7 +49,7 @@ export interface CephPoolProps extends WithTarget {
|
|
|
49
49
|
min_size?: number;
|
|
50
50
|
/**
|
|
51
51
|
* ⛔ CREATE-TIME ONLY, AND NEVER COMPARED — the single biggest noop hazard in this family. With
|
|
52
|
-
* `pg_autoscale_mode` on or warn the autoscaler owns this number: MEASURED on
|
|
52
|
+
* `pg_autoscale_mode` on or warn the autoscaler owns this number: MEASURED on C1, `rbd-c1`
|
|
53
53
|
* sits at pg_num 128 while the autoscaler's own `pg_num_final` is 256, so a declaration
|
|
54
54
|
* diffing it reports an update the moment Ceph decides to act. A split is gradual even with
|
|
55
55
|
* the autoscaler off, and `nopgchange` can refuse the write outright — which kills the WHOLE
|
|
@@ -59,7 +59,7 @@ export interface CephPoolProps extends WithTarget {
|
|
|
59
59
|
pg_num?: number;
|
|
60
60
|
/** The floor the autoscaler may not go below. Operator-owned and stable, so it IS compared. */
|
|
61
61
|
pg_num_min?: number;
|
|
62
|
-
/** ⚠️ PVE's create default is `warn`; Ceph's own is `on`, which is what all four
|
|
62
|
+
/** ⚠️ PVE's create default is `warn`; Ceph's own is `on`, which is what all four C1 pools have. */
|
|
63
63
|
pg_autoscale_mode?: 'off' | 'on' | 'warn';
|
|
64
64
|
/**
|
|
65
65
|
* The CRUSH rule BY NAME, e.g. `replicated_rule`.
|
|
@@ -105,7 +105,7 @@ export interface CephPoolProps extends WithTarget {
|
|
|
105
105
|
* size or its PG shape, and `set_pool` dies on the whole PUT when any one parameter will not
|
|
106
106
|
* apply (Tools.pm:310). `matches` refuses to diff the fields they freeze, so these attributes
|
|
107
107
|
* are the only place a plan can show WHY a declared size is not being enforced. All three read
|
|
108
|
-
* false on all four
|
|
108
|
+
* false on all four C1 pools.
|
|
109
109
|
* ⚠️ `pg_num`, `id` AND `applications` ARE REPORTED AND NEVER COMPARED — see the props above.
|
|
110
110
|
* ⛔ NO `statistics` AND NO `autoscale_status`, though the verbose read returns both. They change
|
|
111
111
|
* every few seconds; persisting them would rewrite this resource's state on every deploy and
|
|
@@ -160,7 +160,7 @@ export declare const same: <T>(declared: T | undefined, live: T, frozen?: boolea
|
|
|
160
160
|
* A declared autoscaler hint, or nothing when it is zero.
|
|
161
161
|
*
|
|
162
162
|
* ⚠️ A DECLARED ZERO IS "NO FLOOR, NO HINT", AND IT IS DELIBERATELY LEFT UNCOMPARED. REASONED, NOT
|
|
163
|
-
* MEASURED: all four
|
|
163
|
+
* MEASURED: all four C1 pools carry null for both `pg_num_min` and `target_size`, and finding
|
|
164
164
|
* out for certain would mean writing to the cluster. Ceph CLEARS both when they are set to 0 and
|
|
165
165
|
* `osd pool get all` then omits the key, which PVE reports as null and this pair reads as UNSET
|
|
166
166
|
* — so a declared 0 would compare 0 against -1 on every plan, forever. Mapping 0 to UNSET
|
|
@@ -185,7 +185,7 @@ export declare const hint: (value: number | undefined) => number | undefined;
|
|
|
185
185
|
* ⚠️ AN UNDECLARED FIELD IS NEITHER SENT NOR COMPARED — storage.ts's rule, and the opposite of
|
|
186
186
|
* Proxmox.Pool's. Undeclared means UNMANAGED here, because a pool has no one set of defaults to
|
|
187
187
|
* fall back on: PVE's POST fills in size 3, min_size 2, application rbd and pg_autoscale_mode
|
|
188
|
-
* 'warn' (MEASURED in createpool), while Ceph's own defaults — which is what every pool on
|
|
188
|
+
* 'warn' (MEASURED in createpool), while Ceph's own defaults — which is what every pool on C1
|
|
189
189
|
* was actually born with — put pg_autoscale_mode at 'on'. Guessing either set would rewrite a
|
|
190
190
|
* pool somebody tuned by hand.
|
|
191
191
|
*
|
|
@@ -198,7 +198,7 @@ export declare const hint: (value: number | undefined) => number | undefined;
|
|
|
198
198
|
* NOT PVE's `1T` STRING. MEASURED: the API parses the string with PVE::JSONSchema::parse_size
|
|
199
199
|
* and stores Ceph's `target_size_bytes` (Pool.pm:474-477 for POST, 683-686 for PUT), and
|
|
200
200
|
* `GET .../status` hands that integer back under the name `target_size` (Pool.pm:878). Run on
|
|
201
|
-
*
|
|
201
|
+
* node-b, `parse_size('1099511627776')` returns 1099511627776 — bare digits are bytes, no
|
|
202
202
|
* multiplier — so a byte count survives the round trip exactly, while a declared `1T` would read
|
|
203
203
|
* back as 1099511627776 and diff against itself on every plan, forever.
|
|
204
204
|
*/
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"ceph-pool-form.d.ts","sourceRoot":"","sources":["../../src/proxmox/ceph-pool-form.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGhD,MAAM,WAAW,aAAc,SAAQ,UAAU;IAC/C;;;;;;OAMG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;OAMG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,uFAAuF;IACvF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gFAAgF;IAChF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+FAA+F;IAC/F,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,
|
|
1
|
+
{"version":3,"file":"ceph-pool-form.d.ts","sourceRoot":"","sources":["../../src/proxmox/ceph-pool-form.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGhD,MAAM,WAAW,aAAc,SAAQ,UAAU;IAC/C;;;;;;OAMG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;OAMG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,uFAAuF;IACvF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gFAAgF;IAChF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+FAA+F;IAC/F,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mGAAmG;IACnG,iBAAiB,CAAC,EAAE,KAAK,GAAG,IAAI,GAAG,MAAM,CAAC;IAC1C;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,QAAQ,GAAG,KAAK,GAAG,KAAK,CAAC;IACvC,qGAAqG;IACrG,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;;;;;OAQG;IACH,gBAAgB,CAAC,EAAE,KAAK,CAAC;IACzB,YAAY,CAAC,EAAE,KAAK,CAAC;CACtB;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,mFAAmF;IACnF,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,oGAAoG;IACpG,UAAU,EAAE,MAAM,CAAC;IACnB,mFAAmF;IACnF,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,MAAM,UAAW,aAAa,WAAkD,CAAC;AAC9F,eAAO,MAAM,UAAU,UAAW,aAAa,WAAoC,CAAC;AAEpF;;;;;GAKG;AACH,eAAO,MAAM,KAAK,KAAK,CAAC;AAExB,qGAAqG;AACrG,eAAO,MAAM,YAAY,UAAW,OAAO,WACoC,CAAC;AAEhF;;;;;GAKG;AACH,eAAO,MAAM,IAAI,GAAI,CAAC,YAAY,CAAC,GAAG,SAAS,QAAQ,CAAC,8BACD,CAAC;AAExD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,IAAI,UAAW,MAAM,GAAG,SAAS,uBAAsC,CAAC;AASrF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,eAAO,MAAM,UAAU,UAAW,aAAa,KAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAQrE,CAAC;AAEH;;;;;;;;;GASG;AACH,eAAO,MAAM,UAAU,UAAW,aAAa,KAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAMrE,CAAC"}
|
|
@@ -18,10 +18,10 @@
|
|
|
18
18
|
* string, so HTTP 200 means "the task started" — an immediate read-back can see a pool that does
|
|
19
19
|
* not exist yet, or values that have not landed. `settle` waits for the cluster to agree.
|
|
20
20
|
*
|
|
21
|
-
* ⛔ THE FOUR POOLS ON
|
|
21
|
+
* ⛔ THE FOUR POOLS ON C1 INCLUDE CEPH'S OWN, AND NONE OF THEM MAY BE ADOPTED. Measured
|
|
22
22
|
* 2026-09-13: `.mgr` (application `mgr`, created and owned by the manager daemons),
|
|
23
|
-
* `cephfs-
|
|
24
|
-
* destroying either destroys the filesystem), and `
|
|
23
|
+
* `cephfs-c1_data` and `cephfs-c1_metadata` (the two halves of the `cephfs-c1` filesystem —
|
|
24
|
+
* destroying either destroys the filesystem), and `rbd-c1`, the rbd pool the guests sit on.
|
|
25
25
|
* `list` answers empty like every resource in this package, so adoption stays an explicit act;
|
|
26
26
|
* the `applications` attribute is reported so that a plan SHOWS which of those a declaration hit.
|
|
27
27
|
*
|
package/dist/proxmox/client.d.ts
CHANGED
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
* ★ PLAIN `fetch`, NO TLS ESCAPE HATCH, AND THAT IS A MEASURED CHOICE RATHER THAN AN OMISSION.
|
|
5
5
|
* Proxmox is usually met with `curl -k` because a fresh install serves its own self-signed
|
|
6
6
|
* certificate — I reached for `-k` myself before checking. This cluster serves a real Let's
|
|
7
|
-
* Encrypt certificate (`CN=cluster-
|
|
7
|
+
* Encrypt certificate (`CN=cluster-c1.example.com`), and strict TLS answers 401, i.e. the
|
|
8
8
|
* handshake succeeds and only the credential is missing. So there is no `rejectUnauthorized`
|
|
9
9
|
* option here to be left switched on by accident in somebody else's estate.
|
|
10
10
|
*
|
|
@@ -46,7 +46,7 @@ export declare const pveEnvelopeWith: (target: PveTarget, credential: PveCredent
|
|
|
46
46
|
* Make one call on a credential for `role`, REUSING a still-valid lease rather than minting one.
|
|
47
47
|
*
|
|
48
48
|
* 🔴 IT USED TO MINT PER CALL, AND AT 98 RESOURCES THAT STOPPED BEING FREE. One plan plus deploy
|
|
49
|
-
* of the
|
|
49
|
+
* of the C1 stack left 760 token entries in `/etc/pve/user.cfg` — read, diff, reconcile and the
|
|
50
50
|
* read-back each minted their own, and `/etc/pve` is a replicated cluster filesystem every node
|
|
51
51
|
* has to agree on. src/lease-cache.ts carries the measurement and the safety argument.
|
|
52
52
|
*
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* A credential written as a LITERAL in a plain prop — refused, because a plain prop is a value in
|
|
3
|
+
* the state store.
|
|
4
|
+
*
|
|
5
|
+
* ⛔ THE HOLE THIS CLOSES, MEASURED 2026-09-22 (adversarial review of PR 95). write-only.ts keeps
|
|
6
|
+
* every `{ fromEnv }` value out of state, and the doc WARNED that a plain header value is a prop.
|
|
7
|
+
* A warning is not a guard: `header: { Authorization: 'Bearer <token>' }` planned, deployed, and
|
|
8
|
+
* left the token in the dumped state store — and so did `url: 'https://…?token=<token>'`. Alchemy
|
|
9
|
+
* stores props unencrypted (write-only.ts has the StateEncoding reading), so the only safe
|
|
10
|
+
* literal is one that is not a credential.
|
|
11
|
+
*
|
|
12
|
+
* ★ WHAT COUNTS AS A CREDENTIAL IS A NAME, NOT A VALUE. A value cannot be recognised — a token is
|
|
13
|
+
* any string — but where it sits can: an `Authorization`/`Cookie` header, a header or query
|
|
14
|
+
* parameter whose name has a word like `token`, `key`, `secret`, `password` or `signature`, and a
|
|
15
|
+
* password in the URL's userinfo. A false positive costs one edit (declare it `{ fromEnv }`, or
|
|
16
|
+
* hold it in `secret` and write `{{ secrets.<name> }}`); a false negative costs a leaked token.
|
|
17
|
+
* ★ A TEMPLATE THAT READS A SECRET IS NOT A LITERAL. `Bearer {{ secrets.token }}`, and
|
|
18
|
+
* `{{ url-encode secrets.token }}` in a query, render on PBS from the root-only secret store —
|
|
19
|
+
* the prop holds the reference, not the value.
|
|
20
|
+
*
|
|
21
|
+
* ⚠️ WHAT THIS CANNOT SEE: a token in a URL PATH (a Slack-style `/services/T…/B…/<token>`), in the
|
|
22
|
+
* `body`, or in a `comment`. Those are plain props too; put the token in `secret` and reference
|
|
23
|
+
* it from the template. docs/pbs-notifications.md says the same to the reader.
|
|
24
|
+
* ⛔ A REFUSAL NAMES THE FIELD, NEVER THE VALUE — the message lands in a terminal and a CI log.
|
|
25
|
+
*/
|
|
26
|
+
import type { FromEnv } from './write-only.ts';
|
|
27
|
+
export declare const isCredentialName: (name: string) => boolean;
|
|
28
|
+
/** Plain header values that are credentials by their header's name. `{ fromEnv }` is never one. */
|
|
29
|
+
export declare const literalCredentialHeaders: (header: Readonly<Record<string, FromEnv | string>> | undefined) => string[];
|
|
30
|
+
/**
|
|
31
|
+
* Where a URL carries a literal credential: `userinfo` (a password before the `@`), or the names
|
|
32
|
+
* of credential-shaped query (or fragment) parameters. Parsed by hand, not with `new URL`: a URL here is a
|
|
33
|
+
* TEMPLATE, and `{{ … }}` in the host or the userinfo is not a URL `new URL` will accept.
|
|
34
|
+
*/
|
|
35
|
+
export declare const literalCredentialsInUrl: (url: string | undefined) => string[];
|
|
36
|
+
//# sourceMappingURL=credential-literals.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"credential-literals.d.ts","sourceRoot":"","sources":["../../src/proxmox/credential-literals.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAU/C,eAAO,MAAM,gBAAgB,SAAU,MAAM,KAAG,OACY,CAAC;AAI7D,mGAAmG;AACnG,eAAO,MAAM,wBAAwB,WAC3B,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,CAAC,GAAG,SAAS,KAC7D,MAAM,EAKE,CAAC;AAEZ;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,QAAS,MAAM,GAAG,SAAS,KAAG,MAAM,EAkBvE,CAAC"}
|
|
@@ -2,13 +2,13 @@
|
|
|
2
2
|
* The PVE credential a reconcile runs with: minted from OpenBao, alive for five minutes.
|
|
3
3
|
*
|
|
4
4
|
* ⛔ THERE IS NO STATIC WRITE TOKEN IN THIS ESTATE, AND THAT IS DELIBERATE. Every PVE token stored
|
|
5
|
-
*
|
|
6
|
-
*
|
|
5
|
+
* on the estate's static KV shelf is read-only — PVEAuditor on each cluster, Audit on PBS, all
|
|
6
|
+
* as one metrics user. The MCP proxmox client says why in its own header: the auditor token bounds
|
|
7
7
|
* what a BUG can do, independently of what the code bounds. Adding a long-lived write token to
|
|
8
8
|
* that shelf would delete the outer lock for every reader of the shelf, not just for this
|
|
9
9
|
* provider.
|
|
10
10
|
*
|
|
11
|
-
* ★ SO WRITES COME FROM A DYNAMIC MOUNT INSTEAD, which the estate already built: `proxmox-
|
|
11
|
+
* ★ SO WRITES COME FROM A DYNAMIC MOUNT INSTEAD, which the estate already built: `proxmox-c1/`
|
|
12
12
|
* exposes two roles — `read` (ttl 3600s) and `provision` (ttl 300s, max 1800s, NOT renewable).
|
|
13
13
|
* A mint returns a PVE API token of its own, `hf-provision@pve!hf-provision-…-<timestamp>-<id>`,
|
|
14
14
|
* which expires on its own whether or not anything cleans up. Same shape as
|
|
@@ -24,7 +24,7 @@
|
|
|
24
24
|
*
|
|
25
25
|
* ⛔ THE SECRET NEVER TOUCHES DISK, A LOG, OR ALCHEMY STATE. Alchemy persists resource attributes
|
|
26
26
|
* WITHOUT encryption — StateEncoding.ts writes `Redacted` as `{"@redacted": <plaintext>}` — and
|
|
27
|
-
* this estate's state store is the `alchemy` Postgres, which
|
|
27
|
+
* this estate's state store is the `alchemy` Postgres, which a nightly job dumps. A PVE
|
|
28
28
|
* secret that reached an attribute would outlive its 300s lease by months, in four places.
|
|
29
29
|
* Nothing here returns it to a resource; it is used to build a header and then dropped.
|
|
30
30
|
*/
|
|
@@ -54,10 +54,10 @@ export type PveRole = 'read' | 'provision';
|
|
|
54
54
|
* use this file unchanged; that is the whole difference between a provider and a script.
|
|
55
55
|
*/
|
|
56
56
|
export type PveTarget = {
|
|
57
|
-
/** OpenBao mount that vends API tokens for this host, e.g. `proxmox-
|
|
57
|
+
/** OpenBao mount that vends API tokens for this host, e.g. `proxmox-c1`. */
|
|
58
58
|
readonly mount: string;
|
|
59
59
|
/**
|
|
60
|
-
* mgmt hostnames for cluster members, e.g. `
|
|
60
|
+
* mgmt hostnames for cluster members, e.g. `node-b.mgmt.example.com`. Any member's :8006 API
|
|
61
61
|
* manages the whole cluster; `client.ts` failovers across them.
|
|
62
62
|
*/
|
|
63
63
|
readonly members: readonly string[];
|
|
@@ -118,14 +118,14 @@ export type BaoEnvironment = Readonly<Record<string, string | undefined>>;
|
|
|
118
118
|
* Mint one credential for `role`: `GET /v1/<mount>/creds/<role>` on OpenBao's HTTP API.
|
|
119
119
|
*
|
|
120
120
|
* 🔴 IT SHELLED OUT TO `bao read -format=json` UNTIL 2026-09-14. The case for the CLI was that one
|
|
121
|
-
* client could not disagree with `bao kv get` about what this machine may do.
|
|
121
|
+
* client could not disagree with `bao kv get` about what this machine may do. <estate>/openbao then
|
|
122
122
|
* learned twice what deciding by stderr costs — every failure read as absent, and two commands
|
|
123
123
|
* said "absent" in different words — so this reads STATUS CODES: 2xx is a credential, and 403
|
|
124
124
|
* (denied), 404 (no such role or mount — a mint has no "absent"), 503 (sealed) all fail.
|
|
125
125
|
* ★ THE ENVIRONMENT CONTRACT IS STILL THE CLI's, READ THE CLI's WAY, which keeps the case above
|
|
126
126
|
* true (openbao v2.6.2 api/client.go:34-66, 370, 503-507, 761-762, 776-785): BAO_AGENT_ADDR over
|
|
127
127
|
* BAO_ADDR over https://127.0.0.1:8200; BAO_NAMESPACE as X-Vault-Namespace; BAO_TOKEN as
|
|
128
|
-
* X-Vault-Token; X-Vault-Request always.
|
|
128
|
+
* X-Vault-Token; X-Vault-Request always. <estate>/openbao/src/bao-address.ts has the long form.
|
|
129
129
|
* ★ AGENT MODE IS NO BAO_TOKEN AND NO TOKEN HEADER. An Agent or Proxy listener with
|
|
130
130
|
* `api_proxy { use_auto_auth_token = true }` (or the older `cache { … }`) substitutes its
|
|
131
131
|
* auto-auth token exactly when a request carries none — command/agentproxyshared/cache/handler.go
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"credentials.d.ts","sourceRoot":"","sources":["../../src/proxmox/credentials.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAIxC,OAAO,KAAK,UAAU,MAAM,iCAAiC,CAAC;AAG9D;;;;;;;;;;;;GAYG;AACH,uFAAuF;AACvF,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,WAAW,CAAC;AAE3C;;;;;;;GAOG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,
|
|
1
|
+
{"version":3,"file":"credentials.d.ts","sourceRoot":"","sources":["../../src/proxmox/credentials.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAIxC,OAAO,KAAK,UAAU,MAAM,iCAAiC,CAAC;AAG9D;;;;;;;;;;;;GAYG;AACH,uFAAuF;AACvF,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,WAAW,CAAC;AAE3C;;;;;;;GAOG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,4EAA4E;IAC5E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;CACxB,CAAC;AAEF,oFAAoF;AACpF,MAAM,MAAM,SAAS,GAAG;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;CACxB,CAAC;AAEF,oGAAoG;AACpG,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;AAE9C;;;;;;;GAOG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,sEAAsE;IACtE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,gEAAgE;IAChE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,iEAAiE;IACjE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF,iGAAiG;AACjG,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;AAM1E;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,IAAI,WAAY,SAAS,QAAQ,OAAO,QAAO,cAAc;;;;gCAuFtE,CAAC;AAEL;;;;;GAKG;AACH,eAAO,MAAM,aAAa,eAAgB,aAAa,UAAU,SAAS,KAAG,MAGf,CAAC"}
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* A PBS (or PVE) notification config that remembers writes — enough of proxmox-notify's CRUD for
|
|
3
|
+
* a family's REAL provider to create, drift, rotate and adopt through Alchemy's engine.
|
|
4
|
+
*
|
|
5
|
+
* ★ STATEFUL, UNLIKE `fakePve`'s bare answer function, because the questions here are about the
|
|
6
|
+
* SECOND deploy: whether a rotated secret is written, whether an unchanged one is not. That needs
|
|
7
|
+
* a server that holds what the first deploy wrote.
|
|
8
|
+
* ★ IT KEEPS proxmox-notify's TWO RULES THAT MATTER HERE (api/webhook.rs, read at HEAD 2026-09-22):
|
|
9
|
+
* 1. a read returns secret NAMES only; values live in a separate private store;
|
|
10
|
+
* 2. a PUT that carries `secret` REPLACES the list, a name without a value keeping the old
|
|
11
|
+
* one; a PUT without `secret` leaves the list alone. `delete` entries clear a field.
|
|
12
|
+
* Repeated form keys arrive as arrays, as the real urlencoded decoder builds them.
|
|
13
|
+
* ⛔ TEST-ONLY. No provider imports this file.
|
|
14
|
+
*/
|
|
15
|
+
import { type FakePve } from './fake-pve.ts';
|
|
16
|
+
export interface FakeNotify extends FakePve {
|
|
17
|
+
/** Public config by path, as a GET would see it apart from secrets. Mutable, for drift. */
|
|
18
|
+
readonly objects: Map<string, Record<string, unknown>>;
|
|
19
|
+
/** Secret items with values (`name=…,value=<base64>`), by path — the root-only file. */
|
|
20
|
+
readonly secrets: Map<string, string[]>;
|
|
21
|
+
}
|
|
22
|
+
export declare const fakeNotify: (seed?: Readonly<Record<string, Record<string, unknown>>>) => FakeNotify;
|
|
23
|
+
//# sourceMappingURL=fake-pbs-notify.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"fake-pbs-notify.d.ts","sourceRoot":"","sources":["../../src/proxmox/fake-pbs-notify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,KAAK,OAAO,EAAyB,MAAM,eAAe,CAAC;AAepE,MAAM,WAAW,UAAW,SAAQ,OAAO;IACzC,2FAA2F;IAC3F,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACvD,wFAAwF;IACxF,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACzC;AA4BD,eAAO,MAAM,UAAU,UACf,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,KACtD,UA2CF,CAAC"}
|
|
@@ -19,6 +19,11 @@ export interface PveCall {
|
|
|
19
19
|
/** Relative to `/api2/json/`, query included — the string a family passes to `pve()`. */
|
|
20
20
|
readonly path: string;
|
|
21
21
|
readonly form: Readonly<Record<string, string>>;
|
|
22
|
+
/**
|
|
23
|
+
* Every key/value pair in wire order. ⚠️ `form` keeps only the LAST value of a repeated key, and
|
|
24
|
+
* a PBS list IS a repeated key (client.ts `encode`) — assert a list on `pairs`, never `form`.
|
|
25
|
+
*/
|
|
26
|
+
readonly pairs: readonly (readonly [string, string])[];
|
|
22
27
|
}
|
|
23
28
|
/** Answers one call with its `data`; `undefined` is PVE's `{"data": null}`. */
|
|
24
29
|
export type PveAnswer = (call: PveCall) => unknown;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"fake-pve.d.ts","sourceRoot":"","sources":["../../src/proxmox/fake-pve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAEtC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAIlD,eAAO,MAAM,WAAW,EAAE,SAIzB,CAAC;AAEF,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,yFAAyF;IACzF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;
|
|
1
|
+
{"version":3,"file":"fake-pve.d.ts","sourceRoot":"","sources":["../../src/proxmox/fake-pve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAEtC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAIlD,eAAO,MAAM,WAAW,EAAE,SAIzB,CAAC;AAEF,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,yFAAyF;IACzF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAChD;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;CACxD;AAED,+EAA+E;AAC/E,MAAM,MAAM,SAAS,GAAG,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC;AAEnD,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC;IAC1B,sDAAsD;IACtD,QAAQ,CAAC,MAAM,EAAE,MAAM,MAAM,EAAE,CAAC;IAChC,wFAAwF;IACxF,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC;CAC9C;AAED,0FAA0F;AAC1F,QAAA,MAAM,SAAS,SAAU,OAAO,KAAK,oFACuD,CAAC;AAE7F,eAAO,MAAM,OAAO,WAAY,SAAS,KAAG,OA4B3C,CAAC;AAEF,sGAAsG;AACtG,eAAO,MAAM,UAAU,GAAI,CAAC,QAAQ,MAAM,OAAO,CAAC,CAAC,CAAC,KAAG,OAAO,CAAC,CAAC,CACO,CAAC"}
|
|
@@ -33,7 +33,7 @@ export declare const fold: (name: string) => string;
|
|
|
33
33
|
/**
|
|
34
34
|
* A CIDR reduced to the one form PVE will hand back.
|
|
35
35
|
*
|
|
36
|
-
* ⛔ MEASURED by running the cluster's own `PVE::Firewall::parse_alias` on
|
|
36
|
+
* ⛔ MEASURED by running the cluster's own `PVE::Firewall::parse_alias` on node-b (pve-manager 9.2.11,
|
|
37
37
|
* 2026-09-13) — a pure function over a string, no config read and none written:
|
|
38
38
|
* `10.1.1.5/32` -> `10.1.1.5` a /32 host suffix is STRIPPED
|
|
39
39
|
* `2001:0DB8::1/128`-> `2001:0DB8::1` a /128 is stripped, and the case is NOT folded
|
|
@@ -61,7 +61,7 @@
|
|
|
61
61
|
* ⚠️ PRIVILEGES, AND FOR ONCE NOTHING NEEDS WIDENING. MEASURED 2026-09-13 from the cluster's own
|
|
62
62
|
* schema and its live ACL: the item GET checks `["perm","/",["Sys.Audit"]]`, POST/PUT/DELETE
|
|
63
63
|
* check `["perm","/",["Sys.Modify"]]`, `hf-read@pve` holds `PVEAuditor` at `/` with propagate and
|
|
64
|
-
* `hf-provision@pve` holds
|
|
64
|
+
* `hf-provision@pve` holds the provision role (provision-baseline.ts) at `/` with propagate. Both privileges are already
|
|
65
65
|
* held, so `readRole` stays the default `read` lane — unlike storage/sdn-zone/sdn-vnet, whose
|
|
66
66
|
* ITEM reads are gated on an allocate privilege the auditor cannot have.
|
|
67
67
|
* ⚠️ `Sys.Modify` ON `/` IS STILL A BIG HAMMER — it is the same grant `metric-server.ts` warns
|