summaryrefslogtreecommitdiff
path: root/devdocs/docker/compose%2Freference%2Fpull%2Findex.html
blob: 4ca2524654d0a636cb30e0efc1a5c20db53f3774 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
<h1>docker-compose pull</h1>
<pre data-language="">Usage: docker-compose pull [options] [SERVICE...]

Options:
    --ignore-pull-failures  Pull what it can and ignores images with pull failures.
    --parallel              Deprecated, pull multiple images in parallel (enabled by default).
    --no-parallel           Disable parallel pulling.
    -q, --quiet             Pull without printing progress information
    --include-deps          Also pull services declared as dependencies
</pre> <p>Pulls an image associated with a service defined in a <code class="language-plaintext highlighter-rouge">docker-compose.yml</code> or <code class="language-plaintext highlighter-rouge">docker-stack.yml</code> file, but does not start containers based on those images.</p> <p>For example, suppose you have this <code class="language-plaintext highlighter-rouge">docker-compose.yml</code> file from the <a href="https://docs.docker.com/samples/rails/">Quickstart: Compose and Rails</a> sample.</p> <div class="highlight"><pre class="highlight" data-language="">version: '2'
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
</pre></div> <p>If you run <code class="language-plaintext highlighter-rouge">docker-compose pull ServiceName</code> in the same directory as the <code class="language-plaintext highlighter-rouge">docker-compose.yml</code> file that defines the service, Docker pulls the associated image. For example, to call the <code class="language-plaintext highlighter-rouge">postgres</code> image configured as the <code class="language-plaintext highlighter-rouge">db</code> service in our example, you would run <code class="language-plaintext highlighter-rouge">docker-compose pull db</code>.</p> <div class="highlight"><pre class="highlight" data-language="">$ docker-compose pull db
Pulling db (postgres:latest)...
latest: Pulling from library/postgres
cd0a524342ef: Pull complete
9c784d04dcb0: Pull complete
d99dddf7e662: Pull complete
e5bff71e3ce6: Pull complete
cb3e0a865488: Pull complete
31295d654cd5: Pull complete
fc930a4e09f5: Pull complete
8650cce8ef01: Pull complete
61949acd8e52: Pull complete
527a203588c0: Pull complete
26dec14ac775: Pull complete
0efc0ed5a9e5: Pull complete
40cd26695b38: Pull complete
Digest: sha256:fd6c0e2a9d053bebb294bb13765b3e01be7817bf77b01d58c2377ff27a4a46dc
Status: Downloaded newer image for postgres:latest
</pre></div> 
<p><a href="https://docs.docker.com/search/?q=fig">fig</a>, <a href="https://docs.docker.com/search/?q=composition">composition</a>, <a href="https://docs.docker.com/search/?q=compose">compose</a>, <a href="https://docs.docker.com/search/?q=docker">docker</a>, <a href="https://docs.docker.com/search/?q=orchestration">orchestration</a>, <a href="https://docs.docker.com/search/?q=cli">cli</a>, <a href="https://docs.docker.com/search/?q=pull">pull</a></p>
<div class="_attribution">
  <p class="_attribution-p">
    &copy; 2019 Docker, Inc.<br>Licensed under the Apache License, Version 2.0.<br>Docker and the Docker logo are trademarks or registered trademarks of Docker, Inc. in the United States and/or other countries.<br>Docker, Inc. and other parties may also have trademark rights in other terms used herein.<br>
    <a href="https://docs.docker.com/compose/reference/pull/" class="_attribution-link">https://docs.docker.com/compose/reference/pull/</a>
  </p>
</div>