1. Compose简介

Docker Compose是Docker官方的用于对Docker容器集群实现编排，快速部署分布式应用的开源项目。Docker Compose通过docker-compose.yml文件来定义一组相关联的应用容器的编排，这组相关联的应用容器一般通过互相交互作为一个整体项目提供服务，比如一个Web项目，既包含业务服务容器，也包含数据库服务容器与缓存服务容器等。

Compose中两个重要的概念：

  • 服务（service）： 包含多个运行相同镜像的容器实例
  • 项目（project）： 由一组关联的应用容器（服务）组成一个完整的业务服务单元，在docker-compose.yml（即Compose的模板文件）中定义

Copmpose项目由Python编写，通过调用Docker服务提供的API来对容器进行管理。Compose默认的管理对象是项目，可以通过子命令对项目中的一组容器进行生命周期管理。

2. Compose安装

在macOS与Win10下，Docker安装自带了docker-compose的二进制文件，可以直接使用。
Linux下，

1
2
3
[root@iZwz ~]# curl -L "https://github.com/docker/compose/releases/download/1.24.1/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

[root@iZwz ~]# chmod +x /usr/local/bin/docker-compose

验证

1
2
3
4
5
[root@iZwz ~]# docker-compose version
docker-compose version 1.24.1, build 4667896b
docker-py version: 3.7.3
CPython version: 3.6.8
OpenSSL version: OpenSSL 1.1.0j  20 Nov 2018

3. Compose模板文件

模板文件是使用Compose的核心，定义了一组相关联的应用容器，使之构成一个项目，里面大部分指令跟docker run相关参数的含义是类似的。默认的模板文件名称为docker-compose.yml，为YAML格式，如

1
2
3
4
5
6
7
8
9
10
11
12
13
version: '3'
services:
    web:
        build: .
        depends_on:
            - db
            - redis
    
    redis:
        image: redis
    
    db:
        image: mysql

Compose模板文件可以动态读取主机的系统环境变量与当前目录下.env文件中的变量，通过${xx}引用。

模板文件中的常用指令说明

  • build
    指定Dockerfile所在文件夹的路径，可以是绝对路径或相对模板文件的路径。Compose将会自动构建镜像，然后使用该镜像。也可以通过如下方式详细指定。cache_from指定构建镜像的缓存

    1
    2
    3
    4
    5
    6
    7
    8
    build:
        context: ./dir
        dockerfile: Dockerfile-alternate
        args:
            buildno: 1
        cache_from:
            - alpine:latest
            - corp/web_app:3.14

  • command
    覆盖容器启动后默认执行的命令。

  • container_name
    Compose默认会使用 项目名称服务名称序号的格式作为容器名称。一般不需要特别指定，因为指定具体名称后，服务将无法进行扩展（scale），因为不允许多个容器具有相同的名称。

  • depends_on
    解决容器的依赖、启动先后顺序的问题，但是服务不会等待依赖的服务“完全启动”之后才启动。

  • env_file
    指定环境变量定义文件，可以为单独文件路径或列表，当与environment中有同名冲突时，以environment为准。

  • environment
    设置环境变量，支持数组或字典两种格式。只有名称的变量会自动获取运行Compose主机上的对应变量的值，以防止信息泄露

    1
    2
    3
    4
    5
    6
    7
    environment:
        RACK_ENV: development
        SESSION_SECRET:

    environment:
        - RACK_ENV=development
        - SESSION_SECRET

  • expose
    暴露端口，不映射到宿主机，只被连接的服务访问

  • healthcheck
    通过命令检查容器是否健康运行，如

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

  • image
    指定镜像名称或镜像ID，所有服务都必要要么通过build，要么通过image来指定镜像。

  • labels
    为容器添加Docker元数据信息

  • network_mode
    设置网络模式，与docker run的–network一样，如bridge，host，none等，也可以是如下形式

    1
    2
    network_mode: "service:[service name]"
    network_mode: "container:[container name/id]"

  • networks
    配置容器连接的网络，如

    1
    2
    3
    4
    5
    6
    7
    8
    services:
        service1:
            networks:
                - some-network
                - other-network
    networks:
        some-network:
        other-network:

  • ports
    暴露端口信息，遵循端口映射规则。

  • secrets
    存储敏感数据，如密码等信息

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    mysql:
        image: mysql
        environment:
            MYSQL_ROOT_PASSWORD_FILE: /run/secrets/db_root_password
        secrets:
            - db_root_password
            - my_other_secret

    secrets:
        my_secret:
            file: ./my_secret.txt
        my_other_secret:
            external: true

  • volumes
    容器的数据卷挂在路径设置，可以设置多个，与docker -v类似，如

    1
    2
    3
    4
    volumes:
        - /var/lib/mysql
        - cache/:/tmp/cache
        - ~/configs:/etc/configs/:ro

4. Compose命令

Compose命令默认是针对项目本身，也可以指定为项目中的服务或容器。
docker-compose 命令的基本使用格式为

1
docker-compose [-f=<arg>...] [options] [COMMAND] [ARGS...]

命令选项

  • -f, –file 指定模板文件，默认为docker-compose.yml，可多次指定
  • -p, –project-name 指定项目名称，默认为所在目录名称
  • –x-networking 使用Docker的可插拔网络特性
  • –x-networking-driver 指定网络驱动，默认为bridge
  • –verbose 输出更多调试信息
  • -v, –version 打印版本信息

命令使用说明

  • build 格式为docker-compose build [options] [SERVICE...]，构建项目中的服务容器，选项包括 –force-rm（删除构建过程中的临时容器），–no-cache（构建镜像过程不使用cache），–pull（始终尝试通过pull来获取最新版本镜像）
  • config 验证模板文件格式是否正确
  • down 停止up命令启动的容器，并移除网络
  • exec 进入指定的容器
  • images 列出compose文件中包含的镜像
  • kill 格式为docker-compose kill [options] [SERVICE...]，强制停止服务容器
  • logs 格式为docker-compose logs [options] [SERVICE...]，查看服务容器的输出
  • pause 格式为docker-compose pause [SERVICE...]， 暂停一个服务容器
  • port 格式为docker-compose port [options] SERVICE PRIVATE_PORT，打印容器端口所映射的公共端口，–index=index（指定容器序号，默认为1）
  • ps 格式为docker-compose ps [options] [SERVICE...]，列出项目中目前的所有容器
  • pull 格式为docker-compose pull [options] [SERVICE...]，拉去服务依赖的镜像
  • push 推送服务依赖的镜像到Docker镜像仓库
  • restart 重启项目中服务，格式为docker-compose restart [options] [SERVICE...]
  • rm 删除所有停止的服务容器，格式docker-compose rm [options] [SERVICE...]， -f（强制直接删除）
  • run 在指定服务上执行一个命令，不会自动创建端口，以避免冲突
  • scale 格式docker-compose scale [options] [SERVICE=NUM...]，设置指定服务运行的容器个数，少则新建，多则删除
  • start 格式docker-compose start [SERVICE...]，启动已经存在的服务容器
  • stop 停止运行中的容器
  • top 查看各个服务容器内运行的进程
  • unpause 格式docker-compose unpause [SERVICE...]，恢复处于暂停状态的服务
  • up 格式docker-compose up [options] [SERVICE...]，尝试自动完成包括构建镜像，创建服务，启动服务，关联服务相关容器的一系列操作，大部分时候都可以通过该命令来启动一个项目，-d（在后台启动所有容器）。docker-compose up --no-recreate只启动处于停止状态的容器，忽略已经运行的服务，docker-compose up --no-deps -d <SERVICE_NAME>重新创建服务，但不影响到它所依赖的服务

5. 总结

Compose是Docker官方的服务容器编排工具，对一些简单的但包含多个组件的服务可以借助Compose来快速搭建环境，如开源的错误监控系统sentry，包括sentry服务本身，redis，postgres。对于业务生产环境，则一般使用功能更为丰富的第三方编排系统如Kubernetes来部署。



欢迎关注我的微信公众号：jboost-ksxy
———————————————————————————————————————————————————————————————
微信公众号