章节索引 :

docker compose 配置文件指令详解

上一节我们快速体验了 Docker Compose,本节我们来学习如何编写和使用 Docker Compose。

Docker Compose 的配置文件是一个基于 YAML 格式的文件。与 Dockerfile 采用 Dockerfile 作为默认文件名一样,Docker Compose 的配置文件也有一个缺省的文件名,就是 docker-compose.yml。

Docker Compose 将所管理的容器分为三层,分别是工程(project)、服务(service)、容器(container),Docker Compose 定义了一个工程,一个工程包含多个服务,每个服务中定义了容器运行的镜像、参数、依赖,一个服务可包括多个容器实例。

1. 梳理工程中各个服务和容器的关系

Docker Compose配置文件有多个层级,直接学习指令不便于理解,通过一个熟悉的例子来掌握它是个更好的办法。

以先前的配置文件为例,从Docker Compose的角度看,多个互相关联的容器构成了一个工程。这个工程中包含应用服务app和数据缓存服务cache。

  • 缓存服务cache包含redis容器,它提供给工程中的其他容器redis服务。

  • 应用服务app中包含我们自定义的Dockerfile构建生成的容器,容器的运行依赖redis服务。

Tips: 需要注意的是,先前借用宿主机网络直接进行容器通信过于简单粗暴。我们只需要对外暴露flask 应用的 5000 端口就足够了,因此在 Docker Compose 容器编排中,需要维护额外的 Docker 网络,来处理这个工程中各容器通信。

2. 详解配置指令

这里是上一节中使用的 Docker Compose 配置文件,它包含许多内容,从每个容器的各个细节控制,到网络、数据卷等的定义。

本节我们加入了注释来快速了解它。

# 指定配置文件的版本号
version: "3.8"

# 服务
services:
	# 服务名称cache
    cache:
     # 标明构建的镜像
      image: redis:6.0.5
      # 生成的容器名称
      container_name: my_redis
      # 指定网络
      networks:
          - mynetwork
      # 设定挂载
      volumes:
          - ./redis/redis.conf:/usr/local/etc/redis/redis.conf:ro
      # 容器启动后执行命令
      command: ["redis-server", "/usr/local/etc/redis/redis.conf"]
    # 服务名称app 
    app:
      # 构建镜像
      build:
          # 指定上下文
          context: .
          # 指定构建脚本
          dockerfile: ./Dockerfile-multi-stage
      # 生成的容器名称
      container_name: my_hello
      # 指定网络
      networks:
          - mynetwork
      # 配置环境变量
      environment:
          - REDIS_HOST=my_redis
      # 指名容器依赖关系
      depends_on:
          - cache
      # 宿主机与容器端口映射
      ports:
          - "5000:5000"

# 网络配置,与services在同一层级,注意书写格式对齐
networks:
  # 标识自定义的网络,对应容器中指定的网络的名称
  mynetwork:
   # 在容器网路中展示的名称
    name: my_network
    # 网络驱动类型
    driver: bridge

基本的结构示意图如下:
图片描述

接下来,我们认识一下这个例子中出现的一些常用指令:

2.1 version

版本号标识我们定义的 docker-compose.yml 文件内容所采用的版本,目前 Docker Compose 的配置文件已经迭代至了第三版,其所支持的功能也越来越丰富,建议使用最新的版本来定义。对照表如下:

Compose 配置文件版本 Docker 版本
3.8 19.03.0+
3.7 18.06.0+
3.6 18.02.0+
3.5 17.12.0+
3.4 17.09.0+
3.3 17.06.0+
3.2 17.04.0+
3.1 1.13.1+
3.0 1.13.0+
2.4 17.12.0+
2.3 17.06.0+
2.2 1.13.0+
2.1 1.12.0+
2.0 1.10.0+
1.0 1.9.1.+

2.2 service

在 Docker Compose 把 service 作为配置的最小单元。使用时,我们首先要为每个服务定义一个名称,用以区别不同的服务。在这个例子里,cache、redis 就是服务的名称。虽然看上去每个 service 里的配置内容就像是在配置单个容器,但其实 service 代表的是一个应用集群的配置,这个部分我们会在后续的实战环节接触到。

2.3 image

类似于Dockerfile中的FROM指令。需要注意,一定要注明镜像的具体版本号,不要使用latest版本(不标明版本即为latest),不同的执行时间,latest指代的镜像会发生改变。准确执行唯一指定的容器才能使得整个工程正确运行。

2.4 build

build另一种指定镜像的方式,通过 build 这个配置我们能够直接采用 Dockerfile 来构建镜像,定义构建的环境目录。

如果我们通过这种方式指定镜像,那么 Docker Compose 先会帮助我们执行镜像的构建,之后再通过这个镜像启动容器。Docker Compose 我们能够指定更多的镜像构建参数,例如 Dockerfile 的文件名,构建上下文,构建参数等等。

此外,与image指令类似,我们希望Dockerfile的构建也是唯一可靠的,因此之前Dockerfile的写法也是不够稳定的,请读者自行在Dockerfile中的镜像和依赖上标明合适的版本号。

2.5 container_name

指定容器名称,如果不指定,会以<项目名称><服务名称><序号>。其中项目名称默认是当前工作目录的名字。

2.6 command

例如上面的配置里,我们希望修改 Redis 的启动命令,加入配置文件以便对 Redis 服务进行配置,那么我们可以直接通过 command 配置来修改。command会覆盖镜像中的CMD指令。

2.7 depends_on

在上面的例子里,我们的 app 依赖 cache,使用 depends_on 这个配置项,列出这个服务所有依赖的其他服务即可。在 Docker Compose 为我们启动项目的时候,会检查所有依赖,按照依赖指定的启动顺序来依次启动容器。

2.8 volumes

在 Docker Compose 里定义文件挂载的方式与 Docker里也并没有太多的区别,使用 volumes 配置可以像 docker 的 -v 选项一样来指定外部挂载和数据卷挂载。在这个例子中,我们将redis的配置文件挂载到容器中。

2.9 ports

ports 这个配置项,它是用来定义端口映射的。我们可以利用它进行宿主机与容器端口的映射,这个配置与 docker 中 -p 选项的使用方法是近似的。

2.10 environment:

设置环境变量, 类似于 Dockerfile 的 ENV

2.11 networks

网络也是容器间互相访问的桥梁,网络的配置对于多个容器组成的应用系统来说也是非常重要的。在 Docker Compose 里,我们可以为整个应用系统设置一个或多个网络。

要使用网络,我们必须先声明网络。声明网络的配置同样独立于 services 存在,是位于根配置下的 networks 配置。在上面的例子里,我们声明了网络mynetwork,在服务的配置中,直接使用networks指定mynetwork即可。

2.12 name

networks下的name的作用类似于 container_name指令,在这个例子中,mynetwork 创建的 docker 网络被命名为 my_network, 使用命令 docker network ls 可以查看到它。

3.小结

本节带领大家认识了配置文件的基本结构和常用指令,这些指令是我们构建 Docker Compose 工程中最最常用的,是指令当中的“骨干成员”,请务必要掌握它们的基本用法。