reactor build

reactor build [flags]

Description

Build the model defined by the current workspace. The image is built from reactor.yaml’s ‘build:’ block: the Dockerfile is generated in memory and handed straight to BuildKit, never written to the workspace. reactor.yaml must declare build.runtime_version, which names the reactor-runtime release the image installs. A Dockerfile on disk takes the build over. The workspace ./Dockerfile is built verbatim when it exists, and -f/--dockerfile builds an explicit path instead; either way reactor.yaml’s build fields are ignored, with a stderr note naming them. --no-dockerfile builds from reactor.yaml even when a ./Dockerfile exists, and is mutually exclusive with -f/--dockerfile. The result is tagged ‘reactor-local/<name>:dev’ (where <name> is derived from the workspace directory name and sanitized for Docker). This is a local development artifact; ‘reactor model deploy’ builds and publishes its own versioned deployment image. --build-secret forwards a BuildKit secret using docker’s standard ‘--secret’ grammar: comma-separated key=value fields with keys type (file|env), id, src/source, and env - for example ‘id=<id>,src=<path>’, ‘id=<id>,env=<envvar>’, or ‘type=env,id=<id>’. The secret is mounted at /run/secrets/<id> only during a matching ‘RUN --mount=type=secret,id=<id>’ step in the Dockerfile and is never baked into image layers (unlike --build-env, which is). Repeatable. --build-env overrides a build.build_env value from reactor.yaml for this build only: KEY=VALUE pairs, repeatable. A bare KEY (no ’=’) takes its value from the environment and is dropped when it is unset there. A build from reactor.yaml rejects a KEY that build.build_env does not declare, except the args BuildKit predefines: the proxy variables (such as HTTP_PROXY), SOURCE_DATE_EPOCH, and BUILDKIT_* names. --build-env values are kept in the image metadata, so use --build-secret for credentials. Examples:

reactor build                                    # from reactor.yaml, layer cache on
reactor build -f Dockerfile.gpu                  # build a non-default Dockerfile
reactor build --no-dockerfile                    # ignore the on-disk ./Dockerfile
reactor build --no-cache                         # rebuild from scratch (no layer cache)
reactor build --build-secret id=github_token,env=GITHUB_TOKEN
reactor build --build-env MAX_JOBS=16

Options

Flag	Description
`--build-env stringArray`	Override a build.build_env value for this build, KEY=VALUE (repeatable; a bare KEY takes its value from the environment)
`--build-secret stringArray`	BuildKit secret forwarded to ‘docker build `--secret`’ (repeatable; e.g. id=github_token,env=GITHUB_TOKEN)
`-f, --dockerfile string`	Path to an explicit Dockerfile (relative to the workspace); defaults to the workspace ./Dockerfile when one exists
`--no-cache`	Pass `--no-cache` to docker build (rebuild every layer)
`--no-dockerfile`	Build from reactor.yaml, ignoring an on-disk Dockerfile
`--platform string`	Target build platform (default linux/amd64). Overrides build.platform in reactor.yaml; an explicit ‘FROM `--platform`=’ in the Dockerfile still wins for that stage.

Global options

Flag	Description
`--server string`	Reactor API server URL (default “https://api.reactor.inc”)
`-v, --verbose`	Enable verbose output

Get Started

CLI & Platform

Build a Model

Media & Transport

Releases

Description

Options

Global options

See also

​Description

​Options

​Global options

​See also

Description

Options

Global options

See also