Osirisrunner Installer

A V language installer module for building and managing the Hero Runner service. This installer handles the complete lifecycle of the Osirisrunner 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 osirisrunner binary from the horus workspace
Service Management: Start/stop/restart via zinit
Configuration: Customizable Redis connection

Quick Start

Manual Usage

import freeflowuniverse.herolib.installers.horus.osirisrunner as osirisrunner_installer

mut osirisrunner := osirisrunner_installer.get()!
osirisrunner.install()!
osirisrunner.start()!

Configuration

!!osirisrunner.configure
    name:'default'
    binary_path:'/hero/var/bin/osirisrunner'
    redis_addr:'127.0.0.1:6379'
    log_level:'info'
    repo_path:'/root/code/git.ourworld.tf/herocode/horus'

Configuration Fields

name: Instance name (default: 'default')
binary_path: Path where the osirisrunner binary will be installed (default: '/hero/var/bin/osirisrunner')
redis_addr: Redis server address (default: '127.0.0.1:6379')
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 osirisrunner binary from the horus workspace. This will:

Install Rust if not present
Clone the horus repository from git.ourworld.tf
Build the osirisrunner binary with cargo build -p runner-osiris --release

hero osirisrunner.install

Start

Starts the osirisrunner service using zinit:

hero osirisrunner.start

Stop

Stops the running service:

hero osirisrunner.stop

Restart

Restarts the service:

hero osirisrunner.restart

Destroy

Stops the service and removes all files:

hero osirisrunner.destroy

Requirements

Dependencies:
- Rust toolchain (automatically installed)
- Git (for cloning repository)
- Redis (must be running separately)

Architecture

The installer follows the standard herolib installer pattern:

osirisrunner_model.v: Configuration structure and initialization
osirisrunner_actions.v: Build, install, start, stop, destroy logic
osirisrunner_factory_.v: Factory pattern for instance management

Notes

The installer builds from source rather than downloading pre-built binaries
Redis must be running and accessible at the configured address
The binary is built with RUSTFLAGS="-A warnings" to suppress warnings
Service management uses zinit by default

2.7 KiB Raw Blame History