Skip to content

OpenShell v0.1.9

Latest

Choose a tag to compare

@github-actions github-actions released this 17 Nov 19:12
· 23 commits to main since this release
ce58cf8

OpenShell v0.1.9

Quick install

curl -LsSf https://raw.githubusercontent.com/NVIDIA/OpenShell/main/install.sh | OPENSHELL_VERSION=v0.1.9 sh

Upgrade notes

  • The Go SDK now lives at github.com/ai-openshell/sdk-go, with versions that follow OpenShell releases. github.com/NVIDIA/OpenShell/sdk/go is deprecated, and its last version is v0.1.8, so switch your module imports to the new path. #5461
  • Wildcard network policy endpoints no longer allow private IP literals on their own. Add an exact endpoint or an allowed_ips grant for any private address your sandboxes still need to reach. #5522
  • On Postgres, gateway migration 010 builds indexes on the objects table with a plain CREATE INDEX, which blocks writes to that table while it runs, so large deployments should plan for this during upgrade. The same release lets operators raise the per-caller request-ID limit with mutation_admission_limit_per_caller (up to 1,000,000) and set mutation_replay_window_seconds; defaults are unchanged. #5506
  • The Helm chart now enables the gateway's Prometheus endpoint with metrics.enabled instead of the port value. Charts that set service.metricsPort to 0 or false now fail to render; set metrics.enabled=false and keep a valid port instead. #5478
  • Middleware selectors can no longer include a port. These selectors never matched, and now fail validation, so remove the port. HTTP middleware also gains new streaming request and response hooks (opt in with the openshell.supervisor-middleware.http-hooks capability), and the legacy EvaluateHttpRequest and HttpResponsePreReturn hooks are deprecated and will be removed in 0.2.0. #4359
  • The gateway now records every user and operator change, such as creating, updating, or deleting a resource, as an OCSF API Activity event. Authorization denials of write methods now report Create, Update, or Delete instead of Other (99), so select denials by class_uid: 6003 and status_id: 2 rather than type_uid: 600399. #5606
  • The Helm chart no longer sets a process-wide SSL_CERT_FILE for a private OIDC CA; the CA from server.oidc.caConfigMapName now applies only to OIDC discovery and JWKS requests. Outside Helm, set it with [openshell.gateway.oidc] ca_bundle, --oidc-ca-bundle, or OPENSHELL_OIDC_CA_BUNDLE. #3673

Bug fixes

  • Long-running sandboxes no longer exit when the supervisor loses its connection to the sandbox a second time, because each connection loss now gets a full reconnect window. #5526
  • A dedicated supervisor now finishes shutting down within 8 seconds after SIGTERM, and Docker gives it 10 seconds before killing it, so stopping a sandbox no longer ends in SIGKILL. A connection to the sandbox that drops during shutdown is no longer recovered. #5342
  • Many idle exec sessions no longer stop the sandbox from accepting new control connections, and the sandbox now reports processes that escape a freeze or stop signal. #5217
  • Stopped sandboxes stay Stopped when an older driver update arrives late, while a later start still shows its progress. #5204
  • Gateways in a multi-replica deployment no longer keep memory for deleted sandboxes, and openshell logs --tail exits after another gateway deletes the sandbox. #5460
  • Sandbox provisioning timeouts on Kubernetes now show the scheduler's reason when a pod can't be scheduled, instead of a generic placeholder. #5344
  • The Helm chart now rejects malformed, out-of-range, or colliding gateway listener ports at render time. #3179
  • Gateway and driver logs only use ANSI colors on a terminal, so logs collected by Kubernetes are plain text; NO_COLOR and FORCE_COLOR override this. #5616
  • The TUI workspace shortcut (w) now cycles through your real workspaces instead of getting stuck on a nonexistent default workspace. #4126
  • rule history now shows the full YYYY-MM-DD HH:MM:SS timestamp like other commands. #5576
  • Updated russh to 0.65.1 to fix SSH security advisories GHSA-9264-jvgf-6w2f and GHSA-736f-c93q-9fwx. #5601
  • Updated hickory-proto to fix DNS parser advisories that affected the supervisor's policy DNS handling. #5513
  • Updated rustix for an upstream memory-safety advisory. #5485

Features

  • Operators can now raise sandbox startup timeouts for slow isolation backends with provisioning_repair_window_seconds, runtime_bootstrap_grace_seconds, and sandbox_attach_request_timeout_seconds. The five-minute defaults are unchanged. #5321
  • openshell sandbox create --timeout <SECONDS> sets how long the CLI waits for provisioning, overriding the 300-second default and OPENSHELL_PROVISION_TIMEOUT. #5545
  • Shared supervisors now spread evenly across gateway replicas when they connect, and new metrics report supervisors per gateway and the busiest supervisor's sandbox count. Supervisors only move when they reconnect, so placement can stay uneven until they restart. #5436
  • A new openshell.v1.ServiceDiscovery service provides GetServiceRouteSnapshot and WatchServiceRoutes so proxies and controllers can discover a workspace's service routes. #4941
  • Inspected HTTP responses now carry an X-OpenShell-Request-ID header that links them to OCSF records and supervisor traces. The ID is a join key, not proof of authorization or delivery, and L4 or uninspected traffic doesn't get it. #5214
  • Gateway delete records now name the workspace and resource deleted, and show when a delete found nothing to remove or is still in progress. #5609
  • A reusable Grafana monitoring mixin provides dashboards for operational health, operational logs, and OCSF events in Kubernetes deployments. #5415
  • openshell workspace create and openshell workspace get now accept -o/--output table|json|yaml. #4620

Other

  • Clarified the security docs on L7 audit mode, Google token delivery, and what the sandbox runtime protects. #5452
  • Ported sandbox lifecycle, API, and create-upload end-to-end tests to the testkit. #5431, #4606
  • Added CDI device injection test scenarios for Docker and Podman. #4461
  • Added an end-to-end test that checks Kubernetes trace export against Jaeger. #5517
  • Fixed Helm overlay handling in the shared-supervisor HA end-to-end test. #5447
  • Generated the nextest profile from shared timeout constants. #5450
  • Ran the Docker external-driver conformance suite on a dedicated test machine. #5603
  • Added a lint that rejects raw TcpStream::connect calls. #5280
  • Fixed sibling script imports during typechecking. #5490
  • Let in-progress dev releases finish instead of being cancelled. #5633
  • Automatically labeled new PRs for accepted work, recorded acceptance evidence as structured metadata, and showed the cause of Review Readiness failures. #5260, #5579, #5575
  • Extracted issue and PR labeling into its own skill, added independent SDK language reviewer topics, and refined label selection guidance. #5355, #5503, #5516, #5581
  • Added the omit-needless-words review skill. #5498
  • Marked stale triage closures with stable metadata. #5493
  • Documented how to run Z3-linking tests with nix develop. #5512
  • Replaced yanked dependencies in standalone examples and refreshed blocked advisory exceptions. #5533, #5637