基于 Docker18.09.0 docker-compose version 1.23.1
简单介绍
Compose
项目是 Docker 官方的开源项目,负责实现对 Docker 容器集群的快速编排。
其定位是: 定义和运行多个 Docker 容器的应用,其前身是开源项目 Fig
。
一个正常的生产环境的项目,一般都包含的负载均衡器,应用程序和数据库。
之前我们都是把每个应用定义在 Dockerfile 中,之后使用在命令中一个一个构建和运行,比如之前我和大家分享的 ELK 容器化中。部署起来不但繁琐,而且容易出错。有没有一种方案,可以把他们整合到一起,一起进行维护和启动呢?应该他们是一个集群嘛。答案肯定是有的,这就是 Compose`。
Compose
使用一个具有 YAML
风格的文件来实现,这个文件一般叫做 docker-compose.yml
。通过编写这个文件来定义一组相互之间有关联的应用容器。
概念
Compose
中有两个比较重要的概念: 服务service
和 项目 project
。
服务 service
就是一个应用容器,实际上可以包含多个使用相同镜像运行的容器实例。
项目 project
就是由组织相互关联的应用容器组成的一个完整的业务单元。
Compose
的默认管理对象是 项目,由 Python
编写,通过调用 Docker 服务提供的 API 实现。
安装和卸载
安装
Mac
和 Windows
系统,只要安装了 Docker,默认就会有 docker-compose
。
下面只讨论 Linux
环境下的安装,建议采用下载二进制的方式进行安装。
1. 下载二进制文件到指定的目录下
sudo curl -L "https://github.com/docker/compose/releases/download/1.23.1/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
更多版本见github
2. 对二进制文件添加可执行权限
sudo chmod +x /usr/local/bin/docker-compose
3. 添加命令行的自动补全等功能
BASH
sudo curl -L https://raw.githubusercontent.com/docker/compose/1.23.1/contrib/completion/bash/docker-compose -o /etc/bash_completion.d/docker-compose
ZSH
$ mkdir -p ~/.zsh/completion
$ curl -L https://raw.githubusercontent.com/docker/compose/1.23.1/contrib/completion/zsh/_docker-compose > ~/.zsh/completion/_docker-compose
之后在 ~/.zshrc
中添加如下内容
fpath=(~/.zsh/completion $fpath)
autoload -Uz compinit && compinit -i
然后重新加载你的shell:
exec $SHELL -l
4. 测试
$ docker-compose --version
ocker-compose version 1.23.1, build b02f1306
docker-py version: 3.5.0
CPython version: 3.6.7
OpenSSL version: OpenSSL 1.1.0f 25 May 2017
卸载
要卸载直接删除二进制文件即可
sudo rm /usr/local/bin/docker-compose
从简单示例开始使用 Compose
以非 root
用户运行,参考以非root用户身份管理Docker
1. 准备数据
a. 为整个项目创建目录,以便管理
$ mkdir composetest
$ cd composetest
b. 在项目的目录下编辑 app.py
文件,并粘贴以下内容
import time
import redis
from flask import Flask
app = Flask(__name__)
cache = redis.Redis(host='redis', port=6379)
def get_hit_count():
retries = 5
while True:
try:
return cache.incr('hits')
except redis.exceptions.ConnectionError as exc:
if retries == 0:
raise exc
retries -= 1
time.sleep(0.5)
@app.route('/')
def hello():
count = get_hit_count()
return 'Hello World! I have been seen {} times.\n'.format(count)
if __name__ == "__main__":
app.run(host="0.0.0.0", debug=True)
在此示例中,redis是应用程序网络上redis容器的主机名。我们使用Redis的默认端口6379。
处理瞬态错误
请注意get_hit_count函数的编写方式。如果redis服务不可用,这个基本的重试循环允许我们多次尝试我们的请求。这在应用程序联机时启动时非常有用,但如果需要在应用程序生命周期内的任何时间重新启动Redis服务,这也会使我们的应用程序更具弹性。在群集中,这还有助于处理节点之间的瞬时连接丢弃。
c. 在项目目录下编辑另一个文件 requirements.txt
flask
redis
此文件定义了一个
Python
应用程序需要的依赖模块。
2. 创建Dockerfile
在此步骤中,您将编写一个用于构建 Docker 镜像的 Dockerfile
。该镜像包含Python应用程序所需的所有依赖项,包括Python本身。
在项目目录中,创建一个名为的文件Dockerfile并粘贴以下内容:
FROM python:3.6-alpine
ADD . /code
WORKDIR /code
RUN pip install -r requirements.txt
CMD ["python", "app.py"]
3. 在Compose文件中定义服务
在项目目录下创建一个名字为 docker-compose.yml
的文件并粘贴以下内容:
version: '3'
services:
web:
build: .
ports:
- "5000:5000"
redis:
image: "redis:alpine"
此Compose文件定义了两个服务,
web
和redis
。该web
服务:
- 使用从当前目录中的
Dockerfile
构建镜像。- 将容器上的公开端口5000转发到主机上的端口5000。我们使用Flask Web服务器的默认端口
5000
。该
redis
服务使用从Docker Hub 注册仓库中提取的公共 Redis映像。
4. 使用Compose构建并运行您的应用程序
$ docker-compose up
5. 编辑Compose文件以添加一个 bind mount
编辑docker-compose.yml
在项目目录添加bind mount的web
服务:
version: '3'
services:
web:
build: .
ports:
- "5000:5000"
volumes:
- .:/code
redis:
image: "redis:alpine"
6. 使用Compose重新构建并运行应用程序
使用Compose重新构建并运行应用程序
$ docker-compose up
7. 尝试更新应用程序
由于应用程序代码现在使用卷安装到容器中,因此您可以更改其代码并立即查看更改,而无需重建映像。
a. 更改问候语app.py并保存。例如,将Hello World!
信息更改为Hello from Docker!
:
return 'Hello from Docker! I have been seen {} times.\n'.format(count)
b. 在浏览器中刷新应用程序。问候语应该更新,计数器仍然应该递增
8. 尝试其他一些命令
a. 后台运行
$ docker-compose up -d
b. 查看目前运行的容器
$ docker-compose ps
c. 查看 web
服务的环境变量
$ docker-compose run web env
d. 停止服务
$ docker-compose stop
e. 完全删除容器。传递 --volumes
还删除Redis容器使用的数据卷:
$ docker-compose down --volumes
更多请参考官方文档
水平扩展和负载均衡
使用 up
子命令中的 --scale
可以实现对一个服务数量的限制。
命令格式如下:
docker-compose up [--scale SERVICE=NUM...] [SERVICE...]