Docker之compose

阿新 • • 發佈：2021-06-24

Compose 是用於定義和執行多容器 Docker 應用程式的工具，通過 Compose 可以使用 YML 檔案來配置應用程式需要的所有服務，然後使用一個命令就可以從 YML 檔案配置中建立並啟動所有服務。

Compose 使用的步驟：

使用 Dockerfile 定義應用程式的環境
使用 docker-compose.yml 定義構成應用程式的服務，這樣它們可以在隔離環境中一起執行
執行 docker-compose up 命令來啟動並執行整個應用程式

yml配置指令

version

指定本 yml 依從的 compose 哪個版本制定的

build

指定為構建映象上下文路徑：

例如 webapp 服務，指定為從上下文路徑 ./dir/Dockerfile 所構建的映象：

version: "3.7"
services:
  webapp:
    build: ./dir

或者作為具有在上下文指定的路徑的物件，以及可選的 Dockerfile 和 args：

version: "3.7"
services:
  webapp:
    build:
      context: ./dir
      dockerfile: Dockerfile-alternate
      args:
        buildno: 1
      labels:
        - "com.example.description=Accounting webapp"
        - "com.example.department=Finance"
        - "com.example.label-with-empty-value"
      target: prod

context：上下文路徑
dockerfile：指定構建映象的 Dockerfile 檔名
args：新增構建引數，這是隻能在構建過程中訪問的環境變數
labels：設定構建映象的標籤
target：多層構建，可以指定構建哪一層

cap_add、cap_drop

新增或刪除容器擁有的宿主機的核心功能

cap_add:
  - ALL # 開啟全部許可權

cap_drop:
  - SYS_PTRACE # 關閉 ptrace許可權

cgroup_parent

為容器指定父 cgroup 組，意味著將繼承該組的資源限制

cgroup_parent: m-executor-abcd

command

覆蓋容器啟動的預設命令

command: ["bundle", "exec", "thin", "-p", "3000"]

container_name

指定自定義容器名稱，而不是生成的預設名稱

container_name: my-web-container

depends_on

設定依賴關係，以依賴性順序啟動服務

version: "3.7"
services:
  web:
    build: .
    depends_on:
      - db
      - redis
  redis:
    image: redis
  db:
    image: postgres

先啟動 db 和 redis ，然後才啟動 web

devices

指定裝置對映列表

devices:
  - "/dev/ttyUSB0:/dev/ttyUSB0"

自定義 DNS 伺服器，可以是單個值或列表的多個值

dns: 8.8.8.8

dns:
  - 8.8.8.8
  - 9.9.9.9

dns_search

自定義 DNS 搜尋域。可以是單個值或列表

dns_search: example.com

dns_search:
  - dc1.example.com
  - dc2.example.com

entrypoint

覆蓋容器預設的 entrypoint

entrypoint: /code/entrypoint.sh

或者是以下格式：

entrypoint:
    - php
    - -d
    - zend_extension=/usr/local/lib/php/extensions/no-debug-non-zts-20100525/xdebug.so
    - -d
    - memory_limit=-1
    - vendor/bin/phpunit

env_file

從檔案新增環境變數。可以是單個值或列表的多個值

env_file: .env

或者是以下格式：

env_file:
  - ./common.env
  - ./apps/web.env
  - /opt/secrets.env

environment

新增環境變數。可以使用陣列或字典、任何布林值，布林值需要用引號引起來，以確保 YML 解析器不會將其轉換為 True 或 False。

environment:
  RACK_ENV: development
  SHOW: 'true'

expose

暴露埠，但不對映到宿主機，只被連線的服務訪問，僅可以指定內部埠為引數

expose:
 - "3000"
 - "8000"

extra_hosts

新增主機名對映。類似 docker client --add-host

extra_hosts:
 - "somehost:162.242.195.82"
 - "otherhost:50.31.209.229"

以上會在此服務的內部容器中 /etc/hosts 建立一個具有 ip 地址和主機名的對映關係：

162.242.195.82  somehost
50.31.209.229   otherhost

image

指定容器執行的映象。以下格式都可以：

image: redis
image: ubuntu:14.04
image: tutum/influxdb
image: example-registry.com:4000/postgresql
image: a4bc65fd # 映象id

logging

服務的日誌記錄配置。

driver：指定服務容器的日誌記錄驅動程式，預設值為json-file。有以下三個選項：

driver: "json-file"
driver: "syslog"
driver: "none"

僅在 json-file 驅動程式下，可以使用以下引數，限制日誌得數量和大小：

logging:
  driver: json-file
  options:
    max-size: "200k" # 單個檔案大小為200k
    max-file: "10" # 最多10個檔案

當達到檔案限制上限，會自動刪除舊得檔案

syslog 驅動程式下，可以使用 syslog-address 指定日誌接收地址：

logging:
  driver: syslog
  options:
    syslog-address: "tcp://192.168.0.42:123"

network_mode

設定網路模式

network_mode: "bridge"
network_mode: "host"
network_mode: "none"
network_mode: "service:[service name]"
network_mode: "container:[container name/id]"

volumes

將宿主機的資料卷或檔案掛載到容器裡

version: "3.7"
services:
  db:
    image: postgres:latest
    volumes:
      - "/localhost/postgres.sock:/var/run/postgres/postgres.sock"
      - "/localhost/data:/var/lib/postgresql/data"