Skip to main content

Docker build task

Task type: dphi.space.cg2.docker.build

Purpose​

Build a Docker image from a Dockerfile in the user volume.

Definition​

  - id: docker_build_image
    type: dphi.space.cg2.docker.build
    description: Build a Docker image onboard
    dockerfile: Dockerfile
    context: build/
    image:
      name: my-app
      tag: latest
    volume: payload
    max_duration: 30

Inputs​

  • id: Name of the task.
  • description: Description of the task.
  • dockerfile: Path to the Dockerfile (relative to the volume).
  • context: Build context path (relative to the volume).
  • image.name and image.tag: Output image name and tag.
  • volume: Required volume name to resolve the dockerfile and context paths.
  • max_duration: Maximum duration (in minutes) for the full build operation, including image push time to the onboard registry.

Outputs​

  • status: Build status string.
  • message: Optional error message.

What it does​

  1. Renders a build sequence with the Dockerfile and context.
  2. Runs the build sequence.
  3. Returns the resulting image reference and status.

Common failure reasons​

  • Image name or tag is missing.
  • Dockerfile or context path is invalid.
  • Build sequence fails.