mirror of https://github.com/docker/compose.git
31 lines
1.2 KiB
Markdown
31 lines
1.2 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. |
|
|
| `--no-cache` | | | Do not use cache when building the image |
|
|
| `--progress` | `string` | `auto` | Set type of progress output (auto, tty, plain, quiet) |
|
|
| `--pull` | | | Always attempt to pull a newer version of the image. |
|
|
| `-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.
|