The tests' seat list holds the group's definitions: mesh-recovery and four more seats, eleven taken again
seatlisttest gains mesh-builds, mesh-delivery-view, mesh-grants, mesh-pipeline-runner and mesh-recovery, which the live list (revision 473) holds, and takes again the eleven definitions and two parts the group's heads change (mesh-contracts feat/47-H2 e6ed560e, mesh-delivery feat/47-H2 80ff1afa, mesh-catalog's form 5 from feat/47-H2-i 5e943280), so a test judges a manifest against the seats the running validator judges it against. The three bootstrapped seats among them (mesh-catalog, mesh-delivery, node-engine) are replaced in the bootstrap and its captured contracts copy too (ADR 0635 §3, ADR 0636 §7); the service manager's tests take its kernel-log verb, and the grants module's name, now also a seat's, joins the kept names. Builds: design 47 H2, H-A-452
This commit is contained in:
@@ -1,11 +1,12 @@
|
||||
{
|
||||
"format": 1,
|
||||
"form": 3,
|
||||
"seat": "node-engine",
|
||||
"scope": "node",
|
||||
"grain": "whole",
|
||||
"domain": "Core",
|
||||
"decision": "novox/hq ADR 0563",
|
||||
"description": "The node seat every node's engine holds (novox/hq ADR 0563, ADR 0618 §3, §4): its hand acts on the operator's warrant, its read-only judgements, its compositions and what it reads of a manifest. Each verb is answered on this node's subject, mesh.seat.node-engine.tool.<verb>.<node>, and each event is published on mesh.seat.node-engine.event.<event>.<node>, the node's name its last token, or, for an event whose subject names <node>, there (composed.<node>, running.<node>.<module>): the grants part grants a node's account only its own node's subjects (ADR 0363 §2).",
|
||||
"description": "The node seat every node's engine holds (novox/hq ADR 0563, ADR 0618 \u00a73, \u00a74): its hand acts on the operator's warrant, its read-only judgements, its compositions and what it reads of a manifest. Each verb is answered on this node's subject, mesh.seat.node-engine.tool.<verb>.<node>, and each event is published on mesh.seat.node-engine.event.<event>.<node>, the node's name its last token, or, for an event whose subject names <node>, there (composed.<node>, running.<node>.<module>): the grants part grants a node's account only its own node's subjects (ADR 0363 \u00a72).",
|
||||
"acts": [
|
||||
{
|
||||
"step": "compose",
|
||||
@@ -15,7 +16,7 @@
|
||||
"verbs": [
|
||||
{
|
||||
"name": "hand-over",
|
||||
"description": "Hand a directory this machine uses as found to the mesh (novox/hq ADR 0563 §3, §5): the engine judges the path as it does every hand-over (absolute, as it states it, used as found, reached through no link) and refuses in words, or asks the operator on their channel at the level approve, binding the owner, group and mode it will set. Nothing changes on the call: only the operator's yes hands it over. One ask is open per path; acts shows where it stands.",
|
||||
"description": "Hand a directory this machine uses as found to the mesh (novox/hq ADR 0563 \u00a73, \u00a75): the engine judges the path as it does every hand-over (absolute, as it states it, used as found, reached through no link) and refuses in words, or asks the operator on their channel at the level approve, binding the owner, group and mode it will set. Nothing changes on the call: only the operator's yes hands it over. One ask is open per path; acts shows where it stands.",
|
||||
"input": {
|
||||
"properties": {
|
||||
"path": {
|
||||
@@ -39,7 +40,7 @@
|
||||
},
|
||||
{
|
||||
"name": "access-act",
|
||||
"description": "Ask the operator for the take act on a library whose root holds data outside its group (novox/hq ADR 0328 §7, ADR 0563 §3, §4), on the library's home engine: the access as declared and its root as last declared, judged and refused in words or asked at the level approve. Only the operator's yes sets the library's group, group write and setgid under its root. One ask is open per access.",
|
||||
"description": "Ask the operator for the take act on a library whose root holds data outside its group (novox/hq ADR 0328 \u00a77, ADR 0563 \u00a73, \u00a74), on the library's home engine: the access as declared and its root as last declared, judged and refused in words or asked at the level approve. Only the operator's yes sets the library's group, group write and setgid under its root. One ask is open per access.",
|
||||
"input": {
|
||||
"properties": {
|
||||
"access": {
|
||||
@@ -68,7 +69,7 @@
|
||||
},
|
||||
{
|
||||
"name": "judge-directories",
|
||||
"description": "Which of this machine's declared directories the engine would refuse to make or keep, one line each (novox/hq ADR 0563 §2). Read-only: changes no owner or mode.",
|
||||
"description": "Which of this machine's declared directories the engine would refuse to make or keep, one line each (novox/hq ADR 0563 \u00a72). Read-only: changes no owner or mode.",
|
||||
"input": {
|
||||
"properties": {},
|
||||
"type": "object"
|
||||
@@ -80,7 +81,7 @@
|
||||
},
|
||||
{
|
||||
"name": "setuid-search",
|
||||
"description": "Throw away the engine's last search for setuid programs and start a full one (novox/hq ADR 0563 §2); until it completes root-free answers that the machine is not judged yet. Refused while one runs, and when one was started within the hour, naming when the next may start.",
|
||||
"description": "Throw away the engine's last search for setuid programs and start a full one (novox/hq ADR 0563 \u00a72); until it completes root-free answers that the machine is not judged yet. Refused while one runs, and when one was started within the hour, naming when the next may start.",
|
||||
"input": {
|
||||
"properties": {
|
||||
"why": {
|
||||
@@ -97,7 +98,7 @@
|
||||
},
|
||||
{
|
||||
"name": "root-free",
|
||||
"description": "Whether this machine is root-free (novox/hq ADR 0259 §8, ADR 0563 §6): free only on the engine's own verdict, at most fifteen minutes old, that the account agents run as cannot become root without a person, and the login shell's execute not served here. Anything else is no pass, and says why. Answered by this machine's engine alone.",
|
||||
"description": "Whether this machine is root-free (novox/hq ADR 0259 \u00a78, ADR 0563 \u00a76): free only on the engine's own verdict, at most fifteen minutes old, that the account agents run as cannot become root without a person, and the login shell's execute not served here. Anything else is no pass, and says why. Answered by this machine's engine alone.",
|
||||
"input": {
|
||||
"properties": {},
|
||||
"type": "object"
|
||||
@@ -121,7 +122,7 @@
|
||||
},
|
||||
{
|
||||
"name": "acts",
|
||||
"description": "Every act this machine's engine was asked through this seat (novox/hq ADR 0563 §9): each hand-over, access act and setuid search, open, done or refused, with who asked, the ask and the operator's warrant. Read-only.",
|
||||
"description": "Every act this machine's engine was asked through this seat (novox/hq ADR 0563 \u00a79): each hand-over, access act and setuid search, open, done or refused, with who asked, the ask and the operator's warrant. Read-only.",
|
||||
"input": {
|
||||
"properties": {
|
||||
"id": {
|
||||
@@ -242,7 +243,7 @@
|
||||
"type": "string"
|
||||
},
|
||||
"digest": {
|
||||
"description": "a composition's digest (sha256:…), to read that revision rather than the latest",
|
||||
"description": "a composition's digest (sha256:\u2026), to read that revision rather than the latest",
|
||||
"type": "string"
|
||||
},
|
||||
"module": {
|
||||
@@ -287,7 +288,7 @@
|
||||
},
|
||||
"self": {
|
||||
"type": "boolean",
|
||||
"description": "the node composes the module itself (ADR 0547 §2)"
|
||||
"description": "the node composes the module itself (ADR 0547 \u00a72)"
|
||||
},
|
||||
"backup": {
|
||||
"type": "string",
|
||||
@@ -517,6 +518,27 @@
|
||||
"withheld-unknown": {
|
||||
"type": "string",
|
||||
"description": "withheld unknown: the grants part does not answer, when its verb withheld did not answer"
|
||||
},
|
||||
"withheld-parts": {
|
||||
"type": "array",
|
||||
"description": "each part a compose kept because its read did not answer, with why (design 08 control-verbs \u00a74, H-A-321): for the packet filter's holder the part node-packet-filter.allowed, its filter file kept as it runs",
|
||||
"items": {
|
||||
"type": "object",
|
||||
"required": [
|
||||
"part",
|
||||
"why"
|
||||
],
|
||||
"properties": {
|
||||
"part": {
|
||||
"type": "string",
|
||||
"description": "the read asked, as <seat>.<verb>"
|
||||
},
|
||||
"why": {
|
||||
"type": "string",
|
||||
"description": "why it did not answer, naming the holder asked"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
@@ -529,6 +551,63 @@
|
||||
},
|
||||
"class": "read"
|
||||
},
|
||||
{
|
||||
"name": "composition-diff",
|
||||
"description": "One module's composed values read by resource (design 47 H2 \u00a7813 (3), H-A-349 DQ-12b): given a module and a revision or a digest of its composition, the entries that differ between the composition that runs and that one, per resource, environment entries by name, a secret's value masked. Read-only. Answered by this machine's engine alone.",
|
||||
"class": "read",
|
||||
"input": {
|
||||
"type": "object",
|
||||
"required": [
|
||||
"module"
|
||||
],
|
||||
"properties": {
|
||||
"module": {
|
||||
"type": "string",
|
||||
"description": "the module, as placed on this machine; node for the node's own"
|
||||
},
|
||||
"revision": {
|
||||
"type": "integer",
|
||||
"description": "the revision of the module's composition key to compare with, from the revisions the bucket keeps; give it or digest"
|
||||
},
|
||||
"digest": {
|
||||
"type": "string",
|
||||
"description": "the digest (sha256:\u2026) of the composition to compare with; give it or revision"
|
||||
}
|
||||
}
|
||||
},
|
||||
"answer": {
|
||||
"type": "object",
|
||||
"required": [
|
||||
"node",
|
||||
"module",
|
||||
"resources"
|
||||
],
|
||||
"properties": {
|
||||
"node": {
|
||||
"type": "string",
|
||||
"description": "the node"
|
||||
},
|
||||
"module": {
|
||||
"type": "string",
|
||||
"description": "the module"
|
||||
},
|
||||
"running": {
|
||||
"type": "string",
|
||||
"description": "the digest of the composition that runs; absent when nothing runs"
|
||||
},
|
||||
"other": {
|
||||
"$ref": "#/defs/Revision"
|
||||
},
|
||||
"resources": {
|
||||
"type": "array",
|
||||
"description": "each resource with an entry that differs; empty when none differs",
|
||||
"items": {
|
||||
"$ref": "#/defs/CompositionDiffResource"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "compose",
|
||||
"description": "Compose this machine's modules now and say how it went, so a composition that failed, or a module held, recovers without a restart: what the pass refused or held, each with why, and when the engine composes again on its own after a seat that did not answer (a deadline, no responders: retried with a growing wait; a refusal never). With module, that module's apply is also tried again. Changes only what a pass the engine makes on its own would change.",
|
||||
@@ -595,7 +674,7 @@
|
||||
},
|
||||
{
|
||||
"name": "compose-candidate",
|
||||
"description": "Compose a check's candidate on this machine in shadow, with its own sealed values and the indexer's manifest verdicts, and say per module placed here whether it composes (with its digest and whether the candidate changes it), is refused by the candidate or is held without it, each with why, and the verdict of the machine's own composition (novox/hq ADR 0593 §7). Read-only: applies nothing and writes nothing. Answered by this machine's engine alone, within the asker's bound.",
|
||||
"description": "Compose a check's candidate on this machine in shadow, with its own sealed values and the indexer's manifest verdicts, and say per module placed here whether it composes (with its digest and whether the candidate changes it), is refused by the candidate or is held without it, each with why, and the verdict of the machine's own composition (novox/hq ADR 0593 \u00a77). Read-only: applies nothing and writes nothing. Answered by this machine's engine alone, within the asker's bound.",
|
||||
"optional": true,
|
||||
"input": {
|
||||
"properties": {
|
||||
@@ -640,7 +719,7 @@
|
||||
"unready",
|
||||
"not-judged"
|
||||
],
|
||||
"description": "the node's verdict (ADR 0593 §7, §9)"
|
||||
"description": "the node's verdict (ADR 0593 \u00a77, \u00a79)"
|
||||
},
|
||||
"modules": {
|
||||
"type": "array",
|
||||
@@ -686,7 +765,7 @@
|
||||
{
|
||||
"name": "manifest-reads",
|
||||
"optional": true,
|
||||
"description": "The reader capabilities this machine's engine states (manifest words, forms and seat names it reads, novox/hq ADR 0618 §3) and when it last stated them. An engine built before it said them states none, which a reader takes as the baseline. Read-only. Answered by this machine's engine alone.",
|
||||
"description": "The reader capabilities this machine's engine states (manifest words, forms and seat names it reads, novox/hq ADR 0618 \u00a73) and when it last stated them. An engine built before it said them states none, which a reader takes as the baseline. Read-only. Answered by this machine's engine alone.",
|
||||
"input": {
|
||||
"type": "object",
|
||||
"properties": {}
|
||||
@@ -720,7 +799,7 @@
|
||||
"node",
|
||||
"stated-at"
|
||||
],
|
||||
"description": "what this machine's engine reads of a manifest (ADR 0618 §3)"
|
||||
"description": "what this machine's engine reads of a manifest (ADR 0618 \u00a73)"
|
||||
},
|
||||
"class": "read"
|
||||
},
|
||||
@@ -787,7 +866,7 @@
|
||||
},
|
||||
{
|
||||
"name": "seat-list",
|
||||
"description": "The seat list this engine holds and what it waits for (novox/hq ADR 0636 §7): each seat's source (trunk or bootstrap) and digest, the seats held from the bootstrap alone, the definitions refused, the last error and whether the seat mesh-catalog has answered. Read-only.",
|
||||
"description": "The seat list this engine holds and what it waits for (novox/hq ADR 0636 \u00a77): each seat's source (trunk or bootstrap) and digest, the seats held from the bootstrap alone, the definitions refused, the last error and whether the seat mesh-catalog has answered. Read-only.",
|
||||
"input": {
|
||||
"type": "object",
|
||||
"properties": {}
|
||||
@@ -798,7 +877,7 @@
|
||||
},
|
||||
{
|
||||
"name": "seat-list-again",
|
||||
"description": "Make this engine read the seat list from the seat mesh-catalog now (novox/hq ADR 0636 §7), the recovery of a list unread; it answers what it holds afterwards, and the error when the read failed. A read that changed nothing still ends the engine's wait.",
|
||||
"description": "Make this engine read the seat list from the seat mesh-catalog now (novox/hq ADR 0636 \u00a77), the recovery of a list unread; it answers what it holds afterwards, and the error when the read failed. A read that changed nothing still ends the engine's wait.",
|
||||
"input": {
|
||||
"type": "object",
|
||||
"properties": {}
|
||||
@@ -1057,6 +1136,52 @@
|
||||
"$ref": "#/defs/ProcessBuilds"
|
||||
},
|
||||
"class": "read"
|
||||
},
|
||||
{
|
||||
"name": "converged",
|
||||
"description": "The node's convergence state, which the node-engine keeps (ADR 0168, ADR 0683; design 33 control-verbs \u00a710): adopted or converged, since when it became so, for an adopted node the kind of the firewall found, and the node's links as the engine classifies them: the tunnel's interface and the outward links (design 47 H-A-325). Read-only: the holder of node-packet-filter asks it at its start and at every allow and disallow, and refuses when it does not answer.",
|
||||
"class": "read",
|
||||
"input": {
|
||||
"type": "object",
|
||||
"properties": {}
|
||||
},
|
||||
"answer": {
|
||||
"type": "object",
|
||||
"required": [
|
||||
"state",
|
||||
"tunnel",
|
||||
"outward"
|
||||
],
|
||||
"properties": {
|
||||
"state": {
|
||||
"type": "string",
|
||||
"enum": [
|
||||
"adopted",
|
||||
"converged"
|
||||
],
|
||||
"description": "the node's mode: adopted (the found firewall's terms) or converged (the mesh's own filter)"
|
||||
},
|
||||
"since": {
|
||||
"type": "string",
|
||||
"description": "when the node became so, RFC 3339; absent where the engine recorded no time for it"
|
||||
},
|
||||
"found": {
|
||||
"type": "string",
|
||||
"description": "the kind of the firewall found, for an adopted node"
|
||||
},
|
||||
"tunnel": {
|
||||
"type": "string",
|
||||
"description": "the private network's tunnel interface on this node, as the engine's filter render names it"
|
||||
},
|
||||
"outward": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"type": "string"
|
||||
},
|
||||
"description": "the links of this node that face outside, as the engine classifies them for its filter render (ADR 0140); an allowance with no interface never opens one"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
],
|
||||
"events": [
|
||||
@@ -1205,6 +1330,10 @@
|
||||
"type": "boolean",
|
||||
"description": "the move changes the build alone"
|
||||
},
|
||||
"run": {
|
||||
"type": "string",
|
||||
"description": "the composition run's pipeline sequence, in decimal, the module was applied from (design 47 H2 §813 (1), H-A-388): a restarted engine applies no older run again"
|
||||
},
|
||||
"kept": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
@@ -1696,7 +1825,7 @@
|
||||
"description": "one finding of the observer that wrote it"
|
||||
}
|
||||
],
|
||||
"description": "the findings this node's engine raises about itself, one key per finding, in the layout of the seat mesh-conditions (its findings state): a key written raises the condition of the same key, a key deleted clears it (novox/hq ADR 0564 §2, ADR 0636 §1); today `machine.<node>.seat-list-unread`"
|
||||
"description": "the findings this node's engine raises about itself, one key per finding, in the layout of the seat mesh-conditions (its findings state): a key written raises the condition of the same key, a key deleted clears it (novox/hq ADR 0564 \u00a72, ADR 0636 \u00a71); today `machine.<node>.seat-list-unread`"
|
||||
},
|
||||
{
|
||||
"name": "bounds",
|
||||
@@ -1708,7 +1837,7 @@
|
||||
"key": "<what>.<id>",
|
||||
"value": {
|
||||
"type": "object",
|
||||
"description": "one bound a wait of the node-engine runs against, kept with its own time to live: its expiry is heard as the bus's delete marker and ends the wait (design 47 G §560, A-77)",
|
||||
"description": "one bound a wait of the node-engine runs against, kept with its own time to live: its expiry is heard as the bus's delete marker and ends the wait (design 47 G \u00a7560, A-77)",
|
||||
"properties": {
|
||||
"v": {
|
||||
"type": "integer",
|
||||
@@ -1815,7 +1944,7 @@
|
||||
},
|
||||
"auto": {
|
||||
"type": "boolean",
|
||||
"description": "the engine asked it itself, on finding a library's root holding data outside its group (ADR 0563 §4)"
|
||||
"description": "the engine asked it itself, on finding a library's root holding data outside its group (ADR 0563 \u00a74)"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
@@ -1825,7 +1954,7 @@
|
||||
"at",
|
||||
"state"
|
||||
],
|
||||
"description": "one act asked through the seat, as acts reads it (ADR 0563 §9)"
|
||||
"description": "one act asked through the seat, as acts reads it (ADR 0563 \u00a79)"
|
||||
},
|
||||
"ActSaid": {
|
||||
"type": "object",
|
||||
@@ -1870,7 +1999,7 @@
|
||||
"state",
|
||||
"node"
|
||||
],
|
||||
"description": "what the seat says of an act: the act, the path or access, the caller as the runtime proved it and the ask (ADR 0563 §1)"
|
||||
"description": "what the seat says of an act: the act, the path or access, the caller as the runtime proved it and the ask (ADR 0563 \u00a71)"
|
||||
},
|
||||
"Acts": {
|
||||
"type": "object",
|
||||
@@ -1961,7 +2090,7 @@
|
||||
"at",
|
||||
"why"
|
||||
],
|
||||
"description": "what a node-engine says when what it reads changed or its node returned (ADR 0618 §4)"
|
||||
"description": "what a node-engine says when what it reads changed or its node returned (ADR 0618 \u00a74)"
|
||||
},
|
||||
"Module": {
|
||||
"type": "object",
|
||||
@@ -2061,7 +2190,7 @@
|
||||
"why",
|
||||
"judged"
|
||||
],
|
||||
"description": "the engine's root-free verdict (ADR 0563 §6)"
|
||||
"description": "the engine's root-free verdict (ADR 0563 \u00a76)"
|
||||
},
|
||||
"Said": {
|
||||
"type": "object",
|
||||
@@ -2106,7 +2235,7 @@
|
||||
},
|
||||
"SeatList": {
|
||||
"type": "object",
|
||||
"description": "what an engine holds of the seat list (novox/hq ADR 0636 §7)",
|
||||
"description": "what an engine holds of the seat list (novox/hq ADR 0636 \u00a77)",
|
||||
"properties": {
|
||||
"status": {
|
||||
"type": "object",
|
||||
@@ -2451,6 +2580,10 @@
|
||||
"type": "string"
|
||||
}
|
||||
},
|
||||
"declaration-reads": {
|
||||
"type": "integer",
|
||||
"description": "the declaration Version its engine reads (design 47 H2 §813 (12), H-A-416 (2), H-A-419): the composer writes this node's declaration at the lower of its own Version and this one, 1 when none is stated"
|
||||
},
|
||||
"runner-capabilities": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
@@ -3160,7 +3293,7 @@
|
||||
},
|
||||
"Running": {
|
||||
"type": "object",
|
||||
"description": "a module's build running on a node, and its health: what the node-engines of other nodes and the grants part decide a seat's pass from (ADR 0660 §2), and the assigner reads a provider's and a canary's health and a put's end from (design 47 G 520); said again on the same subject each time healthy changes and for every module the have holds at the engine's start, kept last per subject with no age limit",
|
||||
"description": "a module's build running on a node, and its health: what the node-engines of other nodes and the grants part decide a seat's pass from (ADR 0660 \u00a72), and the assigner reads a provider's and a canary's health and a put's end from (design 47 G 520); said again on the same subject each time healthy changes and for every module the have holds at the engine's start, kept last per subject with no age limit",
|
||||
"properties": {
|
||||
"v": {
|
||||
"type": "integer",
|
||||
@@ -3331,6 +3464,52 @@
|
||||
"step",
|
||||
"since"
|
||||
]
|
||||
},
|
||||
"CompositionDiffEntry": {
|
||||
"type": "object",
|
||||
"required": [
|
||||
"name"
|
||||
],
|
||||
"properties": {
|
||||
"name": {
|
||||
"type": "string",
|
||||
"description": "the entry: an environment entry by its name, else the part of the resource that differs"
|
||||
},
|
||||
"running": {
|
||||
"type": "string",
|
||||
"description": "its value in the running composition; absent where the running one lacks it or the value is a secret"
|
||||
},
|
||||
"other": {
|
||||
"type": "string",
|
||||
"description": "its value in the other composition; absent where the other lacks it or the value is a secret"
|
||||
},
|
||||
"masked": {
|
||||
"type": "boolean",
|
||||
"description": "the value is a secret, so neither value is given"
|
||||
}
|
||||
},
|
||||
"description": "one entry that differs between the running composition and the other"
|
||||
},
|
||||
"CompositionDiffResource": {
|
||||
"type": "object",
|
||||
"required": [
|
||||
"resource",
|
||||
"entries"
|
||||
],
|
||||
"properties": {
|
||||
"resource": {
|
||||
"type": "string",
|
||||
"description": "the resource, as the composition names it"
|
||||
},
|
||||
"entries": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"$ref": "#/defs/CompositionDiffEntry"
|
||||
},
|
||||
"description": "the entries of the resource that differ"
|
||||
}
|
||||
},
|
||||
"description": "one resource with the entries of it that differ"
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user