Build

The build command allows you to build and optionally push a single docker image.

⚠️ The image is built using img, and not an official Docker release, but every Dockerfile should be processed successfully.

Arguments

Argument	Type	Description	Sample values
dockerfile	Required string	Dockerfile path in the target	Dockerfile
--write	Optional path	Writable path where the built image will be stored as a TAR archive	/builds/results/image.tar
--image	Optional string, defaults to randomized taskboot-XXX	Docker image name applied on the built image	my-project/backend
--tag	Optional strings, defaults to latest	Docker tags applied on the built image	--tag=latest --tag=1.2.3
--push	Boolean switch	Push on the configured repository, using the specified tag with --tag
--build-arg	Optional strings	Docker build arguments directly passed to the inner build command	PKG_VERSION=4.5.6

Taskcluster integration

As this command builds a Docker image, you will need the following:

• scope docker-worker:capability:privileged on your task
• a worker type that can use the privileged capability (ask a #taskcluster admin)
• request the priviliged state in your task payload:

payload:
  capabilities:
    privileged: true