docker-compose.yml参考

在docker-compose.yml定义的服务都需要指明image 或build键值。其他键值是可选的,和docker run命令行的类似。

Image

标记或者偏镜像iD,可以是本地或者远程的——如果本地不存在Compose将试着pull

  1. image: ubuntu
  2. image: orchardup/postgresql
  3. image: a4bc65fd

Build

Dockerfile目录。也是后台进程所需的构建环境。Compose将建立并生成一个名字标记它,会在以后用到。

  1. build: /path/to/build/dir

Command

覆盖默认命令

  1. command: bundle exec thin -p 3000

其他服务到容器的连接,指定服务名字和别名,或者仅仅服务名字(会被别名所用)

  1. links: - db
  2. - db:database
  3. - redis

容器服务的别名键将被创建,如

  1. 172.17.2.186 db
  2. 172.17.2.186 database
  3. 172.17.2.187 redis

环境变量也会被建立,详见 environment variable reference .

对不在docker-compose.yml 或者Compose的容器的链接,尤其是提供共享或者相同服务的容器。指明容器名字和链接别名时external_links 和links语法像似。

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

ports

暴露端口。

Expose ports. 可以指定两端的端口(HOST:CONTAINER), 或者仅仅容器端口(主机端口会被随机选择).

注意:以HOST:CONTAINER 格式映射端口时,如果用小于60的端口,可能会产生错误结果,因为YAML会以xx:yy 的格式按60进制解析端口号。因此,推荐显示以字符串指定端口映射

ports: - “3000” - “8000:8000” - “49100:22” - “127.0.0.1:8001:8001”

Expose

暴露端口号而不将其发布到主机——他们只会被关联的服务访问。只能指定内部端口。

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

Volumes

卷挂载路径,可选地指定一个主机路径(HOST:CONTAINER)或者一种访问模式(HOST:CONTAINER:ro).

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

volumes_from

挂载另一个服务或者容器的所有卷

  • container_name

environment

添加环境变量。可以使用数字或者字典形式。仅存在键的环境变量会在Compose运行的 主机上被解析,这会在使用秘密值或者主机指定值时有用。

  1. environment: RACK_ENV: development
  2. SESSION_SECRET:
  3. environment: - RACK_ENV=development
  4. - SESSION_SECRET

env_file

从文件添加环境变量。可以是一个单值或者一个列表。如果用docker-compose -f FILE指定Compose 文件,env_file 中 的路径就是文件所在路径。环境中指定的环境变量会覆盖这些值。

  1. env_file: .env
  2. env_file: - ./common.env
  3. - ./apps/web.env
  4. - /opt/secrets.env
  5. RACK_ENV: development

Extends

继承当前文件或者其他文件的服务,可以申明覆盖配置。这里有一个简单的例子。假设有两个文件common.yml 和 development.yml.,可以在development.yml 继承common.yml:定义一个服务。

  1. common.yml
  2. webapp: build: ./webapp
  3. environment: - DEBUG=false - SEND_EMAILS=false
  4. development.yml
  5. web: extends: file: common.yml
  6. service: webapp
  7. ports: - "8000:8000" links: - db
  8. environment: - DEBUG=truedb: image: postgres

下面,development.yml 中的web服务继承common.yml 中的web服务的 build 和 environment 键,自己添加了ports 和 links 配置。覆盖了一个环境变量(DEBUG) 而另一个环境变量(SEND_EMAILS)没变。 只需如下定义:

  1. web: build: ./webapp
  2. ports: - "8000:8000" links: - db
  3. environment: - DEBUG=true - SEND_EMAILS=false

继承选项对应用间共享配置,或者在不同环境配置app时非常好。可以编写新的文件staging.yml,,其中绑定端口,不开启调试:

  1. web: extends: file: common.yml
  2. service: webapp
  3. ports: - "80:8000" links: - db
  4. db: image: postgres

注意: 继承服务时, links 和volumes_from configuration options 不被继承,需要手动配置。

net

网络模式。使用docker客户端相同的值。—net parameter.

  1. net: "bridge"net: "none"net: "container:[name or id]"net: "host"

dns

用户DNS服务器,可以是单值或者列表。

  1. dns: 8.8.8.8dns: - 8.8.8.8 - 9.9.9.9

cap_add, cap_drop

增删容器能力。全部列表见man 7 capabilities

  1. cap_add: - ALL
  2. cap_drop: - NET_ADMIN
  3. - SYS_ADMIN

配置DNS搜索域可以是单值或者列表。

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

working_dir, entrypoint, user, hostname, domainname, mem_limit, privileged, restart, stdin_open, tty, cpu_shares

均为单值,和 docker run 的相似.

  1. cpu_shares: 73
  2. working_dir: /code
  3. entrypoint: /code/entrypoint.sh
  4. user: postgresql
  5. hostname: foo
  6. domainname: foo.com
  7. mem_limit: 1000000000privileged: true
  8. restart: always
  9. stdin_open: truetty: true