Docker Build icon

Docker Build

Build images from tar contexts and import image archives with streamed Docker output

Actions2

Import

AI-generated

Summary

Imports a Docker image from a binary tar archive sent via the node's input binary data.

Inputs

  • binaryPropertyName (required) — Name of the binary property on the input item containing the tar archive data (defaults to 'data').
  • platform — Optional target platform in the format os[/arch[/variant]].
  • timeoutSeconds — Maximum time to wait before cancelling the request (default: 900).
  • importRepository — Optional repository name to assign to the imported image.
  • importTag — Optional tag to assign to the imported image.
  • importChanges — Optional Dockerfile instructions to apply while importing the image.
  • importMessage — Optional commit message to record for the imported image.
  • outputMode — Whether to return a single aggregated result or one item per progress message (default: 'aggregate').

Output shape

One or more items with JSON data and optional binary fields.

When 'outputMode' is 'aggregate', returns a single item with summary fields (bytes, changes, image, message, repository, tag, parsedMessages). When 'splitItems', returns one item per parsed Docker progress message. If an image reference is provided, the node attempts to inspect the image after import and includes it in the output.

Examples

Example 1: Import a tar archive located in the binary property 'myImage' and tag it as 'myrepo/myapp:latest'.

Set binaryPropertyName to 'myImage', importRepository to 'myrepo', importTag to 'latest', and outputMode to 'aggregate'.

Example 2: Import an archive and apply 'RUN chmod -R 755 /app' changes using split mode to process each progress line.

Set importChanges to include the instruction, outputMode to 'splitItems'.

Links

Discussion