compose/docs/reference/compose_build.md

3.0 KiB

docker compose build

Services are built once and then tagged, by default as project-service.

If the Compose file specifies an image name, the image is tagged with that name, substituting any variables beforehand. See variable interpolation.

If you change a service's Dockerfile or the contents of its build directory, run docker compose build to rebuild it.

Options

Name Type Default Description
--build-arg stringArray Set build-time variables for services
--builder string Set builder to use
--dry-run bool Execute command in dry run mode
-m, --memory bytes 0 Set memory limit for the build container. Not supported by BuildKit.
--no-cache bool Do not use cache when building the image
--pull bool Always attempt to pull a newer version of the image
--push bool Push service images
-q, --quiet bool Don't print anything to STDOUT
--ssh string Set SSH authentications used when building service images. (use 'default' for using your default SSH Agent)
--with-dependencies bool Also build dependencies (transitively)

Description

Services are built once and then tagged, by default as project-service.

If the Compose file specifies an image name, the image is tagged with that name, substituting any variables beforehand. See variable interpolation.

If you change a service's Dockerfile or the contents of its build directory, run docker compose build to rebuild it.