• docker-compose.yml常用命令
    • (1) build
    • (2) command
    • (3) dns
    • (4) dns_search
    • (5) environment
    • (6) env_file
    • (7) expose
    • (8) external_links
    • (9) image
    • (10) links
    • (11) networks
    • (12) network_mode
    • (13) ports
    • (14) volumes
    • (15) volumes_from
    • TIPS

    docker-compose.yml常用命令

    docker-compose.yml是Compose的默认模板文件。该文件有多种写法，例如Version 1 file format、Version 2 file format、Version 2.1 file format、Version 3 file format等。其中，Version 1 file format将逐步被被弃用；Version 2.x及Version 3.x基本兼容，是未来的趋势。考虑到目前业界的使用情况，本节只讨论Version 2 file format下的常用命令。

    (1) build

    配置构建时的选项，Compose会利用它自动构建镜像。build的值可以是一个路径，例如：

    1. build: ./dir

    也可以是一个对象，用于指定Dockerfile和参数，例如：

    1. build:
    2.   context: ./dir
    3.   dockerfile: Dockerfile-alternate
    4.   args:
    5.     buildno: 1

    (2) command

    覆盖容器启动后默认执行的命令。示例：

    1. command: bundle exec thin -p 3000

    也可以是一个list，类似于Dockerfile中的CMD指令，格式如下：

    1. command: [bundle, exec, thin, -p, 3000]

    (3) dns

    配置dns服务器。可以是一个值，也可以是一个列表。示例：

    1. dns: 8.8.8.8
    2. dns:
    3.   - 8.8.8.8
    4.   - 9.9.9.9

    (4) dns_search

    配置DNS的搜索域名，可以是一个值，也可以是一个列表。示例：

    1. dns_search: example.com
    2. dns_search:
    3.   - dc1.example.com
    4.   - dc2.example.com

    (5) environment

    环境变量设置，可使用数组或字典两种方式。示例：

    1. environment:
    2.   RACK_ENV: development
    3.   SHOW: 'true'
    4.   SESSION_SECRET:
    6. environment:
    7.   - RACK_ENV=development
    8.   - SHOW=true
    9.   - SESSION_SECRET

    (6) env_file

    从文件中获取环境变量，可指定一个文件路径或路径列表。如果通过 docker-compose -f FILE 指定了Compose文件，那么env_file中的路径是Compose文件所在目录的相对路径。使用environment指定的环境变量会覆盖env_file指定的环境变量。示例：

    1. env_file: .env
    3. env_file:
    4.   - ./common.env   # 共用
    5.   - ./apps/web.env # web用
    6.   - /opt/secrets.env # 密码用

    (7) expose

    暴露端口，只将端口暴露给连接的服务，而不暴露给宿主机。示例：

    1. expose:
    2.  - "3000"
    3.  - "8000"

    (8) external_links

    连接到docker-compose.yml外部的容器，甚至并非Compose管理的容器，特别是提供共享或公共服务的容器。格式跟links类似，例如：

    1. external_links:
    2.  - redis_1
    3.  - project_db_1:mysql
    4.  - project_db_1:postgresql

    (9) image

    指定镜像名称或镜像id，如果本地不存在该镜像，Compose会尝试下载该镜像。

    示例：

    1. image: java

    (10) links

    连接到其他服务的容器。可以指定服务名称和服务别名（ SERVICE:ALIAS ），也可只指定服务名称。例如：

    1. web:
    2.   links:
    3.    - db
    4.    - db:database
    5.    - redis

    (11) networks

    详见本书《Docker Compose网络设置》一节。

    (12) network_mode

    设置网络模式。示例：

    1. network_mode: "bridge"
    2. network_mode: "host"
    3. network_mode: "none"
    4. network_mode: "service:[service name]"
    5. network_mode: "container:[container name/id]"

    (13) ports

    暴露端口信息，可使用HOST:CONTAINER 的格式，也可只指定容器端口（此时宿主机将会随机选择端口），类似于docker run -p 。

    需要注意的是，当使用HOST:CONTAINER 格式映射端口时，容器端口小于60将会得到错误的接口，因为yaml会把xx:yy 的数字解析为60进制。因此，建议使用字符串的形式。示例：

    1. ports:
    2.  - "3000"
    3.  - "3000-3005"
    4.  - "8000:8000"
    5.  - "9090-9091:8080-8081"
    6.  - "49100:22"
    7.  - "127.0.0.1:8001:8001"
    8.  - "127.0.0.1:5000-5010:5000-5010"

    (14) volumes

    卷挂载路径设置。可以设置宿主机路径 （HOST:CONTAINER） ，也可指定访问模式 （HOST:CONTAINER:ro）。示例：

    1. volumes:
    2.   # Just specify a path and let the Engine create a volume
    3.   - /var/lib/mysql
    5.   # Specify an absolute path mapping
    6.   - /opt/data:/var/lib/mysql
    8.   # Path on the host, relative to the Compose file
    9.   - ./cache:/tmp/cache
    11.   # User-relative path
    12.   - ~/configs:/etc/configs/:ro
    14.   # Named volume
    15.   - datavolume:/var/lib/mysql

    (15) volumes_from

    从另一个服务或容器挂载卷。可指定只读（ro）或读写（rw），默认是读写（rw）。示例：

    1. volumes_from:
    2.  - service_name
    3.  - service_name:ro
    4.  - container:container_name
    5.  - container:container_name:rw

    TIPS

    (1) docker-compose.yml还有很多其他命令，比如depends_on、pid、devices等。限于篇幅，笔者仅挑选常用的命令进行讲解，其他命令不作赘述。感兴趣的读者们可参考官方文档：https://docs.docker.com/compose/compose-file/ 。