mirror of
https://github.com/docker/docs.git
synced 2026-11-04 10:01:00 +00:00
## Summary Update the Sandbox documentation for the v0.48.0 CLI refactor: renamed flags, settings commands, terminal output, structured output, and non-interactive confirmations. Add a migration reference for scripts and CI workflows, with a [**Copy as prompt** button](https://deploy-preview-26314--docsdocker.netlify.app/ai/sandboxes/workflows/automation/#update-scripts-for-v0480) that copies agent instructions and the section Markdown. This PR targets `main` independently of the other PRs in the sbx/v0.48.0 milestone. It keeps the generated reference import separate from documentation edits: - Vendor the 120 generated CLI YAML files - Update command examples and guidance. Historical release notes retain their original command spellings. The other milestone PRs cover separate release features; this PR covers the CLI migration. @netlify /ai/sandboxes/workflows/automation/ Generated by Codex
50 lines
1.6 KiB
YAML
50 lines
1.6 KiB
YAML
name: sbx kit validate
|
|
synopsis: Validate a kit artifact
|
|
experimental: true
|
|
description: |-
|
|
Validate that a directory or ZIP file is a valid kit artifact.
|
|
|
|
The reference can be a local directory, ZIP file path, or git repository.
|
|
|
|
A kit that declares required arguments is invalid until they are
|
|
supplied, so pass the same --kit-arg values you would pass to sbx
|
|
create.
|
|
usage: sbx kit validate REFERENCE [flags]
|
|
options:
|
|
- name: format
|
|
usage: 'Output format: table, json or yaml'
|
|
- name: help
|
|
shorthand: h
|
|
default_value: "false"
|
|
usage: help for validate
|
|
- name: json
|
|
default_value: "false"
|
|
usage: Output in JSON format
|
|
- name: kit-arg
|
|
default_value: '[]'
|
|
experimental: true
|
|
usage: |
|
|
Value for an argument the kit declares, as name=value for every kit or kit.name=value for one (can be repeated)
|
|
- name: kit-args-file
|
|
default_value: '[]'
|
|
experimental: true
|
|
usage: |
|
|
File of name=value kit arguments, one per line (can be repeated); --kit-arg overrides
|
|
inherited_options:
|
|
- name: cloud
|
|
default_value: "false"
|
|
usage: |
|
|
Dispatch to Docker Cloud Sandboxes API instead of local sandboxd (supported by a growing set of verbs — run 'sbx --cloud --help' for the current list)
|
|
- name: debug
|
|
shorthand: D
|
|
default_value: "false"
|
|
usage: Enable debug logging
|
|
example: |4-
|
|
sbx kit validate ./my-kit
|
|
sbx kit validate ./my-kit.zip
|
|
|
|
# Supply the arguments a kit declares
|
|
sbx kit validate ./my-kit --kit-arg region=eu
|
|
see_also:
|
|
- sbx kit - (Experimental) Manage kit artifacts
|