No description
  • Shell 96%
  • Makefile 3%
  • Dockerfile 1%
Find a file
2026-03-04 16:17:32 +00:00
.forgejo/workflows Migrate to Podman + Forge registry, add Makefile and CI 2026-03-04 10:49:23 -05:00
_archive Move hero installer to archive 2026-03-04 06:37:38 +02:00
devbase Fix: use FORGEJO_USERNAME env var, move podman-run to script 2026-03-04 11:06:22 -05:00
forgejo-runner Add build scripts, installers, and deployment infrastructure 2026-03-04 06:36:17 +02:00
scripts Add build scripts, installers, and deployment infrastructure 2026-03-04 06:36:17 +02:00
.containerignore Migrate to Podman + Forge registry, add Makefile and CI 2026-03-04 10:49:23 -05:00
.gitignore Migrate to Podman + Forge registry, add Makefile and CI 2026-03-04 10:49:23 -05:00
buildenv.sh Migrate to Podman + Forge registry, add Makefile and CI 2026-03-04 10:49:23 -05:00
LICENSE Initial commit 2026-03-04 04:14:12 +00:00
Makefile Fix: use FORGEJO_USERNAME env var, move podman-run to script 2026-03-04 11:06:22 -05:00
README.md Migrate to Podman + Forge registry, add Makefile and CI 2026-03-04 10:49:23 -05:00

Hero Builder

Containerized development environment for building Hero applications and services.

Quick Start

make help               # Show all targets
make podman-build       # Build the container image
make podman-run         # Run locally

Container Image

Published to Forge container registry:

podman pull forge.ourworld.tf/lhumina_code/hero_builder_base:latest

Components

DevBase — Development Environment

Complete containerized environment with Rust, build tools, zinit process supervisor, and Redis.

devbase/
  builder/
    Containerfile         # Container definition
    build.sh              # Build the image
    push.sh               # Push to Forge registry
    scripts/              # Installer scripts (two stages)
    config/zinit/         # Service configurations
  docker-compose.yml      # Local development compose
  myenv.sh                # Environment configuration
  run.sh                  # Start environment

Forgejo Runner — CI/CD Integration

Actions-compatible runner for Forgejo.

forgejo-runner/
  install.sh              # Install runner
  start.sh                # Start runner
  runner.conf             # Runner configuration

Publishing

git tag v0.1.0
git push origin v0.1.0
# CI builds and pushes to forge.ourworld.tf/lhumina_code/hero_builder_base

Development

Build and Push Manually

source ~/hero/cfg/env/*
make podman-login       # Authenticate with Forge
make podman-build       # Build image
make podman-push        # Push to registry

Run the Environment

cd devbase
source myenv.sh
./run.sh

Access the Container

# Via compose
podman-compose exec builder bash

# Via SSH (port from myenv.sh)
ssh root@localhost -p 3422

Services Inside Container

  • Rust toolchain (via installer scripts)
  • zinit process supervisor
  • Redis server
  • OpenSSH server
  • Build tools (gcc, make, pkg-config, git)