mesh-catalog/modules/mesh-build-image/module.json

{
  "module": "mesh-build-image",
  "version": "1",
  "moved": true,
  "runs-as": "mesh-build-image",
  "capabilities": [
    "package-manager",
    "user-namespaces"
  ],
  "state": [
    "keys",
    {"name": "steps", "ttl-seconds": 172800}, "pauses"
  ],
  "claims": [
    {
      "name": "node-build-image",
      "scope": "node",
      "serves": ["current", "pause", "resume"]
    }
  ],
  "config": {
    "capacity": {
      "type": "string",
      "description": "How many asks of the image build seat this module runs at once on each node, as node=asks pairs separated by commas, such as shanks=3,ace=2 (novox/hq ADR 0525 §5); a node set to 0 pulls nothing, a node not named runs one at a time. The control-node and the laptop build nothing.",
      "pattern": "|[a-z0-9_-]+=[0-9]+(,[a-z0-9_-]+=[0-9]+)*",
      "default": "shanks=3,ace=2,g14=0,novox=0"
    },
    "build-hours": {
      "type": "string",
      "description": "When each node may take this module's build asks, as node=HH:MM-HH:MM pairs in the node's local time, separated by commas, such as g14=18:00-06:00 (an end before its start crosses midnight). Outside its window a node takes no new step and finishes the ones it runs; a node not named, or an empty value, builds at any hour. The operator, 2026-10-26: g14 builds only outside office hours.",
      "pattern": "|[a-z0-9_-]+=([01][0-9]|2[0-3]):[0-5][0-9]-([01][0-9]|2[0-3]):[0-5][0-9](,[a-z0-9_-]+=([01][0-9]|2[0-3]):[0-5][0-9]-([01][0-9]|2[0-3]):[0-5][0-9])*",
      "default": ""
    },
    "cores-per-step": {
      "type": "number",
      "description": "How many processors one image step of this module needs (buildah, whose RUN lines are mostly fetches). The capacity above is an upper bound: on each node the module runs at most floor(the cores of its build slice's CPU quota / this) steps at once, the quota read live from its cgroup (issue 1806), so a lowered build CPU share never starves its steps. Above 0.",
      "minimum": 0.1,
      "default": 2
    }
  },
  "tools": [
    "build_image_fetch",
    "build_image_build",
    "build_image_copy",
    "build_image_release",
    "build_image_step",
    "build_image_steps",
    "build_image_step_end",
    "build_image_status",
    "build_image_health"
  ],
  "requires": [
    "forge-account",
    "rootless-image-build",
    "artifact-store",
    "node-tools"
  ],
  "own-secrets": {
    "broker": "${dir:state}/broker"
  },
  "secrets-owner": "mesh-build-image",
  "runtime-health": {
    "kind": "tool",
    "tool": "build_image_health",
    "interval": "60s",
    "timeout": "10s",
    "looks": 2,
    "grace": "60s"
  },
  "resources": [
    {
      "id": "account",
      "type": "user",
      "name": "mesh-build-image",
      "shell": "/usr/bin/nologin",
      "home": "/var/lib/mesh-build-image"
    },
    {
      "id": "state",
      "type": "directory",
      "mode": "0700",
      "owner": "mesh-build-image",
      "place": ".",
      "unknown": "program"
    },
    {
      "id": "settings",
      "trusted": false,
      "type": "file",
      "path": "${dir:state}/settings.json",
      "mode": "0600",
      "owner": "mesh-build-image",
      "takes-config": ["capacity", "cores-per-step", "build-hours"],
      "merge": "json",
      "template": "files/settings.json"
    },
    {
      "id": "work",
      "type": "directory",
      "path": "/var/lib/mesh-build-image-work",
      "mode": "0700",
      "owner": "mesh-build-image",
      "unknown": "program"
    },
    {
      "id": "store",
      "type": "directory",
      "path": "/var/lib/mesh-build-image-store",
      "mode": "0700",
      "owner": "mesh-build-image",
      "unknown": "program"
    },
    {
      "id": "ssh-dir",
      "type": "directory",
      "path": "${dir:state}/.ssh",
      "mode": "0700",
      "owner": "mesh-build-image",
      "unknown": "program"
    },
    {
      "id": "ssh-config",
      "type": "file",
      "path": "${dir:ssh-dir}/config",
      "owner": "mesh-build-image",
      "mode": "0600",
      "template": "files/forge"
    },
    {
      "id": "known-hosts",
      "type": "file",
      "path": "${dir:ssh-dir}/known_hosts",
      "owner": "mesh-build-image",
      "mode": "0644",
      "template": "files/known_hosts"
    },
    {
      "id": "git-config",
      "type": "file",
      "path": "${dir:state}/.config/git/config",
      "owner": "mesh-build-image",
      "mode": "0644",
      "template": "files/gitconfig"
    },
    {
      "id": "registry",
      "type": "file",
      "path": "${dir:state}/registry",
      "owner": "mesh-build-image",
      "mode": "0644",
      "template": "files/registry"
    },
    {
      "id": "git",
      "type": "package",
      "package": "git"
    },
    {
      "id": "openssh",
      "type": "package",
      "package": "openssh"
    }
  ],
  "build": {
    "artifacts": [
      {
        "name": "tools",
        "kind": "bundle",
        "language": "go",
        "system": "arch",
        "from": "cmd/mesh-build-image",
        "binary": "mesh-build-image",
        "loads": [
          "mesh-build-image"
        ]
      },
      {
        "name": "files",
        "kind": "archive",
        "from": "files"
      }
    ]
  }
}