Build
AI-generatedSummary
Builds a Docker image from a binary tar archive containing a Docker build context, or imports an image archive.
Inputs
- Binary Property (required) — The name of the binary property on the input item containing the tar archive (e.g., 'data').
- Dockerfile Path — Path inside the tar build context to the Dockerfile. Defaults to 'Dockerfile'.
- Build Args — Build-time variables passed to Docker (e.g., ARG=value).
- Build Labels — Image labels applied during build (e.g., LabelName=Value).
- Tags — Optional image names and tags to apply during build.
- Timeout Seconds — Maximum time to wait before cancelling the build or import request. Defaults to 900.
- Output Mode — Whether to return a single aggregated result or one item per parsed progress message (aggregate or splitItems). Defaults to aggregate.
Output shape
A single item with image details (digest, ID, tags) and raw build logs, or multiple items (one per log line) when Output Mode is splitItems.
If the build succeeds, the output contains image metadata (ID, digest, named references) and the full stream of Docker build progress messages. The binary property from the input is not propagated to the output.
Examples
Example 1: Build a multi-stage Docker image from a tar context and inspect the result.
Set Binary Property to 'data', provide Dockerfile and tags, set Output Mode to 'aggregate'.
Example 2: Import a tar archive as a Docker image with a custom repository and tag.
Set Operation to 'Import', provide Binary Property, and set Repository and Tag.