1. 背景
Docker Compose是一个用来定义和运行复杂应用的Docker工具。使用Compose,你可以在一个文件中定义一个多容器应用,然后使用一条命令来启动你的应用,完成一切准备工作。
Docker Compose使用yml文件格式定义描述。
2. 安装方式
* 离线安装
下载可执行文件至执行目录
1
|
[root@docker-compose ~]
# curl -L https://github.com/docker/compose/releases/download/1.14.0-rc2/docker-compose-`uname -s`-`uname -m` > /root/docker-compose
|
添加可执行权限
1
|
[root@docker-compose ~]
# chmod +x /usr/local/bin/docker-compose
|
查看 docker-compose 版本
1
2
3
4
5
|
[root@docker-compose ~]
# ./docker-compose version
docker-compose version 1.14.0-rc2, build 24dae73
docker-py version: 2.3.0
CPython version: 2.7.13
OpenSSL version: OpenSSL 1.0.1t 3 May 2016
|
* python-pip安装
安装python-pip
1
|
[root@docker-compose ~]
# yum install python-pip -y
|
pip 自升级
1
2
3
4
5
6
7
8
9
|
[root@docker-compose ~]
# pip install --upgrade pip
Collecting pip
Downloading pip-9.0.1-py2.py3-none-any.whl (1.3MB)
100% |████████████████████████████████| 1.3MB 431kB
/s
Installing collected packages: pip
Found existing installation: pip 8.1.2
Uninstalling pip-8.1.2:
Successfully uninstalled pip-8.1.2
Successfully installed pip-9.0.1
|
安装 docker-compose
1
|
[root@docker-compose ~]
# pip install docker-compose
|
查看 docker-compose 版本
1
2
3
4
5
|
[root@docker-compose ~]
# docker-compose version
docker-compose version 1.13.0, build 1719ceb
docker-py version: 2.3.0
CPython version: 2.7.5
OpenSSL version: OpenSSL 1.0.1e-fips 11 Feb 2013
|
3. docker-compose文件内容区域
* services : 服务,定义应用需要的一些服务,每个服务都有自己的名字、使用的镜像、挂载的数据卷、所属的网络、依赖哪些其他服务等等
* networks : 网络,定义应用的名字、使用的网络类型等等
* volumes : 数据卷,定义的数据卷(名字等等),然后挂载到不同的服务下去使用
4. docker-compose 实战 [ 多 web ] [ dockerfile 相关文章有介绍 ]
* 构建 nginx dockerfile 文件
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
|
#Nginx
#Version 1.0.1
#Author lisea
#Base image
FROM centos:7
#Maintainer
MAINTAINER lisea cnlisea@126.com
#Commands
RUN rpm -ivh http:
//mirrors
.aliyun.com
/epel/epel-release-latest-7
.noarch.rpm
RUN yum
install
-y nginx
RUN
echo
"daemon off;"
>>
/etc/nginx/nginx
.conf
EXPOSE 80
CMD [
"nginx"
]
|
* 通过 dockerfile 文件构建镜像
1
|
[root@docker nginx]
# docker build -t lisea/nginx:v1.0.1 .
|
* 查看镜像
1
2
3
4
|
[root@docker nginx]
# docker images
REPOSITORY TAG IMAGE ID CREATED SIZE
lisea
/nginx
v1.0.1 ced9cfbd138f 23 minutes ago 387.2 MB
docker.io
/centos
7 3bee3060bfc8 12 days ago 192.5 MB
|
* 构建 docker-compose 文件
volumes中挂载的目录当宿主机不存在时,会自动创建
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
|
version:
'2'
services:
web1:
image: lisea
/nginx
:v1.0.1
volumes:
-
/data/www1
:
/usr/share/nginx/html
ports:
-
"8080:80"
web2:
image: lisea
/nginx
:v1.0.1
volumes:
-
/data/www2
:
/usr/share/nginx/html
ports:
-
"8081:80"
web3:
image: lisea
/nginx
:v1.0.1
volumes:
-
/data/www3
:
/usr/share/nginx/html
ports:
-
"8082:80"
|
* 使用docker-compose 开始构建容器
up 构建运行
-d 后台运行
1
2
3
4
5
6
7
8
|
[root@docker nginx]
# docker-compose up -d
Creating network
"nginx_default"
with the default driver
Creating nginx_web2_1 ...
Creating nginx_web3_1 ...
Creating nginx_web1_1 ...
Creating nginx_web2_1
Creating nginx_web3_1
Creating nginx_web1_1 ...
done
|
* 查看容器状态
1
2
3
4
5
6
|
[root@docker nginx]
# docker-compose ps
Name Command State Ports
-----------------------------------------------------
nginx_web1_1 nginx Up 0.0.0.0:8080->80
/tcp
nginx_web2_1 nginx Up 0.0.0.0:8081->80
/tcp
nginx_web3_1 nginx Up 0.0.0.0:8082->80
/tcp
|
* 向web挂载目录添加内容
1
2
3
|
[root@harbor nginx]
# echo "1 web" > /data/www1/index.html
[root@harbor nginx]
# echo "2 web" > /data/www2/index.html
[root@harbor nginx]
# echo "3 web" > /data/www3/index.html
|
* curl 访问测试
1
2
3
4
5
6
|
[root@docker nginx]
# curl http://127.0.0.1:8080
1 web
[root@docker nginx]
# curl http://127.0.0.1:8081
2 web
[root@docker nginx]
# curl http://127.0.0.1:8082
3 web
|
* 查看容器日志
1
2
|
[root@docker nginx]
# docker-compose logs
Attaching to nginx_web3_1, nginx_web1_1, nginx_web2_1
|
* 停止并清除容器[ 需在docker-compose.yml文件同目录下,或 -f 指定docker-compose.yml路径 ]
1
2
3
4
5
6
7
8
|
[root@docker nginx]
# docker-compose down
Stopping nginx_web1_1 ...
done
Stopping nginx_web3_1 ...
done
Stopping nginx_web2_1 ...
done
Removing nginx_web1_1 ...
done
Removing nginx_web3_1 ...
done
Removing nginx_web2_1 ...
done
Removing network nginx_default
|
5. docker-compose.yml 内容相关
* image:指定镜像,如果本地不存在,Compose会尝试去docker hub pull下来
1
2
3
|
image: centos
image: orchardup
/postgresql
image: a4bc65fd
|
* build:指定Dockerfile文件的路径,Compose将会以一个已存在的名称进行构建并标记,并随后使用这个image
1
|
build:
/path/to/build/dir
|
* command:重写默认的命令
1
|
command
: bundle
exec
thin -p 3000
|
* links 连接到其他服务中的容器,可以指定服务名称和这个链接的别名,或者只指定服务名称
1
2
3
4
|
links:
- db
- db:database
- redis
|
* external_links:连接到在这个docker-compose.yml文件或者Compose外部启动的容器,特别是对于提供共享和公共服务的容器。在指定容器名称和别名时,external_links遵循着和links相同的语义用法
1
2
3
4
|
external_links:
- redis_1
- project_db_1:mysql
- project_db_1:postgresql
|
* ports:暴露端口,指定两者的端口(主机:容器),或者只是容器的端口(主机会被随机分配一个端口)
1
2
3
4
5
|
ports:
-
"3000"
-
"8000:8000"
-
"49100:22"
-
"127.0.0.1:8001:8001"
|
* expose:暴露端口而不必向主机发布它们,而只是会向链接的服务(linked service)提供,只有内部端口可以被指定
1
2
3
|
expose:
-
"3000"
-
"8000"
|
* volumes:挂载路径最为卷,可以选择性的指定一个主机上的路径(主机:容器),或是一种可使用的模式(主机:容器:ro)
1
2
3
|
volumes:
-
/data/www
:
/usr/share/nginx/html
- container_name
|
* environment:加入环境变量,可以使用数组或者字典,只有一个key的环境变量可以在运行Compose的机器上找到对应的值,这有助于加密的或者特殊主机的值
1
2
3
4
5
6
|
environment:
RACK_ENV: development
SESSION_SECRET:
environments:
- RACK_ENV=development
- SESSION_SECRET
|
* env_file:从一个文件中加入环境变量,该文件可以是一个单独的值或者一张列表,在environment中指定的环境变量将会重写这些值
1
2
3
4
|
env_file:
- .
env
RACK_ENV: development
|
* net: 网络模式,可以在docker客户端的--net参数中指定这些值
1
2
3
4
|
net:
"bridge"
net:
"none"
net:
"container:[name or id]"
net:
"host"
|
* dns 自定义DNS服务,可以是一个单独的值或者一张列表
1
2
3
4
|
dns: 8.8.8.8
dns:
- 8.8.8.8
- 9.9.9.9
|
* dns_search 自定义DNS搜索范围,可以是单独的值或者一张列表
1
2
3
4
|
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中对应的参数是一样的
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
|
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
|
6. 总结