docker_compose_pull.yaml 3.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102
  1. command: docker compose pull
  2. short: Pull service images
  3. long: |-
  4. Pulls an image associated with a service defined in a `compose.yaml` file, but does not start containers based on
  5. those images.
  6. usage: docker compose pull [SERVICE...]
  7. pname: docker compose
  8. plink: docker_compose.yaml
  9. options:
  10. - option: ignore-pull-failures
  11. value_type: bool
  12. default_value: "false"
  13. description: Pull what it can and ignores images with pull failures
  14. deprecated: false
  15. experimental: false
  16. experimentalcli: false
  17. kubernetes: false
  18. swarm: false
  19. - option: include-deps
  20. value_type: bool
  21. default_value: "false"
  22. description: Also pull services declared as dependencies
  23. deprecated: false
  24. experimental: false
  25. experimentalcli: false
  26. kubernetes: false
  27. swarm: false
  28. - option: no-parallel
  29. value_type: bool
  30. default_value: "true"
  31. description: DEPRECATED disable parallel pulling.
  32. deprecated: false
  33. experimental: false
  34. experimentalcli: false
  35. kubernetes: false
  36. swarm: false
  37. - option: parallel
  38. value_type: bool
  39. default_value: "true"
  40. description: DEPRECATED pull multiple images in parallel.
  41. deprecated: false
  42. experimental: false
  43. experimentalcli: false
  44. kubernetes: false
  45. swarm: false
  46. - option: quiet
  47. shorthand: q
  48. value_type: bool
  49. default_value: "false"
  50. description: Pull without printing progress information
  51. deprecated: false
  52. experimental: false
  53. experimentalcli: false
  54. kubernetes: false
  55. swarm: false
  56. examples: |-
  57. suppose you have this `compose.yaml`:
  58. ```yaml
  59. services:
  60. db:
  61. image: postgres
  62. web:
  63. build: .
  64. command: bundle exec rails s -p 3000 -b '0.0.0.0'
  65. volumes:
  66. - .:/myapp
  67. ports:
  68. - "3000:3000"
  69. depends_on:
  70. - db
  71. ```
  72. If you run `docker compose pull ServiceName` in the same directory as the `compose.yaml` file that defines the service,
  73. Docker pulls the associated image. For example, to call the postgres image configured as the db service in our example,
  74. you would run `docker compose pull db`.
  75. ```console
  76. $ docker compose pull db
  77. [+] Running 1/15
  78. ⠸ db Pulling 12.4s
  79. ⠿ 45b42c59be33 Already exists 0.0s
  80. ⠹ 40adec129f1a Downloading 3.374MB/4.178MB 9.3s
  81. ⠹ b4c431d00c78 Download complete 9.3s
  82. ⠹ 2696974e2815 Download complete 9.3s
  83. ⠹ 564b77596399 Downloading 5.622MB/7.965MB 9.3s
  84. ⠹ 5044045cf6f2 Downloading 216.7kB/391.1kB 9.3s
  85. ⠹ d736e67e6ac3 Waiting 9.3s
  86. ⠹ 390c1c9a5ae4 Waiting 9.3s
  87. ⠹ c0e62f172284 Waiting 9.3s
  88. ⠹ ebcdc659c5bf Waiting 9.3s
  89. ⠹ 29be22cb3acc Waiting 9.3s
  90. ⠹ f63c47038e66 Waiting 9.3s
  91. ⠹ 77a0c198cde5 Waiting 9.3s
  92. ⠹ c8752d5b785c Waiting 9.3s
  93. ``̀`
  94. deprecated: false
  95. experimental: false
  96. experimentalcli: false
  97. kubernetes: false
  98. swarm: false