Files
mesh-delivery/modules/mesh-delivery-pipeline/module.json
T
jschoubben cd08f1e1c2 runner: a test run is kept in the state test-runs with one clock, a cap and an age (R2)
A test run is now one key of test-runs: its untaken bound written at its start, its clock at
ask-taken and each step-progress, an expiry ending the run and every reader could not run and
dropping its ask, a run past its bound while the runner was away ended at its start, the cap
judged by the process, and an ended run aged with its output object in the step log's order.

Builds: design 47 G §725, §720 (When the clock ends, A run never taken); A-466n, A-466p, A-466s, A-468b, A-468c, A-469d, A-469e, A-469w, A-469x, A-470, A-470a
2026-11-17 11:31:26 +01:00

289 lines
7.4 KiB
JSON

{
"module": "mesh-delivery-pipeline",
"version": "0.1",
"slug": "pipeline",
"claims": [
{
"name": "mesh-pipeline-runner",
"scope": "mesh",
"serves": [
"run",
"start",
"show",
"list",
"stands",
"why-carried",
"kept",
"review",
"rerun",
"accept",
"cancel",
"ask-again"
]
}
],
"tools": [
"runner_first_views",
"runner_first_view_again",
"runner_health",
"runner_unlogged",
"runner_unlogged_append"
],
"consumes": [
"mesh-delivery-indexer.take-in.taken",
"mesh-builds.package-published",
"mesh-builds.toolchain-agreed",
"mesh-builds.step-ended",
"operator-channel.decided",
"node-build-go.step-ended",
"node-build-node.step-ended",
"node-build-image.step-ended",
"node-build-go.ask-taken",
"node-build-node.ask-taken",
"node-build-image.ask-taken",
"node-build-go.step-progress",
"node-build-node.step-progress",
"node-build-image.step-progress",
"mesh-wants.step-ended",
"mesh-catalog.registration-changed",
"mesh-catalog.catalog-revision",
"mesh-conditions.findings-asked",
"mesh-delivery.recovery-merged",
"mesh-catalog.seat-definition-changed",
"mesh-catalog.seat-definition-removed"
],
"invokes": [
"seat:mesh-catalog.seat-definitions",
"seat:mesh-catalog.registrations",
"seat:mesh-catalog.revision",
"seat:mesh-hand-acts.hand-act",
"seat:mesh-catalog.outdated",
"seat:git.pull",
"seat:mesh-module-assigner.assignments",
"seat:mesh-grants.grants-for",
"seat:mesh-builds.step",
"seat:mesh-wants.step",
"seat:node-build-go.check.step",
"seat:node-build-node.check.step",
"seat:node-build-image.check.step",
"seat:node-build-go.delivery.step",
"seat:node-build-node.delivery.step",
"seat:node-build-image.delivery.step",
"seat:node-build-go.drop",
"seat:node-build-node.drop",
"seat:node-build-image.drop",
"seat:node-build-go.accept.check",
"seat:node-build-go.accept.delivery",
"seat:node-build-node.accept.check",
"seat:node-build-node.accept.delivery",
"seat:node-build-image.accept.check",
"seat:node-build-image.accept.delivery"
],
"uses": [
"operator-channel"
],
"config": {
"test-runs-cap-mib": {
"type": "number",
"description": "MiB of the state test-runs at which the runner asks no new test run and ends the step could not run, naming the fill (design 47 G section 725, A-469d); the manifest's max-mib is the ceiling.",
"minimum": 1,
"maximum": 64,
"trusted": false,
"default": 16
},
"test-runs-kept": {
"type": "string",
"description": "how long an ended test run and its output object are kept after its end, a Go duration such as 168h (design 47 G section 725, A-469x, A-470a); at most 168h, so the pipeline naming its key is still kept.",
"trusted": false,
"default": "168h"
},
"test-step-bound": {
"type": "string",
"description": "how long a taken test run's ask may say no progress before the run ends could not run, a Go duration such as 30m, counted from the build seat's ask-taken and again from each step-progress (design 47 G section 725, A-466n, A-469x).",
"trusted": false,
"default": "30m"
},
"run-untaken-bound": {
"type": "string",
"description": "how long a test run's ask may wait untaken after the run's start before the run ends could not run, a Go duration such as 24h (design 47 G section 725, A-466s, A-469x).",
"trusted": false,
"default": "24h"
}
},
"state": [
{
"name": "pipelines",
"history": 1,
"max-mib": 256
},
{
"name": "kept",
"history": 1,
"max-mib": 128
},
{
"name": "aged",
"history": 1
},
{
"name": "recoveries",
"history": 1
},
{
"name": "toolchains",
"history": 1
},
{
"name": "bounds",
"history": 1,
"key-ttl": true
},
{
"name": "test-runs",
"history": 1,
"max-mib": 64,
"key-ttl": true
},
{
"name": "findings",
"history": 1
},
{
"name": "first-views",
"history": 1
},
{
"name": "consumers",
"history": 1
}
],
"streams": [
{
"name": "mesh-delivery-pipeline-findings",
"events": [
"finding-written.*",
"finding-cleared.*",
"findings-stated.*"
],
"max-age-days": 7,
"max-mib": 16
}
],
"objects": [
{
"name": "step-outputs",
"max-mib": 1024
},
{
"name": "sent-objects",
"max-mib": 256
}
],
"own-secrets": {
"broker": "${dir:state}/broker"
},
"secrets-owner": "mesh-delivery-pipeline",
"resources": [
{
"id": "account",
"type": "user",
"name": "mesh-delivery-pipeline",
"shell": "/usr/bin/nologin",
"home": "/var/lib/mesh-delivery-pipeline"
},
{
"id": "state",
"type": "directory",
"mode": "0700",
"owner": "mesh-delivery-pipeline",
"place": ".",
"unknown": "program"
},
{
"id": "test-runs-cap",
"type": "file",
"path": "${dir:state}/test-runs-cap-mib",
"owner": "mesh-delivery-pipeline",
"mode": "0600",
"content": "${config:test-runs-cap-mib}"
},
{
"id": "test-runs-kept",
"type": "file",
"path": "${dir:state}/test-runs-kept",
"owner": "mesh-delivery-pipeline",
"mode": "0600",
"content": "${config:test-runs-kept}"
},
{
"id": "test-step-bound",
"type": "file",
"path": "${dir:state}/test-step-bound",
"owner": "mesh-delivery-pipeline",
"mode": "0600",
"content": "${config:test-step-bound}"
},
{
"id": "run-untaken-bound",
"type": "file",
"path": "${dir:state}/run-untaken-bound",
"owner": "mesh-delivery-pipeline",
"mode": "0600",
"content": "${config:run-untaken-bound}"
},
{
"id": "pipeline",
"type": "process",
"name": "mesh-delivery-pipeline",
"artifact": "program",
"run": [
"./mesh-delivery-pipeline"
],
"env": {
"MESH_BROKER_FILE": "${dir:state}/broker",
"MESH_RUNNER_TEST_RUNS_CAP_FILE": "${dir:state}/test-runs-cap-mib",
"MESH_RUNNER_TEST_RUNS_KEPT_FILE": "${dir:state}/test-runs-kept",
"MESH_RUNNER_TEST_STEP_BOUND_FILE": "${dir:state}/test-step-bound",
"MESH_RUNNER_RUN_UNTAKEN_BOUND_FILE": "${dir:state}/run-untaken-bound"
},
"user": "mesh-delivery-pipeline",
"health": {
"kind": "unit"
}
}
],
"build": {
"artifacts": [
{
"name": "program",
"kind": "bundle",
"language": "go",
"system": "arch",
"from": "cmd/mesh-delivery-pipeline",
"binary": "mesh-delivery-pipeline",
"needs": [
"mesh-delivery-assigner:program"
]
},
{
"name": "tools",
"kind": "bundle",
"language": "go",
"system": "arch",
"from": "cmd/mesh-delivery-pipeline-tools",
"binary": "mesh-delivery-pipeline-tools",
"loads": [
"mesh-delivery-pipeline-tools"
]
}
]
},
"logs": [
{
"name": "step-log",
"max-age-days": 100,
"max-mib": 128
}
]
}