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

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

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

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

<a href="/get-started/part3.md#your-first-docker-composeyml-file">你的第一个docker-compose.yml文件</a>

<a href="/get-started/part5.md#adding-a-new-service-and-redeploying">添加新服务并重新部署</a>

另一个很好的参考是在

<a href="https://github.com/docker/labs/tree/master/beginner/">Docker for Beginners实验室</a>

Compose文件是一个定义

Compose文件的默认路径是 <code>./docker-compose.yml</code>.

提示：您可以对此文件使用<code>.yml</code>或<code>.yaml</code>扩展名。他们都工作.

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

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

您可以使用类似Bash的<code>${VARIABLE}</code>语法在配置值中使用环境变量 - 有关详细信息，请参阅

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

<code>build</code> 可以指定为包含构建上下文的路径的字符串：

如果指定<code>image</code>以及<code>build</code>，然后撰写的名称与内置的图像<code>webapp</code>和可选的<code>tag</code>规定<code>image</code>：

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

时，将忽略此选项 。该<code>docker stack</code>命令仅接受预建图像。

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

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

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

备用Docker文件。

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

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

首先，在Dockerfile中指定参数：

然后在<code>build</code>密钥下指定参数。您可以传递映射或列表：

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

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

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

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

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

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

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

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

时，将忽略这些选项 。

覆盖默认命令。

该命令也可以是一个列表，类似于

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

中定义，否则堆栈部署将失败

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

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

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

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

<code>source</code>：Docker中存在的配置名称。

<code>target</code>：将要装入服务任务容器的文件的路径和名称。默认为<code>/&lt;source&gt;</code>未指定。

<code>uid</code>和<code>gid</code>：数字UID或GID，它将拥有服务的任务容器中的挂载配置文件。<code>0</code>如果没有指定，则默认为Linux。Windows不支持

<code>mode</code>：将在服务的任务容器中装载的文件的权限，以八进制符号表示。例如<code>，0444</code> 代表世界可读。默认是<code>0444</code>。配置不能被写入，因为它们被安装在临时文件系统中，所以如果设置可写位，则忽略它。可执行位可以设置。如果您不熟悉UNIX文件权限模式，您可能会发现此

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

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

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

时，将忽略此选项 。

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

因为Docker容器名称必须是唯一的，如果您指定了自定义名称，则无法将服务扩展到超过1个容器。尝试这样做会导致错误。

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

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

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

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

以下示例从<code>my-credential-spec</code> 注册表中指定的值加载凭据规范：

有几个子选项可用：

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

<code>endpoint_mode: vip</code> - Docker为服务分配虚拟IP（VIP），作为客户端到达网络服务的“前端”。Docker在服务的客户端和可用的工作者节点之间路由请求，而无需客户端了解有多少个节点参与服务或其IP地址或端口。（这是默认值。）

<code>endpoint_mode: dnsrr</code> - DNS循环（DNSRR）服务发现不使用单个虚拟IP。Docker为服务设置DNS条目，以便服务名称的DNS查询返回IP地址列表，客户端直接连接到其中一个。如果要使用自己的负载均衡器，或混合Windows和Linux应用程序，则DNS循环是非常有用的。

<code>endpoint_mode</code>在swarm模式CLI命令

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

要在容器上设置标签，请使用以下<code>labels</code>键<code>deploy</code>：

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

指定布局约束

如果服务是<code>replicated</code>（默认为），请指定在任何给定时间应运行的容器数。

配置资源约束。

这些都是一个单一的值，类似于[docker service

create](/engine/reference/commandline/service_create.md) 对应的.

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

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

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

<code>condition</code>: 其中之一<code>none</code>，<code>on-failure</code>或<code>any</code>（默认：）<code>any</code>。

<code>delay</code>:在重新启动尝试之间等待多长时间，指定为 <code>持续时间</code>（默认值：0）。

<code>max_attempts</code>: 在放弃之前尝试重新启动一个容器多少次（默认：永不放弃）.

<code>window</code>: 在决定重新启动成功之前等待多长时间，指定为持续时间（默认：立即决定）.

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

<code>parallelism</code>:一次更新的容器数量。

<code>delay</code>:更新一组容器之间等待的时间。

<code>failure_action</code>: 如果更新失败，该怎么办？其中之一<code>continue，rollback或pause</code> （默认：）pause。

<code>monitor</code>: 每个任务更新后的持续时间来监视失败 <code>(ns|us|ms|s|m|h)</code>（默认为0）。

<code>max_failure_ratio</code>:更新期间容忍的故障率。

<code>order</code>: 更新期间的操作顺序。其中一个<code>stop-first</code>（旧任务，开始新的一个前停止），或者<code>start-first</code>（新的任务首先启动，并且正在运行的任务将简要重叠）（默认stop-first）注：仅支持V3.4及更高版本。

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

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

<a href="#build">build</a>

<a href="#cgroup_parent">cgroup_parent</a>

<a href="#container_name">container_name</a>

<a href="#devices">devices</a>

<a href="#dns">dns</a>

<a href="#dns_search">dns_search</a>

<a href="#tmpfs">tmpfs</a>

<a href="#external_links">external_links</a>

<a href="#links">links</a>

<a href="#network_mode">network_mode</a>

<a href="#security_opt">security_opt</a>

<a href="#stop_signal">stop_signal</a>

<a href="#sysctls">sysctls</a>

<a href="#userns_mode">userns_mode</a>

设备映射列表 使用与<code>--device</code>docker客户端创建选项相同的格式。

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

<code>docker-compose up</code> 将依依次顺序启动服务。在下面的例子中，db并redis会开始之前web。

<code>docker-compose up SERVICE</code> 将自动包含SERVICE的依赖关系。在下面的例子中，docker-compose up web也将创建和启动db和redis。

简单的例子:

使用时需要注意几件事情 <code>depends_on</code>: <code>depends_on</code> 在开始之前不会等待<code>db</code>并且<code>redis</code>“准备好”<code>，web</code>直到它们被启动为止 版本3不再支持的<code>condition</code>形式<code>depends_on</code>

自定义DNS服务器。可以是单个值或列表。

自定义DNS搜索域。可以是单个值或列表。

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

覆盖默认入口点。

entrypoint也可以是一个列表，类似于

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

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

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

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

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

该值<code>VAL</code>是按原样使用的，完全没有修改。例如，如果值被引号包围（通常是shell变量的情况），引号将包含在传递给Compose的值中。

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

和以下文件：

和

$ VAR将会hello

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

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

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

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

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

注意：

如果您使用的是版本2或以上的文件格式，外部创建的容器必须连接至至少一个与要链接的服务相同的网络。链接是遗留选项。我们建议使用网络。

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

添加主机名映射。使用与docker客户端<code>--add-host</code>参数相同的值。

将在<code>/etc/hosts</code>此服务的内部容器中创建具有ip地址和主机名的条目，例如：

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

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

test必须是字符串或列表。如果它是一个列表，第一项必须是NONE，CMD或CMD-SHELL。如果它是一个字符串，则相当于指定CMD-SHELL该字符串。

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

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

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

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

<a href="/engine/reference/commandline/run.md#specify-isolation-technology-for-container---isolation">Docker Engine docs</a>

.

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

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

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

链接不需要启用服务进行通信 - 默认情况下，任何服务都可以达到该服务名称的任何其他服务。

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

Notes 如果您定义了链接和网络，那么它们之间链接的服务必须至少共享一个网络以进行通信。 使用（版本3）Compose文件在群集模式下部署堆栈时，将忽略此选项

记录该服务的配置。

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

默认值为json-file。

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

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

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

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

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

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

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

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

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

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

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

由于aliases是网络范围的，相同的服务可以在不同的网络上有不同的别名。

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

一般格式如下所示。

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

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

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

一个例子：

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

Expose ports.

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

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

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

<code>target</code>: 容器内的端口

<code>published</code>: 公开端港口

<code>protocol</code>: 端口协议（tcp或udp）

<code>mode</code>: host用于在每个节点上发布主机端口，或者ingress用于在负载均衡的群集模式端口上发布主机端口。

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

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

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

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

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

The long syntax provides more granularity in how the secret is created within

the service's task containers.

<code>source</code>: The name of the secret as it exists in Docker.

<code>target</code>: The name of the file that will be mounted in <code>/run/secrets/</code> in the

service's task containers. Defaults to <code>source</code> if not specified.

<code>uid</code> and <code>gid</code>: The numeric UID or GID which will own the file within

<code>/run/secrets/</code> in the service's task containers. Both default to <code>0</code> if not

specified.

<code>mode</code>: The permissions for the file that will be mounted in <code>/run/secrets/</code>

in the service's task containers, in octal notation. For instance, <code>0444</code>

represents world-readable. The default in Docker 1.13.1 is <code>0000</code>, but will

be <code>0444</code> 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

useful.

The following example sets name of the <code>my_secret</code> to <code>redis_secret</code> within the

container, sets the mode to <code>0440</code> (group-readable) and sets the user and group

to <code>103</code>. The <code>redis</code> service does not have access to the <code>my_other_secret</code>

secret.

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.

Override the default labeling scheme for each container.

Note: This option is ignored when <a href="/engine/reference/commandline/stack_deploy.md">deploying a stack in swarm mode</a> with a (version 3) Compose file.

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

By default, <code>stop</code> waits 10 seconds for the container to exit before sending

SIGKILL.

Sets an alternative signal to stop the container. By default <code>stop</code> uses

SIGTERM. Setting an alternative signal using <code>stop_signal</code> will cause

<code>stop</code> to send that signal instead.

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

dictionary.

Override the default ulimits for a container. You can either specify a single

limit as an integer or soft/hard limits as a mapping.

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

more information.

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

您可以将主机路径作为单个服务的定义的一部分进行安装，并且不需要在顶级volumes密钥中定义它。

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

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

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

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

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

<code>type</code>: 安装类型volume，bind或tmpfs

<code>source</code>: 安装的源，主机上的绑定安装路径，或顶级volumes密钥中定义的卷的名称 。不适用于tmpfs mount。

<code>target</code>: 容器中将要装入卷的路径

<code>read_only</code>:将卷设置为只读的标志

<code>bind</code>: 配置其他绑定选项

<code>propagation</code>:用于绑定的传播模式

<code>volume</code>:配置其他卷选项

<code>nocopy</code>: 在创建卷时禁止从容器复制数据的标志

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

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

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

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

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

这些都是一个单一的值，类似于其

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

The supported units are <code>us</code>, <code>ms</code>, <code>s</code>, <code>m</code> and <code>h</code>.

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

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

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

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

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

如果设置为true，则指定此卷已在Compose之外创建。docker-compose up不会尝试创建它，如果不存在则会引发错误。

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

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

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

总是使用docker stack deploy创建外部卷

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

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

顶级networks密钥允许您指定要创建的网络。

For a full explanation of Compose's use of Docker networking features and all

on networking, start with [Designing Scalable, Portable Docker

Container

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

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

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

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

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

For a working example of how to build and use an

<code>overlay</code> network with a service in swarm mode, see the Docker Labs tutorial on

[Overlay networking and service

For an in-depth look at how it works under the hood, see the

concepts lab on the [Overlay Driver Network

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

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

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

Note: Only supported for v3.2 and higher.

仅在driver设置时使用overlay。如果设置为true，则除了服务之外，独立容器可以附加到此网络。如果独立的容器附加到覆盖网络，则它可以与服务和独立容器通信，这些容器也从其他Docker守护程序连接到覆盖网络。

在此网络上启用IPv6网络。

Compose File版本3中不支持 <code>enable_ipv6</code> 要求您使用版本2 Compose文件，因为在Swarm模式下此命令尚不支持。

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

which is optional:

<code>driver</code>: Custom IPAM driver, instead of the default.

<code>config</code>: A list with zero or more config blocks, each containing any of

the following keys:

<code>subnet</code>: Subnet in CIDR format that represents a network segment

A full example:

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

By default, Docker also connects a bridge network to it to provide external

If you want to create an externally isolated overlay network,

can set this option to <code>true</code>.

Add metadata to containers using

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.

If set to <code>true</code>, specifies that this network has been created outside of

Compose. <code>docker-compose up</code> will not attempt to create it, and will raise

an error if it doesn't exist.

<code>external</code> cannot be used in conjunction with other network configuration keys

(<code>driver</code>, <code>driver_opts</code>, <code>ipam</code>, <code>internal</code>).

In the example below, <code>proxy</code> is the gateway to the outside world. Instead of

attempting to create a network called <code>[projectname]_outside</code>, Compose will

look for an existing network simply called <code>outside</code> and connect the <code>proxy</code>

service's containers to it.

You can also specify the name of the network separately from the name used to

refer to it within the Compose file:

The top-level <code>configs</code> declaration defines or references

The source of the config is either <code>file</code> or <code>external</code>.

<code>file</code>: The config is created with the contents of the file at the specified

path.

<code>external</code>: If set to true, specifies that this config has already been

Docker will not attempt to create it, and if it does not exist, a

<code>config not found</code> error occurs.

In this example, <code>my_first_config</code> will be created (as

<code>&lt;stack_name&gt;_my_first_config)</code>when the stack is deployed,

and <code>my_second_config</code> already exists in Docker.

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

<code>redis_config</code>.

stack.

The top-level <code>secrets</code> declaration defines or references

The source of the secret is either <code>file</code> or <code>external</code>.

<code>file</code>: The secret is created with the contents of the file at the specified

<code>external</code>: If set to true, specifies that this secret has already been

<code>secret not found</code> error occurs.

In this example, <code>my_first_secret</code> will be created (as

<code>&lt;stack_name&gt;_my_first_secret)</code>when the stack is deployed,

and <code>my_second_secret</code> already exists in Docker.

Another variant for external secrets is when the name of the secret in Docker

example modifies the previous one to use the external secret called

<code>redis_secret</code>.

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

<a href="/compose/index.md">User guide</a>

<a href="/compose/install/">Installing Compose</a>

<a href="compose-versioning.md">Compose file versions and upgrading</a>

<a href="/get-started/">Get started with Docker</a>

<a href="/samples/">Samples</a>

<a href="/compose/reference/">Command line reference</a>