2026-05-07 19:49:56 +00:00
2026-05-07 17:44:31 +00:00
2026-05-07 17:44:31 +00:00
2026-05-07 17:44:31 +00:00
2026-05-07 17:44:31 +00:00
2026-05-07 17:44:31 +00:00
2026-05-07 17:44:31 +00:00

@serve.zone/corebuild

CoreBuild is the serve.zone worker service for heavy artifact generation jobs such as BaseOS ISO builds.

Cloudly owns orchestration and user-facing downloads. CoreBuild runs on suitable builder nodes, executes isocreator, uploads artifacts to S3-compatible storage, and returns artifact metadata to Cloudly.

Runtime

Required environment:

  • COREBUILD_PORT: HTTP port, defaults to 3060.
  • COREBUILD_TOKEN: shared worker token expected from Cloudly.
  • COREBUILD_WORKDIR: temp workspace, defaults to .nogit/workdir.
  • ISO_CREATOR_COMMAND: command used to run isocreator, defaults to isocreator.

For local development against the workspace checkout:

ISO_CREATOR_COMMAND="deno run --allow-all ../isocreator/mod.ts" pnpm run startTs

API

  • GET /health
  • GET /corebuild/v1/capabilities
  • POST /corebuild/v1/jobs/baseos-image

The BaseOS image job expects Cloudly to provide the S3 descriptor and a one-time provisioning token. CoreBuild never stores those values beyond the build workspace.

S
Description
No description provided
Readme 150 KiB
Languages
TypeScript 100%