onset/workspace — Base Images for Onset Workspaces

This repository defines and builds the container images used by Onset for developer workspaces. Each image flavor lives in a subdirectory and is tagged with a consistent scheme.

Repository Structure

.
├── minimal-image/        # Minimal base image (Ubuntu 24.04 + dev essentials)
│   └── Dockerfile
├── images/
│   └── default/          # Default workspace image (chains off minimal)
│       └── Dockerfile
└── .forgejo/workflows/
    ├── build-on-commit.yml   # Builds minimal-image on push to main
    └── build-on-tag.yml      # Retags minimal + builds default on v* tags

Tag Scheme

Trigger	Flavor Built	Tags Pushed
Push to main (exclude tags)	minimal-image/	:minimal-{sha}, :minimal-nightly
Push tag v*	retag minimal only	:minimal-{tag}, :minimal-latest, :latest
Push tag v*	images/default/	:default-{tag}, :default

• :latest always points to the latest stable minimal image.
• :minimal-nightly is overwritten on each push to main.
• Each flavor's bare tag (:default) acts as that flavor's -latest alias.

Adding a New Image Flavor

1. Create images/<flavor>/Dockerfile with ARG BASE_IMAGE at the top.
2. Add a build step in build-on-tag.yml similar to the default step.
3. Push a v* tag to publish.

Prerequisites

The Forgejo instance must have the following secrets configured:

• OCI_TOKEN — OCI registry token
• OCI_USER — OCI registry username