Merge pull request #296 from khs1994/master

pull/298/head
Baohua Yang 2017-12-17 13:39:32 +08:00 committed by GitHub
commit ba0b55101c
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 82 additions and 21 deletions

View File

@ -73,7 +73,7 @@
* [安装与卸载](compose/install.md)
* [使用](compose/usage.md)
* [命令说明](compose/commands.md)
* [YAML 模板文件](compose/yaml_file.md)
* [Compose 模板文件](compose/compose_file.md)
* [实战 Django](compose/django.md)
* [实战 Rails](compose/rails.md)
* [实战 WordPress](compose/wordpress.md)

View File

@ -27,7 +27,39 @@ services:
指定 `Dockerfile` 所在文件夹的路径(可以是绝对路径,或者相对 docker-compose.yml 文件的路径)。 `Compose` 将会利用它自动构建这个镜像,然后使用这个镜像。
```yaml
build: /path/to/build/dir
version: '3'
services:
webapp:
build: ./dir
```
你也可以使用 `context` 指令指定 `Dockerfile` 所在文件夹的路径。
使用 `dockerfile` 指令指定 `Dockerfile` 文件名。
使用 `arg` 指令指定构建镜像时的变量。
```yaml
version: '3'
services:
webapp:
build:
context: ./dir
dockerfile: Dockerfile-alternate
args:
buildno: 1
```
使用 `cache_from` 指定构建镜像的缓存
```yaml
build:
context: .
cache_from:
- alpine:latest
- corp/web_app:3.14
```
### `cap_add, cap_drop`
@ -78,7 +110,7 @@ cgroup_parent: cgroups_1
container_name: docker-web-container
```
需要注意,指定容器名称后该服务将无法进行扩展scale因为 Docker 不允许多个容器具有相同的名称。
>注意: 指定容器名称后该服务将无法进行扩展scale因为 Docker 不允许多个容器具有相同的名称。
### `deploy`
@ -114,6 +146,8 @@ services:
image: postgres
```
>注意:`web` 服务不会等待 `redis` `db` 「完全启动」之后才启动。
### `dns`
自定义 `DNS` 服务器。可以是一个值,也可以是一个列表。
@ -189,9 +223,7 @@ environment:
- SESSION_SECRET
```
注意,如果变量名称或者值中用到 `true|falseyes|no` 等表达布尔含义的词汇,最好放到引号里,避免 YAML 自动解析某些内容为对应的布尔语义。
`http://yaml.org/type/bool.html` 中给出了这些特定词汇,包括
如果变量名称或者值中用到 `true|falseyes|no` 等表达 [布尔](http://yaml.org/type/bool.html) 含义的词汇,最好放到引号里,避免 YAML 自动解析某些内容为对应的布尔语义。这些特定词汇,包括
```bash
y|Y|yes|Yes|YES|n|N|no|No|NO|true|True|TRUE|false|False|FALSE|on|On|ON|off|Off|OFF
@ -211,7 +243,9 @@ expose:
### `external_links`
链接到 docker-compose.yml 外部的容器,甚至并非 `Compose` 管理的外部容器。参数格式跟 `links` 类似。
>注意:不建议使用该指令。
链接到 `docker-compose.yml` 外部的容器,甚至并非 `Compose` 管理的外部容器。
```yaml
external_links:
@ -272,7 +306,7 @@ labels:
### `links`
不推荐使用该指令。
>注意:不推荐使用该指令。
### `logging`
@ -303,7 +337,7 @@ options:
### `network_mode`
设置网络模式。使用和 `docker run``--net` 参数一样的值。
设置网络模式。使用和 `docker run``--network` 参数一样的值。
```yaml
network_mode: "bridge"
@ -343,7 +377,7 @@ pid: "host"
暴露端口信息。
使用宿主:容器 `HOST:CONTAINER`格式,或者仅仅指定容器的端口(宿主将会随机选择端口)都可以。
使用宿主端口:容器端口 `(HOST:CONTAINER)` 格式,或者仅仅指定容器的端口(宿主将会随机选择端口)都可以。
```yaml
ports:
@ -357,7 +391,26 @@ ports:
### `secrets`
仅用于 `Swarm mode`,详细内容请查看 [`Swarm mode`](../swarm_mode/) 一节。
存储敏感数据,例如 `mysql` 服务密码。
```bash
version: "3"
services:
mysql:
image: mysql
environment:
MYSQL_ROOT_PASSWORD_FILE: /run/secrets/db_root_password
secrets:
- db_root_password
- my_other_secret
secrets:
my_secret:
file: ./my_secret.txt
my_other_secret:
external: true
```
### `security_opt`
@ -448,12 +501,6 @@ hostname: test
mac_address: 08-00-27-00-0C-0A
```
指定容器中
```yaml
ipc: host
```
允许容器中运行一些特权命令。
```yaml
@ -478,21 +525,35 @@ read_only: true
stdin_open: true
```
模拟一个假的远程控制台
模拟一个伪终端
```yaml
tty: true
```
### 读取环境变量
### 读取变量
Compose 模板文件支持动态读取主机的系统环境变量。
Compose 模板文件支持动态读取主机的系统环境变量和当前目录下的 `.env` 文件中的变量
例如,下面的 Compose 文件将从运行它的环境中读取变量 ${MONGO_VERSION} 的值,并写入执行的指令中。
例如,下面的 Compose 文件将从运行它的环境中读取变量 `${MONGO_VERSION}` 的值,并写入执行的指令中。
```yaml
version: "3"
services:
db:
image: "mongo:${MONGO_VERSION}"
```
如果执行 `MONGO_VERSION=3.2 docker-compose up` 则会启动一个 `mongo:3.2` 镜像的容器;如果执行 `MONGO_VERSION=2.8 docker-compose up` 则会启动一个 `mongo:2.8` 镜像的容器。
若当前目录存在 `.env` 文件,执行 `docker-compose` 命令时将从该文件中读取变量。
在当前目录新建 `.env` 文件并写入以下内容。
```bash
# 支持 # 号注释
MONGO_VERSION=3.6
```
执行 `docker-compose up` 则会启动一个 `mongo:3.6` 镜像的容器。