lhumina_code/hero_os_tfgrid_deployer
0
0
Fork 0
Code Issues 13 Pull requests Projects Releases 3 Packages Wiki Activity
Internal admin tool for deploying Hero OS demos on the ThreeFold Grid.
122 commits 4 branches 3 tags 4.4 MiB
  • Rust 51%
  • JavaScript 30.5%
  • HTML 13.1%
  • CSS 3.8%
  • Shell 1.6%
Find a file
Exact
mik-tf ee0d443001
Some checks are pending
lab publish / publish (push) Has started running
Details
fix(deployer): restart services after tester updates 
Reinstalling a tester VM already forced binary downloads, but the follow-up
service pass used idempotent starts. Existing processes therefore kept running
old binaries after an update. Restart hero_proc_server and reset each installed
service so update/reinstall actually applies the downloaded release channel.

Signed-by: mik-tf <mik-tf@noreply.invalid>
2026-06-10 01:40:12 -04:00
.forgejo/workflows ci(deployer): publish main to latest 2026-06-09 22:11:29 -04:00
crates fix(deployer): restart services after tester updates 2026-06-10 01:40:12 -04:00
schema chore: auto-commit local changes before pull 2026-05-31 23:42:11 +02:00
.gitignore deployer_server: bump ureq to 3.x to fix CI build 2026-05-28 09:35:26 -04:00
Cargo.lock feat(admin): manage compute wallet mnemonics 2026-06-09 13:55:28 -04:00
Cargo.toml feat(deployer): show node links and include foundry 2026-06-09 21:59:52 -04:00
Cargo.toml.hero_builder_backup refactor: migrate from hero_rpc/herolib_core service macros to hero_lifecycle 2026-06-01 09:32:40 +02:00
README.md deployer: rename HERO_SOCKET_DIR → PATH_SOCKET + drop RUST_LOG/HERO_COMPUTE_NODE_ADDR env entries 2026-05-26 12:49:55 +02:00
rust-toolchain.toml chore: set rust-version to 1.96 and add rust-toolchain.toml 2026-06-01 13:31:07 +02:00

README.md

hero_tfgrid_deployer

Internal admin deployment tool for Hero OS demo environments on the ThreeFold Grid.

Purpose

Administrators use this tool to:

  1. Deploy VMs on the ThreeFold Grid — create one VM per demo user or environment, select capacity/node/location as needed, and track VM status, IP, and access details.

  2. Install Forge Hero OS — run lab builder inside each VM after creation to deploy and configure Hero OS automatically, with status and logs visible in the admin interface.

  3. Manage Forge accounts — check whether a user account exists at forge.ourworld.tf, create it if it does not, and link it to the deployed VM/Hero OS instance.

  4. Admin view — see all demo users, their associated VMs, and deployment status. Admins can access user machines directly (this is an internal demo tool, not a privacy environment).

  5. User view — each demo user sees only their own Hero OS environment. Admin functionality is not visible in the user view.

Crate layout

Crate Role
hero_tfgrid_deployer CLI — registers server + admin with hero_proc (--start / --stop)
hero_tfgrid_deployer_server JSON-RPC 2.0 daemon over Unix socket (OpenRPC)
hero_tfgrid_deployer_admin Admin web dashboard (Axum + Askama + Bootstrap)
hero_tfgrid_deployer_sdk Typed OpenRPC client generated from openrpc.json

Development

# Build all crates
lab build

# Start the service
hero_tfgrid_deployer --start

# Stop the service
hero_tfgrid_deployer --stop

Architecture

  • Transport: Unix domain sockets under $PATH_SOCKET/hero_tfgrid_deployer/
  • RPC socket: rpc.sock — JSON-RPC 2.0 / OpenRPC
  • Admin socket: admin.sock — HTTP / Axum dashboard

The server exposes its spec at /openrpc.json and a health endpoint at /health.