Repository navigation
v5.254.0
Added
- A hive now derives write-tier
project.reference_reposentries from an accepted request issue instead of needing the operator to hand-write them (#18139). When an authorized repo's bound workflow model declaresintake.referenceRepoFields(first:cncf-techdocs-assessment@curated-2026.11.2; hives bound to 11.1 must rebind), every repository the request form names in scope becomes anissues+prsreference repo once a person with write access appliestriage/accepted; a bot applying the label grants nothing. The credential is the App installation on the requesting org, with a read-only fallback and one marked comment on the request issue when there is none, so a derived entry never fails boot. Entries are rebuilt at boot, on every config reload and everyHIVE_REFERENCE_REPOS_DERIVE_INTERVAL(default10m), vanish when the issue closes or loses the label, are never written to any saved config, yield to a hand-written entry on the same repo, carry(from owner/repo#N)in the kick, and appear read-only in Settings with their source and credential state. Docs:agent-configuration.md,operator-reference/README.md,design/workflow-models.md,workflows/techdocs-assessment.md(#18157, #18158, #18159, #18160, #18161, #18162). - Spoke: optional report-only heartbeat mirror to a second hub (#18060, #18148). With
HIVE_MIRROR_HUB_URLandHIVE_MIRROR_HUB_HEARTBEAT_KEYset (the key comes from registering the hive on that hub, for example through its Register your own hive form), every heartbeat the primary hub accepts is also POSTed, in its own goroutine with its own short timeout (HIVE_MIRROR_HUB_TIMEOUT, default 5s), to the mirror hub as a reduced copy: the dashboard token hash, the App and webhook key fingerprints, authentication error text, the signed-in user list and the activity digest are left out, andHIVE_MIRROR_HUB_HIVE_IDcan override the reportedhive_id. The mirror's response is never applied: upgrade, restart, branch switch, breaker, GitHub App config, funded gateway, project claim, access list, visibility and cluster id from the mirror are counted and ignored, and logged at most once per hour asmirror_hub_response_ignored(field names only). A mirror failure never affects the primary heartbeat, liveness or the hive. The primary key is never sent to the mirror; without a mirror key nothing is sent.GET /api/health/deepshows the mirror underhub_heartbeat.mirror(url_host,last_ok,last_attempt,last_error,ignored_fields,last_ignored_fields), host only, never the key. project.reference_reposentries are now derived from accepted request issues at boot, on every config reload and everyHIVE_REFERENCE_REPOS_DERIVE_INTERVAL(default10m), in memory only: for each authorized repo whose bound workflow model declaresintake.referenceRepoFields, the hive lists open issues carryingtriage/accepted, reads who applied the label from the timeline and their repository permission, runs the request-form parser and installs the result on the proxy at theissues+prstier (hand-written entries win on the same repo, authorized repos are never derived, duplicates keep the first). Closing the request issue or removing the label drops the entry, its proxy policy and its kick line on the next pass; a saved overlay or runtime config never contains a derived entry; the kick's REFERENCE REPOS block appends(from owner/repo#N)and, for a read-only derived entry, the reason (#18139, #18159).
Changed
- The hub's
/get-started#self-hostcard now describes self-service registration (sign in, Register your own hive, copy the one-time key, paste the Compose, Podman or Kubernetes snippet) instead of telling self-hosters to open an issue and obtainHIVE_HUB_SECRETfrom the operator.hub-deployment.mdgains a Self-service registration section for operators,env-vars.mdnotes thatbyo-hives hold onlyHIVE_HEARTBEAT_KEY, and a newregister-self-hosted-hive.mdwalks owners through the flow (#18147, part of #18060).
SBOMs: SPDX JSON, generated by Syft against the linux/amd64 image digest, attached below for hive, hive-contributor, and hive-hub. They cover linux/amd64 only — see releases.md for why linux/arm64 is not scanned separately.
NOTICE: third-party license attribution for the Go module dependencies compiled into these images, attached below. Does not cover base-image OS packages or the Node.js/tmux layers built from source — see releases.md for the exact boundary.