mirror of https://github.com/docker/compose.git
34 lines
2.3 KiB
Markdown
34 lines
2.3 KiB
Markdown
# docker compose build
|
|
|
|
<!---MARKER_GEN_START-->
|
|
Build or rebuild services
|
|
|
|
### Options
|
|
|
|
| Name | Type | Default | Description |
|
|
|:-----------------|:--------------|:--------|:------------------------------------------------------------------------------------------------------------|
|
|
| `--build-arg` | `stringArray` | | Set build-time variables for services. |
|
|
| `--builder` | `string` | | Set builder to use. |
|
|
| `--dry-run` | | | Execute command in dry run mode |
|
|
| `-m`, `--memory` | `bytes` | `0` | Set memory limit for the build container. Not supported by BuildKit. |
|
|
| `--no-cache` | | | Do not use cache when building the image |
|
|
| `--pull` | | | Always attempt to pull a newer version of the image. |
|
|
| `--push` | | | Push service images. |
|
|
| `-q`, `--quiet` | | | Don't print anything to STDOUT |
|
|
| `--ssh` | `string` | | Set SSH authentications used when building service images. (use 'default' for using your default SSH Agent) |
|
|
|
|
|
|
<!---MARKER_GEN_END-->
|
|
|
|
## Description
|
|
|
|
Services are built once and then tagged, by default as `project_service`.
|
|
|
|
If the Compose file specifies an
|
|
[image](https://github.com/compose-spec/compose-spec/blob/master/spec.md#image) name,
|
|
the image is tagged with that name, substituting any variables beforehand. See
|
|
[variable interpolation](https://github.com/compose-spec/compose-spec/blob/master/spec.md#interpolation).
|
|
|
|
If you change a service's `Dockerfile` or the contents of its build directory,
|
|
run `docker compose build` to rebuild it.
|