Docker学习总结(42)——Docker Compose 入门学习

版权声明:本文为博主原创文章,未经博主允许不得转载。 https://blog.csdn.net/u012562943/article/details/86221778

一、Docker Compose介绍

Compose 是 Docker 公司推出的一个工具软件,可以管理多个 Docker 容器组成一个应用(称为一个 project,即项目)。Compose 定位是“Define and run multi-container applications with Docker”,其前身是 Fig,兼容 Fig 的模板文件。你需要定义一个 YAML 格式的配置文件docker-compose.yml,写好多个容器之间的调用关系。然后,只要一个命令,就能同时启动/关闭这些容器。Docker Compose是一个用来定义和运行复杂应用的Docker工具。一个使用Docker容器的应用,通常由多个容器组成。使用Docker Compose不再需要使用shell脚本来启动容器。 Compose 通过一个配置文件来管理多个Docker容器,在配置文件中,所有的容器通过services来定义,然后使用docker-compose脚本来启动,停止和重启应用,和应用中的服务以及所有依赖服务的容器,非常适合组合使用多个容器进行开发的场景。

二、Docker Compose安装

安装步骤请参考:Docker Compose安装

三、Compose使用实例

在本例中将会实现启动nginx服务及一个数据卷容器,并将该数据卷容器作为nginx的静态文件 
1、创建compose文件夹 
sudo mkdir composetest 
cd composetest 
2、创建docker-compose.yml文件 
touch docker-compose.yml 
vim docker-compose.yml 
在docker-compose.yml中输入以下内容:

dvc:  
  image: debian:wheezy
  volumes:  
   - /www:/usr/share/nginx/html:ro

nginx:
  image: nginx:latest
  volumes_from:
   - dvc
  ports:
   - "8081:80"

3、启动 
docker-compose up -d 
注:使用命令docker-compose ps查看运行状况

四、CLI 说明(docker-compose 命令)

大多数Compose命令都是运行于一个或多个服务的,如果服务没有指定,该命令将会应用到所有服务,如果要获得所有可用信息,使用命令:docker-compose [COMMAND] --help,下面是命令(COMMAND)的说明:

build :创建或者再建服务 
服务被创建后会标记为project_service(比如composetest_db),如果改变了一个服务的Dockerfile或者构建目录的内容,可以使用docker-compose build来重建它

help :显示命令的帮助和使用信息

kill :通过发送SIGKILL的信号强制停止运行的容器,这个信号可以选择性的通过,比如: 
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.yml命令说明

每一个定义在docker-compose.yml中的服务必须明确指定一个image或者build选项,这与docker run命令行中输入的是对应相同的,对于docker run,在Dockerfile文件中指定的选项(比如CMD、EXPOSE、VOLUME、ENV)是默认的,因此不必在docker-compose.yml中再指定一次

image :标明image的ID,这个image ID可以是本地也可以是远程的,如果本地不存在,Compose会尝试去pull下来

image: ubuntu  
image: orchardup/postgresql  
image: a4bc65fd 

build :该参数指定Dockerfile文件的路径,该目录也是发送到守护进程的构建环境(这句有点),Compose将会以一个已存在的名称进行构建并标记,并随后使用这个image

build: /path/to/build/dir  
command :重写默认的命令

command: bundle exec thin -p 3000  
links :连接到其他服务中的容器,可以指定服务名称和这个链接的别名,或者只指定服务名称

links:  
 - db  
 - db:database  
 - redis  

此时,在容器内部,会在/etc/hosts文件中用别名创建一个条目,就像这样:

172.17.2.186  db  
172.17.2.186  database  
172.17.2.186  redis  

环境变量也会被创建,关于环境变量的参数,会在后面讲到

external_links 
连接到在这个docker-compose.yml文件或者Compose外部启动的容器,特别是对于提供共享和公共服务的容器。在指定容器名称和别名时,external_links遵循着和links相同的语义用法

external_links:  
 - redis_1  
 - project_db_1:mysql  
 - project_db_1:postgresql  
ports 

暴露端口,指定两者的端口(主机:容器),或者只是容器的端口(主机会被随机分配一个端口)

注:当以 主机:容器 的形式来映射端口时,如果使容器的端口小于60,那可能会出现错误,因为YAML会将 xx:yy这样格式的数据解析为六十进制的数据,基于这个原因,时刻记得要将端口映射明确指定为字符串

ports:  
 - "3000"  
 - "8000:8000"  
 - "49100:22"  
 - "127.0.0.1:8001:8001" 
expose 

暴露端口而不必向主机发布它们,而只是会向链接的服务(linked service)提供,只有内部端口可以被指定

expose:  
 - "3000"  
 - "8000"  
volumes 

挂载路径最为卷,可以选择性的指定一个主机上的路径(主机:容器),或是一种可使用的模式(主机:容器:ro)

volumes_from:  
 - service_name  
 - container_name 
environment 

加入环境变量,可以使用数组或者字典,只有一个key的环境变量可以在运行Compose的机器上找到对应的值,这有助于加密的或者特殊主机的值

environment:  
  RACK_ENV: development  
  SESSION_SECRET:  
environments:  
  - RACK_ENV=development  
  - SESSION_SECRET  
env_file 

从一个文件中加入环境变量,该文件可以是一个单独的值或者一张列表,在environment中指定的环境变量将会重写这些值

env_file:  
  - .env  
RACK_ENV: development  
net 

网络模式,可以在docker客户端的--net参数中指定这些值

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

自定义DNS服务,可以是一个单独的值或者一张列表

dns: 8.8.8.8  
dns:  
  - 8.8.8.8  
  - 9.9.9.9  
cap_add,cap_drop 

加入或者去掉容器能力,查看man 7 capabilities 可以有一张完整的列表

cap_add:
  - ALL  

cap_drop:  
  - NET_ADMIN  
  - SYS_ADMIN  
dns_search 
自定义DNS搜索范围,可以是单独的值或者一张列表

dns_search: example.com  
dns_search:  
  - dc1.example.com  
  - dc2.example.com  
working_dir,entrypoint,user,hostname,domainname,mem_limit,privileged,restart,stdin_open,tty,cpu_shares 

上述的每一个都只是一个单独的值,和docker run中对应的参数是一样的

cpu_shares: 73

working_dir: /code
entrypoint: /code/entrypoint.sh
user: postgresql

hostname: foo
domainname: foo.com

mem_limit: 1000000000
privileged: true

restart: always

stdin_open: true
tty: true  

六、Compose环境变量说明

环境变量已经不再是用来连接服务的推荐方法了,相反,应该使用链接名称(默认情况下是链接服务的名称)作为主机名称来连接,这可以查看docker-compose.yml的更多细节 
Compose使用Docker links来暴露服务的容器给其他的。每一个链接的容器都使用了一组环境变量,这每一组环境变量都是以容器名称的大写字母开头的 
要查看服务可用的环境变量,运行docker-compose run SERVICE env

name_PORT 
完整URL,如:DB_PORT=tcp//172.17.0.5:5432

name_PORT_num_protocol 
完整URL,如:DB_PORT_5432_TCP=tcp://172.17.0.5:5432

name_PORT_num_protocol_ADDR 
容器的IP地址,如:DB_PORT_5432_TCP_ADDR=172.17.0.5

name_PORT_num_protocol_PORT 
暴露的端口号,如:DB_PORT_5432_TCP_PORT=5432

name_PORT_num_protocol_PROTO 
协议(tcp或者udp),如:DB_PORT_5432_TCP_PROTO=tcp

name_NAME 
完全合格的容器名称,如:DB_1_NAME=/myapp_web_1/myapp_db_1

猜你喜欢

转载自blog.csdn.net/u012562943/article/details/86221778