Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
55 commits
Select commit Hold shift + click to select a range
a11727b
fix(renovate): match the freedesktop-sdk series the junction actually…
hanthor Sep 10, 2026
f25bcee
refactor: switch OS payload to Flatcar base, drop displaced FSDK comp…
kylerankin Sep 13, 2026
e5fba15
fix(installer): ld.so.conf uses Flatcar /usr/lib64, not Debian multiarch
kylerankin Sep 14, 2026
dca9fe7
fix(flatcar): drop duplicate flatcar-usr.bst, provided by #140
kylerankin Sep 14, 2026
e55b365
fix(installer): keep host ld.so.conf on Debian multiarch path
kylerankin Sep 14, 2026
5536e39
Merge remote-tracking branch 'origin/main' into refresh-pr-132
castrojo Sep 14, 2026
850463d
Merge remote-tracking branch 'origin/main' into refresh-pr-84
castrojo Sep 14, 2026
b972378
Merge remote-tracking branch 'origin/main' into refresh-pr-132
castrojo Sep 14, 2026
01b3d62
Merge remote-tracking branch 'origin/main' into refresh-pr-84
castrojo Sep 14, 2026
b2e3836
Merge remote-tracking branch 'origin/main' into refresh-pr-132
castrojo Sep 15, 2026
9cb7789
Merge remote-tracking branch 'origin/main' into refresh-pr-84
castrojo Sep 15, 2026
29e20ec
Merge remote-tracking branch 'origin/main' into refresh-pr-132
castrojo Sep 15, 2026
2fd5283
Merge remote-tracking branch 'origin/main' into refresh-pr-84
castrojo Sep 15, 2026
312e11d
ci(just): run the renovate series guard in validate
castrojo Sep 18, 2026
45ca29e
ci: expand unit-tests workflow paths trigger
mrbobbytables Sep 19, 2026
a13e40a
fix(ci): pin just tool version in CI workflows
Sep 19, 2026
8e96b1c
fix(installer): align target ld.so.conf path + add linker-path contra…
Sep 19, 2026
5f9ab23
fix(installer): revert ld.so.conf write path — -f resolves post-chroot
Sep 19, 2026
dd31769
test(132): drop duplicate test_os_countme from #132
Sep 19, 2026
668ffd1
docs(ci-tooling): pin the tool version in the canonical just snippet
Sep 20, 2026
e3ad842
fix(installer): bound root-a partition to guarantee room for var (#207)
mrbobbytables Sep 20, 2026
1698c25
[sec-check] fix: harden sshd drop-in — no root password login over ne…
hivecommons-hive[bot] Sep 20, 2026
5575404
[scanner] fix: propagate lima-e2e browser-verification failures (#160)
hivecommons-hive[bot] Sep 20, 2026
e8aa8a6
test: executed coverage for docs-checks.py main() — new tests/unit/te…
hivecommons-hive[bot] Sep 20, 2026
d8cfa65
test: behavioral coverage for files/bin/bluefin-kubestellar — tests/u…
hivecommons-hive[bot] Sep 20, 2026
547f5f7
test(build-depends): lock in os-countme curl+jq FSDK paths (#122)
kylerankin Sep 20, 2026
115c0da
test: files/ payload reachability gate — tests/unit/test_files_payloa…
hivecommons-hive[bot] Sep 20, 2026
fc1d164
feat(arch): produce Flatcar-to-FSDK version parity matrix (#142) (#184)
mrbobbytables Sep 20, 2026
9b506c7
feat(flatcar): record container runtime parity (#192)
castrojo Sep 20, 2026
32a212c
fix(ci): move junction ref tracking out of the pull_request path (#180)
castrojo Sep 20, 2026
230e6fa
Merge pr189
castrojo Sep 20, 2026
9523bf5
Merge pr84
castrojo Sep 20, 2026
13488ea
Merge pr190
castrojo Sep 20, 2026
c3bd1fe
Merge pull request #217 from projectbluefin/ci/pin-just-and-expand-paths
castrojo Sep 20, 2026
cdb1683
fix(boot): resolve QEMU installer boot deadlock and console readiness…
mrbobbytables Sep 21, 2026
e13f4a6
fix(installer): hard preflight abort when bluefin-installer-data is a…
castrojo Sep 21, 2026
f9bdef4
fix(justfile): probe install-vm kiosk readiness from inside the guest…
castrojo Sep 22, 2026
d003122
fix: generate SSH host keys on device, not in the published DDI (#216)
hivecommons-hive[bot] Sep 22, 2026
0beec80
ci: include scripts/** in unit-tests workflow paths filter (#234)
mendezr Sep 22, 2026
3f79592
docs: appliance identity, mDNS, and Bash prompt design (#208)
hivecommons-hive[bot] Sep 22, 2026
b5f9962
chore(renovate): disable the homebrew manager for binary-asset formul…
castrojo Sep 22, 2026
438426c
fix(installer): harden flash-installer with refusal guards, write ver…
castrojo Sep 22, 2026
dc3b424
test(kiosk): executed coverage for kiosk-gate.js — tests/unit/test_ki…
hivecommons-hive[bot] Sep 22, 2026
dc48bfb
revert: "docs: appliance identity, mDNS, and Bash prompt design (#208…
castrojo Sep 22, 2026
d0c770c
feat(creds): extend systemd-creds provisioning to SSH keys, network, …
mrbobbytables Sep 23, 2026
f3c8975
arch: make include/flatcar.yml the single source of truth for Flatcar…
kylerankin Sep 23, 2026
4298278
fix(kiosk): console shows live local cluster state on first boot (#214)
kylerankin Sep 23, 2026
ab5a717
fix(k0s): pin argocd image by digest and upgrade past EOL v2.12.3 (#212)
kylerankin Sep 23, 2026
90f37fd
test(installer): behavioural contract for the QEMU boot-proof readine…
Danathar Sep 23, 2026
3008ada
feat(installer): add opt-in PXE network DDI pull (#229)
kylerankin Sep 23, 2026
39ba324
build: os-base option to compare FSDK payload against Flatcar referen…
kylerankin Sep 23, 2026
874679a
feat(flatcar): add flatcar-usr.bst importing Flatcar /usr as the OS p…
mrbobbytables Sep 23, 2026
e7e6c32
fix(flatcar): use flatcar-kernel-container-sha256 variable in flatcar…
castrojo Sep 23, 2026
498d192
refactor(arch): split release-version into installer and Flatcar axes…
mrbobbytables Sep 23, 2026
a50c485
refactor: switch OS payload to Flatcar base, drop displaced FSDK comp…
castrojo Sep 23, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
106 changes: 106 additions & 0 deletions .github/scripts/check-flatcar-version.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,106 @@
#!/usr/bin/env python3
"""Enforce the Flatcar single-source-of-truth invariant.

include/flatcar.yml is the ONLY place a Flatcar upstream version or sha256 is
declared. Every Flatcar element reads those values through %{...} variable
substitution (see elements/flatcar/*.bst); nothing restates a pin.

This script fails the build when a pinned literal — a Flatcar version, kernel
vermagic, or source sha256 — is hardcoded anywhere in elements/ or files/,
where it would drift from include/flatcar.yml and silently pull a different
upstream payload than the pin file names. It reads the declared pins out of
include/flatcar.yml and greps the tree for any copy of them outside that file,
in the spirit of check-release-version.py.
"""

import re
import sys
import os
from pathlib import Path

ROOT = Path(__file__).resolve().parents[2]
PIN_FILE = ROOT / "include" / "flatcar.yml"
SCAN_DIRS = (ROOT / "elements", ROOT / "files")

# A `key: "value"` / `key: 'value'` / `key: bare` line inside the variables:
# block of the pin file. The captured group is the declared pin literal.
VAR_RE = re.compile(
r'^\s+[A-Za-z0-9_.-]+:\s*(?:"([^"]*)"|' r"'([^']*)'" r'|([^\s#]+))',
re.MULTILINE,
)
# Directories that legitimately echo upstream digests and must never be scanned.
SKIP_DIRS = {".git", "__pycache__", "node_modules"}


def read(path):
if not path.is_file():
sys.exit(f"ERROR: expected file not found: {path.relative_to(ROOT)}")
return path.read_text(encoding="utf-8")


def declared_pins(pin_text):
"""Every literal declared in the variables: block of the pin file."""
pins = []
for value in VAR_RE.findall(pin_text):
literal = next(part for part in value if part)
if literal:
pins.append(literal)
return pins


def iter_scan_files():
for scan_dir in SCAN_DIRS:
if not scan_dir.is_dir():
continue
# os.walk with dir pruning so files under .git / __pycache__ /
# node_modules are never read (rglob would flatten and scan them).
for root, dirs, files in os.walk(scan_dir):
dirs[:] = [d for d in dirs if d not in SKIP_DIRS]
for name in files:
if name.endswith(".pyc"):
continue
yield Path(root) / name


def is_binary(text):
return "\x00" in text


def main():
pins = declared_pins(read(PIN_FILE))
if not pins:
sys.exit(
"ERROR: include/flatcar.yml declares no pins to enforce. Add the "
"Flatcar version / sha256 variables here."
)

violations = []
for path in iter_scan_files():
try:
text = path.read_text(encoding="utf-8")
except (UnicodeDecodeError, OSError):
continue
if is_binary(text):
continue
for pin in pins:
if pin in text:
violations.append((path.relative_to(ROOT), pin))

if violations:
lines = [
"ERROR: Flatcar pin(s) hardcoded outside include/flatcar.yml.\n"
"Every Flatcar version and sha256 must live in include/flatcar.yml "
"and be\n"
"referenced via %{...}; hardcoding one here lets it drift from the "
"pin file.\n"
"\nRemove the literal and read it from include/flatcar.yml:"
]
for path, pin in violations:
lines.append(f" {path}: {pin}")
sys.exit("\n".join(lines))

print(f"OK: no Flatcar pins hardcoded outside include/flatcar.yml ({len(pins)} pinned).")


if __name__ == "__main__":
main()
4 changes: 2 additions & 2 deletions .github/scripts/check-k0s-version.py
Original file line number Diff line number Diff line change
Expand Up @@ -128,9 +128,9 @@ def main():
"restore the sysext asset filename assignment.",
)
fname_expr = fname_match.group(1)
if "%{release-version}" in fname_expr:
if any(axis in fname_expr for axis in ("%{release-version}", "%{installer-version}", "%{flatcar-version}")):
fail(
"elements/oci/k0s-sysext.bst names the k0s sysext on the OS release\n"
"elements/oci/k0s-sysext.bst names the k0s sysext on an OS release\n"
f" axis: FNAME=\"{fname_expr}\"\n"
" 70-k0s.transfer reads this filename as the version of the k0s it\n"
" delivers.",
Expand Down
92 changes: 53 additions & 39 deletions .github/scripts/check-release-version.py
Original file line number Diff line number Diff line change
@@ -1,29 +1,30 @@
#!/usr/bin/env python3
"""Enforce the release-version invariant for Bluefin Server.

project.conf declares:
The two release version axes are each declared in exactly one place:

variables:
release-version: "X.Y.Z" # must match the FSDK point release
project.conf installer-version: "X.Y.Z" # FSDK point release
include/flatcar.yml flatcar-version: "X.Y.Z" # Flatcar LTS release

That value names every published *OS* release asset
(`bluefin-server-ddi-<v>.raw.zst`, `bluefin-server-<v>.efi`,
`bluefin-server-installer-<v>.raw.zst`) and is the version
systemd-sysupdate extracts from those filenames via `@v`.
The installer-version axis names the offline installer disk image and PXE boot
inputs (bluefin-server-installer-<v>.raw.zst, bluefin-server-pxe-*), which
compose their userspace from freedesktop-sdk.

The k0s sysext is deliberately *not* on this axis: it is an
independently-pinned third-party payload versioned from `include/k0s.yml`
and enforced separately by `.github/scripts/check-k0s-version.py`.
The flatcar-version axis names the OS payload release assets
(bluefin-server-ddi-<v>.raw.zst, bluefin-server-<v>.efi) and is the version
systemd-sysupdate extracts from those filenames via `@v`. project.conf pulls
include/flatcar.yml in via its `(@)` list, so %{flatcar-version} resolves
project-wide without being restated.

The release *tag* is derived independently by the Justfile
(`fsdk_version`), which greps the point release out of the pinned
`elements/freedesktop-sdk.bst` junction ref. Renovate bumps that ref
automatically; nothing bumps `release-version`. When the two drift, CI
publishes a new tag containing assets that still carry the old version
string, so `systemd-sysupdate` sees no version change and the fleet
silently stops updating.
The k0s sysext is on its own axis: an independently-pinned third-party
payload versioned from `include/k0s.yml` and enforced separately by
`.github/scripts/check-k0s-version.py`.

This script fails closed on that drift.
This script validates both axes against their pins:
* project.conf installer-version against elements/freedesktop-sdk.bst
* include/flatcar.yml flatcar-version is well-formed

This script fails closed on any drift.
"""

import re
Expand All @@ -33,11 +34,15 @@
ROOT = Path(__file__).resolve().parents[2]
PROJECT_CONF = ROOT / "project.conf"
FSDK_JUNCTION = ROOT / "elements" / "freedesktop-sdk.bst"
FLATCAR_PIN = ROOT / "include" / "flatcar.yml"

RELEASE_VERSION_RE = re.compile(
r"^\s*release-version:\s*[\"']?([0-9]+\.[0-9]+\.[0-9]+)[\"']?\s*$", re.MULTILINE
INSTALLER_VERSION_RE = re.compile(
r"^\s*installer-version:\s*[\"']?([0-9]+\.[0-9]+\.[0-9]+)[\"']?\s*$", re.MULTILINE
)
FSDK_REF_RE = re.compile(r"freedesktop-sdk-([0-9]+\.[0-9]+\.[0-9]+)")
FLATCAR_PIN_RE = re.compile(
r"^\s*flatcar-version:\s*[\"']?([0-9]+\.[0-9]+\.[0-9]+)[\"']?\s*$", re.MULTILINE
)


def read(path):
Expand All @@ -49,39 +54,48 @@ def read(path):
def main():
conf = read(PROJECT_CONF)
junction = read(FSDK_JUNCTION)
flatcar = read(FLATCAR_PIN)

conf_match = RELEASE_VERSION_RE.search(conf)
if not conf_match:
installer_match = INSTALLER_VERSION_RE.search(conf)
if not installer_match:
sys.exit(
"ERROR: project.conf does not declare a "
"'release-version: X.Y.Z' variable."
"ERROR: project.conf does not declare an "
"'installer-version: X.Y.Z' variable."
)
declared = conf_match.group(1)
installer_declared = installer_match.group(1)

ref_match = FSDK_REF_RE.search(junction)
if not ref_match:
fsdk_match = FSDK_REF_RE.search(junction)
if not fsdk_match:
sys.exit(
"ERROR: elements/freedesktop-sdk.bst has no "
"'freedesktop-sdk-X.Y.Z' point release in its ref."
)
pinned = ref_match.group(1)
fsdk_pinned = fsdk_match.group(1)

flatcar_pin_match = FLATCAR_PIN_RE.search(flatcar)
if not flatcar_pin_match:
sys.exit(
"ERROR: include/flatcar.yml does not declare a "
"'flatcar-version: X.Y.Z' variable."
)
flatcar_pinned = flatcar_pin_match.group(1)

if declared != pinned:
if installer_declared != fsdk_pinned:
sys.exit(
"ERROR: release-version drift.\n"
f" project.conf release-version : {declared}\n"
f" elements/freedesktop-sdk.bst pinned ref: {pinned}\n"
"ERROR: installer-version drift.\n"
f" project.conf installer-version : {installer_declared}\n"
f" elements/freedesktop-sdk.bst pinned ref: {fsdk_pinned}\n"
"\n"
"The release tag is derived from the junction ref while asset\n"
"filenames are derived from release-version. While these differ,\n"
"a new GitHub Release publishes assets still named with the old\n"
"version, systemd-sysupdate reads the old version from '@v', and\n"
"deployed hosts never see an update.\n"
"The installer release tag and installer assets are derived from the\n"
"junction ref while project.conf declares installer-version.\n"
"\n"
f"Fix: set release-version to \"{pinned}\" in project.conf."
f"Fix: set installer-version to \"{fsdk_pinned}\" in project.conf."
)

print(f"OK: release-version {declared} matches the pinned FSDK point release.")
print(
f"OK: installer-version {installer_declared} matches pinned FSDK point release.\n"
f"OK: flatcar-version {flatcar_pinned} declared in include/flatcar.yml."
)


if __name__ == "__main__":
Expand Down
125 changes: 125 additions & 0 deletions .github/scripts/check-renovate-series.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,125 @@
#!/usr/bin/env python3
"""Keep Renovate's version filters on the same release series as the junctions.

`elements/*.bst` pin a junction with a `track:` glob and a resolved `ref:`:

track: freedesktop-sdk-26.08*
ref: freedesktop-sdk-26.08.0-0-gdb97cce...

`renovate.json` decides which upstream tags are candidates for a bump with a
per-package `extractVersion` anchored to that same series:

"extractVersion": "^freedesktop-sdk-(?<version>26\\.08\\.[0-9]+)$"

Nothing ties the two together. When a junction moves to a new series and the
Renovate rule does not, the rule stops matching every tag upstream publishes.
Renovate then reports no updates rather than an error, so the junction quietly
stops receiving bumps and the `track-refs` job in build.yml has nothing to
resolve. That is not hypothetical: the freedesktop-sdk rule still read
`25\\.08\\.` after the junction moved to `freedesktop-sdk-26.08.0`.

This script fails closed on that drift. It reads the series out of each
junction's `track:` glob and asserts the matching `extractVersion` in
renovate.json is anchored to the same one.
"""

import json
import re
import sys
from pathlib import Path

ROOT = Path(__file__).resolve().parents[2]
RENOVATE_JSON = ROOT / "renovate.json"

# depName in renovate.json -> the junction whose `track:` is authoritative.
JUNCTIONS = {
"https://gitlab.com/freedesktop-sdk/freedesktop-sdk.git": (
ROOT / "elements" / "freedesktop-sdk.bst"
),
"https://gitlab.gnome.org/GNOME/gnome-build-meta.git": (
ROOT / "elements" / "gnome-build-meta.bst"
),
}

TRACK_RE = re.compile(r"^\s*track:\s*[\"']?([^\"'\s]+)[\"']?\s*$", re.MULTILINE)


def read(path):
if not path.is_file():
sys.exit(f"ERROR: expected file not found: {path.relative_to(ROOT)}")
return path.read_text(encoding="utf-8")


def series_of(track):
"""The literal prefix of a track glob, with the trailing '*' removed.

`freedesktop-sdk-26.08*` -> `freedesktop-sdk-26.08`
`gnome-50` -> `gnome-50` (no glob; the whole value)
"""
return track.split("*", 1)[0]


def digits(text):
"""Version-ish digit groups, so an escaped regex and a plain glob compare.

`^freedesktop-sdk-(?<version>26\\.08\\.[0-9]+)$` -> ['26', '08']
`freedesktop-sdk-26.08` -> ['26', '08']
`[0-9]+` is dropped: it is the part Renovate fills in, not a series digit.
"""
stripped = text.replace("\\.", ".").replace("[0-9]+", "")
return [g for g in re.findall(r"\d+", stripped)]


def main():
config = json.loads(read(RENOVATE_JSON))
rules = config.get("packageRules", [])
failures = []
checked = 0

for dep_name, junction_path in JUNCTIONS.items():
matching = [
rule
for rule in rules
if dep_name in rule.get("matchPackageNames", [])
and "extractVersion" in rule
]
if not matching:
failures.append(
f"renovate.json has no packageRule with an extractVersion for "
f"{dep_name}; {junction_path.relative_to(ROOT)} would never be bumped"
)
continue

track_match = TRACK_RE.search(read(junction_path))
if not track_match:
failures.append(
f"{junction_path.relative_to(ROOT)} declares no `track:`; "
"cannot verify the Renovate series against it"
)
continue

series = series_of(track_match.group(1))
want = digits(series)

for rule in matching:
checked += 1
got = digits(rule["extractVersion"])
if got != want:
failures.append(
f"{junction_path.relative_to(ROOT)} tracks `{track_match.group(1)}` "
f"(series {'.'.join(want) or '<none>'}) but renovate.json filters "
f"{dep_name} with extractVersion {rule['extractVersion']!r} "
f"(series {'.'.join(got) or '<none>'}). Renovate matches no tag, "
"so this junction gets no update PRs."
)

if failures:
for failure in failures:
print(f"ERROR: {failure}", file=sys.stderr)
sys.exit(1)

print(f"OK: {checked} Renovate version filter(s) match their junction `track:` series")


if __name__ == "__main__":
main()
Loading
Loading