feat: Add install script, uninstall script, and CI test workflow #64

Merged

mahmoud merged 11 commits from development_install_ci into development 2026-04-07 09:20:22 +00:00

Conversation 0 Commits 11 Files changed 4 +598 -161

mahmoud commented 2026-04-06 15:04:59 +00:00

Owner

Copy link

Summary

• Install script (scripts/install.sh): Single-command installer that downloads pre-built binaries (cloud-hypervisor, mycelium, hero_proc, my_hypervisor, hero_compute), installs system dependencies, and starts all services. Safe to re-run — checks each component and only downloads what's missing or outdated. Supports --env flag for environment selection.
• Uninstall script (scripts/uninstall.sh): Clean removal of all installed components.
• CI workflow (.forgejo/workflows/test-install.yaml): Forgejo Actions workflow that tests the install script in a container environment — verifies binary downloads, dependency installation, and service startup.

Changes

File	Description
scripts/install.sh	Single-command installer with progress output, version checks, graceful package handling
scripts/uninstall.sh	Uninstall script for clean removal
.forgejo/workflows/test-install.yaml	CI workflow to test the install script

Install usage

# Default (development environment)
curl -sfL https://forge.ourworld.tf/lhumina_code/hero_compute/raw/branch/development/scripts/install.sh | bash

# Specific environment
curl -sfL https://forge.ourworld.tf/lhumina_code/hero_compute/raw/branch/development/scripts/install.sh | bash -s -- --env production

Test plan

• CI workflow passes in container environment
• Install script downloads all binaries correctly
• Install script handles missing system packages gracefully
• Uninstall script removes all components
• Re-running install script is idempotent

Related issues

• #63

## Summary - **Install script** (`scripts/install.sh`): Single-command installer that downloads pre-built binaries (cloud-hypervisor, mycelium, hero_proc, my_hypervisor, hero_compute), installs system dependencies, and starts all services. Safe to re-run — checks each component and only downloads what's missing or outdated. Supports `--env` flag for environment selection. - **Uninstall script** (`scripts/uninstall.sh`): Clean removal of all installed components. - **CI workflow** (`.forgejo/workflows/test-install.yaml`): Forgejo Actions workflow that tests the install script in a container environment — verifies binary downloads, dependency installation, and service startup. ## Changes | File | Description | |------|-------------| | `scripts/install.sh` | Single-command installer with progress output, version checks, graceful package handling | | `scripts/uninstall.sh` | Uninstall script for clean removal | | `.forgejo/workflows/test-install.yaml` | CI workflow to test the install script | ## Install usage ```bash # Default (development environment) curl -sfL https://forge.ourworld.tf/lhumina_code/hero_compute/raw/branch/development/scripts/install.sh | bash # Specific environment curl -sfL https://forge.ourworld.tf/lhumina_code/hero_compute/raw/branch/development/scripts/install.sh | bash -s -- --env production ``` ## Test plan - [x] CI workflow passes in container environment - [x] Install script downloads all binaries correctly - [x] Install script handles missing system packages gracefully - [x] Uninstall script removes all components - [x] Re-running install script is idempotent ### Related issues - https://forge.ourworld.tf/lhumina_code/hero_compute/issues/63

mahmoud force-pushed development_install_ci from 53a54f2b93 to ec27ebebc4 2026-04-06 18:34:49 +00:00 Compare

mahmoud changed title from CI workflow to test single line installer to feat: Add install script, uninstall script, and CI test workflow 2026-04-06 18:42:11 +00:00

mahmoud referenced this pull request 2026-04-06 18:42:34 +00:00

feat: Add single-command install script, uninstall script, and CI workflow #68

mahmoud added 1 commit 2026-04-06 18:54:21 +00:00

chore: finalize CI workflow targets and docs before merge ... 7b350f5f87

- Update test-install.yaml to target development/main branches
- Add --env flag documentation to setup.md

mahmoud added 1 commit 2026-04-06 18:57:30 +00:00

fix: set FORGE_TOKEN and WEBROOT defaults when starting hero_proc_server ... e365fa84a3

hero_proc_server v0.4.4 requires FORGE_TOKEN and WEBROOT env vars
on startup. Set sensible defaults so the installer can start the
service. Users can configure the real token later.

mahmoud added 1 commit 2026-04-06 19:03:51 +00:00

fix: address all review findings for install/uninstall/CI ... 40ac805515

Install script (scripts/install.sh):
- Replace set -e with set -u to prevent silent exits from background
  process failures; all errors now handled explicitly with return codes
- Add --connect-timeout 10 --max-time 120 --retry 2 to all curl calls
- Show download URL to user on failure (not just in log file)
- Every download() caller now checks return code and handles failure
  gracefully (skip component, not crash entire install)
- Tighten version grep with word-boundary anchoring to prevent
  0.1.3 matching 0.1.30
- Fix printf format strings: use %b for ANSI escapes consistently,
  never embed escape codes in format string position
- Extract _hero_proc_socket_exists helper to avoid path duplication
- Extract _wait_with_dots helper to reduce code duplication
- Rename mycelium peers variable to peers_list for clarity
- Add FORGE_TOKEN to --help output

Uninstall script (scripts/uninstall.sh):
- Replace pgrep -f with pgrep -x for exact process name matching,
  falling back to full-path match only for ~/hero/bin/ binaries
- Check reverse dependencies before removing system packages
  (apt-cache rdepends) to avoid breaking shared packages
- Fix printf format strings for consistent ANSI handling
- Use set -u instead of set -e

CI workflow (.forgejo/workflows/test-install.yaml):
- Set FORGE_TOKEN and WEBROOT as job-level env vars
- Consolidate binary existence + response checks into single step
  (reduces duplication between Ubuntu and Alpine jobs)
- Add FORGE_TOKEN/WEBROOT to service start/stop test step
- Branch triggers already set to development/main

mahmoud added 1 commit 2026-04-07 08:43:13 +00:00

fix: update stale versions in configure.sh ... 9b86da41dd

- cloud-hypervisor: v43.0 → v50.0
- my_hypervisor: v0.1.2 → v0.1.4

These defaults were out of sync with the central config.

mahmoud added 1 commit 2026-04-07 08:46:18 +00:00

fix: show PATH export command in post-install summary ... 036bfbd41f

After curl | bash, ~/hero/bin is added to .bashrc but not the
current shell. Print the export command so the user can copy-paste
it immediately.

mahmoud added 1 commit 2026-04-07 08:47:45 +00:00

merge: bring in latest development changes ed2c3f058e

mahmoud added 1 commit 2026-04-07 09:03:55 +00:00

ci: remove Alpine job from install test workflow 03b50499ab

mahmoud added 1 commit 2026-04-07 09:09:45 +00:00

chore: fix comment — Ubuntu only ec8652cfa5

mahmoud added 1 commit 2026-04-07 09:13:19 +00:00

merge: resolve conflict in configure.sh — keep development version (central config) 171eed46a3

mahmoud added 1 commit 2026-04-07 09:17:33 +00:00

fix: prompt for user confirmation even via curl | bash ... 674790c0e6

Read from /dev/tty instead of stdin so the y/N prompt works when
the script is piped (curl | bash). Skip in CI where no TTY exists.

mahmoud merged commit 5f788f2658 into development 2026-04-07 09:20:22 +00:00

mahmoud referenced this pull request from a commit 2026-04-07 09:20:23 +00:00

feat: Add install script, uninstall script, and CI test workflow (#64)

mahmoud deleted branch development_install_ci 2026-04-07 09:20:28 +00:00

Sign in to join this conversation.

Reviewers

No reviewers

Labels

Clear labels   

prio_critical

  

prio_low

  

type_bug

  

type_contact

  

type_issue

  

type_lead

  

type_question

  

type_story

  

type_task

No labels

prio_critical

prio_low

type_bug

type_contact

type_issue

type_lead

type_question

type_story

type_task

Milestone

Clear milestone

No items

No milestone

Projects

Clear projects

No items

No project

Assignees

Clear assignees

No assignees

1 participant

Notifications

Subscribe

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference

lhumina_code/hero_compute!64

No description provided.