build:./dirbuild:context:./dirdockerfileockerfile-alternateargs:buildno:1context为路径,dockerfile为需要替换默认docker-compose的文件名,args为构建(build)过程中的环境变量,用于替换Dockerfile里定义的ARG参数,容器中不可用。示例:
Dockerfile:
ARGbuildnoARGpasswordRUNecho"Buildnumberbuildno"RUNscript-requiring-password.sh"$password"docker-compose.yml:
build:context:.args:buildno:1password:secretbuild:context:.args:-buildno=1-password=secret
command用来覆盖缺省命令。示例:
command:bundleexecthin-p3000command也支持数组形式:
command:[bundle,exec,thin,-p,3000]links用于链接另一容器服务,如需要使用到另一容器的mysql服务。可以给出服务名和别名;也可以仅给出服务名,这样别名将和服务名相同。同docker run --link。示例:
links:-db-db:mysql-redis使用了别名将自动会在容器的/etc/hosts文件里创建相应记录:
172.17.2.186db172.17.2.186mysql172.17.2.187redis所以我们在容器里就可以直接使用别名作为服务的主机名。
ports用于暴露端口。同docker run -p。示例:
ports:-"3000"-"8000:8000"-"49100:22"-"127.0.0.1:8001:8001"exposeexpose提供container之间的端口访问,不会暴露给主机使用。同docker run --expose。
expose:-"3000"-"8000"volumes挂载数据卷。同docker run -v。示例:
volumes:-/var/lib/mysql-cache/:/tmp/cache-~/configs:/etc/configs/:rovolumes_from挂载数据卷容器,挂载是容器。同docker run --volumes-from。示例:
volumes_from:-service_name-service_name:ro-container:container_name-container:container_name:rwcontainer:container_name格式仅支持version 2。
environment添加环境变量。同docker run -e。可以是数组或者字典格式:
environment:RACK_ENV:developmentSESSION_SECRET:environment:-RACK_ENV=development-SESSION_SECRETdepends_on使用 Compose 时,最大的好处就是少打启动命令,但是一般项目容器启动的顺序是有要求的,如果直接从上到下启动容器,必然会因为容器依赖问题而启动失败。
例如在没启动数据库容器的时候启动了应用容器,这时候应用容器会因为找不到数据库而退出,为了避免这种情况我们需要加入一个标签,就是depends_on,这个标签解决了容器的依赖、启动先后的问题。
例如下面容器会先启动redis 和 db 两个服务,最后才启动 web 服务:
ersion:'2'services:web:build:.depends_on:-db-redisredis:image:redisdb:image:postgres注意的是,默认情况下使用 docker-compose up web 这样的方式启动 web 服务时,也会启动 redis 和 db 两个服务,因为在配置文件中定义了依赖关系。
external_links链接搭配docker-compose.yml文件或者Compose之外定义的服务,通常是提供共享或公共服务。格式与links相似:
external_links:-redis_1-project_db_1:mysql-project_db_1:postgresql注意,external_links链接的服务与当前服务必须是同一个网络环境。
extra_hosts添加主机名映射。
extra_hosts:-"somehost:162.242.195.82"-"otherhost:50.31.209.229将会在/etc/hosts创建记录:
162.242.195.82somehost50.31.209.229otherhostextends继承自当前yml文件或者其它文件中定义的服务,可以选择性的覆盖原有配置。
extends:file:common.ymlservice:webappservice必须有,file可选。service是需要继承的服务,例如web、database。
net设置网络模式。同docker的--net参数。
net:"bridge"net:"none"net:"container:[nameorid]"net:"host"dns自定义dns服务器。
dns:8.8.8.8dns:-8.8.8.8-9.9.9.9完整列子: