28313ad22f
- Convert all module-level functions to methods on config structs - Add InstallArgs struct with reset parameter to actions files - Update factory play() functions to call instance methods with name parameter - Remove duplicate InstallArgs and wrapper methods from factory files - Add support for start_pre, start_post, stop_pre, stop_post as callable actions - Rename running() to running_check() to avoid conflicts - All lifecycle methods (install, destroy, build, start, stop, etc.) now accept optional name parameter Affected installers: - coordinator - supervisor - herorunner - osirisrunner - salrunner This provides a cleaner, more consistent API where all installer actions can be called on specific configuration instances from heroscript files.
Coordinator Installer
A V language installer module for building and managing the Coordinator service. This installer handles the complete lifecycle of the Coordinator binary from the Horus workspace.
Features
- Automatic Rust Installation: Installs Rust toolchain if not present
- Git Repository Management: Clones and manages the horus repository
- Binary Building: Compiles the coordinator binary from the horus workspace
- Service Management: Start/stop/restart via zinit
- Configuration: Customizable Redis, HTTP, and WebSocket ports
Quick Start
Using the Example Script
cd /root/code/github/incubaid/herolib/examples/installers/horus
./coordinator.vsh
Manual Usage
import incubaid.herolib.installers.horus.coordinator as coordinator_installer
mut coordinator := coordinator_installer.get()!
coordinator.install()!
coordinator.start()!
Configuration
!!coordinator.configure
name:'default'
binary_path:'/hero/var/bin/coordinator'
redis_addr:'127.0.0.1:6379'
redis_port:6379
http_port:8081
ws_port:9653
log_level:'info'
repo_path:'/root/code/git.ourworld.tf/herocode/horus'
Configuration Fields
- name: Instance name (default: 'default')
- binary_path: Path where the coordinator binary will be installed (default: '/hero/var/bin/coordinator')
- redis_addr: Redis server address (default: '127.0.0.1:6379')
- redis_port: Redis server port (default: 6379)
- http_port: HTTP API port (default: 8081)
- ws_port: WebSocket API port (default: 9653)
- log_level: Rust log level - trace, debug, info, warn, error (default: 'info')
- repo_path: Path to clone the horus repository (default: '/root/code/git.ourworld.tf/herocode/horus')
Commands
Install
Builds the coordinator binary from the horus workspace. This will:
- Check if Rust is installed (installs if not present)
- Clone the horus repository from git.ourworld.tf
- Build the coordinator binary with
cargo build -p hero-coordinator --release
Note: The installer skips the build if the binary already exists at the configured path.
hero coordinator.install
Force Reinstall
To force a rebuild even if the binary already exists, use the reset flag:
import incubaid.herolib.installers.horus.coordinator as coordinator_installer
mut coordinator := coordinator_installer.get()!
coordinator.install(reset: true)! // Force reinstall
Or manually delete the binary before running install:
rm /hero/var/bin/coordinator
hero coordinator.install
Start
Starts the coordinator service using zinit:
hero coordinator.start
Stop
Stops the running service:
hero coordinator.stop
Restart
Restarts the service:
hero coordinator.restart
Destroy
Stops the service and removes all files:
hero coordinator.destroy
Requirements
- Dependencies:
- Rust toolchain (automatically installed if not present)
- Git (for cloning repository)
- Redis (must be pre-installed and running)
- Mycelium (must be installed and running separately)
Architecture
The installer follows the standard herolib installer pattern:
- coordinator_model.v: Configuration structure and initialization
- coordinator_actions.v: Build, install, start, stop, destroy logic
- coordinator_factory_.v: Factory pattern for instance management
Notes
- The installer builds from source rather than downloading pre-built binaries
- Redis must be pre-installed and running - the installer does not install Redis
- The installer checks if the binary already exists and skips rebuild unless
reset: trueis used - Rust is automatically installed if not present (checks for
rustccommand) - The binary is built with
RUSTFLAGS="-A warnings"to suppress warnings - Service management uses zinit by default
Example Workflow
import incubaid.herolib.installers.horus.coordinator as hc
// Get installer instance
mut coordinator := hc.get()!
// Customize configuration
coordinator.redis_addr = '127.0.0.1:6379'
coordinator.redis_port = 6379
coordinator.http_port = 8081
coordinator.log_level = 'debug'
hc.set(coordinator)!
// Build and start
coordinator.install()!
coordinator.start()!
// Check status
if coordinator.running()! {
println('Coordinator is running on port ${coordinator.http_port}')
}
// Later: cleanup
coordinator.destroy()!