Repository navigation
Release Process EN
Language: English ｜ Release-Process
The exact sequence a release walks. Every step has a gate; a failed gate stops the release.
git fetch && git status (clean tree, correct branch)
git tag --list 'WP-*' (the new tag does not exist yet)
make clean && make -j$(nproc) all
Gate: 0 errors 0 warnings (-Wall -Wextra -Werror is in the flags).
Outputs: build/opencube.iso, dist/OpenCubeOS-<ver>-src.zip,
dist/OpenCubeOS-<ver>-update.tar.gz.
make reproducible-check
Gate: PASS - ELF byte-identical across two clean builds.
make run-bios (banner + 233 commands + oc> + boot complete)
make run-uefi (same, through OVMF)
| Gate | Command | Must |
|---|---|---|
| Regression battery | tools/run_fix4_regression.py |
28/28 |
| Watchdog/logging/health E2E | tools/wp12_watchdog_logging_e2e.py |
14/14 |
| dhtest + cryptotest | in-guest | PASS |
| SSH E2E | paramiko suite (seeded /etc) | 5/5 |
| HTTPS E2E | reference server | 7/7 |
git tag WP-<stage>
git push origin main --tags
GitHub Release from the tag with the note containing: change summary,
new interfaces, known issues, the three SHA256s. Attach the three
assets. The release script (tools/build_release.sh) automates
manifest + note + upload.
tools/update_website.sh (versions/hashes/downloads on the site)
tools/sync_wiki.sh (docs/ -> the GitHub Wiki)
Gate: the live site shows the new version, the three SHA256s match the Release, downloads resolve HTTP 200 and hash-verify.
Copy the three assets + release note + the mirrored website files
into the private repository; push. Gate: git ls-remote on both
repos shows the expected HEADs.
- Both repos' remote HEADs match local.
- The tag exists on the public repo.
- Author identity on every release commit.
- gh-pages updated (live site serves the new version).
- update.json: version + build + package_sha256.
- Three-way asset hashes: local = Release API digest = live download.
- Website numbers (commands/interfaces/lines) match
docs/data/*.json. - The gates in step 4 all green (paste the outputs).
- Token hygiene (only last-4 ever shown).
- Whole-repo number consistency (233 / 162 / 140,672-class).
- Private mirror complete.
- CI green on the release commit.
The delivery report quotes: build evidence, all gate outputs, push outputs (public + private), the Release URL, the site URL, the three SHA256s, and the honest-deviation list.