一 Docker Compose文件簡(jiǎn)介

compose文件使用yml格式，主要分為了四個(gè)區(qū)域：

• version：用于指定當(dāng)前docker-compose.yml語(yǔ)法遵循哪個(gè)版本
• services：服務(wù)，在它下面可以定義應(yīng)用需要的一些服務(wù)，每個(gè)服務(wù)都有自己的名字、使用的鏡像、掛載的數(shù)據(jù)卷、所屬的網(wǎng)絡(luò)、依賴(lài)哪些其他服務(wù)等等。
• networks：應(yīng)用的網(wǎng)絡(luò)，在它下面可以定義應(yīng)用的名字、使用的網(wǎng)絡(luò)類(lèi)型等。
• volumes：數(shù)據(jù)卷，在它下面可以定義數(shù)據(jù)卷，然后掛載到不同的服務(wù)下去使用。

二 Docker Compose文件詳解

2.1 version字段

用于指定當(dāng)前compose文件語(yǔ)法遵循哪個(gè)版本，Compose文件版本支持特定的Docker版本列表如下：

Compose文件格式	Docker Engine版本
3.7	18.06.0+
3.6	18.02.0+
3.5	17.12.0+
3.4	17.09.0+
3.3	17.06.0+
3.2	17.04.0+
3.1	1.13.1+
3.0	1.13.0+
2.4	17.12.0+
2.3	17.06.0+
2.2	1.13.0+
2.1	1.12.0+
2.0	1.10.0+
1.0	1.9.1.+

示例：version: "3"

2.2 services區(qū)域

所有服務(wù)的定義都是定義在services區(qū)域中，services常用的配置項(xiàng)如下： image：指定要啟動(dòng)容器的映像。可以是一個(gè)repository/tag或鏡像ID來(lái)表明。 示例： image: redis image: ubuntu:14.04 image: tutum/influxdb image: example-registry.com:4000/postgresql image: a4bc65fd 提示：image可以是本地也可以是遠(yuǎn)程的，如果本地不存在，compose會(huì)嘗試pull下來(lái)，肉使用了build手動(dòng)構(gòu)建鏡像，則使用指定的選項(xiàng)構(gòu)建它，并使用指定的標(biāo)簽標(biāo)記它。 build：該參數(shù)指定Dockerfile文件的路徑，compose會(huì)通過(guò)Dockerfile構(gòu)建并生成鏡像，然后使用該鏡像 示例： 1 version: '3' 2 services: 3 webapp: 4 build: ./dir 5 image: webapp:tag 提示：如果在構(gòu)建鏡像的時(shí)候你指定相關(guān)名字和tag，則生成指定的鏡像和tag。 command：重寫(xiě)默認(rèn)的命令，即指定啟動(dòng)容器的命令。 示例： command: bundle exec thin -p 3000 或 command: ["bundle", "exec", "thin", "-p", "3000"] links：鏈接到其他服務(wù)中的容器，可以指定服務(wù)名稱(chēng)和這個(gè)鏈接的別名，或者只指定服務(wù)名稱(chēng)。 示例： 1 web: 2 links: 3 - db 4 - db:database 5 - redis 此時(shí)，在容器內(nèi)部，會(huì)在/etc/hosts文件中用別名創(chuàng)建幾個(gè)條目，如下： 1 172.17.2.100 db 2 172.17.2.100 database 3 172.17.2.100 redis external_links：鏈接到compose外部啟動(dòng)的容器，特別是對(duì)于提供共享和公共服務(wù)的容器。在指定容器名稱(chēng)和別名時(shí)，external_links遵循著和links相同的語(yǔ)義用法。 示例： 1 external_links: 2 - redis_1 3 - project_db_1:mysql 4 - project_db_1:postgresql ports：暴露端口，指定宿主機(jī)到容器的端口映射，或者只指定容器的端口，則表示映射到主機(jī)上的隨機(jī)端口。 提示：注意：以HOST:CONTAINER格式映射端口時(shí)，使用低于60的容器端口時(shí)可能會(huì)遇到錯(cuò)誤的結(jié)果，因?yàn)閅AML會(huì)將格式xx:yy中的數(shù)字解析為base-60值。因此，我們建議始終將端口映射明確指定為字符串。 示例： 1 ports: 2 - "3000" 3 - "3000-3005" 4 - "8000:8000" 5 - "9090-9091:8080-8081" 6 - "49100:22" 7 - "127.0.0.1:8001:8001" 8 - "127.0.0.1:5000-5010:5000-5010" 9 - "6060:6060/udp" 示例2： 1 ports: 2 - target: 80 3 published: 8080 4 protocol: tcp 5 mode: host 解釋：長(zhǎng)格式語(yǔ)法允許配置無(wú)法以簡(jiǎn)短形式表示的其他字段。

• target：容器內(nèi)的端口
• published：公開(kāi)暴露的港口
• protocol：端口協(xié)議（tcp或udp）
• mode：host用于在每個(gè)節(jié)點(diǎn)上發(fā)布主機(jī)端口，或者ingress用于負(fù)載平衡的群集模式端口。

expose：暴露端口，但不需要建立與宿主機(jī)的映射，只是會(huì)向鏈接的服務(wù)提供，只能指定內(nèi)部端口。 示例： 1 expose: 2 - "3000" 3 - "8000" environment：加入環(huán)境變量，可以使用數(shù)組或者字典，只有一個(gè)key的環(huán)境變量可以在運(yùn)行compose的機(jī)器上找到對(duì)應(yīng)的值。 提示：任何布爾值; true，false，yes no，需要用引號(hào)括起來(lái)，以確保YML解析器不會(huì)將它們轉(zhuǎn)換為T(mén)rue或False。 示例： 1 environment: 2 RACK_ENV: development 3 SHOW: 'true' 4 SESSION_SECRET: 5 environment: 6 - RACK_ENV=development 7 - SHOW=true 8 - SESSION_SECRET env_file：從一個(gè)文件中引入環(huán)境變量，該文件可以是一個(gè)單獨(dú)的值或者一個(gè)列表，如果同時(shí)定義了environment，則environment中的環(huán)境變量會(huì)重寫(xiě)這些值。 示例： 1 env_file: .env 2 3 env_file: 4 - ./common.env 5 - ./apps/web.env 6 - /opt/secrets.env 提示：列表中文件的順序?qū)τ诖_定分配給多次顯示的變量的值非常重要。列表中的文件從上到下進(jìn)行處理。對(duì)于在文件中指定的相同變量a.env并在文件中 分配不同的值b.env，如果b.env列在下面（后），則來(lái)自b.envstand 的值。 如：給出以下聲明docker_compose.yml： 1 services: 2 some-service: 3 env_file: 4 - a.env 5 - b.env 以下文件： # a.env VAR=1 和 # b.env VAR=hello 則$VAR是hello。 depends_on：指定與部署和運(yùn)行服務(wù)相關(guān)的配置。 示例： 1 version: '3' 2 services: 3 web: 4 build: . 5 depends_on: 6 - db 7 - redis 8 redis: 9 image: redis 10 db: 11 image: postgres 服務(wù)依賴(lài)關(guān)系之間的Express依賴(lài)關(guān)系會(huì)導(dǎo)致以下行為：

• docker-compose up：以依賴(lài)順序啟動(dòng)服務(wù),在以上示例中，db和redis之在web之前啟動(dòng)。
• docker-compose up SERVICE：自動(dòng)包含SERVICE依賴(lài)項(xiàng)。在以上示例中，docker-compose up web還創(chuàng)建并啟動(dòng)db和redis。

deploy：指定與部署和運(yùn)行服務(wù)相關(guān)的配置。 示例： 1 version: '3' 2 services: 3 redis: 4 image: redis:alpine 5 deploy: 6 labels： 7 com.example.description: "This label will appear on all containers for the web service" 8 resources: 9 limits: 10 cpus: '0.50' 11 memory: 50M 12 reservations: 13 cpus: '0.25' 14 memory: 20M 15 replicas: 6 16 update_config: 17 parallelism: 2 18 delay: 10s 19 update_config: 20 parallelism: 2 21 delay: 10s 22 order: stop-first 23 restart_policy: 24 condition: on-failure 25 delay: 5s 26 max_attempts: 3 27 window: 120s 子選項(xiàng)說(shuō)明： labels：指定服務(wù)的標(biāo)簽。這些標(biāo)簽僅在服務(wù)上設(shè)置，而不是在服務(wù)的任何容器上設(shè)置。 mode：global：每個(gè)集群節(jié)點(diǎn)只有一個(gè)容器，默認(rèn)為replicated。 resources：資源限制,如上所示：redis服務(wù)被限制為使用不超過(guò)50M的內(nèi)存和0.50（50％）的CPU時(shí)間，并且保留20M了內(nèi)存和0.25CPU時(shí)間（始終可用）。 replicas：指定replicated后，或默認(rèn)情況下課使用replicas指定副本數(shù)， restart_policy：配置是否以及如何在容器退出時(shí)重新啟動(dòng)容器，包括：

• condition：其中之一none，on-failure或any（默認(rèn):) any。
• delay：重新啟動(dòng)嘗試之間等待的時(shí)間，指定為持續(xù)時(shí)間（默認(rèn)值：0）。
• max_attempts：在放棄之前嘗試重新啟動(dòng)容器的次數(shù)（默認(rèn)值：永不放棄）。如果在配置中未成功重新啟動(dòng) window，則此嘗試不會(huì)計(jì)入配置的max_attempts值。例如，如果max_attempts設(shè)置為“2”，并且第一次嘗試時(shí)重新啟動(dòng)失敗，則可能會(huì)嘗試重新啟動(dòng)兩次以上。
• window：在決定重啟是否成功之前等待多長(zhǎng)時(shí)間，指定為持續(xù)時(shí)間（默認(rèn)值：立即決定）。

rollback_config:配置在更新失敗的情況下應(yīng)如何回滾服務(wù)。

• parallelism：一次回滾的容器數(shù)。如果設(shè)置為0，則所有容器同時(shí)回滾。
• delay：每個(gè)容器組的回滾之間等待的時(shí)間（默認(rèn)為0）。
• failure_action：如果回滾失敗該怎么辦。一個(gè)continue或pause（默認(rèn)pause）
• monitor：每次更新任務(wù)后的持續(xù)時(shí)間以監(jiān)視失敗(ns|us|ms|s|m|h)（默認(rèn)為0）。
• max_failure_ratio：回滾期間容忍的失敗率（默認(rèn)值為0）。
• order：回滾期間的操作順序。其中之一stop-first（舊任務(wù)在啟動(dòng)新任務(wù)之前停止），或者start-first（首先啟動(dòng)新任務(wù)，并且正在運(yùn)行的任務(wù)暫時(shí)重疊）（默認(rèn)stop-first）。

update_config：配置服務(wù)應(yīng)如何更新，用于配置滾動(dòng)更新。

• parallelism：一次更新的容器數(shù)。
• delay：更新一組容器之間的等待時(shí)間。
• failure_action：更新失敗時(shí)的行為。其中一個(gè)continue，rollback或者pause （默認(rèn)：pause）。
• monitor：每次更新任務(wù)后的持續(xù)時(shí)間以監(jiān)視失敗(ns|us|ms|s|m|h)（默認(rèn)為0）。
• max_failure_ratio：更新期間容忍的故障率。
• order：更新期間的操作順序。其中一個(gè)stop-first（舊任務(wù)在啟動(dòng)新任務(wù)之前停止），或者start-first（首先啟動(dòng)新任務(wù)，并且正在運(yùn)行的任務(wù)暫時(shí)重疊）（默認(rèn)stop-first）注意：僅支持v3.4及更高版本。

注意：order僅支持v3.4及更高版本的撰寫(xiě)文件格式。 healthcheck：配置運(yùn)行的檢查以確定此服務(wù)的容器是否“健康”。 示例： 1 healthcheck: 2 test: ["CMD", "curl", "-f", "http://localhost"] 3 interval: 1m30s 4 timeout: 10s 5 retries: 3 6 start_period: 40s 提示：healthcheck可參考：https://docs.docker.com/engine/reference/builder/#healthcheck network_mode：網(wǎng)絡(luò)類(lèi)型，可指定容器運(yùn)行的網(wǎng)絡(luò)類(lèi)型 示例： 1 network_mode: "bridge" 2 network_mode: "host" 3 network_mode: "none" 4 network_mode: "service:[service name]" 5 network_mode: "container:[container name/id]" dns：自定義dns服務(wù) 1 dns: 8.8.8.8 2 dns: 3 - 8.8.8.8 4 - 9.9.9.9

2.3 networks區(qū)域

網(wǎng)絡(luò)決定了服務(wù)之間以及服務(wù)和外界之間如何去通信，在執(zhí)行docker-compose up的時(shí)候，docker會(huì)默認(rèn)創(chuàng)建一個(gè)默認(rèn)網(wǎng)絡(luò)，創(chuàng)建的服務(wù)也會(huì)默認(rèn)的使用這個(gè)默認(rèn)網(wǎng)絡(luò)。服務(wù)和服務(wù)之間，可以使用服務(wù)的名字進(jìn)行通信，也可以自己創(chuàng)建網(wǎng)絡(luò)，并將服務(wù)加入到這個(gè)網(wǎng)絡(luò)之中，這樣服務(wù)之間可以相互通信，而外界不能夠與這個(gè)網(wǎng)絡(luò)中的服務(wù)通信，可以保持隔離性。 提示：注意：您的應(yīng)用程序網(wǎng)絡(luò)的名稱(chēng)基于“項(xiàng)目名稱(chēng)”，該名稱(chēng)基于其所在目錄的名稱(chēng)。您可以使用--project-name參數(shù)或COMPOSE_PROJECT_NAME環(huán)境變量覆蓋項(xiàng)目名稱(chēng),如當(dāng)前的目錄為myapp，期docker-compose.yml如下： 1 version: "3" 2 services: 3 web: 4 build: . 5 ports: 6 - "8000:8000" 7 db: 8 image: postgres 9 ports: 10 - "8001:5432" 運(yùn)行時(shí)docker-compose up，則：

創(chuàng)建了一個(gè)名為myapp_default的網(wǎng)絡(luò)。

使用web配置創(chuàng)建容器，在web下加入myapp_default網(wǎng)絡(luò)。

使用db配置創(chuàng)建容器，在db下加入myapp_default網(wǎng)絡(luò)。

示例： 1 version: '2' 2 3 services: 4 app: 5 image: busybox 6 command: ifconfig 7 networks: 8 app_net: 9 ipv4_address: 172.16.238.10 10 11 networks: 12 app_net: 13 driver: bridge 14 enable_ipv6: true 15 ipam: 16 driver: default 17 config: 18 - subnet: 172.16.238.0/24 19 gateway: 172.168.238.254

2.4 volumes區(qū)域

可以在Compose file文件上聲明卷，同時(shí)也可以在本區(qū)域創(chuàng)建volumes_from，以便在多個(gè)服務(wù)中重用卷。 示例： 1 version: "3" 2 services: 3 db: 4 image: db 5 volumes: 6 - data-volume:/var/lib/db 7 backup: 8 image: backup-service 9 volumes: 10 - data-volume:/var/lib/backup/data 11 volumes: 12 data-volume: 提示：volumes可參考：https://docs.docker.com/compose/compose-file/#specifying-byte-values

轉(zhuǎn)載于:https://www.cnblogs.com/itzgr/p/10041249.html

總結(jié)

以上是生活随笔為你收集整理的附005.Docker Compose文件详解的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問(wèn)題。

如果覺(jué)得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。