lfg2025/archy
1
0
Fork 0
Code Issues 21 Pull Requests 1 Actions Packages Projects Releases 61 Wiki Activity
archy/image-recipe/_archived
History
Dorian ae12ff2517 fix(iso): fail builds on missing VPN binaries, skip units cleanly, invalidate stale rootfs cache 
v1.7.104 shipped ISOs whose units crash-looped (nostr-relay 3s loop,
archipelago-diag 203/EXEC) because build-time extraction failures were mere
warnings and the cached rootfs never tracked its recipe:

- hash the rootfs-defining region of the build script and rebuild when it
  changes (stale cache shipped ISOs without wpasupplicant/iw/rfkill)
- refuse to build without nvpn / nostr-rs-relay unless
  ALLOW_MISSING_VPN_BINARIES=1
- ConditionPathExists on nostr-relay/nostr-vpn/diag units so a stripped
  image skips them instead of crash-looping
- post-install test: every enabled archipelago*/nostr* unit must have an
  existing ExecStart payload

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-20 06:08:04 +01:00
..
.gitea-workflows
chore: purge retired git.tx1138.com registry host from the codebase
2026-07-10 18:55:32 +01:00
branding
chore(release): archive ISO build recipes, tarball-only releases
2026-04-23 15:36:00 -04:00
scripts
chore(release): archive ISO build recipes, tarball-only releases
2026-04-23 15:36:00 -04:00
build-auto-installer-iso.sh
fix(iso): fail builds on missing VPN binaries, skip units cleanly, invalidate stale rootfs cache
2026-07-20 06:08:04 +01:00
BUILD-ISO-STATUS.md
chore(release): archive ISO build recipes, tarball-only releases
2026-04-23 15:36:00 -04:00
build-unbundled-iso.sh
chore(release): archive ISO build recipes, tarball-only releases
2026-04-23 15:36:00 -04:00
ISO-BUILD-CHECKLIST.md
chore(release): archive ISO build recipes, tarball-only releases
2026-04-23 15:36:00 -04:00
README.md
chore(release): archive ISO build recipes, tarball-only releases
2026-04-23 15:36:00 -04:00
test-iso-qemu.sh
chore(release): archive ISO build recipes, tarball-only releases
2026-04-23 15:36:00 -04:00

README.md

Archived ISO build recipes

These scripts built the Archipelago auto-installer ISO (bundled and unbundled variants). As of v1.7.43-alpha, ISOs are no longer part of the release deliverable. Releases ship as tarballs consumed by scripts/self-update.sh on existing nodes.

Archived here rather than deleted so they can be resurrected if ISO distribution is reintroduced.

Contents

  • build-auto-installer-iso.sh — orchestrator, bundles container images into squashfs
  • build-unbundled-iso.sh — thin wrapper that sets BUNDLE_IMAGES=0 and delegates
  • test-iso-qemu.sh — smoke-tests a built ISO under QEMU
  • scripts/convert-iso-to-disk.sh — converts an ISO to a raw disk image
  • BUILD-ISO-STATUS.md, ISO-BUILD-CHECKLIST.md — contributor guides
  • branding/isohdpfx.bin — isolinux MBR hybrid image
  • .gitea-workflows/build-iso-dev.yml — CI workflow that ran the build+smoke-test

To resurrect

  1. git mv image-recipe/_archived/* image-recipe/ (adjust paths back)
  2. Restore .gitea/workflows/build-iso-dev.yml
  3. Re-add release-process references (see scripts/create-release.sh, docs/BETA-RELEASE-CHECKLIST.md, docs/hotfix-process.md, README.md).

Why archived

The release flow is simpler and faster as tarball-only:

  • releases/vX.Y.Z-alpha/archipelago (backend binary)
  • releases/vX.Y.Z-alpha/archipelago-frontend-X.Y.Z-alpha.tar.gz (frontend + AIUI + filebrowser UI assets)
  • releases/manifest.json (pointers + changelog)

Nodes pull these via scripts/self-update.sh from either Gitea mirror. Filebrowser and AIUI remain bundled inside the frontend tarball and deployed atomically by self-update.sh.