archy/.claude/memory/project_cicd_setup.md

---
name: CI/CD Setup
description: Gitea Actions CI/CD — runner on .228, workflow builds unbundled ISO on push to main
type: project
---

CI/CD pipeline using Gitea Actions on git.tx1138.com.

**Why:** Automatic ISO builds on every push to main. ISOs copied to FileBrowser /Builds/ for download.

**How to apply:**
- Gitea repo: `git.tx1138.com/lfg2025/archy`
- Runner: .228 registered as `archipelago-builder` with label `ubuntu-latest:host`
- Runner service: `gitea-runner.service` (systemd, runs as archipelago user)
- Runner config: `~/.runner` on .228
- Workflow: `.gitea/workflows/build-iso.yml` — unbundled ISO only
- Uses `https://git.tx1138.com/actions/checkout@v4` (NOT github.com actions)
- Builds: backend (cargo), frontend (npm), then ISO with `UNBUNDLED=1`
- Output: copied to `/var/lib/archipelago/filebrowser/Builds/`
- act_runner v0.2.11 installed at `/usr/local/bin/act_runner`
fix: overhaul container lifecycle — recovery, health, uninstall, UI state Container recovery: - Health monitor: MAX_RESTART_ATTEMPTS 3→10, interval 60s→120s - Dependency-aware restarts: won't restart services before their deps - Reset dependent counters when a dependency recovers - Handle "created" state containers (were invisible to health monitor) - Added IndeedHub, mempool-api, mysql to tier system - Crash recovery: podman start timeout 30s→120s with retry - Podman client: socket timeout 5s→30s, added restart policy UI state representation: - Exit code 0 shows "stopped" (gray), not "crashed" (red) - Exit code 137 shows "killed (OOM)" - Non-zero exit shows "crashed" (red) - Added exit_code field to PackageDataEntry Install/uninstall fixes: - Install returns error when container doesn't start (was silent success) - Post-install hooks awaited instead of fire-and-forget tokio::spawn - Uninstall: graceful rm before force, volume prune, network cleanup - Uninstall returns error on partial failure (was 200 OK) Config consistency: - DB passwords read from /var/lib/archipelago/secrets/ (was hardcoded) - Bitcoin: added ZMQ ports 28332/28333 for LND block notifications - IndeedHub port 7777→8190 (was conflicting with strfry) - Marketplace versions: LND 0.17.4→0.18.4, Mempool 2.5.0→3.0.0 Performance: - Metrics collector interval 60s→300s (was duplicating health monitor) - Podman client: proper error propagation instead of unwrap_or_default Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> 2026-03-31 07:03:57 +01:00			`---`
			`name: CI/CD Setup`
			`description: Gitea Actions CI/CD — runner on .228, workflow builds unbundled ISO on push to main`
			`type: project`
			`---`

			`CI/CD pipeline using Gitea Actions on git.tx1138.com.`

			`Why: Automatic ISO builds on every push to main. ISOs copied to FileBrowser /Builds/ for download.`

			`How to apply:`
			- Gitea repo: `git.tx1138.com/lfg2025/archy`
			- Runner: .228 registered as `archipelago-builder` with label `ubuntu-latest:host`
			- Runner service: `gitea-runner.service` (systemd, runs as archipelago user)
			- Runner config: `~/.runner` on .228
			- Workflow: `.gitea/workflows/build-iso.yml` — unbundled ISO only
			- Uses `https://git.tx1138.com/actions/checkout@v4` (NOT github.com actions)
			- Builds: backend (cargo), frontend (npm), then ISO with `UNBUNDLED=1`
			- Output: copied to `/var/lib/archipelago/filebrowser/Builds/`
			- act_runner v0.2.11 installed at `/usr/local/bin/act_runner`