docker-compose

一、docker-compose容器编排的简介

docker-compose 是一个可以实现在单机上对容器集群编排管理的工具。

它允许用户使用docker-compose.yml 配置模板文件来定义应用程序的配置，包括容器的数量、容器之间的依赖关系、环境变量、端口映射以及数据卷等设置。

然后，用户使用docker-compose命令根据指定配置模板文件的配置来启动和管理容器集群。

通过docker-compose的优势：

1. 使用 Docker Compose命令可以方便地管理多个容器；
2. 可以解决容器之间的依赖关系，同时启动一个 Web 服务器容器和一个数据库容器，并在它们之间建立网络连接，再通过depends_on实现php依赖于nginx和mysql服务的启动顺序；
3. Docker Compose 还支持自定义网络，使得容器可以在不同的网络中进行通信；

本质就是在yaml格式的docker-compose配置模板文件里定义多个服务容器的启动参数和依赖关系，并使用docker-compose命令根据指定配置模板文件的配置来启动和管理容器集群。

docker-compose的三大概念
项目project -> 包含一个或多个服务service -> 包含一个或多个容器container的镜像、端口映射、环境变量、依赖关系等启动参数

1. 默认使用项目的目录名作为project的项目名，支持使用 -p 或 --project-name 来指定项目名称
2. 项目目录里要包含一个 docker-compose 配置模板文件，默认为 docker-compose.yml，支持使用 -f 或 --file 来指定项目的配置模板文件
3. 在配置模板文件docker-compose.yaml里要包含一个或多个服务容器的配置，每个服务要包含容器的名称、镜像、映射端口、挂载点、网络模式、依赖关系等容器启动的配置参数

二、docker-compose的使用

1、docker-compose的配置模板文件yaml文件的编写

YAML是一种标记语言，可以很直观的展示数据序列化格式，可读性很高。类似于json数据描述语言，语法比json简单很多，关于yaml数据格式：

• YAML数据结构通过缩进来表示字段的层级
• 连续的项目通过减号来表示，
• 键值对用冒号分隔，
• 数组用中括号 [] 括起来，
• hash 用花括号 {} 括起来

关于yaml的注意事项：

1. 大小写敏感
2. 通过缩进表示层级关系
3. 不支持制表符 tab 键缩进，只能使用空格缩进
4. 缩进的空格数目不重要，只要相同层级左对齐，通常开头缩进2个空格
5. 用 # 号注释
6. 符号字符后缩进1个空格，如冒号 :  、逗号 ,  、横杠 - 
7. 如果包含特殊字符用单引号('')引起来会作为普通字符串处理，双引号(""): 特殊字符作为本身想表示的意思

（1）布尔值类型

debug: true
debug: false
privileged: true

（2）字符串类型

name: tom
name: 'tom'
name: "tom"

（3）一个key有多个值

animal: 
- 飞行动物
- 爬行动物
- 水生动物
- 两栖动物
 
横向格式
animal: ["飞行动物", "爬行动物", "水生动物", "两栖动物"]

（4）对象object类型类型

#yaml格式用 空格缩进 表示字段的层级关系，同一层字段要靠左对齐
 
一级字段:
    二级字段1:                    
    二级字段2:
	    三级字段: 
 
human:
  name:
    姓: "王"
	ming: 
	- 文宇
	- 思聪
  age: 24
  sex: 男
  height: 180

（5）文本块

value:              ->  value: "helloworld"
       hello 
       world
 
 
value: |            -> value: "hello\nworld"              #key: |  表示保留文本块里的换行符
       hello 
       world
 
value: |-           -> value: 相当于 echo -n "helloworld"
       hello        
       world
	   
value: |+           -> value: "hello\nworld\n"
       hello    
       world 

（6）锚点

name: &a yaml       #锚点，相当于 a="yaml"                    
book: *a            #引用，相当于 echo $a     book: yaml   

关于json格式：

 json文件格式：文件名格式通常是以 .json 为后缀，用 大括号{} 表示字段的层级关系，每层字段除了最后一个字段都要用逗号,结尾，特性：易于api接口解析

human:
  name:
    姓: "王"
	ming: 
	- 文宇
	- 思聪
  age: 24
  sex: 男
  height: 180
  
  
{
  "human": {                      #json格式用 大括号{} 表示字段的层级关系，每层字段除了最后一个字段都要用逗号,结尾
     "name": {
	    "姓": ["王"],
		"名"：["文宇", "思聪"]
	 },
	 "age": ["24"],
	 "sex": ["男"],
     "height": ["180"]
  
  }
}

2、docker-compose配置模板文件常用的字段 与docker run的选项和参数对比

image	使用本地镜像或从仓库拉取镜像创建容器
build	使用dockerfile现场构建镜像创建容器
context	指定dockerfile文件所在的目录
dockerfile	指定dockerfile的文件名称
command	指定容器启动命令，会覆盖镜像中的CMD指令
container_name	相当于指定容器的名称  --name
environment	相当于指定容器的环境变量 -e  --env
network_mode	相当于指定容器的网络 --network
networks	指定加入的网络和IP    --IP以及自定义网络模式
ports	指定端口映射 -p
volumes	指定数据卷   -v 或者自定义顶级卷（版本3）
volumes_from	--volumes-from ，版本3不支持
hostname	指定容器的主机名  -h  --hostname
sysctls	指定容器的内核参数  --sysctl
links	指定容器的名称以及连接别名，可以通过容器名称通信 --link
privileged	让容器拥有真正的root权限 不建议使用  不安全 --privileged
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:   depends_on:     - apache     - mysql

3、docker-compose命令的选项和参数

字段	描述
build	重新构建服务
ps	列出容器
up	创建和启动容器
exec	在容器里面执行命令
scale	指定一个服务容器启动数量
top	显示容器进程
logs	查看容器输出
down	删除容器、网络、数据卷和镜像
stop/start/restart	停止/启动/重启服务

Docker-compose搭建nginx

[root@localhost ~]# cd /usr/local/bin/
[root@localhost bin]# ls
docker-compose
[root@localhost bin]# chmod +x docker-compose
[root@localhost bin]# docker-compose --version
docker-compose version 1.21.1, build 5a3f1a3
[root@localhost ~]# mkdir -p /opt/compose_nginx/nginx /opt/compose_nginx/wwwroot
[root@localhost ~]# cd /opt/compose_nginx/nginx/
[root@localhost nginx]# ls
nginx-1.24.0.tar.gz
[root@localhost nginx]# vim run.sh 
#!/bin/bash
/usr/local/nginx/sbin/nginx

[root@localhost nginx]# vim Dockerfile 
FROM centos:7
MAINTAINER this is nginx image <wx>  #自己定义的名字
RUN yum -y update
RUN yum -y install pcre-devel zlib-devel gcc gcc-c++ make
RUN useradd -M -s /sbin/nologin nginx
ADD nginx-1.24.0.tar.gz /usr/local/src/  #注意 nginx
WORKDIR /usr/local/src/nginx-1.24.0
RUN ./configure \
--prefix=/usr/local/nginx \
--user=nginx \
--group=nginx \
--with-http_stub_status_module && make && make install
ENV PATH /usr/local/nginx/sbin:$PATH
EXPOSE 80
EXPOSE 443
ADD run.sh /run.sh
RUN chmod 755 /run.sh
CMD ["/run.sh"]

##注释##
#基于基础镜像
FROM centos:7
#用户信息
MAINTAINER this is nginx image <wl>
#添加环境包
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 && make && make install
ENV PATH /usr/local/nginx/sbin:$PATH
#指定http和https端口
EXPOSE 80
EXPOSE 443

##启动方法##
//方法一：
RUN echo "daemon off;" >> /usr/local/nginx/conf/nginx.conf			#关闭 nginx 在后台运行
#添加宿主机中run.sh到容器中
ADD run.sh /run.sh
RUN chmod 755 /run.sh
CMD ["/run.sh"]
//方法二：
ENTRYPOINT [ "/usr/local/nginx/sbin/nginx", "-g", "daemon off;" ]

[root@localhost nginx]# echo "<h1>this is test web</h1>" > /opt/compose_nginx/wwwroot/index.html
[root@localhost nginx]# vim /opt/compose_nginx/docker-compose.yml 
version: '3'

services:
  nginx:
    container_name: web1
    hostname: nginx
    build:
      context: ./nginx
      dockerfile: Dockerfile
    ports:
      - 1216:80
      - 1217:443
    networks:
      lnmp:
        ipv4_address: 172.18.0.10
    volumes:
      - ./wwwroot:/usr/local/nginx/html

networks:
  lnmp:
    driver: bridge
    ipam:
      config:
      - subnet: 172.18.0.0/16

[root@localhost nginx]# cd /opt/compose_nginx/
[root@localhost compose_nginx]# docker-compose -f docker-compose.yml up -d
..........   #最后显示为类似以下内容为成功
Creating web1 ... done      #意思：正在创建 web1 ... 已完成




##注释##
-f, --file FILE ：使用特定的 compose 模板文件，默认为 docker-compose.yml
-p, --project-name NAME ：指定项目名称，默认使用目录名称
-d ：在后台运行



[root@localhost compose_nginx]# docker ps -a
CONTAINER ID   IMAGE                 COMMAND                   CREATED          STATUS                     PORTS                                       NAMES
4ba5b7c7f5c2   compose_nginx_nginx   "/run.sh"                 52 minutes ago   Exited (0) 2 minutes ago                                               web1
3a284c552f59   registry:latest       "/entrypoint.sh /etc…"   7 hours ago      Up 7 hours                 0.0.0.0:5000->5000/tcp, :::5000->5000/tcp   registry

#必须在 docker-compose.yml所在目录执行此命令
[root@localhost compose_nginx]# docker-compose ps
Name   Command   State    Ports
-------------------------------
web1   /run.sh   Exit 0        

#下载相关应用，并查看实验所有配置
[root@localhost compose_nginx]# yum install -y tree
[root@localhost compose_nginx]# tree /opt/compose_nginx/
/opt/compose_nginx/
├── docker-compose.yml             #创建模板脚本
├── nginx
│   ├── Dockerfile                 #创建容器脚本
│   ├── nginx-1.24.0.tar.gz        #复制源码包
│   └── run.sh                     #启动服务脚本
└── wwwroot
    └── index.html                 #站点网页

2 directories, 5 files