学习技能光看不做是不行的,强烈推荐按照教程敲一遍 https://docs.docker.com/compose/gettingstarted/

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

本人提炼出了几点技巧:

  1. 多用 docker-compose config 命令校验和查看配置信息, 当修改了docker-compose.yml文件,不要急于执行docker-compose up启动,可以先检查下配置。很多时候是yml格式不规范导致的。
  2. docker-compose up docker-compose up 包含了构建镜像,创建服务,启动服务等一系列操作。一般配好文件执行这个命令就可以了。
  3. 使用.env环境变量配置文件 一些敏感信息如,数据库密码等不建议写死到docker-compose.yml中,可以写在.env环境配置文件中(使用Laravel的同学对这个文件肯定不陌生)。

因为docker-compose.yml一般跟随项目受版本控制,.env可以不受版本控制。 优化前: docker-compose.yml

  mysql:
      build: ./docker-build/mysql
      ports:
        - "33060:3306"
      volumes:
        - ./docker-build/mysql/data:/var/lib/mysql
      environment:
        MYSQL_ROOT_PASSWORD: 123456
1
2
3
4
5
6
7
8

优化后: 同级目录建立.env文件

  mysql:
      build: ./docker-build/mysql
      ports:
        - "33060:3306"
      volumes:
        - ./docker-build/mysql/data:/var/lib/mysql
      environment:
       # 先从.env找DOCKER_MYSQL_PASSPORD,找不到使用后面的默认值
        MYSQL_ROOT_PASSWORD: ${DOCKER_MYSQL_PASSPORD-123456}
1
2
3
4
5
6
7
8
9

.env

# define env var default value.
DOCKER_MYSQL_PASSPORD=root
1
2
  1. 使用docker-compose.yml中的env_file语法 service节点下支持 env_file属性,即环境变量从额外的文件中读取。 如下面的例子,如果local.env和common.env有相同key。则下面的优先级高。
  php:
      build:
        context: ./docker-build/php
        args:
          - INSTALL_COMPOSER=${PHP_INSTALL_COMPOSER}
          - INSTALL_MONGO=${PHP_INSTALL_MONGO}
          - INSTALL_REDIS=${PHP_INSTALL_REDIS}
          - INSTALL_XDEBUG=${PHP_INSTALL_XDEBUG}
      ports:
        - "9001:9000"
      links:
        - "mysql"
      volumes:
        - .:/www
      env_file:
        - ./common.env
        - ./local.env
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

假设 local.env 中内容是A:1,common.env 是 A:2

      environment:
        A: 3
      env_file:
        - ./common.env
        - ./local.env
1
2
3
4
5

最终生效的是 A:3

  1. 配置不同场景下的环境变量 我们可以把不同场景下的环境变量定义在不同的 shell 脚本中并导出, 然后在执行 docker-compose 命令前先执行 source 命令把 shell 脚本中定义的环境变量导出到当前的 shell 中。 通过这样的方式可以减少维护环境变量的地方,下面的例子中我们分别在 docker-compose.yml 文件所在的目录创建 test.shprod.shtest.sh 的内容如下:
#!/bin/bash
# define env var default value.
export IMAGETAG=web:v1
export APPNAME=HelloWorld
export AUTHOR=Nick Li
export VERSION=1.0
1
2
3
4
5
6

prod.sh 的内容如下:

#!/bin/bash
# define env var default value.
export IMAGETAG=webpord:v1
export APPNAME=HelloWorldProd
export AUTHOR=Nick Li
export VERSION=1.0LTS
1
2
3
4
5
6

在测试环境下,执行下面的命令:

$ source test.sh
$ docker-compose config
1
2

image.png

此时 docker-compose.yml 中的环境变量应用的都是测试环境相关的设置。 而在生产环境下,执行下面的命令:

image.png

此时 docker-compose.yml 中的环境变量应用的都是生产环境相关的设置。

  1. 环境变量的优先级 docker-compose.yml 文件中引用的环境变量,它们的优先级如下:
  • Compose file
  • Shell environment variables
  • Environment file
  • Dockerfile
  • Variable is not defined

首先,在 docker-compose.yml 文件中直接设置的值优先级是最高的。 然后是在当前 shell 中 export 的环境变量值。 接下来是在环境变量文件中定义的值。 再接下来是在 Dockerfile 中定义的值。 最后还没有找到相关的环境变量就认为该环境变量没有被定义。

额外内容,使用 extends 继承扩展docker-compose.yml 基于其他模板文件进行扩展 。 例如,我们已经有了一个 webapp 服务,定义一个基础模板文件为 common.yml,如下所示: common.yml:

webapp
  build : . /webapp 
  environment:
    - DEBUG=false
    - SEND EMAILS=false
1
2
3
4
5

再编写一个新的 development .yml 文件,使用 common.yml 中的 webapp 服务进行扩展:

development .yml:

web:
  extends:
    file: common .yml
    service: webapp 
    ports :
      - "8000:8000" 
    links:
      - db environment:
      - DEBUG=true 
  db:
    image : postgres
1
2
3
4
5
6
7
8
9
10
11

后者会自动继承common.yml中的webapp服务及环境变量定义。 使用extends需要注意以下两点:

  • 要避免出现循环依赖,例如 A 依赖 B, B 依赖 C, C 反过来依赖 A 的情况 。
  • extends 不会继承 links 和 volumes_from 中定义的容器和数据卷资源 。 一般情况下,推荐在基础模板中只定义一些可以共享的镜像和环境变量,在扩展模板中 具体指定应用变量、链接、数据卷等信息 。

TIP

RUN vs CMD vs ENTRYPOINT 的区别

  1. Dockerfile中,在基础镜像上安装软件使用 RUN
  2. CMD命令是当Docker镜像被启动后Docker容器将会默认执行的命令。一个Dockerfile中只能有一个CMD命令。通过执行docker run $image $other_command启动镜像可以重载CMD命令。
  3. 使用 docker-compose run 命令可以在服务上运行一次性命令,如 docker-compose run web env 查看服务为web的环境变量

image.png

# 参考:

  • https://www.cnblogs.com/sparkdev/p/9826520.html
  • https://docs.docker.com/compose/reference/envvars/
  • https://docs.docker.com/compose/environment-variables/
上次更新: 9/8/2019, 9:59:21 PM