Skip to content

Commit bbee456

Browse files
authored
docs: explain kit sets and environment file composition (#26221)
## Summary The kit docs explain published sets and direct mixin composition but don't help readers choose between a set and an environment file. Clarify when to use each, link to environment files from the mixin composition instructions, and note that separately composed OCI kits need distinct image repository names. @netlify /ai/sandboxes/customize/ Generated by Codex
1 parent b4b06ed commit bbee456

2 files changed

Lines changed: 13 additions & 0 deletions

File tree

‎content/manuals/ai/sandboxes/customize/_index.md‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -82,6 +82,14 @@ combined environment.
8282
If the set includes a workload, you run the published kit with `sbx run`.
8383
If it contains only mixins, you add it to a workload with `--kit`.
8484

85+
To share a combination without publishing another kit, list the workload and
86+
mixins in a [sandbox environment file](/manuals/ai/sandboxes/configuration/environment-files.md).
87+
Docker Sandboxes composes those kits when it creates the sandbox. An environment
88+
file can also configure the workspace and host resources. Choose a set when you
89+
want one published reference with a fixed list of components; the set records
90+
their image digests when you build it. You can also use a set in an environment
91+
file.
92+
8593
See [Use kits](/manuals/ai/sandboxes/customize/use-kits.md) for how to run kits
8694
and add mixins. To customize and publish your own combination, see
8795
[Compose a kit set](/manuals/ai/sandboxes/customize/author/kit-sets.md).

‎content/manuals/ai/sandboxes/customize/use-kits.md‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -135,6 +135,11 @@ feature, Docker Sandboxes can reject the combination.
135135

136136
To publish your combination as one reference, see
137137
[Compose a kit set](/manuals/ai/sandboxes/customize/author/kit-sets.md).
138+
To keep the kits separate in a shared sandbox configuration, list them in a
139+
[sandbox environment file](/manuals/ai/sandboxes/configuration/environment-files.md).
140+
Give each published kit its own image repository name. Different tags of the
141+
same repository have the same kit name, and Docker Sandboxes rejects duplicate
142+
names in a composition.
138143

139144
### Change a sandbox's mixins
140145

0 commit comments

Comments
 (0)