alldigital/PSA
2
0
Fork 0
Code Issues Pull Requests Actions 14 Packages Projects Releases Wiki Activity
PSA/ee/appliance/ubuntu-iso/README.md
Hermes 284313f908
Some checks are pending
Bidi Control Character Guard / bidi-control-guard (push) Waiting to run
Details
Circular Dependency Check / Check for new circular dependencies (push) Waiting to run
Details
Citus Migration Smoke / Combined migrations on single-node Citus (push) Waiting to run
Details
E2E Fresh Install Tests / fresh-install-e2e (push) Waiting to run
Details
ext-v2 guardrails / Run ext-v2 guard and ESLint (push) Waiting to run
Details
Integration Tests / Check for relevant changes (push) Waiting to run
Details
Integration Tests / ${{ (github.event_name == 'schedule' || github.event.inputs.suite == 'full') && 'Full integration suite' || 'Tier-1 integration subset' }} (push) Blocked by required conditions
Details
Mobile checks / Mobile lint + typecheck (push) Waiting to run
Details
Mobile checks / Mobile unit tests (push) Waiting to run
Details
Mobile checks / Mobile dependency audit (report) (push) Waiting to run
Details
Mobile checks / Mobile reproducibility checks (push) Waiting to run
Details
Secrets guard (env backups) / Ensure no tracked env backup files (push) Waiting to run
Details
Temporal Readiness / fast-readiness (push) Waiting to run
Details
Temporal Readiness / docker-parity (push) Waiting to run
Details
TypeScript Type Check / Nx affected typecheck (push) Waiting to run
Details
Unit Tests / Skipped-test budget (push) Waiting to run
Details
Unit Tests / Nx affected unit tests (push) Waiting to run
Details
Unit Tests / Server unit coverage (informational) (push) Waiting to run
Details
Validate Tenant Management Schema / Check for relevant changes (push) Waiting to run
Details
Validate Tenant Management Schema / Validate Tenant Management Schema (push) Blocked by required conditions
Details
EE Workflows Build Guard / ee-workflows-build-guard (push) Waiting to run
Details
Initial import of AlgaPSA codebase from PSA server 
Excluded: .git, node_modules, secrets/, compose.env, assemblyscript tgz

Source: /opt/alga-psa on psa.joliet.tech
2026-06-22 16:12:17 -05:00

1.7 KiB
Raw Permalink Blame History

Ubuntu Appliance ISO Build Layout

This directory defines the Ubuntu Server 24.04 LTS appliance ISO build workspace.

Purpose

The Ubuntu ISO path replaces Talos-based image generation for supported appliance installs.

This layout separates concerns so later plan items can evolve independently:

  • config/nocloud/: autoinstall seed (user-data, meta-data) injected into the ISO.
  • overlay/: host files copied into the installed system (systemd units, scripts, defaults).
  • scripts/: repeatable build/validation automation.
  • work/: ephemeral unpacked ISO workspace.
  • output/: generated appliance ISO artifacts.

Build Contract

scripts/build-ubuntu-appliance-iso.sh is the single entrypoint. It stages host appliance artifacts through scripts/stage-host-artifacts.sh into overlay/opt/alga-appliance/ before ISO remaster steps.

Expected inputs:

  • A base Ubuntu Server 24.04 LTS ISO path (--base-iso).
  • A release version string (--release-version).

Expected outputs:

  • output/alga-appliance-ubuntu-<release-version>.iso
  • output/alga-appliance-ubuntu-<release-version>.sha256

Fresh Install Smoke

After building an ISO, validate the Kubernetes-hosted setup payload and then run a live fresh VM smoke with:

ee/appliance/tests/kubernetes-hosted-fresh-install-smoke.sh preflight \
  --overlay-root ee/appliance/ubuntu-iso/overlay

For a live VM, use the same script's live mode with the VM node IP and setup token printed on the appliance console.

Current Status

This commit establishes the layout and build interface (F001).

Autoinstall seed files now live in config/nocloud/user-data and config/nocloud/meta-data.

Subsequent features add host service artifacts and full ISO remastering.