Docker 三剑客(三):Docker-Compose 创建容器
Docker-compose(创建容器)
样例
1 | version: "2" |
docker-compose 命令
大多数 Compose
命令都是运行于一个或多个服务的,如果服务没有指定,该命令将会应用到所有服务,
如果要获得所有可用信息,使用命令:docker-compose [COMMAND] –help,下面是命令(COMMAND)的说明:
build
创建或者再建服务
服务被创建后会标记为 project_service
(比如 composetest_db
),
如果改变了一个服务的 Dockerfile 或者构建目录的内容,可以使用 docker-compose build
来重建它
help
显示命令的帮助和使用信息
kill
通过发送 SIGKILL
的信号强制停止运行的容器,这个信号可以选择性的通过,比如:
1 | docker-compose kill -s SIGKINT |
logs
显示服务的日志输出
port
为端口绑定输出公共信息
ps
显示容器
pull
拉取服务镜像
rm
删除停止的容器
run
在服务上运行一个一次性命令,比如:
docker-compose run web python manage.py shell
scale
设置为一个服务启动的容器数量,数量是以这样的参数形式指定的:service=num
,比如:
docker-compose scale web=2 worker=3
start
启动已经存在的容器作为一个服务
stop
停止运行的容器而不删除它们,它们可以使用命令docker-compose start
重新启动起来
up
为一个服务构建、创建、启动、附加到容器
连接的服务会被启动,除非它们已经在运行了
默认情况下,docker-compose up
会集中每个容器的输出,当存在时,所有的容器会停止,运行 docker-compose up -d
会在后台启动容器并使它们运行
默认情况下,如果服务存在容器的话,docker-compose up
会停止并再创建它们(使用了 volumes-from
会保留已挂载的卷),
如果不想使容器停止并再创建的话,使用docker-compose up --no-recreate
,如果有需要的话,这会启动任何停止的容器
选项
–verbose
显示更多输出
–version
显示版本号并退出
-f,–file FILE
指定一个可选的 Compose yaml
文件(默认:docker-compose.yml
)
-p,–project-name NAME
指定可选的项目名称(默认:当前目录名称)
docker-compose.yaml 文件说明
每一个定义在 docker-compose.yml
中的服务必须明确指定一个 image
或者 build
选项,
这与 docker run
命令行中输入的是对应相同的,对于docker run
,
在 Dockerfile
文件中指定的选项(比如 CMD
、EXPOSE
、VOLUME
、ENV
)是默认的,因此不必在 docker-compose.yml
中再指定一次
image
标明 image 的 ID,这个 image ID 可以是本地也可以是远程的,如果本地不存在,Compose 会尝试去 pull
下来
1 | image: ubuntu |
build
该参数指定 Dockerfile
文件的路径,该目录也是发送到守护进程的构建环境(这句有点),Compose 将会以一个已存在的名称进行构建并标记,并随后使用这个 image
1 | build: /path/to/build/dir |
command
覆盖容器启动后默认执行的命令
1 | command: bundle exec thin -p 3000 |
links
连接到其他服务中的容器,可以指定服务名称和这个链接的别名,或者只指定服务名称
1 | links: |
此时,在容器内部,会在 /etc/hosts 文件中用别名创建一个条目,就像这样:
1 | 172.17.2.186 db |
环境变量也会被创建,关于环境变量的参数,会在后面讲到
external_links
连接到在这个 docker-compose.yml 文件或者 Compose 外部启动的容器,特别是对于提供共享和公共服务的容器。
在指定容器名称和别名时,external_links
遵循着和 links
相同的语义用法
1 | external_links: |
ports
暴露端口信息。
使用宿主:容器 (HOST:CONTAINER)格式或者仅仅指定容器的端口(宿主将会随机选择端口)都可以。
1 | ports: |
注:当使用 HOST:CONTAINER
格式来映射端口时,如果你使用的容器端口小于 60 你可能会得到错误得结果,
因为 YAML 将会解析 xx:yy
这种数字格式为 60 进制。所以建议采用字符串格式。
expose
暴露端口而不必向主机发布它们,而只是会向链接的服务 linked service
提供,只有内部端口可以被指定
1 | expose: |
volumes
挂载路径最为卷,可以选择性的指定一个主机上的路径(主机:容器
),或是一种可使用的模式(主机:容器:ro
)
1 | volumes: |
volumes_from
从另一个服务或容器挂载它的所有卷。
1 | volumes_from: |
environment
加入环境变量,可以使用数组或者字典,只有一个 key 的环境变量可以在运行 Compose 的机器上找到对应的值,这有助于加密的或者特殊主机的值
1 | environment: |
env_file
从文件中获取环境变量,可以为单独的文件路径或列表。
如果通过 docker-compose -f FILE
指定了模板文件,则 env_file
中路径会基于模板文件路径。
如果有变量名称与 environment
指令冲突,则以后者为准。
1 | env_file: |
net
网络模式,可以在docker客户端
的--net
参数中指定这些值
1 | net: "bridge" |
dns
自定义DNS服务,可以是一个单独的值或者一张列表
1 | dns: 8.8.8.8 |
cap_add,cap_drop
加入或者去掉容器能力,查看man 7 capabilities
可以有一张完整的列表
1 | cap_add: |
dns_search
自定义DNS搜索范围,可以是单独的值或者一张列表
1 | dns_search: example.com |
working_dir,entrypoint,user,hostname,domainname,mem_limit,privileged,restart,stdin_open,tty,cpu_shares
上述的每一个都只是一个单独的值,和docker run中对应的参数是一样的
1 | cpu_shares: 73 |
Compose 环境变量说明
环境变量已经不再是用来连接服务的推荐方法了,相反,应该使用链接名称(默认情况下是链接服务的名称)作为主机名称来连接,这可以查看 docker-compose.yaml 的更多细节
Compose 使用 Docker links 来暴露服务的容器给其他的。每一个链接的容器都使用了一组环境变量,这每一组环境变量都是以容器名称的大写字母开头的
要查看服务可用的环境变量,运行 docker-compose run SERVICE env
name_PORT
完整URL,如:
1 | DB_PORT=tcp//172.17.0.5:5432 |
name_PORT_num_protocol
完整URL,如:
1 | DB_PORT_5432_TCP=tcp://172.17.0.5:5432 |
name_PORT_num_protocol_ADDR
容器的IP地址,如:
1 | DB_PORT_5432_TCP_ADDR=172.17.0.5 |
name_PORT_num_protocol_PORT
暴露的端口号,如:
1 | DB_PORT_5432_TCP_PORT=5432 |
name_PORT_num_protocol_PROTO
协议(tcp或者udp),如:
1 | DB_PORT_5432_TCP_PROTO=tcp |
name_NAME
完全合格的容器名称,如:
1 | DB_1_NAME=/myapp_web_1/myapp_db_1 |