Captain Bob's CI directive (2026-11-17) and the design he ruled point by point (docs/v4.0.0/plans/2026-11-17-emergency-diagnostic-build.md). - v4/system/dump.c, v4/include/v4/dump.h: what a node was doing when it stopped -- the fault's kind, address and count; P A B; the data stack, T first; the return stack, R first, each entry named by the word it falls in (the backtrace; ROM and below-every-word said so); the running line. Bounded dictionary walk; no C library. Ruled: every build, on a stop only (a handled fault keeps its line). - kernel/src/v4/sk_v4.c: the dump before each of the three halts (not started; POST's blocks not let go; a node stopped on a fault) -- Hera and any stopped node. kernel/Makefile links dump.o. - scripts/nightly.sh diagnose [<stage>]: after a failed stage, that configuration built again with EMERGENCY_CONSOLE_ENABLED=1 -- build only, nothing booted (ruled) -- its artifacts kept in logs/<TS>/diagnose/ only from a build that passed, with a README saying how to launch it with --log-level=debug. Always exits 0: evidence, never a result. The protocol runs it after a failed stage and still exits with that stage's code; acceptance.yml, nightly.yml and release.yml run it `if: failure()`, before the logs are kept. Any failed stage triggers it (ruled). - capsules/BLOCK_MAP.md: as the build writes it -- the v4:physics.4th row, missing since28ffed8f(ruled: commit the regenerated map). - Test first: test_dump.c failed with no dump.c (logs/20261117-dump), then 15 checks at both widths and under ASan+UBSan. The diagnose stage: a real EMERGENCY amd64 build; a failing build exits 0 and keeps no artifacts (a defect found and fixed this way); the protocol path keeps the stage's exit. - Also the write-up of the regression at046ce0be, for ruling. Not yet: acceptance on a clean tree (the next run); the kernel's stop wiring is compile-tested only -- no boot reaches a stop on purpose. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_017RzZgrf7V7Zk2iczBXDRbm
122 lines
5.4 KiB
YAML
122 lines
5.4 KiB
YAML
# A release: pushing a tag v<version> builds that commit exactly as the nightly does -- the
|
|
# acceptance protocol, the proofs, the board images -- and the documents, and publishes both to
|
|
# starshipos-releases at that version:
|
|
#
|
|
# org.starship:kernelImage:<version> classifiers pc, pc-stick, raspi5, milkv, logs (nightly.yml)
|
|
# org.starship:documentation:<version> classifiers book, vol1, vol2, vol3, api (nightly-docs.yml)
|
|
#
|
|
# and makes the tag a Gitea release -- a pre-release for v<x.y.z>-alpha.N and the like -- with the
|
|
# images, SHA256SUMS, the documents and the StarshipOS Root CA's certificate attached, for anyone
|
|
# to download (#126; scripts/nightly.sh gitea-release). Needs the secret RELEASE_TOKEN: a token
|
|
# that may write the repository.
|
|
#
|
|
# The tag must name the version the tree says it is: v<LITHOS_VERSION> (kernel/Makefile). A tag
|
|
# that does not is refused before anything is built. A release repository takes a version once.
|
|
name: Release
|
|
|
|
on:
|
|
push:
|
|
tags: ['v*']
|
|
|
|
# No concurrency group (Captain Bob, 2026-11-11, #140: "It should be global"). The one runner
|
|
# (starshipos-vps) has capacity 1, so every job of every workflow waits its turn in Gitea's queue
|
|
# and none is cancelled; a runner-image rebuild still blocks the rest (2026-11-07). A shared
|
|
# concurrency group kept only one waiting run, and each run that joined cancelled it.
|
|
# The capacity is explicit in the runner's config.yaml: runner.capacity: 1 (FABRIC-3, 2026-11-11).
|
|
|
|
jobs:
|
|
release:
|
|
name: Release ${{ github.ref_name }}
|
|
runs-on: ubuntu-latest
|
|
container:
|
|
image: gitea.starshipos-f18.org/rajames/lithosananke-runner:4f675c8b75b2 # ci/runner-image (#120)
|
|
credentials: # the registry refuses anonymous pulls
|
|
username: rajames
|
|
password: ${{ secrets.PACKAGES_TOKEN }}
|
|
timeout-minutes: 240
|
|
steps:
|
|
- uses: actions/checkout@v4
|
|
with:
|
|
fetch-depth: 0
|
|
lfs: false
|
|
|
|
# A release refuses an unsigned build (Captain Bob, 2026-11-12: "release MUST refuse unsigned
|
|
# builds"), as the gate into master does (#174). It warned and went on.
|
|
# scripts/test_acceptance_signing.sh runs this step.
|
|
- name: The capsule-signing key
|
|
env:
|
|
KEY: ${{ secrets.CAPSULE_SIGN_KEY }}
|
|
run: | # ci/pki/make-ca.sh; kernel/Makefile signs with SIGN_KEY
|
|
if [ -n "$KEY" ]; then
|
|
f="${RUNNER_TEMP:-/tmp}/capsule-signing.key"
|
|
(umask 077; printf '%s\n' "$KEY" > "$f")
|
|
echo "SIGN_KEY=$f" >> "$GITHUB_ENV"; echo "The capsules will be signed."
|
|
else
|
|
echo "::error::No CAPSULE_SIGN_KEY secret: a release is not built unsigned."
|
|
exit 1
|
|
fi
|
|
|
|
- name: The tag names the tree's version
|
|
run: |
|
|
tree="v$(sed -n 's/^LITHOS_VERSION *?= *//p' kernel/Makefile)"
|
|
echo "tag ${{ github.ref_name }}, kernel/Makefile LITHOS_VERSION -> $tree"
|
|
[ "${{ github.ref_name }}" = "$tree" ] || { echo "The tag must be $tree, or LITHOS_VERSION changed first."; exit 1; }
|
|
echo "NIGHTLY_VERSION=${tree#v}" >> "$GITHUB_ENV"
|
|
|
|
- name: Install the dependencies
|
|
# INIT_PROOFS=0: the image's Isabelle has HOL-Library prebuilt; a full init would fetch a fresh
|
|
# Isabelle into the workspace and point isabelle at it, and the proofs would build HOL-Library
|
|
# from scratch -- killed (release run 196, v4.0.0-alpha.1)
|
|
run: make ARCH=amd64,aarch64,riscv64 init INIT_PROOFS=0 # the image has all but the documents' packages
|
|
|
|
- name: Acceptance amd64
|
|
run: scripts/nightly.sh accept amd64
|
|
- name: Acceptance aarch64
|
|
run: scripts/nightly.sh accept aarch64
|
|
- name: Acceptance riscv64
|
|
run: scripts/nightly.sh accept riscv64
|
|
- name: Acceptance PC stick loaded high
|
|
run: scripts/nightly.sh accept stick-high
|
|
- name: Acceptance 32-bit build
|
|
run: scripts/nightly.sh test-32
|
|
- name: Isabelle/HOL proofs
|
|
run: scripts/nightly.sh proofs
|
|
- name: Images
|
|
run: scripts/nightly.sh images
|
|
- name: Documents
|
|
run: scripts/nightly.sh docs
|
|
|
|
- name: Publish to Nexus
|
|
env:
|
|
NEXUS_USER: ci-publisher
|
|
NEXUS_PASSWORD: ${{ secrets.NEXUS_CI_PASSWORD }}
|
|
run: |
|
|
scripts/nightly.sh publish https://nexus.starshipos-f18.org/repository/starshipos-releases
|
|
scripts/nightly.sh publish-docs https://nexus.starshipos-f18.org/repository/starshipos-releases
|
|
|
|
- name: Gitea release # the downloads anyone can fetch (#126): no Nexus login
|
|
env:
|
|
RELEASE_TOKEN: ${{ secrets.RELEASE_TOKEN }} # a token that may write the repository
|
|
run: scripts/nightly.sh gitea-release "${{ github.ref_name }}"
|
|
|
|
- name: Keep the release
|
|
uses: actions/upload-artifact@v3
|
|
with:
|
|
name: release-${{ github.ref_name }}
|
|
path: |
|
|
build/nightly/
|
|
build/nightly-docs/
|
|
|
|
- name: EMERGENCY diagnostic build (on failure; evidence, not a result)
|
|
if: failure()
|
|
run: scripts/nightly.sh diagnose # build only; the failed step stays the job's failure
|
|
|
|
- name: Keep the logs and DoE CSVs
|
|
if: always()
|
|
uses: actions/upload-artifact@v3
|
|
with:
|
|
name: release-logs-${{ github.ref_name }}
|
|
path: |
|
|
logs/
|
|
experiments/bare_metal/runs/
|