Image registry via remote TOML — fetch available VM images from public repo #32

New issue

Closed

opened 2026-03-18 09:40:20 +00:00 by mahmoud · 1 comment

mahmoud commented

2026-03-18 09:40:20 +00:00

Owner

A TOML file hosted on a public git repo defines the list of available VM images. hero_compute_server fetches this file at deploy time (or on a schedule)
and exposes the list via a new RPC method:

list_images() -> [VmImage]

  VmImage = {
      name: str        # display name e.g. "Ubuntu 22.04"
      id: str          # image identifier e.g. "ubuntu-22.04"
      url: str         # download URL
      size_gb: u64     # disk space required
      description: str
}

The TOML URL is configurable via env var: IMAGE_REGISTRY_URL=https://raw.githubusercontent.com/
.../images.toml

deploy_vm() accepts an optional image_id param. If omitted, use the first image in the registry as default.

UI: deploy modal shows a dropdown of available
images fetched from list_images().

Definition of Done:

images.toml format defined and hosted
list_images() RPC method on server
deploy_vm accepts optional image_id param
Images fetched and cached on server startup
UI deploy modal has image selector dropdown
docs/api.md updated

A TOML file hosted on a public git repo defines the list of available VM images. hero_compute_server fetches this file at deploy time (or on a schedule) and exposes the list via a new RPC method: ``` list_images() -> [VmImage] VmImage = { name: str # display name e.g. "Ubuntu 22.04" id: str # image identifier e.g. "ubuntu-22.04" url: str # download URL size_gb: u64 # disk space required description: str } ``` The TOML URL is configurable via env var: IMAGE_REGISTRY_URL=https://raw.githubusercontent.com/ .../images.toml deploy_vm() accepts an optional image_id param. If omitted, use the first image in the registry as default. UI: deploy modal shows a dropdown of available images fetched from list_images(). Definition of Done: - [x] images.toml format defined and hosted - [x] list_images() RPC method on server - [x] deploy_vm accepts optional image_id param - [x] Images fetched and cached on server startup - [x] UI deploy modal has image selector dropdown - [x] docs/api.md updated