Docker-Compose
我们使用 Docker 的时候,定义 Dockerfile 文件,然后使用 docker build、docker run 等命令操作容器。然而微服务架构的应用系统一般包含若干个微服务,每个微服务一般都会部署多个实例,如果每个微服务都要手动启停,那么效率之低,维护量之大可想而知。那有没有一种方式能让我们的项目快速启动呢?
然而使用 Docker Compose 可以轻松、高效的管理容器,它是一个用于定义和运行多容器 Docker 的应用程序工具。
Docker Compose 的安装
Docker Desktop for Mac/Windows 自带 Docker Compose 二进制文件,安装 Docker 之后可以直接使用。由于笔者的环境是Linux,所以我们只讲述Linux的安装方法。
Docker Compose 在Linux的安装非常简单,我们只需要下载编译好的二进制文件并为脚本添加可执行权限即可:
sudo curl -L https://github.com/docker/compose/releases/download/1.29.1/docker-compose-Linux-x86_64 > /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose
安装完成后,我们可以使用docker-compose -v
命令来查看Docker Compose是否安装成功。
如何使用docker compose
- Docker Compose 将所管理的容器分为三层,分别是工程(project)、服务(service)、容器(container)
- Docker Compose 运行目录下的所有文件(docker-compose.yml)组成一个工程,一个工程包含多个服务,每个服务中定义了容器运行的镜像、参数、依赖,一个服务可包括多个容器实例。
- 使用Compose 基本上分为三步
(1)Dockerfile 定义应用的运行环境
(2)docker-compose.yml 定义组成应用的各服务
(3)docker-compose up 启动整个应用 - 下面我们运行一个 compose 项目来实时更新网页被访问次数:
- 创建一个测试目录:
mkdir test
cd test
- 在测试目录中创建一个名为 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)
- 在test目录中创建另一个名为 requirements.txt 的文件,内容如下:
flask
redis
- 创建 Dockerfile 文件
FROM python:3.7-alpine
WORKDIR /code
ENV FLASK_APP app.py
ENV FLASK_RUN_HOST 0.0.0.0
RUN apk add --no-cache gcc musl-dev linux-headers
COPY requirements.txt requirements.txt
RUN pip install -r requirements.txt
COPY . .
CMD ["flask", "run"]
- 创建 docker-compose.yml
# yaml 配置
version: '3'
services:
web:
build: .
ports:
- "5000:5000"
redis:
image: "redis:alpine"
- 使用 Compose 命令构建和运行您的应用
在测试目录中,执行以下命令来启动应用程序:
docker-compose up
但是直接通过这种方式的话会直接将启动时的输出打印到终端,所以我们常会加上-d参数采用后台启动方式。
bash docker-compose up -d
docker-compose.yml 属性
- version:指定 docker-compose.yml 文件的写法格式
- services:多个容器集合
- build:配置构建时,Compose 会利用它自动构建镜像,该值可以是一个路径,也可以是一个对象,用于指定 Dockerfile 所在文件夹的路径。
- depends_on:解决容器的依赖、启动先后的问题。
- command:覆盖容器启动后默认执行的命令
- dns:配置 dns 服务器,可以是一个值或列表
- dns_search:配置 DNS 搜索域,可以是一个值或列表
- environment:环境变量配置,可以用数组或字典两种方式,只给定名称的变量会自动获取运行 Compose 主机上对应变量的值,可以用来防止泄露不必要的数据。
- env_file:从文件中获取环境变量,可以指定一个文件路径或路径列表,其优先级低于 environment 指定的环境变量
- expose:暴露端口,只将端口暴露给连接的服务,而不暴露给主机,只被连接的服务访问。仅可以指定内部端口为参数
- ports:对外暴露的端口定义,和 expose 对应
- secrets:存储敏感数据,例如 mysql 服务密码、
- image:指定为镜像名称或镜像 ID。如果镜像在本地不存在,Compose 将会尝试拉取这个镜像
- labels:为容器添加 Docker 元数据(metadata)信息。例如可以为容器添加辅助说明信息
- network_mode:设置网络模式。使用和
docker run
的--networ
参数一样的值。 - networks:配置容器连接的网络。
- volumes:数据卷所挂载路径设置。可以设置为宿主机路径(HOST:CONTAINER)或者数据卷名称(VOLUME:CONTAINER),并且可以设置访问模式 (HOST:CONTAINER:ro)。该指令中路径支持相对路径。
- logs:日志输出信息
Compose命令
up
该命令十分强大,它将尝试自动完成包括构建镜像,(重新)创建服务,启动服务,并关联服务相关容器的一系列操作。
链接的服务都将会被自动启动,除非已经处于运行状态。可以说,大部分时候都可以直接通过该命令来启动一个项目。
默认情况,docker-compose up 启动的容器都在前台,控制台将会同时打印所有容器的输出信息,可以很方便进行调试。
当通过 Ctrl-C 停止命令时,所有容器将会停止。
默认情况,如果服务容器已经存在,docker-compose up 将会尝试停止容器,然后重新创建(保持使用 volumes-from 挂载的卷),以保证新启动的服务匹配 docker-compose.yml 文件的最新内容。如果用户不希望容器被停止并重新创建,可以使用 docker-compose up --no-recreate
。这样将只会启动处于停止状态的容器,而忽略已经运行的服务。如果用户只想重新部署某个服务,可以使用 docker-compose up --no-deps -d
来重新创建服务并后台停止旧服务,启动新服务,并不会影响到其所依赖的服务。
docker-compose up [options] [--scale SERVICE=NUM...] [SERVICE...]
选项包括:
- -d 在后台运行服务容器
- –no-color 不使用颜色来区分不同的服务的控制输出
- –no-deps 不启动服务所链接的容器
- –force-recreate 强制重新创建容器,不能与–no-recreate同时使用
- –no-recreate 如果容器已经存在,则不重新创建,不能与–force-recreate同时使用
- –no-build 不自动构建缺失的服务镜像
- –build 在启动容器前构建服务镜像
- –abort-on-container-exit 停止所有容器,如果任何一个容器被停止,不能与-d同时使用
- -t, –timeout TIMEOUT 停止容器时候的超时(默认为10秒)
- –remove-orphans 删除服务中没有在compose文件中定义的容器
- –scale SERVICE=NUM 设置服务运行容器的个数,将覆盖在compose中通过scale指定的参数
其他命令本文不再详写,如需学习请查看:Docker-compose 常用命令
使用Docker-Compose做负载均衡:
- 因为本机上的5000端口,只能分配给一个service,如果你想同时在本机上调试,可以将上面的ports改为5000,修改后的docker-compose文件如下:
# yaml 配置
version: '3'
services:
web:
build: .
ports:
- "5000:5000"
redis:
image: "redis:alpine"
此时会有3个不同的本机端口绑定到容器的5000端口
2. 使用Haproxy
- 安装haproxy:
Ubuntu安装只需使用如下命令即可安装Haporxy
apt-get install haproxy
修改docker-compose.yml文件
# yaml 配置
version: '3'
services:
web:
build: .
ports:
- "5000:5000"
redis:
image: "redis:alpine"
web2:
build: .
ports:
- "5000:5000"
redis:
image: "redis:alpine
haproxy:
image: haproxy:latest
volumes:
- ./haproxy/haproxy.cfg:/usr/local/etc/haproxy/haproxy.cfg:ro
links:
- web1
- web2
ports:
- "5000:5000"
expose:
- 5000
本文只讲述此案例,更多Haproxy用法和配置文件详解请看HAProxy用法详解 全网最详细中文文档