buildx_create
Create a new BuildKit builder for multi-platform builds and cache export. Set it as default or bootstrap immediately.
Instructions
Create a new BuildKit builder instance.
Needed when the default docker driver falls short: multi-platform builds and cache export
require a docker-container (or kubernetes/remote) builder. Pass use=True to make it
the default for later buildx_build calls (else switch with buildx_use); bootstrap=True
starts the builder now rather than on first build.
Does not raise on a non-zero CLI exit (a missing buildx plugin or a timeout still raises) - inspect
returncode/stderr in the result.
Args:
name: Name for the new builder (defaults to a generated name)
driver: BuildKit driver (e.g. "docker-container", "kubernetes", "remote")
driver_opts: Driver-specific options (each becomes --driver-opt KEY=VALUE)
use: Set the new builder as the current one
bootstrap: Boot the builder immediately
platforms: Platforms the builder advertises
config: Path to a buildkitd config file (copied to the target host if no local plugin); passed as
--buildkitd-config, so this argument needs buildx >= 0.17
node_name: Node name within the builder (for multi-node builders)
append: Append a node to an existing builder named name
Returns: dict: {"returncode": int, "stdout": str, "stderr": str, "truncated": bool}
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| use | No | ||
| name | No | ||
| append | No | ||
| config | No | ||
| driver | No | ||
| bootstrap | No | ||
| node_name | No | ||
| platforms | No | ||
| driver_opts | No |