Difference between revisions of "Buildctl build"
Jump to navigation
Jump to search
(Created page with "{{lc}} == See also == * {{buildctl}} * {{BuildKit}} Category:Containers") |
|||
Line 1: | Line 1: | ||
{{lc}} | {{lc}} | ||
+ | <pre> | ||
+ | buildctl build --help | ||
+ | NAME: | ||
+ | buildctl build - build | ||
+ | |||
+ | USAGE: | ||
+ | |||
+ | To build and push an image using Dockerfile: | ||
+ | $ buildctl build --frontend dockerfile.v0 --opt target=foo --opt build-arg:foo=bar --local context=. --local dockerfile=. --output type=image,name=docker.io/username/image,push=true | ||
+ | |||
+ | |||
+ | OPTIONS: | ||
+ | --output value, -o value Define exports for build result, e.g. --output type=image,name=docker.io/username/image,push=true | ||
+ | --progress value Set type of progress (auto, plain, tty). Use plain to show container output (default: "auto") | ||
+ | --trace value Path to trace file. Defaults to no tracing. | ||
+ | --local value Allow build access to the local directory | ||
+ | --oci-layout value Allow build access to the local OCI layout | ||
+ | --frontend value Define frontend used for build | ||
+ | --opt value Define custom options for frontend, e.g. --opt target=foo --opt build-arg:foo=bar | ||
+ | --no-cache Disable cache for all the vertices | ||
+ | --export-cache value Export build cache, e.g. --export-cache type=registry,ref=example.com/foo/bar, or --export-cache type=local,dest=path/to/dir | ||
+ | --import-cache value Import build cache, e.g. --import-cache type=registry,ref=example.com/foo/bar, or --import-cache type=local,src=path/to/dir | ||
+ | --secret value Secret value exposed to the build. Format id=secretname,src=filepath | ||
+ | --allow value Allow extra privileged entitlement, e.g. network.host, security.insecure | ||
+ | --ssh value Allow forwarding SSH agent to the builder. Format default|<id>[=<socket>|<key>[,<key>]] | ||
+ | --metadata-file value Output build metadata (e.g., image digest) to a file as JSON | ||
+ | --source-policy-file value Read source policy file from a JSON file | ||
+ | --ref-file value Write build ref to a file | ||
+ | </pre> | ||
Latest revision as of 13:32, 7 April 2023
buildctl build --help NAME: buildctl build - build USAGE: To build and push an image using Dockerfile: $ buildctl build --frontend dockerfile.v0 --opt target=foo --opt build-arg:foo=bar --local context=. --local dockerfile=. --output type=image,name=docker.io/username/image,push=true OPTIONS: --output value, -o value Define exports for build result, e.g. --output type=image,name=docker.io/username/image,push=true --progress value Set type of progress (auto, plain, tty). Use plain to show container output (default: "auto") --trace value Path to trace file. Defaults to no tracing. --local value Allow build access to the local directory --oci-layout value Allow build access to the local OCI layout --frontend value Define frontend used for build --opt value Define custom options for frontend, e.g. --opt target=foo --opt build-arg:foo=bar --no-cache Disable cache for all the vertices --export-cache value Export build cache, e.g. --export-cache type=registry,ref=example.com/foo/bar, or --export-cache type=local,dest=path/to/dir --import-cache value Import build cache, e.g. --import-cache type=registry,ref=example.com/foo/bar, or --import-cache type=local,src=path/to/dir --secret value Secret value exposed to the build. Format id=secretname,src=filepath --allow value Allow extra privileged entitlement, e.g. network.host, security.insecure --ssh value Allow forwarding SSH agent to the builder. Format default|<id>[=<socket>|<key>[,<key>]] --metadata-file value Output build metadata (e.g., image digest) to a file as JSON --source-policy-file value Read source policy file from a JSON file --ref-file value Write build ref to a file
See also[edit]
Advertising: