Skip to content

Secure, Fast, and Extensible Sandbox runtime for AI agents.

chore(manifests): bump fast-sandbox pin to 0163332 (master) (#2338)

epha88014e185cb5
diff --git a/manifests/charts/base/files/fast-sandbox-crds.yaml b/manifests/charts/base/files/fast-sandbox-crds.yaml
index 5932b75e0..729b8e018 100644
--- a/manifests/charts/base/files/fast-sandbox-crds.yaml
+++ b/manifests/charts/base/files/fast-sandbox-crds.yaml
@@ -1011,8 +1011,9 @@ spec:
openAPIV3Schema:
description: |-
SandboxSnapshot is a one-shot snapshot of a running Sandbox: the artifacts
- (rootfs, vmstate, memory) are published to the artifact store in the
- SandboxTemplate layout, addressable under spec.templateName. The object is
+ (rootfs, vmstate, memory) are published to the native artifact store or an
+ OCI registry, addressable by status.manifestRef. Native snapshots also
+ publish an image-name index under spec.templateName. The object is
created by fastpath (CreateSandboxSnapshot) and driven to completion by
the controller; a Sandbox (or template name) with a non-terminal snapshot
rejects further snapshot requests.
@@ -1067,8 +1068,8 @@ spec:
type: object
templateName:
description: |-
- TemplateName is the artifact-store index key the artifact set is
- published under: publish writes index/<sha256(templateName)>.json, and
+ TemplateName is required for native snapshots and selects the artifact-store
+ index key the artifact set is published under: publish writes index/<sha256(templateName)>.json, and
a later Sandbox create with image=TemplateName boots from the
snapshot through the standard pull/restore chain. Unlike a
SandboxTemplate build, no default sha256(image) index is written.
@@ -1076,12 +1077,13 @@ spec:
snapshots with the same TemplateName overwrite each other's artifacts
(last writer wins), and FastPath's pre-check therefore rejects a
non-terminal holder of a name cluster-wide.
+ OCI snapshots may omit it: their two images use a random snapshotID,
+ and new Sandboxes boot from status.manifestRef without a name index.
maxLength: 255
pattern: ^[a-z0-9]([-a-z0-9]*[a-z0-9])?(\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*(/[a-zA-Z0-9._-]+)*(:[a-zA-Z0-9._-]{1,127})?$
type: string
required:
- sandboxRef
- - templateName
type: object
status:
description: |-
@@ -1171,8 +1173,8 @@ spec:
type: string
manifestRef:
description: |-
- ManifestRef is the s3:// URI of the published manifest.json
- (Succeeded only).
+ ManifestRef is the published s3:// manifest.json or immutable oci://
+ snapfiles manifest reference (Succeeded only).
type: string
message:
description: Message is the latest progress or failure reason.
@@ -1548,8 +1550,9 @@ spec:
properties:
format:
default: overlaybd
- description: Format selects the storage encoding of the snapshot
- set.
+ description: |-
+ Format selects the storage encoding. Native requires object storage;
+ OverlayBD requires an explicit oci:// publish target.
enum:
- native
- overlaybd
@@ -1570,7 +1573,12 @@ spec:
type: object
publish:
description: |-
- Publish is the S3-compatible object store target, e.g.
+ Publish selects the destination. oci://registry/namespace/repo must
+ omit the tag and digest; each build Pod receives a system-generated
+ UUID and publishes <uuid>_rootfs and <uuid>_snapfiles. A new build
+ uses a new UUID; retries of the same Pod reuse its UUID.
+ PublishSecretRef then requires .dockerconfigjson.
+ For format=native, Publish is the S3-compatible object store target, e.g.
s3://bucket/sandbox-images/ (digest-addressed publication). When
empty, the controller defaults it to the platform artifact store
(the fast-sandbox-artifact-store ConfigMap); when set it must equal
diff --git a/manifests/release/build-fast-sandbox.sh b/manifests/release/build-fast-sandbox.sh
index 592122661..8d9504d94 100755
--- a/manifests/release/build-fast-sandbox.sh
+++ b/manifests/release/build-fast-sandbox.sh
@@ -143,8 +143,10 @@ FSB_COMMIT="$(sed -n 's/^commit:[[:space:]]*//p' "$PIN_FILE")"
die "pin file $PIN_FILE must carry a full 40-character commit SHA (got: ${FSB_COMMIT:-<empty>})"
# image-name:make-COMPONENT:make-image-variable — the exact Firecracker scope.
-# sandboxtemplate-builder has no make target (direct docker build, same as
-# scripts/fast-sandbox-env).
+# sandboxtemplate-builder is a direct docker build (same as
+# scripts/fast-sandbox-env). firecracker-runtime and sandboxtemplate-builder
+# both consume the shared oci-tools build-base image; build_images builds it
+# once up front and points every consumer at the same ref.
IMAGES=(
"fsb-controller:controller:CONTROLLER_IMAGE"
"fsb-fastlet:fastlet:FASTLET_IMAGE"
@@ -211,6 +213,14 @@ log "fast-sandbox checkout ready @ $(git -C "$FSB_SRC_DIR" rev-parse --short HEA
build_images() {
local entry image component var
+ # Shared build base (COPY --from source for the runtime and builder
+ # images). Tagged with $TAG so every consumer references the same build.
+ local oci_tools_ref="$REGISTRY/oci-tools:$TAG"
+ log "building $oci_tools_ref (shared oci build base)"
+ # shellcheck disable=SC2086
+ docker build ${DOCKER_BUILD_FLAGS:-} --quiet \
+ -t "$oci_tools_ref" -f "$FSB_SRC_DIR/build/Dockerfile.oci-tools" \
+ "$FSB_SRC_DIR" >/dev/null || die "oci-tools image build failed"
for entry in "${IMAGES[@]}"; do
image="$REGISTRY/${entry%%:*}:$TAG"
component="$(cut -d: -f2 <<<"$entry")"
@@ -218,12 +228,14 @@ build_images() {
if [[ "$component" == "sandboxtemplate-builder" ]]; then
# shellcheck disable=SC2086
docker build ${DOCKER_BUILD_FLAGS:-} --quiet \
+ --build-arg OCI_TOOLS_IMAGE="$oci_tools_ref" \
-t "$image" -f "$FSB_SRC_DIR/build/Dockerfile.sandboxtemplate-builder" \
"$FSB_SRC_DIR" >/dev/null || die "sandboxtemplate-builder image build failed"
else
var="$(cut -d: -f3 <<<"$entry")"
(make -C "$FSB_SRC_DIR" images "COMPONENT=$component" \
- "REGISTRY=$REGISTRY" "$var=$image" >/dev/null) ||
+ "REGISTRY=$REGISTRY" "$var=$image" \
+ "OCI_TOOLS_IMAGE=$oci_tools_ref" >/dev/null) ||
die "make images COMPONENT=$component failed"
fi
done
diff --git a/manifests/third-party/fast-sandbox.commit b/manifests/third-party/fast-sandbox.commit
index 17f386790..4d87a62c6 100644
--- a/manifests/third-party/fast-sandbox.commit
+++ b/manifests/third-party/fast-sandbox.commit
@@ -11,4 +11,4 @@
# Bump by updating `commit` to a full 40-character SHA, then run:
# manifests/release/build-fast-sandbox.sh --sync-crds
repo: https://github.com/opensandbox-group/fast-sandbox.git
-commit: 9cb48085e6a4dfc20a3efd42caea59f80d8da091
+commit: 221311024a7ec89a2ed12506ec719f7f5b9f766b
diff --git a/scripts/fast-sandbox-env/integration-env.sh b/scripts/fast-sandbox-env/integration-env.sh
index c0ad582f3..6e1f860a8 100755
--- a/scripts/fast-sandbox-env/integration-env.sh
+++ b/scripts/fast-sandbox-env/integration-env.sh
@@ -141,6 +141,9 @@ IMG_FASTLET="${IMAGE_FASTLET:-opensandbox/fsb-fastlet:dev}"
IMG_FASTLET_PROXY="${IMAGE_FASTLET_PROXY:-opensandbox/fsb-fastlet-proxy:dev}"
IMG_JANITOR="${IMAGE_JANITOR:-opensandbox/fsb-janitor:dev}"
IMG_BUILDER="${IMAGE_BUILDER:-opensandbox/fsb-sandboxtemplate-builder:dev}"
+# Shared build base for the builder image (built by build-fast-sandbox.sh
+# during build_images; rebuilt here only if missing).
+IMG_OCI_TOOLS="${IMAGE_OCI_TOOLS:-opensandbox/oci-tools:dev}"
IMG_RUNTIME="${IMAGE_RUNTIME:-opensandbox/fsb-firecracker-runtime:dev}"
IMG_EGRESS="${EGRESS_IMAGE:-docker.io/opensandbox/egress:latest}"
@@ -1089,8 +1092,16 @@ template_failed() {
template_up() {
log "building the sandboxtemplate-builder image"
+ if ! docker image inspect "$IMG_OCI_TOOLS" >/dev/null 2>&1; then
+ log "building shared oci build base ($IMG_OCI_TOOLS)"
+ # shellcheck disable=SC2086
+ docker build ${DOCKER_BUILD_FLAGS:-} --quiet -t "$IMG_OCI_TOOLS" \
+ -f "$FSB_DIR/build/Dockerfile.oci-tools" "$FSB_DIR" >/dev/null \
+ || die "oci-tools image build failed"
+ fi
# shellcheck disable=SC2086
- docker build ${DOCKER_BUILD_FLAGS:-} --quiet -t "$IMG_BUILDER" \
+ docker build ${DOCKER_BUILD_FLAGS:-} --quiet \
+ --build-arg OCI_TOOLS_IMAGE="$IMG_OCI_TOOLS" -t "$IMG_BUILDER" \
-f "$FSB_DIR/build/Dockerfile.sandboxtemplate-builder" "$FSB_DIR" >/dev/null \
|| die "sandboxtemplate-builder image build failed"
kind load docker-image "$IMG_BUILDER" --name "$KIND_CLUSTER" >/dev/null