You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 7fcd175
Browse filesBrowse the repository at this point in the historyBrowse files
| Private named volumes | One carries the authenticated sandbox/supervisor channel. The other is mounted only into the supervisor and contains its JWT and private gateway credentials. |
86
86
| In-memory `/run/openshell-supervisor-ca` tmpfs | Holds only the public supervisor CA certificate and trust bundle without making all of `/run` writable. |
87
87
| CDI GPU request | Assigns the exact validated CDI devices requested by driver config or count-based selection. |
88
+
| CDI workload projection | For GPU sandboxes only, embeds selected device metadata in the protected boundary config and mounts Docker daemon CDI spec directories read-only into the workload. |
88
89
89
90
## Stop, Start, and Delete
90
91
@@ -98,6 +99,20 @@ Delete force-removes both containers, the driver-owned runtime volumes, and the
98
99
host-private runtime descriptor. Missing or altered descriptor and channel resources
99
100
fail closed; the driver does not run an older combined-supervisor layout.
100
101
102
+
## CDI GPU Metadata
103
+
104
+
Docker remains the source of truth for GPU injection. The driver selects opaque
105
+
CDI device IDs from `driver_config.cdi_devices` or the daemon's discovered CDI
106
+
inventory, then passes the same IDs to Docker with a CDI `DeviceRequest`.
107
+
108
+
For a GPU sandbox, the driver writes those IDs and projected CDI spec directory
109
+
paths to a versioned context in the protected workload boundary configuration.
110
+
It bind-mounts the daemon-reported spec directories read-only into the workload.
111
+
The sandbox runtime resolves the selected devices in that mount namespace before
112
+
it launches agent processes and derives Landlock paths and supplemental groups
113
+
from CDI `containerEdits`. A missing context or spec directory fails workload
114
+
startup closed. Non-GPU sandboxes receive no CDI context or spec mounts.
115
+
101
116
## Driver Config Mounts
102
117
103
118
The gateway forwards the `docker` block from `--driver-config-json`. Supported
Copy file name to clipboardExpand all lines: docs/how-it-works/sandboxes/runtimes.mdx
+11Lines changed: 11 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -91,6 +91,17 @@ Common options in `[openshell.drivers.docker]` are `socket_path`, `grpc_endpoint
91
91
92
92
Docker Desktop must have host networking enabled, and it cannot use Enhanced Container Isolation. Set `grpc_endpoint` when sandboxes cannot reach the gateway on host loopback. For GPU sandboxes, configure Docker CDI before starting the gateway.
0 commit comments