Documentation
Docs/Product guides

Kernary Build

Target-aware isolated engineering environments that restore source, toolchains, emulators, caches and project state for agents, developers and CI.

Build cells

BUILD CELL / 01Yocto snapshot v12CPURAMSTATESUSPENDEDBUILD CELL / 02Yocto snapshot v12CPURAMSTATEACTIVEBUILD CELL / 03Yocto snapshot v12CPURAMSTATESUSPENDED
A Build Cell is the product abstraction; container or microVM technology remains an implementation detail.

A cell combines an immutable base snapshot with a private writable workspace, explicit resource limits, scoped networking, tool-proxy credentials and content-addressed shared caches.

Define a cell

build-cell.yaml
apiVersion: build.kernary.dev/v1alpha1
kind: BuildCell
metadata:
  name: orbit-yocto
spec:
  snapshot: kernary/imx93-yocto-scarthgap:v12
  resources:
    cpu: 4
    memory: 8Gi
    scratch: 60Gi
  workspace:
    project: orbit-controller
    persist: true
  caches:
    - yocto-downloads
    - yocto-sstate
  network:
    policy: vendor-and-source-allowlist
  lifecycle:
    idleSuspendAfter: 15m
    archiveAfter: 14d

Run a build

Terminal · proposed CLI
CELL=$(kernary build cell start \
  --file build-cell.yaml \
  --output uri)

kernary build exec "$CELL" -- \
  bitbake kernary-image-production

kernary build artifacts "$CELL" \
  --collect image,dtb,kernel,sbom,manifest

Cell lifecycle

Lifecycle
CREATE → RESTORE → ACTIVE → SUSPEND → RESUME
                         ↓                    ↓
                       FAILED              ARCHIVE
                                                ↓
                                            TERMINATE

These docs are part of the product design. Interfaces remain proposals until an implementation is published.

View the platform →