docker_compose_pull.yaml 3.4 KB

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