feat: add corebuild worker

2026-05-07 17:44:31 +00:00
commit f2fa041109
11 changed files with 4667 additions and 0 deletions
@@ -0,0 +1,28 @@
+# @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:
+
+```bash
+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.