Skip to content

docs(rhcos): real RHCOS validation evidence + operator guide#52

Merged
ErenAri merged 1 commit into
mainfrom
docs/rhcos-evidence
Jun 27, 2026
Merged

docs(rhcos): real RHCOS validation evidence + operator guide#52
ErenAri merged 1 commit into
mainfrom
docs/rhcos-evidence

Conversation

@ErenAri

@ErenAri ErenAri commented Jun 27, 2026

Copy link
Copy Markdown
Contributor

Closes the evidence gap on the RHCOS path. Earlier PRs added the opt-in mechanism (#50 Ignition boot, #51 operator image + opt-in); this proves it with a real run and documents it.

Real run (not a claim)

Downloaded the public RHCOS 4.16.51 qemu image, staged it via make rhcos-image RHCOS_IMAGE_URL=..., and ran with BPFCOMPAT_ENABLE_RHCOS=1:

  • Booted Red Hat Enterprise Linux CoreOS 416.94… (OpenShift 4.16), kernel 5.14.0-427.93.1.el9_4
  • Boot path: Ignition via -fw_cfg name=opt/com.coreos/config; SSH as core
  • ringbuf-modern artifact: load=pass, attach=1/1, kernel BTF present
  • Ring buffer is upstream-since-5.8 yet passes on this 5.14 RHCOS kernel — RHEL's backport, tested directly.

Sanity-checked the gate too: without BPFCOMPAT_ENABLE_RHCOS the run is correctly refused with the "stage image + opt in" reason.

Deliverables

  • docs/evidence-rhcos.md — committed evidence: result table, in-guest validator JSON, serial excerpt (ignition.platform.id=qemu, "CoreOS Ignition User Config Setup"), image provenance (public mirror + sha256s), reproduce steps.
  • docs/rhcos-openshift.md — operator guide: why opt-in, getting the image (public mirror / openshift-install coreos print-stream-json), the RHEL/Alma 9 interim kernel approximation, limits.
  • matrices/rhcos.yaml — ready-to-run single-profile matrix.
  • README — careful CoreOS/OpenShift note: FCOS Ignition boot implemented + public; RHCOS opt-in/operator-supplied; example commands; links to evidence + guide.

Honesty preserved

  • RHCOS stays out of the "Distributions covered" table (no evergreen public image).
  • /evidence/ is git-ignored (high-churn local output), so the decisive fields are inlined in docs/evidence-rhcos.md — the committed, reviewable record.
  • No image blobs or per-run SSH keys committed.

🤖 Generated with Claude Code

Records a real validation run inside a booted RHEL CoreOS guest and documents
the operator path end to end:

- docs/evidence-rhcos.md: committed evidence — RHCOS 416.94 (OpenShift 4.16),
  kernel 5.14.0-427.93.1.el9_4, ringbuf-modern load=pass attach=1/1, with the
  in-guest validator output, serial excerpt (ignition.platform.id=qemu), and
  image provenance (public OpenShift mirror, sha256s). Reproduce steps included.
- docs/rhcos-openshift.md: operator guide — why it's opt-in, getting the image
  (public mirror / openshift-install), the RHEL/Alma 9 interim kernel
  approximation, and limits.
- matrices/rhcos.yaml: ready-to-run single-profile matrix (required: false).
- README: a careful CoreOS/OpenShift note under the backports section — FCOS
  Ignition boot implemented + public; RHCOS opt-in, operator-supplied image;
  example commands; links to the evidence and guide. RHCOS stays OUT of the
  "Distributions covered" table (no public evergreen image).

Raw run artifacts live under evidence/rhcos/ locally (git-ignored as high-churn
output); the decisive fields are inlined in docs/evidence-rhcos.md.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@ErenAri ErenAri merged commit 4034e4f into main Jun 27, 2026
7 of 8 checks passed
@ErenAri ErenAri deleted the docs/rhcos-evidence branch June 27, 2026 10:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant