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:
  5. environment:
  6. - RACK_ENV=development
  7. - SHOW=true
  8. - SESSION_SECRET

(6) env_file

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

  1. env_file: .env
  2. env_file:
  3. - ./common.env # 共用
  4. - ./apps/web.env # web用
  5. - /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
  4. # Specify an absolute path mapping
  5. - /opt/data:/var/lib/mysql
  6. # Path on the host, relative to the Compose file
  7. - ./cache:/tmp/cache
  8. # User-relative path
  9. - ~/configs:/etc/configs/:ro
  10. # Named volume
  11. - 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/

本文首发

http://www.itmuch.com/docker/22-docker-compose-yml-commands/

作者:周立_itmuch
链接:https://www.jianshu.com/p/92ae57e4d91a
来源:简书
著作权归作者所有。商业转载请联系作者获得授权,非商业转载请注明出处。