docker-compose v3版本命令详解参考

时间 2019-11-11

标签 docker compose v3 版本命令详解参考栏目 Docker 繁體版

原文原文链接

参考和指南

这些主题描述了Compose文件格式的第3版。这是最新的版本.php

Compose and Docker 兼容性矩阵

有几个版本的Compose文件格式 - 1，2，2.x和3.x.下表是快速浏览。有关每一个版本包含和如何升级的详细信息，请参阅关于版本和升级.前端

Compose 文件结构和示例

version: "3"
services:

  redis:
    image: redis:alpine
    ports:
      - "6379"
    networks:
      - frontend
    deploy:
      replicas: 2
      update_config:
        parallelism: 2
        delay: 10s
      restart_policy:
        condition: on-failure

  db:
    image: postgres:9.4
    volumes:
      - db-data:/var/lib/postgresql/data
    networks:
      - backend
    deploy:
      placement:
        constraints: [node.role == manager]

  vote:
    image: dockersamples/examplevotingapp_vote:before
    ports:
      - 5000:80
    networks:
      - frontend
    depends_on:
      - redis
    deploy:
      replicas: 2
      update_config:
        parallelism: 2
      restart_policy:
        condition: on-failure

  result:
    image: dockersamples/examplevotingapp_result:before
    ports:
      - 5001:80
    networks:
      - backend
    depends_on:
      - db
    deploy:
      replicas: 1
      update_config:
        parallelism: 2
        delay: 10s
      restart_policy:
        condition: on-failure

  worker:
    image: dockersamples/examplevotingapp_worker
    networks:
      - frontend
      - backend
    deploy:
      mode: replicated
      replicas: 1
      labels: [APP=VOTING]
      restart_policy:
        condition: on-failure
        delay: 10s
        max_attempts: 3
        window: 120s
      placement:
        constraints: [node.role == manager]

  visualizer:
    image: dockersamples/visualizer:stable
    ports:
      - "8080:8080"
    stop_grace_period: 1m30s
    volumes:
      - "/var/run/docker.sock:/var/run/docker.sock"
    deploy:
      placement:
        constraints: [node.role == manager]

networks:
  frontend:
  backend:

volumes:
  db-data:

此参考页面上的主题按顶级按键按字母顺序组织，以反映撰写文件自己的结构。定义配置文件中的一部分，如顶级键build，deploy，depends_on， networks，等等，都与全部支持他们的子课题的选项中列出。这将映射到 : node

一个好的开始是入门教程，它使用版本3编写堆栈文件来实现多容器应用程序，服务定义和群组模式。如下是本教程中使用的一些撰写文件。，mysql

另外一个很好的参考是在
Docker for Beginners实验室
主题将应用程序部署到Swarm. 上的投票应用程序示例的compose文件。这也在本节顶部上展现。github

服务配置参考

Compose文件是一个定义
服务,
网络和
卷的YAML 文件.
Compose文件的默认路径是 ./docker-compose.yml.web

提示：您能够对此文件使用.yml或.yaml扩展名。他们都工做.redis

服务定义包含将应用于为该服务启动的每一个容器的配置，就像传递命令行参数同样 docker run。一样，网络和卷的定义相似于 docker network create和docker volume create。sql

正如docker run在Dockerfile指定选项（例如，CMD， EXPOSE，VOLUME，ENV）是默认的尊重-你不须要再次指定它们docker-compose.yml。

您可使用相似Bash的${VARIABLE}语法在配置值中使用环境变量 - 有关详细信息，请参阅
变量替换 for full details.

本节包含版本3中服务定义支持的全部配置选项的列表。

build

build 能够指定为包含构建上下文的路径的字符串：

version: '2'
services:
  webapp:
    build: ./dir

或者，做为一个对象，具备上下文和可选的Dockerfile 和 args下指定的路径:

version: '2'
services:
  webapp:
    build:
      context: ./dir
      dockerfile: Dockerfile-alternate
      args:
        buildno: 1

若是指定image以及build，而后撰写的名称与内置的图像webapp和可选的tag规定image：

build: ./dir
image: webapp:tag

这将致使命名的镜像webapp和标签tag，从建成./dir。

注意：在使用（版本3）Compose文件以群组模式部署堆栈
时，将忽略此选项。该docker stack命令仅接受预建图像。

上下文

到包含Dockerfile的目录的路径，或者是git仓库的URL。

当提供的值是相对路径时，它被解释为相对于撰写文件的位置。该目录也是发送到Docker守护程序的构建上下文。

Compose将使用生成的名称构建并标记它，而后使用该映像。

build:
  context: ./dir

Dockerfile

备用Docker文件。

Compose将使用备用文件来构建。还必须指定构建路径。

build:
  context: .
  dockerfile: Dockerfile-alternate

Args

添加构建参数，环境变量只能在构建过程当中访问。

首先，在Dockerfile中指定参数：

ARG buildno
ARG password

RUN echo "Build number: $buildno"
RUN script-requiring-password.sh "$password"

而后在build密钥下指定参数。您能够传递映射或列表：

build:
  context: .
  args:
    buildno: 1
    password: secret

build:
  context: .
  args:
    - buildno=1
    - password=secret

您能够在指定构建参数时省略该值，在这种状况下，构建时的值是运行Compose的环境中的值。

args:
  - buildno
  - password

注：YAML布尔值（true，false，yes，no，on，off）必须用引号括起来，这样分析器会将它们解释为字符串。

cache_from

注意：此选项在v3.2中是新增功能

引擎将用于缓存解析的图像列表。

build:
  context: .
  cache_from:
    - alpine:latest
    - corp/web_app:3.14

labels

注意：此选项在v3.3中是新增的

使用 Docker labels
将元数据添加到生成的图像。您可使用数组或字典。

建议您使用反向DNS符号来防止标签与其余软件使用的标签相冲突。

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


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

cap_add, cap_drop

添加或删除容器功能。查看man 7 capabilities完整列表。

cap_add:
  - ALL

cap_drop:
  - NET_ADMIN
  - SYS_ADMIN

注意：在使用（版本3）Compose文件以群组模式部署堆栈
时，将忽略这些选项。

command

覆盖默认命令。

command: bundle exec thin -p 3000

该命令也能够是一个列表，相似于
dockerfile:

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

configs

使用每一个服务configs 配置在每一个服务的基础上授予对配置的访问权限。支持两种不一样的语法变体。

注意：该配置必须已经存在或在configs 该堆栈文件的顶级配置
中定义，不然堆栈部署将失败

Short syntax

短语法变体只指定配置名称。这容许容器访问该配置并将其安装在/<config_name> 容器内。源名称和目标安装点都设置为配置名称。

如下示例使用简短的语法来授予redis对my_config和my_other_config配置的服务访问权限。将值 my_config设置为文件的内容./my_config.txt，并将 my_other_config其定义为外部资源，这意味着它已经在Docker中定义，不管是经过运行docker config create 命令仍是经过其余堆栈部署。若是外部配置不存在，则堆栈部署失败并出现config not found错误。

注意：config定义仅在版本3.3及更高版本的组合文件格式中受支持。

version: "3.3"
services:
  redis:
    image: redis:latest
    deploy:
      replicas: 1
    configs:
      - my_config
      - my_other_config
configs:
  my_config:
    file: ./my_config.txt
  my_other_config:
    external: true

Long syntax

长语法在服务的任务容器中如何建立配置提供了更多的粒度。

source：Docker中存在的配置名称。
target：将要装入服务任务容器的文件的路径和名称。默认为/<source>未指定。
uid和gid：数字UID或GID，它将拥有服务的任务容器中的挂载配置文件。0若是没有指定，则默认为Linux。Windows不支持
mode：将在服务的任务容器中装载的文件的权限，以八进制符号表示。例如，0444 表明世界可读。默认是0444。配置不能被写入，由于它们被安装在临时文件系统中，因此若是设置可写位，则忽略它。可执行位能够设置。若是您不熟悉UNIX文件权限模式，您可能会发现此
权限计算器颇有用.

下面的示例设置的名称my_config，以redis_config在容器内，将模式设定为0440（组可读），而且将所述用户和组103。该redis服务没法访问该my_other_config 配置。

version: "3.3"
services:
  redis:
    image: redis:latest
    deploy:
      replicas: 1
    configs:
      - source: my_config
        target: /redis_config
        uid: '103'
        gid: '103'
        mode: 0440
configs:
  my_config:
    file: ./my_config.txt
  my_other_config:
    external: true

您能够授予对多个配置的服务访问权限，您能够混合长短语法。定义配置并不意味着授予对其的访问权限。

cgroup_parent

为容器指定一个可选的父cgroup。

cgroup_parent: m-executor-abcd

注意：在使用（版本3）Compose文件以群组模式部署堆栈
时，将忽略此选项。

container_name

指定自定义容器名称，而不是生成的默认名称。

container_name: my-web-container

由于Docker容器名称必须是惟一的，若是您指定了自定义名称，则没法将服务扩展到超过1个容器。尝试这样作会致使错误。

注意：在使用（版本3）Compose文件以群组模式部署堆栈
时，将忽略此选项。

credential_spec

注意：此选项已在v3.3中添加

配置托管服务账户的凭据规范。此选项仅用于使用Windows容器的服务。在credential_spec必须在格式file://<filename>或registry://<value-name>。

在使用时file:，引用的文件必须存在于CredentialSpecs docker数据目录的子目录中，这C:\ProgramData\Docker\ 在Windows上是默认的。如下示例从名为C:\ProgramData\Docker\CredentialSpecs\my-credential-spec.json如下文件的文件加载凭据规范：

credential_spec:
  file: my-credential-spec.json

使用时registry:，凭据规范从守护程序主机上的Windows注册表中读取。具备给定名称的注册表值必须位于：

HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Virtualization\Containers\CredentialSpecs

如下示例从my-credential-spec 注册表中指定的值加载凭据规范：

credential_spec:
  registry: my-credential-spec

deploy

仅限版本3

指定与部署和运行相关的配置。这只能部署到时生效 swarm 与
docker stack deploy,而且被忽略docker-compose up和docker-compose run。

version: '3'
services:
  redis:
    image: redis:alpine
    deploy:
      replicas: 6
      update_config:
        parallelism: 2
        delay: 10s
      restart_policy:
        condition: on-failure

有几个子选项可用：

endpoint_mode

为链接到群组的外部客户端指定服务发现方法。

版本3.3 .

endpoint_mode: vip - Docker为服务分配虚拟IP（VIP），做为客户端到达网络服务的“前端”。Docker在服务的客户端和可用的工做者节点之间路由请求，而无需客户端了解有多少个节点参与服务或其IP地址或端口。（这是默认值。）
endpoint_mode: dnsrr - DNS循环（DNSRR）服务发现不使用单个虚拟IP。Docker为服务设置DNS条目，以便服务名称的DNS查询返回IP地址列表，客户端直接链接到其中一个。若是要使用本身的负载均衡器，或混合Windows和Linux应用程序，则DNS循环是很是有用的。

version: "3.3"

services:
  wordpress:
    image: wordpress
    ports:
      - 8080:80
    networks:
      - overlay
    deploy:
      mode: replicated
      replicas: 2
      endpoint_mode: vip

  mysql:
    image: mysql
    volumes:
       - db-data:/var/lib/mysql/data
    networks:
       - overlay
    deploy:
      mode: replicated
      replicas: 2
      endpoint_mode: dnsrr

volumes:
  db-data:

networks:
  overlay:

endpoint_mode在swarm模式CLI命令
docker service create也可用做标志的选项。有关全部群集相关docker命令的快速列表，请参阅Swarm模式CLI命令.

labels

指定服务的标签。这些标签只能在服务上设置，而不能在服务的任何容器上设置。

version: "3"
services:
  web:
    image: web
    deploy:
      labels:
        com.example.description: "This label will appear on the web service"

要在容器上设置标签，请使用如下labels键deploy：

version: "3"
services:
  web:
    image: web
    labels:
      com.example.description: "This label will appear on all containers for the web service"

mode

任一global（正好一个每群节点容器）或replicated（一个指定的数量的容器）。默认是replicated。

version: '3'
services:
  worker:
    image: dockersamples/examplevotingapp_worker
    deploy:
      mode: global

placement

指定布局约束

version: '3'
services:
  db:
    image: postgres
    deploy:
      placement:
        constraints:
          - node.role == manager
          - engine.labels.operatingsystem == ubuntu 14.04

replicas

若是服务是replicated（默认为），请指定在任何给定时间应运行的容器数。

version: '3'
services:
  worker:
    image: dockersamples/examplevotingapp_worker
    networks:
      - frontend
      - backend
    deploy:
      mode: replicated
      replicas: 6

resources

配置资源约束。

注意：这取代了旧的资源约束选项在撰写非群模式文件以前版本3（ cpu_shares，cpu_quota，cpuset， mem_limit，memswap_limit，mem_swappiness如在升级版本2.x到3.x.

这些都是一个单一的值，相似于docker service
create 对应的.

在这个通用示例中，redis服务被限制为使用不超过50M的内存和0.001（0.1％）的可用处理时间（CPU），而且具备保留20M的内存和0.0001CPU时间（一直可用）。

version: '3'
services:
  redis:
    image: redis:alpine
    deploy:
      resources:
        limits:
          cpus: '0.001'
          memory: 50M
        reservations:
          cpus: '0.0001'
          memory: 20M

下面的主题描述了为群集中的服务或容器设置资源约束的可用选项。

内存异常 (OOME)

若是您的服务或容器尝试使用比系统可用的更多内存，则可能会遇到内存异常（OOME），而且容器或Docker守护程序可能被内核OOM杀手杀死。为了防止这种状况发生，请确保您的应用程序在具备足够内存的主机上运行，而且了解内存不足的风险。

restart_policy

配置在退出时是否以及如何从新启动容器。替换restart.

condition: 其中之一none，on-failure或any（默认：）any。
delay:在从新启动尝试之间等待多长时间，指定为 持续时间（默认值：0）。
max_attempts: 在放弃以前尝试从新启动一个容器多少次（默认：永不放弃）.
window: 在决定从新启动成功以前等待多长时间，指定为持续时间（默认：当即决定）.

version: "3"
services:
  redis:
    image: redis:alpine
    deploy:
      restart_policy:
        condition: on-failure
        delay: 5s
        max_attempts: 3
        window: 120s

update_config

配置服务如何更新。用于配置滚动更新。

parallelism:一次更新的容器数量。
delay:更新一组容器之间等待的时间。
failure_action: 若是更新失败，该怎么办？其中之一continue，rollback或pause （默认：）pause。
monitor: 每一个任务更新后的持续时间来监视失败 (ns|us|ms|s|m|h)（默认为0）。
max_failure_ratio:更新期间容忍的故障率。
order: 更新期间的操做顺序。其中一个stop-first（旧任务，开始新的一个前中止），或者start-first（新的任务首先启动，而且正在运行的任务将简要重叠）（默认stop-first）注：仅支持V3.4及更高版本。

注意：order仅支持v3.4及更高版本的撰写文件格式。

version: '3.4'
services:
  vote:
    image: dockersamples/examplevotingapp_vote:before
    depends_on:
      - redis
    deploy:
      replicas: 2
      update_config:
        parallelism: 2
        delay: 10s
        order: stop-first

不支持 `docker stack deploy`

下面的子选项（支持docker compose up和docker compose run）是不支持的docker stack deploy或deploy键的。

devices

设备映射列表使用与--devicedocker客户端建立选项相同的格式。

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

注意：在使用（版本3）Compose文件以群组模式部署堆栈
时，将忽略此选项。

depends_on

服务之间的快速依赖，有两个做用：

docker-compose up 将依依次顺序启动服务。在下面的例子中，db并redis会开始以前web。
docker-compose up SERVICE 将自动包含SERVICE的依赖关系。在下面的例子中，docker-compose up web也将建立和启动db和redis。

简单的例子:

version: '3'
services:
  web:
    build: .
    depends_on:
      - db
      - redis
  redis:
    image: redis
  db:
    image: postgres

使用时须要注意几件事情 depends_on:

depends_on 在开始以前不会等待db而且redis“准备好”，web直到它们被启动为止

版本3再也不支持的condition形式depends_on

depends_on 使用（版本3）Compose文件以群组模式部署堆栈
时，将忽略此选项。

DNS

自定义DNS服务器。能够是单个值或列表。

dns: 8.8.8.8
dns:
  - 8.8.8.8
  - 9.9.9.9

注意:使用（版本3）Compose文件以群组模式部署堆栈
时，将忽略此选项。

dns_search

自定义DNS搜索域。能够是单个值或列表。

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

注意:使用（版本3）Compose文件以群组模式部署堆栈
时，将忽略此选项。

tmpfs

版本2文件格式 and up.

在容器内安装临时文件系统。能够是单个值或列表。

tmpfs: /run
tmpfs:
  - /run
  - /tmp

注意:使用（版本3）Compose文件以群组模式部署堆栈
时，将忽略此选项。

entrypoint

覆盖默认入口点。

entrypoint: /code/entrypoint.sh

entrypoint也能够是一个列表，相似于
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

注意：设置entrypoint将使用ENTRYPOINTDockerfile指令覆盖服务映像上的任何默认入口点集，并清除映像上的任何默认命令 - 这意味着如果CMD Dockerfile中有指令，则将忽略它。

env_file

从文件添加环境变量。能够是单个值或列表。

若是您指定了一个Compose文件docker-compose -f FILE，则路径 env_file相对于该文件所在的目录。

环境变量部分中声明的环境变量将覆盖这些值 - 即便这些值为空或未定义，这也将成立。

env_file: .env

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

Compose指望env文件中的每一行都是VAR=VAL格式化的。以#（即注释）开始的行将被忽略，空白行也将被忽略。

# Set Rails/Rack environment
RACK_ENV=development

注意：若是您的服务指定构建选项，则在构建期间将不会自动显示在环境文件中定义的变量。使用args子选项build定义构建时环境变量。

该值VAL是按原样使用的，彻底没有修改。例如，若是值被引号包围（一般是shell变量的状况），引号将包含在传递给Compose的值中。

请记住，在肯定分配给显示屡次的变量的值时，列表中文件的顺序很重要。列表中的文件从上到下处理。对于在文件中指定的相同变量，a.env并在文件中分配了不一样的值b.env，若是b.env在下面列出（以后），则来自b.envstand 的值。例如，给出如下声明docker_compose.yml：

services:
  some-service:
    env_file:
      - a.env
      - b.env

和如下文件：

# a.env
VAR=1

和

# b.env
VAR=hello

$ VAR将会hello

environment

添加环境变量。您可使用数组或字典。任何布尔值; true，false，yes no，须要用引号括起来，以确保它们不被YML解析器转换为True或False。

仅具备密钥的环境变量将被解析为其正在运行的机器上的值，这对于秘密或主机特定值有帮助。

environment:
  RACK_ENV: development
  SHOW: 'true'
  SESSION_SECRET:

environment:
  - RACK_ENV=development
  - SHOW=true
  - SESSION_SECRET

注意：若是您的服务指定构建选项，environment则在构建期间不会自动显示定义的变量。使用args子选项build定义构建时环境变量。

expose

暴露端口而不将它们发布到主机 - 它们只能被连接服务访问。只能指定内部端口。

expose:
 - "3000"
 - "8000"

external_links

链接到组合以外docker-compose.yml或甚至外部的容器，尤为是提供共享或公共服务的容器。在指定容器名称和连接别名（）时，external_links遵循与legacy选项类似的语义。linksCONTAINER:ALIAS

external_links:
 - redis_1
 - project_db_1:mysql
 - project_db_1:postgresql

注意：
若是您使用的是版本2或以上的文件格式，外部建立的容器必须链接至至少一个与要连接的服务相同的网络。连接是遗留选项。咱们建议使用网络。
使用（版本3）Compose文件在群集模式下部署堆栈时，将忽略此选项。

extra_hosts

添加主机名映射。使用与docker客户端--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

healthcheck

配置运行的支票以肯定此服务的容器是否“健康”。

healthcheck:
  test: ["CMD", "curl", "-f", "http://localhost"]
  interval: 1m30s
  timeout: 10s
  retries: 3

interval并被timeout指定为持续时间。

test必须是字符串或列表。若是它是一个列表，第一项必须是NONE，CMD或CMD-SHELL。若是它是一个字符串，则至关于指定CMD-SHELL该字符串。

# Hit the local web app
test: ["CMD", "curl", "-f", "http://localhost"]

# As above, but wrapped in /bin/sh. Both forms below are equivalent.
test: ["CMD-SHELL", "curl -f http://localhost || exit 1"]
test: curl -f https://localhost || exit 1

要禁用图像设置的任何默认的健康检查，可使用disable: true。这至关于指定test: ["NONE"]。

healthcheck:
  disable: true

image

指定要从中启动容器的图像。能够是存储库/标签或部分映像ID。

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

若是图像不存在，Compose尝试拉它，除非您也指定了构建，在这种状况下，它使用指定的选项构建它，并使用指定的标签进行标记。

isolation

指定容器的隔离技术。在Linux上，惟一支持的值是default。在Windows中，可接受的值是default，process和 hyperv。有关详细信息，请参阅
Docker Engine docs
.

labels

使用Docker标签将元数据添加到容器。您可使用数组或字典。

建议您使用反向DNS符号来防止标签与其余软件使用的标签相冲突。

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

连接到另外一个服务中的容器。指定服务名称和连接别名（SERVICE:ALIAS）或仅指定服务名称。

web:
  links:
   - db
   - db:database
   - redis

连接服务的容器将以与别名相同的主机名或者未指定别名的服务名称可访问。

连接不须要启用服务进行通讯 - 默认状况下，任何服务均可以达到该服务名称的任何其余服务。

连接还以与depends_on相同的方式表示服务之间的依赖关系，所以它们肯定服务启动的顺序。

Notes

若是您定义了连接和网络，那么它们之间连接的服务必须至少共享一个网络以进行通讯。

使用（版本3）Compose文件在群集模式下部署堆栈时，将忽略此选项

logging

记录该服务的配置。

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

该driver 名称指定服务的容器的日志记录驱动程序，以及--log-driverdocker运行的选项（在此记录）。

默认值为json-file。

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

Note: 只有json-file和journald驱动程序能够直接从docker-compose up和docker-compose logs。使用任何其余驱动程序不会打印任何日志。

使用options键指定记录驱动程序的日志记录选项，与--log-opt选项同样docker run。

记录选项是键值对。syslog选项示例：

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

默认驱动程序json-file具备限制存储的日志数量的选项。为此，请使用键值对来获取最大存储大小和最大文件数：

options:
  max-size: "200k"
  max-file: "10"

上面显示的示例将存储日志文件，直到它们达到max-size200kB，而后旋转它们。存储的各个日志文件的数量由max-file值指定。当日志超出最大限制时，会删除较旧的日志文件以容许存储新日志。

这是一个docker-compose.yml限制日志存储的示例文件：

services:
  some-service:
    image: some-service
    logging:
      driver: "json-file"
      options:
        max-size: "200k"
        max-file: "10"

上述用于控制日志文件和大小的示例使用特定于json文件驱动程序的选项。这些特定选项在其余日志记录驱动程序中不可用。

network_mode

网络模式。使用与docker客户端--net参数相同的值，加上特殊格式service:[service name]。

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

Notes

使用（版本3）Compose文件在群集模式下部署堆栈时，将忽略此选项。

network_mode: "host" 不能与links混合.

networks

加入网络，引用顶级networks密钥下的条目

services:
  some-service:
    networks:
     - some-network
     - other-network

aliases

网络上此服务的别名（替代主机名）。同一网络上的其余容器可使用服务名称或此别名来链接到其中一个服务的容器。

因为aliases是网络范围的，相同的服务能够在不一样的网络上有不一样的别名。

Note: 全网域别名可由多个容器共享，甚至能够由多个服务共享。若是是，则不能保证名称解决的哪一个容器。

通常格式以下所示。

services:
  some-service:
    networks:
      some-network:
        aliases:
         - alias1
         - alias3
      other-network:
        aliases:
         - alias2

在下面的例子中，提供了三种服务（web，worker，和db），其中两个网络（沿new和legacy）。该db服务是在到达的主机名db或database上new网络，并db或mysql将上legacy网络。

version: '2'

services:
  web:
    build: ./web
    networks:
      - new

  worker:
    build: ./worker
    networks:
      - legacy

  db:
    image: mysql
    networks:
      new:
        aliases:
          - database
      legacy:
        aliases:
          - mysql

networks:
  new:
  legacy:

ipv4_address, ipv6_address

在加入网络时为该服务指定容器的静态IP地址。

顶级网络部分中的相应网络配置必须具备ipam覆盖每一个静态地址的子网配置的块。若是须要IPv6寻址，则enable_ipv6必须设置该选项，您必须使用版本2.x Compose文件，以下所示。

一个例子：

version: '2.1'

services:
  app:
    image: busybox
    command: ifconfig
    networks:
      app_net:
        ipv4_address: 172.16.238.10
        ipv6_address: 2001:3984:3989::10

networks:
  app_net:
    driver: bridge
    enable_ipv6: true
    ipam:
      driver: default
      config:
      -
        subnet: 172.16.238.0/24
      -
        subnet: 2001:3984:3989::/64

pid

pid: "host"

将PID模式设置为主机PID模式。这将打开容器和主机操做系统之间的共享PID地址空间。使用此标志启动的容器将可以访问和操做裸机机器的命名空间中的其余容器，反之亦然。

ports

Expose ports.

Short syntax

既能够指定端口（HOST:CONTAINER），也能够指定容器端口（将选择随机的主机端口）。

Note:以HOST:CONTAINER格式映射端口时，使用低于60的容器端口时，可能会遇到错误的结果，由于YAML会将格式的数字解析xx:yy为六进制（基数为60）。所以，咱们建议您始终将端口映射明确指定为字符串。

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"
 - "6060:6060/udp"

Long syntax

长格式语法容许配置不能以简短形式表达的其余字段。

target: 容器内的端口
published: 公开端港口
protocol: 端口协议（tcp或udp）
mode: host用于在每一个节点上发布主机端口，或者ingress用于在负载均衡的群集模式端口上发布主机端口。

ports:
  - target: 80
    published: 8080
    protocol: tcp
    mode: host

Note: v3.2中的长语法是新的

secrets

使用每一个服务secrets 配置在每一个服务的基础上授予访问权限。支持两种不一样的语法变体。

Note: 该秘密必须已经存在或者在secrets 该堆栈文件的顶级配置中定义，不然堆栈部署将失败

For more information on secrets, see secrets.

Short syntax

短语法变体仅指定秘密名称。这容许容器访问秘密，并将其安装在/run/secrets/ 容器内。源名称和目标挂载点都设置为秘密名称。

如下示例使用简短的语法来授予redis对该my_secret和my_other_secret机密的服务访问权限。将值 my_secret设置为文件的内容./my_secret.txt，并将 my_other_secret其定义为外部资源，这意味着它已经在Docker中定义，不管是经过运行docker secret create 命令仍是经过其余堆栈部署。若是外部机密不存在，则堆栈部署失败并出现secret not found错误。

version: "3.1"
services:
  redis:
    image: redis:latest
    deploy:
      replicas: 1
    secrets:
      - my_secret
      - my_other_secret
secrets:
  my_secret:
    file: ./my_secret.txt
  my_other_secret:
    external: true

Long syntax

The long syntax provides more granularity in how the secret is created within
the service's task containers.

source: The name of the secret as it exists in Docker.
target: The name of the file that will be mounted in /run/secrets/ in the
service's task containers. Defaults to source if not specified.
uid and gid: The numeric UID or GID which will own the file within
/run/secrets/ in the service's task containers. Both default to 0 if not
specified.
mode: The permissions for the file that will be mounted in /run/secrets/
in the service's task containers, in octal notation. For instance, 0444
represents world-readable. The default in Docker 1.13.1 is 0000, but will
be 0444 in the future. Secrets cannot be writable because they are mounted
in a temporary filesystem, so if you set the writable bit, it is ignored. The
executable bit can be set. If you aren't familiar with UNIX file permission
modes, you may find this
permissions calculator{: target="blank" class="" }
useful.

The following example sets name of the my_secret to redis_secret within the
container, sets the mode to 0440 (group-readable) and sets the user and group
to 103. The redis service does not have access to the my_other_secret
secret.

version: "3.1"
services:
  redis:
    image: redis:latest
    deploy:
      replicas: 1
    secrets:
      - source: my_secret
        target: redis_secret
        uid: '103'
        gid: '103'
        mode: 0440
secrets:
  my_secret:
    file: ./my_secret.txt
  my_other_secret:
    external: true

You can grant a service access to multiple secrets and you can mix long and
short syntax. Defining a secret does not imply granting a service access to it.

security_opt

Override the default labeling scheme for each container.

security_opt:
  - label:user:USER
  - label:role:ROLE

Note: This option is ignored when
deploying a stack in swarm mode
with a (version 3) Compose file.

stop_grace_period

Specify how long to wait when attempting to stop a container if it doesn't
handle SIGTERM (or whatever stop signal has been specified with
stop_signal), before sending SIGKILL. Specified
as a duration.

stop_grace_period: 1s
stop_grace_period: 1m30s

By default, stop waits 10 seconds for the container to exit before sending
SIGKILL.

stop_signal

Sets an alternative signal to stop the container. By default stop uses
SIGTERM. Setting an alternative signal using stop_signal will cause
stop to send that signal instead.

stop_signal: SIGUSR1

Note: This option is ignored when
deploying a stack in swarm mode
with a (version 3) Compose file.

sysctls

Kernel parameters to set in the container. You can use either an array or a
dictionary.

sysctls:
  net.core.somaxconn: 1024
  net.ipv4.tcp_syncookies: 0

sysctls:
  - net.core.somaxconn=1024
  - net.ipv4.tcp_syncookies=0

Note: This option is ignored when
deploying a stack in swarm mode
with a (version 3) Compose file.

ulimits

Override the default ulimits for a container. You can either specify a single
limit as an integer or soft/hard limits as a mapping.

ulimits:
  nproc: 65535
  nofile:
    soft: 20000
    hard: 40000

userns_mode

userns_mode: "host"

Disables the user namespace for this service, if Docker daemon is configured with user namespaces.
See dockerd for
more information.

Note: This option is ignored when
deploying a stack in swarm mode
with a (version 3) Compose file.

volumes

挂载主机路径或命名卷，指定为服务的子选项。

您能够将主机路径做为单个服务的定义的一部分进行安装，而且不须要在顶级volumes密钥中定义它。

可是，若是要跨多个服务重用卷，请在顶级volumes密钥中定义一个命名卷。使用命名卷与服务，群组和堆栈文件。

Note: 顶级卷键定义一个命名卷，并从每一个服务的volumes列表中引用它。这将替代volumes_from早期版本的撰写文件格式。

该实施例显示了一个名为体积（mydata）正在使用的web服务，和一个绑定安装为一个单一的服务（下第一路径定义db的服务 volumes）。该db服务还使用一个名为dbdata（称为db服务的第二个路径volumes）的命名卷，但使用旧的字符串格式来定义它，用于安装一个命名卷。命名卷必须列在顶级 volumes密钥下，如图所示。

version: "3.2"
services:
  web:
    image: nginx:alpine
    volumes:
      - type: volume
        source: mydata
        target: /data
        volume:
          nocopy: true
      - type: bind
        source: ./static
        target: /opt/app/static

  db:
    image: postgres:latest
    volumes:
      - "/var/run/postgres/postgres.sock:/var/run/postgres/postgres.sock"
      - "dbdata:/var/lib/postgresql/data"

volumes:
  mydata:
  dbdata:

Short syntax

可选地指定主机（HOST:CONTAINER）或访问模式（HOST:CONTAINER:ro）上的路径。

您能够在主机上安装相对路径，该路径将相对于正在使用的Compose配置文件的目录进行扩展。相对路径应该始于.或..。

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
  - datavolume:/var/lib/mysql

Long syntax

长格式语法容许配置不能以简短形式表达的其余字段。

type: 安装类型volume，bind或tmpfs
source: 安装的源，主机上的绑定安装路径，或顶级volumes密钥中定义的卷的名称。不适用于tmpfs mount。
target: 容器中将要装入卷的路径
read_only:将卷设置为只读的标志
bind: 配置其余绑定选项
- propagation:用于绑定的传播模式
volume:配置其余卷选项
- nocopy: 在建立卷时禁止从容器复制数据的标志

version: "3.2"
services:
  web:
    image: nginx:alpine
    ports:
      - "80:80"
    volumes:
      - type: volume
        source: mydata
        target: /data
        volume:
          nocopy: true
      - type: bind
        source: ./static
        target: /opt/app/static

networks:
  webnet:

volumes:
  mydata:

Note: v3.2中的长语法是新的

Volumes for services, swarms, and stack files

当使用服务，群集和docker-stack.yml文件时，请记住，支持服务的任务（容器）能够部署在群集中的任何节点上，每当节点更新时，它们多是不一样的节点。

在没有指定源的命名卷的状况下，Docker为支持服务的每一个任务建立一个匿名卷。删除关联的容器后，匿名卷不会持久。

若是要使数据持久存在，请使用多主机感知的命名卷和卷驱动程序，以即可以从任何节点访问数据。或者，对服务设置约束，使其任务部署在存在卷的节点上。

做为示例，Docker Labs中docker-stack.yml的表决应用程序示例的文件定义了一个名为db运行postgres数据库的服务。它被配置为命名卷，以便将数据保留在群集中，而且被限制为仅在manager节点上运行。这是从该文件的相关剪辑：

version: "3"
services:
  db:
    image: postgres:9.4
    volumes:
      - db-data:/var/lib/postgresql/data
    networks:
      - backend
    deploy:
      placement:
        constraints: [node.role == manager]

restart

no是默认的从新启动策略，它不会在任何状况下从新启动容器。当always指定时，容器老是从新启动。on-failure若是退出代码指示故障错误，该策略将从新启动容器。

restart: "no"
restart: always
restart: on-failure
restart: unless-stopped

domainname, hostname, ipc, mac_address, privileged, read_only, shm_size, stdin_open, tty, user, working_dir

这些都是一个单一的值，相似于其
docker run 对应物

user: postgresql
working_dir: /code

domainname: foo.com
hostname: foo
ipc: host
mac_address: 02:42:ac:11:65:43

privileged: true


read_only: true
shm_size: 64M
stdin_open: true
tty: true

Specifying durations

一些配置选项，如interval和timeout子选项 check，接受一个持续时间为看起来像这样的格式的字符串：

2.5s
10s
1m30s
2h32m
5h34m56s

The supported units are us, ms, s, m and h.

Volume configuration reference

虽然能够在文件中声明卷做为服务声明的一部分，但本节容许您建立volumes_from能够跨多个服务重复使用的命名卷（不依赖），而且可使用docker命令行轻松地检索和检查API。有关更多信息，请参阅 docker volume子命令文档。

如下是一个双服务设置的示例，其中将数据库的数据目录与其余服务共享为卷，以即可以按期备份数据库的数据目录：

version: "3"

services:
  db:
    image: db
    volumes:
      - data-volume:/var/lib/db
  backup:
    image: backup-service
    volumes:
      - data-volume:/var/lib/backup/data

volumes:
  data-volume:

顶级volumes密钥下的条目能够为空，在这种状况下，它将使用引擎配置的默认驱动程序（在大多数状况下，这是 local驱动程序）。

driver

指定该卷使用哪一个卷驱动程序。默认为Docker Engine配置为使用的任何驱动程序，这在大多数状况下是这样 local。若是驱动程序不可用，引擎将在docker-compose up尝试建立卷时返回错误。

driver: foobar

driver_opts

指定选项列表做为键值对，以传递给此卷的驱动程序。这些选项与驱动程序相关 - 有关详细信息，请参阅驱动程序文档。可选的。

driver_opts:
   foo: "bar"
   baz: 1

external

若是设置为true，则指定此卷已在Compose以外建立。docker-compose up不会尝试建立它，若是不存在则会引起错误。

external不能与其余卷配置键（driver，driver_opts）结合使用。

在下面的示例中，[projectname]_dataCompose 不是尝试建立一个名为的卷，而是会查找一个简单调用的现有卷，data并将其安装到db服务的容器中。

version: '2'

services:
  db:
    image: postgres
    volumes:
      - data:/var/lib/postgresql/data

volumes:
  data:
    external: true

您还能够在Compose文件中与用于引用卷的名称分开指定卷的名称：

volumes:
  data:
    external:
      name: actual-name-of-volume

老是使用docker stack deploy建立外部卷

若是使用docker stack deploy以swarm模式启动应用程序（而不是docker组合），则将建立不存在的外部卷。在群集模式下，当由服务定义时，会自动建立一个卷。因为服务任务在新节点上安排，因此swarmkit会在本地节点上建立卷。

labels

使用Docker标签将元数据添加到容器。您可使用数组或字典。

建议您使用反向DNS符号来防止标签与其余软件使用的标签相冲突。

labels:
  com.example.description: "Database volume"
  com.example.department: "IT/Ops"
  com.example.label-with-empty-value: ""

labels:
  - "com.example.description=Database volume"
  - "com.example.department=IT/Ops"
  - "com.example.label-with-empty-value"

Network configuration reference

顶级networks密钥容许您指定要建立的网络。

For a full explanation of Compose's use of Docker networking features and all
network driver options, see the Networking guide.
For Docker Labs
tutorials on networking, start with Designing Scalable, Portable Docker
Container
Networks

driver

指定该网络应使用哪一个驱动程序。

默认驱动程序取决于您使用的Docker Engine是如何配置的，但在大多数状况下，它将bridge位于单个主机和overlaySwarm上。

若是驱动程序不可用，Docker Engine将返回一个错误。

driver: overlay

bridge

Docker默认bridge在单个主机上使用网络。

overlay

该overlay驱动程序建立一个跨多个节点命名的网络
swarm.

For a working example of how to build and use an
overlay network with a service in swarm mode, see the Docker Labs tutorial on
Overlay networking and service
discovery.
For an in-depth look at how it works under the hood, see the
networking concepts lab on the Overlay Driver Network
Architecture.

host or none

使用主机的网络堆栈，或没有网络。等同于 docker run --net=host或docker run --net=none。仅在使用docker stack命令时使用。若是使用该docker-compose命令，请改用network_mode。

使用内置的网络，如语法host和none稍有不一样。使用名称host或none（Docker已经自动建立的）和Compose可使用的别名（hostnet或nonet在这些示例中）定义外部网络，而后使用别名授予对该网络的服务访问权限。

services:
  web:
    ...
    networks:
      hostnet: {}

networks:
  hostnet:
    external:
      name: host

services:
  web:
    ...
    networks:
      nonet: {}

networks:
  nonet:
    external:
      name: none

driver_opts

指定选项列表做为键值对，以传递给此网络的驱动程序。这些选项与驱动程序相关 - 有关详细信息，请参阅驱动程序文档。可选的。

driver_opts:
    foo: "bar"
    baz: 1

attachable

Note: Only supported for v3.2 and higher.

仅在driver设置时使用overlay。若是设置为true，则除了服务以外，独立容器能够附加到此网络。若是独立的容器附加到覆盖网络，则它能够与服务和独立容器通讯，这些容器也从其余Docker守护程序链接到覆盖网络。

networks:
  mynet1:
    driver: overlay
    attachable: true

enable_ipv6

在此网络上启用IPv6网络。

Compose File版本3中不支持

enable_ipv6 要求您使用版本2 Compose文件，由于在Swarm模式下此命令尚不支持。

ipam

Specify custom IPAM config. This is an object with several properties, each of
which is optional:

driver: Custom IPAM driver, instead of the default.
config: A list with zero or more config blocks, each containing any of
the following keys:
- subnet: Subnet in CIDR format that represents a network segment

A full example:

ipam:
  driver: default
  config:
    - subnet: 172.28.0.0/16

Note: Additional IPAM configurations, such as gateway, are only honored for version 2 at the moment.

internal

By default, Docker also connects a bridge network to it to provide external
connectivity. If you want to create an externally isolated overlay network,
you can set this option to true.

labels

Add metadata to containers using
Docker labels. You can use either
an array or a dictionary.

It's recommended that you use reverse-DNS notation to prevent your labels from
conflicting with those used by other software.

labels:
  com.example.description: "Financial transaction network"
  com.example.department: "Finance"
  com.example.label-with-empty-value: ""

labels:
  - "com.example.description=Financial transaction network"
  - "com.example.department=Finance"
  - "com.example.label-with-empty-value"

external

If set to true, specifies that this network has been created outside of
Compose. docker-compose up will not attempt to create it, and will raise
an error if it doesn't exist.

external cannot be used in conjunction with other network configuration keys
(driver, driver_opts, ipam, internal).

In the example below, proxy is the gateway to the outside world. Instead of
attempting to create a network called [projectname]_outside, Compose will
look for an existing network simply called outside and connect the proxy
service's containers to it.

version: '2'

services:
  proxy:
    build: ./proxy
    networks:
      - outside
      - default
  app:
    build: ./app
    networks:
      - default

networks:
  outside:
    external: true

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

networks:
  outside:
    external:
      name: actual-name-of-network

configs configuration reference

The top-level configs declaration defines or references
configs which can be granted to the services in this
stack. The source of the config is either file or external.

file: The config is created with the contents of the file at the specified
path.
external: If set to true, specifies that this config has already been
created. Docker will not attempt to create it, and if it does not exist, a
config not found error occurs.

In this example, my_first_config will be created (as
<stack_name>_my_first_config)when the stack is deployed,
and my_second_config already exists in Docker.

configs:
  my_first_config:
    file: ./config_data
  my_second_config:
    external: true

Another variant for external configs is when the name of the config in Docker
is different from the name that will exist within the service. The following
example modifies the previous one to use the external config called
redis_config.

configs:
  my_first_config:
    file: ./config_data
  my_second_config:
    external:
      name: redis_config

You still need to grant access to the config to each service in the
stack.

secrets configuration reference

The top-level secrets declaration defines or references
secrets which can be granted to the services in this
stack. The source of the secret is either file or external.

file: The secret is created with the contents of the file at the specified
path.
external: If set to true, specifies that this secret has already been
created. Docker will not attempt to create it, and if it does not exist, a
secret not found error occurs.

In this example, my_first_secret will be created (as
<stack_name>_my_first_secret)when the stack is deployed,
and my_second_secret already exists in Docker.

secrets:
  my_first_secret:
    file: ./secret_data
  my_second_secret:
    external: true

Another variant for external secrets is when the name of the secret in Docker
is different from the name that will exist within the service. The following
example modifies the previous one to use the external secret called
redis_secret.

secrets:
  my_first_secret:
    file: ./secret_data
  my_second_secret:
    external:
      name: redis_secret

You still need to grant access to the secrets to each service in the
stack.

Variable substitution

{% include content/compose-var-sub.md %}

docker-compose v3版本命令详解参考

参考和指南

Compose and Docker 兼容性矩阵

Compose 文件结构和示例

服务配置参考

build

上下文

Dockerfile

Args

cache_from

labels

cap_add, cap_drop

command

configs

Short syntax

Long syntax

cgroup_parent

container_name

credential_spec

deploy

endpoint_mode

labels

mode

placement

replicas

resources

内存异常 (OOME)

restart_policy

update_config

不支持 docker stack deploy

devices

depends_on

DNS

dns_search

tmpfs

entrypoint

env_file

environment

expose

external_links

extra_hosts

healthcheck

image

isolation

labels

links

logging

network_mode

networks

aliases

ipv4_address, ipv6_address

pid

ports

Short syntax

Long syntax

secrets

Short syntax

Long syntax

security_opt

stop_grace_period

stop_signal

sysctls

ulimits

userns_mode

volumes

Short syntax

Long syntax

Volumes for services, swarms, and stack files

restart

domainname, hostname, ipc, mac_address, privileged, read_only, shm_size, stdin_open, tty, user, working_dir

Specifying durations

Volume configuration reference

driver

driver_opts

external

labels

Network configuration reference

driver

bridge

overlay

不支持 `docker stack deploy`