Docker-compose

一、概述

Docker-Compose项目是Docker官方的开源项目，负责实现对Docker容器集群的快速编排。

Docker-Compose将所管理的容器分为三层，分别是工程（project），服务（service）以及容器（container）。

Docker-Compose运行目录下的所有文件（docker-compose.yml，extends文件或环境变量文件等）组成一个工程，若无特殊指定工程名即为当前目录名。一个工程当中可包含多个服务，每个服务中定义了容器运行的镜像、参数、依赖。一个服务当中可包括多个容器实例，Docker-Compose并没有解决负载均衡的问题，因此需要借助其它工具实现服务发现及负载均衡，比如 Consul。

Docker-Compose的工程配置文件默认为docker-compose.yml，可通过环境变量COMPOSE_FILE或-f参数自定义配置文件，其定义了多个有依赖关系的服务及每个服务运行的容器。

使用一个Dockerfile模板文件，可以让用户很方便的定义一个单独的应用容器。在工作中，经常会碰到需要多个容器相互配合来完成某项任务的情况。例如要实现一个Web项目，除了Web服务容器本身，往往还需要再加上后端的数据库服务容器，甚至还包括负载均衡容器等。

Compose允许用户通过一个单独的docker-compose.yml模板文件（YAML 格式）来定义一组相关联的应用容器为一个项目（project）。

Docker-Compose项目由Python编写，调用Docker服务提供的API来对容器进行管理。因此，只要所操作的平台支持Docker API， 就可以在其上利用Compose来进行编排管理。

二、YAML文件格式及编写注意事项

YAML 是一种标记语言，它可以很直观的展示数据序列化格式，可读性高。类似于 XML数据描述语言，语法比 XML 简单的很多。YAML 数据结构通过缩进来表示，连续的项目通过减号来表示，键值对用冒号分隔，数组用中括号 [] 括起来， hash 用花括号 {} 括起来。

使用 YAML 时需要注意下面事项：
（1）不支持制表符 tab 键缩进，需要使用空格缩进
（2）通常开头缩进2个空格
（3）字符后缩进1个空格，如冒号 : 、逗号 , 、横杠 -
（4）用 # 号注释
（5）如果包含特殊字符用单引号 ‘’ 引起来
（6）布尔值必须用引号 " " 括起来

三、Docker Compose配置常用字段

（1）build ：指定 Dockerfile 文件名（要指定Dockerfile文件需要在build标签的子级标签中使用dockerfile标签指定）

（2）dockerfile ：构建镜像上下文路径

（3）context ：可以是 dockerfile 的路径，或者是指向 git 仓库的 url 地址

（4）image ：指定镜像

（5）command ：执行命令，覆盖默认命令

（6）container name ：指定容器名称，由于容器名称是唯一的，如果指定自定义名称，则无法 scale

（7）deploy ：指定部署和运行服务相关配置，只能在 Swarm 模式使用

（8）environment ：添加环境变量

（9）networks ：加入网络

（10）ports ：暴露容器端口，与 -p 相同，但端口不能低于 60

（11）volumes ：挂载宿主机路径或命令卷

（12）hostname ：容器主机名

（13）restart ：重启策略，默认 no，always，no-failure，unless-stoped
注：
no，默认策略，在容器退出时不重启容器。
on-failure，在容器非正常退出时（退出状态非0），才会重启容器。
on-failure:3，在容器非正常退出时重启容器，最多重启3次。
always，在容器退出时总是重启容器。
unless-stopped，在容器退出时总是重启容器，但是不考虑在 Docker 守护进程启动时就已经停止了的容器。

四、Docker Compose命令

格式

docker-compose -f docker-compose.yml up -d

注释
-f, --file FILE ：使用特定的 compose 模板文件，默认为 docker-compose.yml
-p, --project-name NAME ：指定项目名称，默认使用目录名称
-d ：在后台运行

常用命令

字段	说明