Docker Compose文件詳解 V2

Compose file reference

語法：

web:

     build: ./web

     ports:

     - "5000:5000"

     volumes:

     - .:/code

     links:

     - redis

redis:

     image:redis

build：可以使用相對目錄或絕對目錄

ports：可以使用端口範圍

links：可以使用別名，例如： -redis:web-redis

build

build: ./dir

# build後可直接接Dockerfile所在目錄，該目錄必須存在Dockerfile

build:

  context: ./dir

  dockerfile: Dockerfile-alternate

  args:

    buildno: 1

image: webapp:tag

# contest指定Dockerfile的目錄。dockerfile指定Dockerfile文件名

# args:不清楚

# images：指定dockerfile構建出的鏡像名，默認使用docker-compose.yml所在的文件夾名+service名

context

build:

  context: ./dir

#指定Dockerfile所在的目錄

dockerfile

build:

  context: .

  dockerfile: Dockerfile-alternate

build: .

dockerfile: Dockerfile-alternate

# 當Dockerfile文件名不是默認名稱時，使用dockerfile參數指定Dockerfile的文件名

args

cap_add, cap_drop

Add or drop container capabilities. See man 7 capabilities for a full list.

cap_add:

  - ALL

cap_drop:

  - NET_ADMIN

  - SYS_ADMIN

command

覆蓋Dockerfile中的command

command: bundle exec thin -p 3000

# 相似於dockerfile中的命令：

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

container_name

 指定容器的名稱

container_name: my-web-container

depends_on

表示服務以前的依賴關係，有兩個效果：

• docker-compose up，啓動web服務以前、啓動redis、db。
• docker-compose up web，啓動web容器時，檢查依賴depends_on的配置內容，先啓動db和redis

'2'

services: 

build: .

    depends_on:

       - db

      - redis

  redis:   

     image: redis

 db:   

    image: postgres

dns

自定義DNS，能夠是單個的，也能夠是列表.

dns: 8.8.8.8

dns:

  - 8.8.8.8
  - 9.9.9.9

dns_search

Custom DNS search domains. Can be a single value or a list.

dns_search: example.com

dns_search:

  - dc1.example.com
  - dc2.example.com

tmpfs

在容器中掛載一個tmpfs。

# tmpfs能夠理解成虛擬機磁盤，是建立在內存上，不是在硬盤上。讀取速度快，重啓後數據消失

run

tmpfs:
  - /run
  - /tmp

entrypoint

覆蓋默認的entrypoint.

entrypoint: /code/entrypoint.sh

能夠是個列表，相似dockerfile中的語法

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

指定變量的文件，默認爲docker-compose文件夾下的 .env 文件.

同一個變量，經過export設置，會覆蓋env_file中的變量.

env_file: .env

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

env

environment

設置環境變量，支持數組和字典.

environment:

  RACK_ENV: development

'true'

  SESSION_SECRET:




environment:

  - RACK_ENV=development

 - SHOW=true

 - SESSION_SECRET

expose

暴漏端口，並不會暴漏到宿主機上，而是提供給內部容器通訊.

expose:
 - "3000"
 - "8000"

extends、

external_links

待補充

extra_hosts

添加主機映射. Use the same values as the docker client  --add-host parameter.

extra_hosts:
 - "somehost:162.242.195.82"

- "otherhost:50.31.209.229"

映射結果會體如今  /etc/hosts :

162.242.195.82  somehost
50.31.209.229   otherhost

image

指定基礎鏡像. 能夠是鏡像名稱、鏡像ID。

version1中不容許build和image同時出現，version2中容許，image表明指定build以後的鏡像名稱。

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

labels

指定容器的標籤.

labels:
  com.example.description: "Accounting webapp"
  com.example.department: "Finance"
  com.example.label-with-empty-value: ""

labels:
  - "com.example.description=Accounting webapp"
  - "com.example.department=Finance"
  - "com.example.label-with-empty-value"

links

鏈接其餘容器，能夠設置別名，設置link以後，hostname與IP的對應關係會寫入到 /etc/hosts中. 和depend_on相似，設置link後，也間接的規定了容器的啓動順序.

web:

  links:

  - db

 - redis

logging

設置容器的日誌驅動.version 2 經過logging替換log_driver和log_opt

 options:

   syslog-address: "tcp://192.168.0.42:123"

net

Version 1 file format only. In version 2, use  network_mode.

爲容器指定網絡類型，version 1專用，version 2使用network_mode.

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

network_mode

Version 2 file format only. In version 1, use  net.

爲容器指定網絡類型.

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

networks

Version 2 file format only. In version 1, use net.

Networks to join, referencing entries under the  top-level networks key.

services:

  some-service:

    networks:

     - some-network

     - other-network

aliases

待補充

ipv4_address, ipv6_address

指定容器的IP地址等，用法待補充，未操做

pid

經過設置，容器可經過ps查詢宿主機的進程.

pid: "host"

ports

暴漏容器的端口，可設置爲8080:8080 或 :8080（宿主機端口隨機).

Note:建議使用引號

ports:
 - "3000"
 - "3000-3005"
 - "8000:8000"
 - "9090-9091:8080-8081"
 - "49100:22"
 - "127.0.0.1:8001:8001"
 - "127.0.0.1:5000-5010:5000-5010"

stop_signal

待補充

ulimits

設置ulimit值，可替換掉docker或dockerfile默認的值.

ulimits:

  nproc: 65535

  nofile:

    soft: 20000

    hard: 40000

volumes, volume_driver

掛載卷，若是不指定宿主機目錄，會在volume默認目錄建立掛載點。可單獨掛載文件、可設置目錄權限.  。

volumes:
  # Just specify a path and let the Engine create a volume
  - /var/lib/mysql

  # Specify an absolute path mapping
  - /opt/data:/var/lib/mysql

  # Path on the host, relative to the Compose file
  - ./cache:/tmp/cache

  # User-relative path
  - ~/configs:/etc/configs/:ro

  # Named volume

var/lib/mysql    # datavolume是經過docker volume create --name datavolume建立

若是不使用宿主機存儲，須臾奧指定 volume_driver.例如rancher的convoy fs。

volume_driver: mydriver

volumes_from

從其餘服務或容器掛載全部的volume, 可設置制度訪問 ( ro)或讀寫 ( rw). 若是不設置，默認爲讀寫模式。

volumes_from:

 - service_name

 - service_name:ro

 - container:container_name

 - container:container_name:rw

Note: The Container:... formats are only supported in the version 2 file format. In version 1, you can use container names without marking them as such:

- service_name
- service_name:ro
- container_name
- container_name:rw

cpu_shares, cpu_quota, cpuset, domainname, hostname, ipc, mac_address, mem_limit, memswap_limit, privileged, read_only, restart, shm_size, stdin_open, tty, user, working_dir

單獨的值，相似於docker run的參數.

cpu_shares: 73

cpu_quota: 50000

cpuset: 0,1

user: postgresql

working_dir: /code

domainname: foo.com

hostname: foo

ipc: host

mac_address: 02:42:ac:11:65:43

mem_limit: 1000000000

memswap_limit: 2000000000

privileged: true

restart: always

read_only: true

shm_size: 64M

stdin_open: true

tty: true

Volume configuration reference

driver

設置volume的驅動，默認是local.

 driver: foobar

driver_opts

設置驅動的參數，不一樣的驅動所須要的參數不一樣.可選.

 driver_opts:

   foo: "bar"

   baz: 1

external

若是設置爲true，指定volume在compose的外部，docker-compose up 時不去建立該volume。若是不存在報錯.

version: '2'

services:

  db:

    image: postgres

    volumes:

      - data:/var/lib/postgresql/data

volumes:

  data:

    external: true

You can also specify the name of the volume separately from the name used to refer to it within the Compose file:

volumes:

  data:

    external:

      name: actual-name-of-volume

A more extended example, defining volumes and networks:

version: '2'

services:

  web:

    build: .

    ports:

     - "5000:5000"

    volumes:

     - .:/code

    networks:

      - front-tier

      - back-tier

  redis:

    image: redis

    volumes:

      - redis-data:/var/lib/redis

    networks:

      - back-tier

volumes:

  redis-data:

    driver: local

networks:

  front-tier:

    driver: bridge

  back-tier:

    driver: bridge

或

version: '2'

services:

  db:

    image: postgres

    volumes:

      - data:/var/lib/postgresql/data

volumes:

  data: {}