Docker Compose 容器编排

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