Docker-Compose
一、Docker-Compose 简介
Docker-Compose项目是Docker官方的开源项目,负责实现对Docker容器集群的快速编排。
Docker-Compose将所管理的容器分为三层,分别是 工程(project),服务(service)以及容器(container)。
Docker-Compose运行目录下的所有文件(docker-compose.yml,extends文件或环境变量文件等)组成一个工程,若无特殊指定工程名即为当前目录名。
一个工程当中可包含多个服务,每个服务中定义了容器运行的镜像、参数、依赖。一个服务当中可包括多个容器实例,Docker-Compose并没有解决负载均衡的问题,因此需要借助其它工具实现服务发现及负载均衡,比如 Consul。
Docker-Compose的工程配置文件默认为docker-compose.yml,可通过环境变量COMPOSE_FILE或-f参数自定义配置文件,其定义了多个有依赖关系的服务及每个服务运行的容器。
使用一个Dockerfile模板文件,可以让用户很方便的定义一个单独的应用容器。
在工作中,经常会碰到需要多个容器相互配合来完成某项任务的情况。例如要实现一个Web项目,除了Web服务容器本身,往往还需要再加上后端的数据库服务容器,甚至还包括负载均衡容器等。
Compose允许用户通过一个单独的docker-compose.yml模板文件(YAML 格式)来定义一组相关联的应用容器为一个项目(project)。
Docker-Compose项目由Python编写,调用Docker服务提供的API来对容器进行管理。因此,只要所操作的平台支持Docker API, 就可以在其上利用Compose来进行编排管理
二、YAML 文件格式及编写注意事项
YAML 是一种标记语言,它可以很直观的展示数据序列化格式,可读性高。类似于 XML数据描述语言,语法比 XML 简单的很多。
YAML 数据结构通过缩进来表示,连续的项目通过减号来表示,键值对用冒号分隔,数组用中括号 [] 括起来, hash 用花括号 {} 括起来
三、数据及结构
1. 对象映射
键值对的字典
animal: pets
2. 序列数组
一组按次序排序的列表
- Cat
- Dog
- Golodfish
["Cat","Dog","Golodfish"]
3. 布尔值
debug:true
debug:false
4. 示例
# yaml 格式
languages: #序列的映射
- Java
- Golang
- Python
websites: #映射的映射
cpu: 2
memory: 1024M
swap: 2048M
disk: 60G
zhongbo:
yunjisuan:
- yunyuansheng
- devops
- sre
houduan:
- java
- spingcould
- spingboot
键:{值}
# Json 格式
{
languages: [
'Java',
'Golang',
'Python'
],
resources: {
cpu: '2',
memory: '1024M',
swap: '2048M',
disk: '60G'
}
}
baidu:
www.baidu.com
tenxun: www.qq.com
wangyi: www.163.com
四、Docker Compose 配置常用字段
字段 | 描述 |
---|---|
build | 指定 Dockerfile 文件名,要指定Dockerfile文件需要在build标签的子级标签中使用dockerfile标签指定 |
dockerfile | 构建镜像上下文路径 |
context | 可以是 dockerfile 的路径,或者是指向 git 仓库的 url 地址 |
image | 指定镜像 |
command | 执行命令,覆盖默认命令 |
container name | 指定容器名称,由于容器名称是唯一的,如果指定自定义名称,则无法 scale(水平扩展) |
deploy | 指定部署和运行服务相关配置,只能在 Swarm 模式使用 |
environment | 添加环境变量 |
networks | 加入网络 |
ports | 暴露容器端口,与 -p 相同,但端口不能低于 60 |
volumes | 挂载宿主机路径或命令卷 |
hostname | 容器主机名 |
restart | 重启策略,默认 no,always,no-failure,unless-stoped no,默认策略,在容器退出时不重启容器。 on-failure,在容器非正常退出时(退出状态非0),才会重启容器。 on-failure:3,在容器非正常退出时重启容器,最多重启3次。 always,在容器退出时总是重启容器。 unless-stopped,在容器退出时总是重启容器,但是不考虑在 Docker 守护进程启动时就已经停止了的容器 |
depends_on | 在使用Compose时,最大的好处就是少打启动命令,但一般项目容器启动的顺序是有要求的,如果直接从上到下启动容器,可能会因为容器依赖问题而启动失败。例如在没启动数据库容器的时候启动应用容器,应用容器会因为找不到数据库而退出。depends_on标签用于解决容器的依赖、启动先后的问题。 php: depends_on: - apache - mysql |
五、Docker Compose 常用命令
命令 | 描述 |
---|---|
build | 重新构建服务 |
ps | 列出容器 |
up | 创建和启动容器 |
exec | 在容器里面执行命令 |
scale | 指定一个服务器启动数量 |
top | 显示容器进程 |
logs | 查看容器输出 |
down | 删除容器、网络、数据卷和镜像 |
stop/start/restart | 停止/启动/重启服务 |
六、Docker Compose 文件结构
yum install -y tree
tree /opt/compose_nginx
/opt/compose_nginx/
├── docker-compose.yml # 创建模板脚本
├── nginx
│?? ├── Dockerfile # 创建容器脚本
│?? ├── nginx-1.12.0.tar.gz # 复制源码包
│?? └── run.sh # 启动服务脚本
└── wwwroot
└── index.html # 站点网页
七、Docker Compose 环境部署
Docker Compose 是 Docker 的独立产品,因此需要安装 Docker 之后在单独安装 Docker Compose
1. 下载
在Linux上我们可以从GitHub上下载它的二进制包来使用,此命令是下载Docker Compose的当前稳定版本
curl -L https://github.com/docker/compose/releases/download/1.21.1/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-compose
2. 安装
chmod +x /usr/local/bin/docker-compose
3. 查看版本
docker-compose --verserion
八、Docker Compose 部署 Nginx
1. 准备nginx安装包
mkdir -p /opt/compose_nginx/nginx /opt/compose_nginx/wwwroot
cd /opt/compose_nginx/nginx
# 上传 Nginx 安装包 nginx-1.12.0.
rz -E
2. 准备依赖文件
(1)run.sh
vim run.sh
#!/bin/bash
/usr/local/nginx/sbin/nginx
(2)Dockerfile
vim Dockerfile
# 基于基础镜像
FROM centos:7
# 维护者信息
MAINTAINER this is nginx image <mz>
# 添加环境包
RUN yum -y update
RUN yum -y install pcre-devel zlib-devel gcc gcc-c++ make
RUN useradd -M -s /sbin/nologin nginx
# 上传 nginx 软件压缩包,并解压
ADD nginx-1.12.0.tar.gz /usr/local/src/
# 指定工作目录
WORKDIR /usr/local/src/nginx-1.12.0
RUN ./configure \
--prefix=/usr/local/nginx \
--user=nginx \
--group=nginx \
--with-http_stub_status_module
# 编译及安装
RUN make && make install
# 环境变量
ENV PATH /usr/local/nginx/sbin:$PATH
# 指定 http 和 https 端口
EXPOSE 80
EXPOSE 443
# 关闭 nginx 后台运行(守护进程)
RUN echo "daemon off;" >> /usr/local/nginx/conf/nginx.conf
# 方法一:
# 添加宿主机中的 run.sh 到容器中
ADD run.sh /run.sh
RUN chmod 755 /run.sh
CMD ["/run.sh"]
# 方法二:
# 使用方法二不需要准备 run.sh 文件
ENTRYPOINT [ "/usr/local/nginx/sbin/nginx", "-g", "daemon off;" ]
(3)前端页面 index.php
echo "<h1>this is test web</h1>" > /opt/compose_nginx/wwwroot/index.html
3. 编写配置文件 docker-compose.yml
vim /opt/compose_nginx/docker-compose.yml
# 指定docker-compose版本为3
version: '3'
services:
# 定义一个名为 nginx 的服务
nginx:
# 设置容器名称为 web1
container_name: web1
# 设置主机名为 nginx
hostname: nginx
# 构建镜像
build:
# 设置上下文路径为 ./nginx,及Dockerfile所在目录
context: ./
# 指定 Dockerfile 文件名为 Dockerfile
dockerfile: Dockerfile
# 端口映射
ports:
# 将主机的 1314 端口映射到容器的 80 端口
- 1314:80
# 将主机的 520 端口映射到容器的 443 端口
- 520:443
# 网络设置
networks:
# 连接到名为 lnmp 的网络
lnmp:
# 指定容器的ip地址为 172.18.0.10
ipv4_address: 172.18.0.10
# 卷挂载
volumes:
# 将主机的 ./wwwroot 目录挂载到容器的 /usr/local/nginx/html 的目录
- ./wwwroot:/usr/local/nginx/html
# 网络定义
networks:
# 定义名为 lnmp 的网络
lnmp:
# 使用 bridge 网络驱动
driver: bridge
# IP 地址管理
ipam:
# 配置 IP 地址
config:
# 设置子网为 172.18.0.0/16
- subnet: 172.18.0.0/16
4. 部署并运行 compose
cd /opt/compose_nginx/
docker-compose -f docker-compose.yml up -d
docker ps
-f
--file FILE :使用特定的 compose 模板文件,默认为 docker-compose.yml
-p
--project-name NAME :指定项目名称,默认使用目录名称
-d
在后台运行
up
命令用于根据 Docker Compose 配置文件启动定义的服务。它会创建和启动配置文件中所有的服务容器,并将它们放置在一个共享网络中
# 必须在docker-compose.yum 所在目录执行此命令
cd /opt/compose_nginx/
# 查看已经启动的服务器的状态
docker-compose ps