Skip to content

v5.254.0

Choose a tag to compare

@github-actions github-actions released this 14 Nov 03:43
· 753 commits to v5 since this release

Added

  • A hive now derives write-tier project.reference_repos entries from an accepted request issue instead of needing the operator to hand-write them (#18139). When an authorized repo's bound workflow model declares intake.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 an issues+prs reference repo once a person with write access applies triage/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 every HIVE_REFERENCE_REPOS_DERIVE_INTERVAL (default 10m), 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_URL and HIVE_MIRROR_HUB_HEARTBEAT_KEY set (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, and HIVE_MIRROR_HUB_HIVE_ID can override the reported hive_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 as mirror_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/deep shows the mirror under hub_heartbeat.mirror (url_host, last_ok, last_attempt, last_error, ignored_fields, last_ignored_fields), host only, never the key.
  • project.reference_repos entries are now derived from accepted request issues at boot, on every config reload and every HIVE_REFERENCE_REPOS_DERIVE_INTERVAL (default 10m), in memory only: for each authorized repo whose bound workflow model declares intake.referenceRepoFields, the hive lists open issues carrying triage/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 the issues+prs tier (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-host card 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 obtain HIVE_HUB_SECRET from the operator. hub-deployment.md gains a Self-service registration section for operators, env-vars.md notes that byo- hives hold only HIVE_HEARTBEAT_KEY, and a new register-self-hosted-hive.md walks 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.