Docker compose
Docker compose 实现单机容器集群编排管理(使用一个模板文件定义多个应用容器的启动参数和依赖关系,并使用docker compose来根据这个模板文件的配置来启动容器)
通俗来说就是把之前的多条docker run启动容器命令 转换为docker-compose.yml配置文件。
Docker compose 三大概念
项目/工程 -> 包含一个或多个 服务 --> 包含一个或多个 容器
默认使用项目的目录名做项目名,支持使用 -p 或 --project-name 来指定项目名
在项目的目录中通常会包含一个 docker-compose.yml 模板文件,此文件为项目的默认配置模板文件(支持使用 -f 或 COMPOSE_FILE 来指定项目的配置模板文件)
在配置模板文件里面可以定义项目的一个或多个服务,每个服务包含容器的名称、镜像、端口映射、环境变量、挂载点、依赖关系等配置参数
1. Docker Compose 环境安装
Docker Compose 是 Docker 的独立产品,因此需要安装 Docker 之后在单独安装 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
安装
chmod +x /usr/local/bin/docker-compose
查看版本
docker-compose --version
2. YAML 文件格式及编写注意事项
YAML 是一种标记语言,它可以很直观的展示数据序列化格式,可读性高。类似于 json 数据描述语言,语法比 json 简单的很多。YAML 数据结构通过缩进来表示,连续的项目通过减号来表示,键值对用冒号分隔,数组用中括号 [] 括起来, hash 用花括号 {} 括起来。
使用 YAML 时需要注意下面事项
●大小写敏感
●通过缩进表示层级关系
●不支持制表符 tab 键缩进,只能使用空格缩进
●缩进的空格数目不重要,只要相同层级左对齐,通常开头缩进2个空格
●用 # 号注释
●符号字符后缩进1个空格,如冒号 : 、逗号 , 、横杠 -
●如果包含特殊字符用单引号('')引起来会作为普通字符串处理,双引号(""): 特殊字符作为本身想表示的意思
3. Docker Compose配置常用字段
Compose 字段 对应
docker run参数
描述 build 用于构建镜像。指定 Dockerfile 文件名,要指定Dockerfile文件需要在build标签的子级标签中使用dockerfile标签指定 dockerfile 构建镜像上下文路径 context 可以是 dockerfile 的路径,或者是指向 git 仓库的 url 地址 image 镜像:标签 直接指定镜像,如果不需要build使用dockerfile构建镜像。 command 启动命令 执行命令,覆盖容器启动后默认执行的命令 container_name --name 指定容器名称,由于容器名称是唯一的,如果指定自定义名称,则无法scale指定容器数量 deploy 指定部署和运行服务相关配置,只能在 Swarm 模式使用 environment --env 添加环境变量 networks --network 加入网络,引用顶级networks下条目 network_mode --network 设置容器的网络模式,如 host,bridge,... ports -p 暴露容器端口,与 -p 相同,但端口不能低于 60 volumes -v 挂载一个宿主机目录或命令卷到容器,命名卷要在顶级 volumes 定义卷名称 volumes_from --volumes-from 从另一个服务或容器挂载卷,可选参数 :ro 和 :rw,仅版本 '2' 支持。版本3直接挂载全局共享卷 hostname -h 容器主机名 sysctls --sysctl 在容器内设置内核参数 links --link 连接到另外一个容器,- 服务名称[:服务别名] privileged --privileged 用来给容器root权限,注意是不安全的,true | false restart --restart 设置重启策略,no,always,no-failure,unless-stopped
no,默认策略,在容器退出时不重启容器。
on-failure,在容器非正常退出时(退出状态非0),才会重启容器。
on-failure:3,在容器非正常退出时重启容器,最多重启3次。
always,在容器退出时总是重启容器。
unless-stopped,在容器退出时总是重启容器,但是不考虑在 Docker 守护进程启动时就已经停止了的容器。depends_on 在使用Compose时,最大的好处就是少打启动命令,但一般项目容器启动的顺序是有要求的,如果直接从上到下启动容器,可能会因为容器依赖问题而启动失败。例如在没启动数据库容器的时候启动应用容器,应用容器会因为找不到数据库而退出。depends_on标签用于解决容器的依赖、启动先后的问题。
指定php依赖于apache和mysql,php就会在这两个服务运行后才运行
php:
depends_on:
- apache
- mysql
4. Docker Compose 常用命令
字段 描述
build 重新构建服务
ps 列出容器
up 创建和启动容器
exec 在容器里面执行命令
scale 指定一个服务容器启动数量
top 显示容器进程
logs 查看容器输出
down 删除容器、网络、数据卷和镜像
stop/start/restart 停止/启动/重启服务
5. 项目文件结构
tree -L 2
6. Docker Compose使用 编写配置文件docker-compose.yml
这里使用上一篇博客搭建完成的3容器分布式LNMP架构。将这三条启动命令使用docker-compose进行编排写入docker-compose.yml配置文件
docker run -itd --name nginx8 -v /opt/0A/nginx/html/:/usr/local/nginx/html/ --net mynetwork --ip 172.18.0.10 -p 80:80 nginx:v1
docker run -d --privileged --name mysql --network mynetwork --ip 172.18.0.20 -v /usr/local/mysql mysql:v1
docker run -d --name php -p 9000:9000 --network mynetwork --ip 172.18.0.30 --volumes-from mysql --volumes-from nginx php:v1#定义docker-compose版本,可以是2 或 3 version: '3' #使用services定义服务 services: #第一个service nginx: #设置容器名 container_name: nginx #使用dockerfile来构建镜像 #build: #指定Dockerfile文件所在位置 #context: ./nginx #指定文件名 #dockerfile: Dockerfile image: nginx:v1 #✨由于上一篇博客已经通过Dockerfile构建了镜像,这里可以不用build,直接指定镜像image: nginx:v1。若要build构建则需要把这条image指定镜像注释掉 #映射端口 ports: - 80:80 # - 在yum中代表列表形式 - 443:443 #设置数据卷挂载 volumes: - ./nginx/html:/usr/local/nginx/html #加入网络 networks: mynetwork2: ipv4_address: 172.18.0.10 mysql: container_name: mysql #build: # context: ./mysql # dockerfile: Dockerfile image: mysql:v1 #✨由于上一篇博客已经通过Dockerfile构建了镜像,这里可以不用build,直接指定镜像image: mysql:v1。若要build构建则需要把这条image指定镜像注释掉 ports: - 3306:3306 networks: mynetwork2: ipv4_address: 172.18.0.20 volumes: - db-data:/usr/local/mysql #共享卷 分享mysql.sock privileged: true #MySQL运行需要root权限 php: container_name: php #build: # context: ./php # dockerfile: Dockerfile image: php:v1 #✨由于上一篇博客已经通过Dockerfile构建了镜像,这里可以不用build,直接指定镜像image: php:v1。若要build构建则需要把这条image指定镜像注释掉 ports: - 9000:9000 networks: mynetwork2: ipv4_address: 172.18.0.30 volumes: - db-data:/usr/local/mysql #共享卷 分享mysql.sock - ./nginx/html:/usr/local/nginx/html #挂载宿主机html目录 depends_on: #PHP基于nginx mysql。depends on使php在nginx mysql之后启动 - nginx - mysql #创建自定义网络。 注意,不可与现有网络网段重合。 networks: mynetwork2: #自定义mynetwork2网络 driver: bridge ipam: config: - subnet: 172.18.0.0/16 #由于docker-compose版本v3 挂载卷需要创建全局共享卷 volumes: db-data:
由于指定IP 所以创建 mynetwork2。但是容器编排脚本中的mynetwork2的网段与上一篇博客已经创建的mynetwork网络网段重叠了 会报错,先把容器删除,再删除mynetwork网络。
docker rm -f $(docker ps -aq) docker network rm mynetwork
执行容器编排脚本,完成容器运行
cd /opt/0A/ docker-compose -f docker-compose.yml up -d -f, --file FILE :使用特定的 compose 模板文件,默认为 docker-compose.yml -p, --project-name NAME :指定项目名称,默认使用目录名称 -d :在后台运行
7.查看运行状态
docker ps -a CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES 6bfe1bc5d96c php:v1 "/usr/local/php/sbin…" About an hour ago Up About an hour 0.0.0.0:9000->9000/tcp, :::9000->9000/tcp php 4d2c94fa590a mysql:v1 "/usr/local/mysql/bi…" About an hour ago Up About an hour 0.0.0.0:3306->3306/tcp, :::3306->3306/tcp mysql c2e3146138a8 nginx:v1 "/usr/local/nginx/sb…" About an hour ago Up About an hour 0.0.0.0:80->80/tcp, :::80->80/tcp, 0.0.0.0:443->443/tcp, :::443->443/tcp nginx
cd /opt/0A/ docker-compose ps #必须在docker-compose.yml所在目录执行此命令 Name Command State Ports ----------------------------------------------------------------------------------------------------------------------- mysql /usr/local/mysql/bin/mysqld Up 0.0.0.0:3306->3306/tcp,:::3306->3306/tcp nginx /usr/local/nginx/sbin/ngin ... Up 0.0.0.0:443->443/tcp,:::443->443/tcp, 0.0.0.0:80->80/tcp,:::80->80/tcp php /usr/local/php/sbin/php-fpm -F Up 0.0.0.0:9000->9000/tcp,:::9000->9000/tcp