aws-samples / aws-samples/sample-openclaw-multi-tenant-platform

Upgrade agent-sandbox v0.4.5 → v0.5.2+ (v1beta1 migration)

Open
#13 0 comments 0 reactions 0 assignees View on GitHub
area/upstream
Dominant language
Shell
Stars
41
Forks
8
PR merge metrics
No merged PRs in 30d

Description

[v0.5.0](https://github.com/kubernetes-sigs/agent-sandbox/releases/tag/v0.5.0)
(2026-06-24) graduated the APIs to `v1beta1`; per the release notes, "v1alpha1
APIs are now deprecated". This sample currently teaches a deprecated API.
Upgrade is NOT a version bump:

- [ ] `SandboxClaim.spec.templateRef` → `spec.warmpoolRef`; for the
no-prewarmed-capacity path, reference a `SandboxWarmPool` with `replicas: 0`
(supersedes the design recorded in ADR-0002 — new ADR + index update)
- [ ] `spec.replicas` → `spec.operatingMode: Running | Suspended`
- [ ] Re-verify NetworkPolicy interactions: v0.5.0's controller-managed policy
scopes sandbox-router ingress to `agent-sandbox-system`, and this cluster now
enforces NetworkPolicy (#11) — prove tenant HTTPRoute → controller-owned
Service → sandbox traffic end to end under enforcement
- [ ] `scripts/conformance-runtime-tier.sh` both tiers post-upgrade
- [ ] Rollback plan: restore prior chart + CRDs and re-validate an existing
tenant route before declaring rollback complete

**Timing:** do not begin until v0.5.2 is released (upstream advisory: v0.5.0/
v0.5.1 carry a status-wiping race for warm-started claims; fix scheduled for
the v0.5.2 release, expected 2026-07-16) — re-check its release notes before
starting.

Part of #5.

Contributor guide

Open the contributing guide

Research direction

Wait for v0.5.2, then re-check its release notes before inspecting the sample's SandboxClaim, SandboxWarmPool, chart and CRD references. Read ADR-0002 and update its replacement and index, then run scripts/conformance-runtime-tier.sh for both tiers. Done means both tiers pass, tenant HTTPRoute traffic works under NetworkPolicy enforcement, and rollback restores the chart and CRDs while re-validating an existing route.

Written by the indexing model from the issue text.

Assessment

Tech stack
kubernetes, shell
Domain
devops, infrastructure, networking
Issue type
Refactor
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.