Skip to content

docs: verify compatibility with OpenShell 0.0.113 and apple/container 1.3.0 - #52

Merged
vyncint merged 2 commits into
mainfrom
compat/0.0.113-1.3.0
Aug 26, 2026
Merged

docs: verify compatibility with OpenShell 0.0.113 and apple/container 1.3.0#52
vyncint merged 2 commits into
mainfrom
compat/0.0.113-1.3.0

Conversation

@vyncint

@vyncint vyncint commented Aug 26, 2026

Copy link
Copy Markdown
Owner

Tested the newer upstreams as asked. No driver change was needed — this is documentation only.

OpenShell 0.0.111 → 0.0.113

compute_driver.proto is byte-identical between the two tags, so there was no contract risk. Verified live: setup derived supervisor:0.0.113 and pulled it, then create → Ready → exec → policy-blocked egress → clean delete.

(Aside worth knowing: supervisor:0.0.112 returns 404 on ghcr — not every OpenShell release publishes a supervisor image. That is exactly the case the driver's fallback covers, and why deriving the tag from the gateway version needs one.)

apple/container 1.2.2 → 1.3.0

A minor release, so I read its notes against our code before touching anything:

Upstream change Effect here
⌨️ --scheme auto removed for image operations none — the driver never passes --scheme
tmpfsMounts() refactored the driver does use --tmpfs, so this needed testing
New default Kata kernel (3.32.0-debug) touches ensureKernel() and --kernel
maskedPaths/readonlyPaths no longer defaulted could change in-guest behaviour

I captured a baseline on 1.2.2 before the upgrade so the comparison would mean something. Everything matched afterwards:

Check 1.2.2 baseline 1.3.0
create → Ready Ready Ready
exec kernel 6.18.15 aarch64 6.18.15 aarch64
workload uid 998 998
policy egress blocked blocked
tmpfs mount tmpfs on /scratch type tmpfs (rw,relatime), writable identical
restart adoption Ready + exec Ready + exec
delete clean clean, 0 VMs left

The existing default.kernel-arm64 → vmlinux-6.18.15-186 survived the upgrade untouched, so ensureKernel() correctly skips re-downloading — the new default kernel only affects fresh installs.

Also found (not fixed here)

apple/container's update-container.sh runs sudo installer … >/dev/null 2>&1 || error "Installer failed", which swallows the real error. Run unprivileged, the mid-script sudo prompt is easy to miss and you get a bare Error: Installer failed with no cause. Running the whole script under sudo avoids it. That is upstream's script, not ours, but it is worth knowing when update --all --container-version is used.

Verification

go build, go test -race, golangci-lint (0 issues), shellcheck install.sh, goreleaser check, govulncheck/gosec/gitleaks — all clean.

… 1.3.0

No driver change was needed.

compute_driver.proto is byte-identical between 0.0.111 and 0.0.113, so the
OpenShell side carried no risk. apple/container 1.3.0 is a minor release and
did: one breaking CLI change (`--scheme auto` removed for image operations,
which this driver never used), a tmpfsMounts() refactor on a path the driver
does use, and a new default Kata kernel.

So a baseline was captured on 1.2.2 before upgrading, and every check matched
afterwards on 1.3.0:

  create -> Ready, exec (kernel 6.18.15, workload uid 998)
  policy still blocking egress
  tmpfs driver-config mount: tmpfs on /scratch type tmpfs (rw,relatime), writable
  restart adoption, then a clean delete leaving no VMs behind

An already-configured guest kernel survives the upgrade, so ensureKernel()
correctly skips re-downloading; the new default only affects fresh installs.

Update the compatibility table, STATUS.md, the release footer and the contract
note to the tested range.

Signed-off-by: Vyncint Ng <vyncint@users.noreply.github.com>
…sh setup

Verified from the 1.3.0 binaries: --recommended resolves to Kata 3.32.0 and
extracts vmlinux-6.18.35-197-debug. setup calls --recommended on a machine with
no kernel configured, so fresh installs land on that; an existing kernel is left
untouched, which is why this machine stayed on vmlinux-6.18.15-186 through the
upgrade. Worth stating because it is a debug build.

Signed-off-by: Vyncint Ng <vyncint@users.noreply.github.com>
@vyncint
vyncint merged commit 0a03d38 into main Aug 26, 2026
10 checks passed
@vyncint
vyncint deleted the compat/0.0.113-1.3.0 branch August 26, 2026 15:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant