mirror of https://github.com/docker/compose.git
140 lines
4.7 KiB
YAML
140 lines
4.7 KiB
YAML
command: docker compose pull
|
|
short: Pull service images
|
|
long: |
|
|
Pulls an image associated with a service defined in a `compose.yaml` file, but does not start containers based on those images
|
|
usage: docker compose pull [OPTIONS] [SERVICE...]
|
|
pname: docker compose
|
|
plink: docker_compose.yaml
|
|
options:
|
|
- option: ignore-buildable
|
|
value_type: bool
|
|
default_value: "false"
|
|
description: Ignore images that can be built
|
|
deprecated: false
|
|
hidden: false
|
|
experimental: false
|
|
experimentalcli: false
|
|
kubernetes: false
|
|
swarm: false
|
|
- option: ignore-pull-failures
|
|
value_type: bool
|
|
default_value: "false"
|
|
description: Pull what it can and ignores images with pull failures
|
|
deprecated: false
|
|
hidden: false
|
|
experimental: false
|
|
experimentalcli: false
|
|
kubernetes: false
|
|
swarm: false
|
|
- option: include-deps
|
|
value_type: bool
|
|
default_value: "false"
|
|
description: Also pull services declared as dependencies
|
|
deprecated: false
|
|
hidden: false
|
|
experimental: false
|
|
experimentalcli: false
|
|
kubernetes: false
|
|
swarm: false
|
|
- option: no-parallel
|
|
value_type: bool
|
|
default_value: "true"
|
|
description: DEPRECATED disable parallel pulling
|
|
deprecated: false
|
|
hidden: true
|
|
experimental: false
|
|
experimentalcli: false
|
|
kubernetes: false
|
|
swarm: false
|
|
- option: parallel
|
|
value_type: bool
|
|
default_value: "true"
|
|
description: DEPRECATED pull multiple images in parallel
|
|
deprecated: false
|
|
hidden: true
|
|
experimental: false
|
|
experimentalcli: false
|
|
kubernetes: false
|
|
swarm: false
|
|
- option: policy
|
|
value_type: string
|
|
description: Apply pull policy ("missing"|"always")
|
|
deprecated: false
|
|
hidden: false
|
|
experimental: false
|
|
experimentalcli: false
|
|
kubernetes: false
|
|
swarm: false
|
|
- option: quiet
|
|
shorthand: q
|
|
value_type: bool
|
|
default_value: "false"
|
|
description: Pull without printing progress information
|
|
deprecated: false
|
|
hidden: false
|
|
experimental: false
|
|
experimentalcli: false
|
|
kubernetes: false
|
|
swarm: false
|
|
inherited_options:
|
|
- option: dry-run
|
|
value_type: bool
|
|
default_value: "false"
|
|
description: Execute command in dry run mode
|
|
deprecated: false
|
|
hidden: false
|
|
experimental: false
|
|
experimentalcli: false
|
|
kubernetes: false
|
|
swarm: false
|
|
examples: |-
|
|
Consider the following `compose.yaml`:
|
|
|
|
```yaml
|
|
services:
|
|
db:
|
|
image: postgres
|
|
web:
|
|
build: .
|
|
command: bundle exec rails s -p 3000 -b '0.0.0.0'
|
|
volumes:
|
|
- .:/myapp
|
|
ports:
|
|
- "3000:3000"
|
|
depends_on:
|
|
- db
|
|
```
|
|
|
|
If you run `docker compose pull ServiceName` in the same directory as the `compose.yaml` file that defines the service,
|
|
Docker pulls the associated image. For example, to call the postgres image configured as the db service in our example,
|
|
you would run `docker compose pull db`.
|
|
|
|
```console
|
|
$ docker compose pull db
|
|
[+] Running 1/15
|
|
⠸ db Pulling 12.4s
|
|
⠿ 45b42c59be33 Already exists 0.0s
|
|
⠹ 40adec129f1a Downloading 3.374MB/4.178MB 9.3s
|
|
⠹ b4c431d00c78 Download complete 9.3s
|
|
⠹ 2696974e2815 Download complete 9.3s
|
|
⠹ 564b77596399 Downloading 5.622MB/7.965MB 9.3s
|
|
⠹ 5044045cf6f2 Downloading 216.7kB/391.1kB 9.3s
|
|
⠹ d736e67e6ac3 Waiting 9.3s
|
|
⠹ 390c1c9a5ae4 Waiting 9.3s
|
|
⠹ c0e62f172284 Waiting 9.3s
|
|
⠹ ebcdc659c5bf Waiting 9.3s
|
|
⠹ 29be22cb3acc Waiting 9.3s
|
|
⠹ f63c47038e66 Waiting 9.3s
|
|
⠹ 77a0c198cde5 Waiting 9.3s
|
|
⠹ c8752d5b785c Waiting 9.3s
|
|
```
|
|
|
|
`docker compose pull` tries to pull image for services with a build section. If pull fails, it lets you know this service image must be built. You can skip this by setting `--ignore-buildable` flag.
|
|
deprecated: false
|
|
hidden: false
|
|
experimental: false
|
|
experimentalcli: false
|
|
kubernetes: false
|
|
swarm: false
|
|
|