ovmlayer-rootfs

This repository builds Oomol runtime assets for amd64 and arm64.

Release Artifacts

base-rootfs

Minimal Ubuntu-based base-rootfs with zsh, used as the lightest ovmlayer test base.

• Architecture: amd64, arm64
• Output files: amd64-rootfs.tar, arm64-rootfs.tar
• Tag trigger: base-rootfs*
• Workflow: rootfs-base.yml

server-base-rootfs

Server foundation server-base-rootfs used by runtime-related builds.

• Architecture: amd64, arm64
• Output files: amd64-server-base.tar, arm64-server-base.tar
• Tag trigger: server-base*
• Workflow: rootfs-server-base.yml

Studio Executor Layer

Executor layer for studio runtime, built from Python dependencies in requirements.txt and Node.js dependencies in package.json.

• Architecture: amd64, arm64
• Output files: amd64-executor.tar, arm64-executor.tar
• Tag trigger: executor-layer*
• Workflow: layer-executor.yml

Cloud Executor Layer

Executor layer for cloud runtime, built from the same dependency sources as the studio executor layer.

• Architecture: amd64, arm64
• Output files: amd64-executor.tar, arm64-executor.tar
• Tag trigger: cloud-executor-layer*
• Workflow: layer-cloud-executor.yml

Container Images

Runtime Image

Container image for directly running the runtime environment.

• Image: ghcr.io/oomol/oocana-runtime
• Includes:
  • oocana binary in /usr/bin/oocana
  • ovmlayer binaries in /usr/bin/
  • bundled server-base-rootfs tarball at /root/rootfs.tar, sourced from the release artifact amd64-server-base.tar or arm64-server-base.tar
  • bundled latest executor-layer tarball at /tmp/executor-layer.tar, sourced from the release artifact amd64-executor.tar or arm64-executor.tar
  • layer working directory at /opt/ovmlayer
  • runtime dependencies from package.json, requirements.txt, and mosquitto
• Startup behavior:
  • runs scripts/entrypoint.sh, which initializes ovmlayer from the bundled server-base-rootfs tarball if needed
• Tag trigger: oocana-runtime*
• Workflow: image-oocana-runtime.yml

Oocana Mount Image

Container image for the mount-style runtime dependency environment.

• Image: ghcr.io/oomol/oocana-mount
• Includes:
  • runtime dependencies from package.json, requirements.txt, and mosquitto
• Does not include:
  • oocana binary
  • ovmlayer binaries
  • bundled server-base-rootfs tarball
  • pre-initialized layer data under /opt/ovmlayer
• Expected external asset:
  • server-base-rootfs, matching the release artifact amd64-server-base.tar or arm64-server-base.tar
• Intended use:
  • provide the dependency environment when oocana, ovmlayer, server-base-rootfs, or related layer assets are supplied from outside the image
• Tag trigger: oocana-mount*
• Workflow: image-oocana-mount.yml

Workflow Mapping

Workflow	Tag trigger	Build artifacts
rootfs-base.yml	base-rootfs*	amd64-rootfs.tar, arm64-rootfs.tar
rootfs-server-base.yml	server-base*	amd64-server-base.tar, arm64-server-base.tar
layer-executor.yml	executor-layer*	amd64-executor.tar, arm64-executor.tar
layer-cloud-executor.yml	cloud-executor-layer*	amd64-executor.tar, arm64-executor.tar
image-oocana-runtime.yml	oocana-runtime*	ghcr.io/oomol/oocana-runtime
image-oocana-mount.yml	oocana-mount*	ghcr.io/oomol/oocana-mount

Other Workflows

Workflow	Trigger	Purpose
tag-server-base.yml	push to main on dockerfiles/server-base.dockerfile or manual dispatch	Extracts the base image tag from dockerfiles/server-base.dockerfile and creates a matching git tag in the form server-base@<version>. If only .github/workflows/tag-server-base.yml changes, it skips pushing the tag.
tag-executor-layer.yml	push to main on package.json, requirements.txt, .github/workflows/tag-executor-layer.yml, or manual dispatch	Resolves the highest existing executor-layer or cloud-executor-layer version, bumps the patch version, updates package.json, commits and pushes that version bump back to main, then creates both tags. If only .github/workflows/tag-executor-layer.yml changes, it skips pushing tags. Include [skip executor-layer-tag] in a pushed commit message to bypass the workflow. Auto-generated version bump commits matching chore(release): bump executor layer version to <version> are ignored to prevent recursive runs.
test-actions.yml	pull request on action files, workflow_dispatch	Verifies reusable actions in this repository.
export-package-layer.yml	workflow_call	Deprecated compatibility workflow that only prints a warning.