Docker-compose

一、docker-compose的认识：

Dockerfile可以让用户管理一个单独的应用容器；而Compose则允许用户在一个模板（YAML格式）中定义一组相关联的应用容器（被称为一个 project，即项目），例如一个 Web 服务容器再加上后端的数据库服务容器等。

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来进行编排管理。

1.docker 镜像管理的问题 ：

• 多次使用 Dockerfile Build Image 或者 DockerHub 拉取 Image;
• 需要创建多个 Container，多次编写启动命令；
• Container 互相依赖的如何进行管理和编排；

当我们服务数量增多的时候，上面三个问题就会更加的被放大，如果这三个问题不解决，其实从虚拟机到容器化除了机器减少一些浪费以外，好像没有更多的变化。Docker有没有什么好的方法，可以让我们通过一个配置就搞定容器编排和运行呢?这个时候Docker Compose就站出来了。

2.Docker Compose 的解决方案：

• 提供工具用于定义和运行多个 docker 容器应用；
• 使用 yaml 文件来配置应用服务 (docker-compse.yml)；
• 可以通过一个简单的命令 docker-compse up 可以按照依赖关系启动所有服务；
• 可以通过一个简单的命令 docker-compose down 停止所有服务；
• 当一个服务需要的时候，可以很简单地通过 --scale 进行扩容；

3.Compose的特征 ：

更高的可移植性，Docker Compose 仅需一个 docker-compse up 可以完成按照依赖关系启动所有服务，然后使用 docker-compose down 轻松将其拆解。帮助我们更轻松地部署复杂的应用程序；
单个主机上的多个隔离环境，Compose 可以使用项目名称将环境彼此隔离，这带可以在一台计算机上运行同一环境的多个副本，它可以防止不同的项目和服务相互干扰；

二、compose 部署：

1.Docker Compose的安装：

#注意必须是在安装docker的基础上
curl -L https://github.com/docker/compose/releases/download/1.21.1/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-compose
#下载安装包单独安装DockerCompose
chmod +x /usr/local/bin/docker-compose
#docker-compose添加执行权限
docker-compose --version
#查看docker-compose版本

2.YAML 文件格式及编写注意事项：

YAML 是一种标记语言，它可以很直观的展示数据序列化格式，可读性高。类似于 XML数据描述语言，语法比 XML 简单的很多。YAML 数据结构通过缩进来表示，连续的项目通过减号来表示，键值对用冒号分隔，数组用中括号 [ ] 括起来， hash 用花括号 { } 括起来。

使用 YAML 时需要注意下面事项：

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

两种格式：

• json  主要用于API接口之间的消息传递 
• YAML 用于配置和管理 yaml 是一个简洁的非标记性语言,内容 格式 人性化 较易读

#yml 格式
languages:       #序列的映射
  - Java
  - Golang
  - Python
websites:        #映射的映射
  cpu: 2
  memory: 1024M
  swap: 2048M
  disk: 60G 

数据结构：

YAML 序列：

 YAML 序列是一个列表。在其最简单的形式中，每行有一个项目，每行以破折号和空格开始。将即将进行的任务项目罗列在此，并且以此展开。

---
- JAVA
- python
- c++

于是这三种程序设计语言有着并列的关系，将此罗列为一个列表

YAML 映射：

YAML 映射是一个关键术语与该术语的定义相结合。在其他语言中，映射被称为“键值对”，一般的格式均为“变量：值 ”。简单明了的解释二则之间的关系

---
host：
 Kernel: Linux
 CPU: AMD
 RAM: '16 GB'

以上面为例子，首先用三个破折号为项目的开始，参数host的参数：内核为Linux，cpu为AMD，

运行内存为16GB 

序列的映射：

当我运用键值对的方式去映射定义一个变量的值，有时候会发现，这个变量不单单是一个值就能阐述清楚，于是我们可以让这个值变为一个序列，就像Java中的数组一样，定义数组命名，多个值进行组成。

---
hobby:
  - sing
  - dance
  - rap
phone:
  - 123456
  - 111111

映射的映射 

让一个键项的值中既有键又有值时，你可以使用映射的映射.就比如你的爱好是跳远，跳远就是你爱好的映射值，你能跳两米，于是两米就是跳远的映射值

---
host1:
  CPU: Intel
  RAM: '32 GB'
host2:
  CPU: AMD
  RAM: '16 GB'

 序列的序列：

就像你可以嵌套映射一样，你可以将一个序列嵌套到一个序列中： 

---
- [Linux, FreeBSD, Illumos]
- [YAML, XML, JSON]

序列的序列是 YAML 的实际使用中遇到的最不常见的数据结构 ，但是不排除你会需要一个列表的列表

映射的序列 ：

你也可以创建一个包含映射的序列。对于人类排序数据的方式来说，这并不太常见，但对于计算机来说，这可能是一个重要的结构。

---
-
  CPU: AMD
  RAM: '16 GB'
-
  CPU: Intel
  RAM: '16 GB'

 对于 YAML，这可能是最不直观的语法。它在 Python 中呈现时更清晰：

[{"CPU": "AMD", "RAM": "16 GB"}, {"CPU": "Intel", "RAM": "16 GB"}]

方括号代表一个列表结构，这个列表包含两个字典。每个字典都包含键值对 

对象映射：键值对的字典：

animal: pets

序列数组：一组按次序排列的列表：

- Cat
- Dog
- Goldfish
 
["Cat", "Dog", "Goldfish"]

键：（值）：

# Json 格式
{
  languages: [
    'Java',
    'Golang',
    'Python'	
  ],
  resources: {
    cpu: '2',
    memory: '1024M',
    swap: '2048M',
    disk: '60G'
  }
}

字段    描述
build    指定 Dockerfile 文件名，要指定Dockerfile文件需要在build标签的子级标签中使用dockerfile标签指定
dockerfile    构建镜像上下文路径 dockerfile-nginx
context    可以是 dockerfile 的路径，或者是指向 git 仓库的 url 地址
image    指定镜像
command    执行命令，覆盖容器启动后默认执行的命令
container_name    指定容器名称，由于容器名称是唯一的，如果指定自定义名称，则无法scale指定容器数量
deploy    指定部署和运行服务相关配置，只能在 Swarm 模式使用
environment    添加环境变量
networks    加入网络，引用顶级networks下条目
network_mode    设置容器的网络模式，如 host，bridge，...
ports    暴露容器端口，与 -p 相同，但端口不能低于 60
volumes    挂载一个宿主机目录或命令卷到容器，命名卷要在顶级 volumes 定义卷名称
volumes_from    从另一个服务或容器挂载卷，可选参数 :ro 和 :rw，仅版本 '2' 支持
hostname    容器主机名
sysctls    在容器内设置内核参数
links    连接到另外一个容器，- 服务名称[:服务别名]
privileged    用来给容器root权限，注意是不安全的，true | false
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  #先启动apache
    - mysql    #在启动mysql

3.Docker Compose 配置常用字段:

字段	描述
build	使用Dockerfile构建镜像。指定Dockerfile 文件名，要指定Dockerfile文件需要在bui ld标签的子级标签中使用dockerfile标签指定
dockerfile	构建镜像上下文路径（指定Dockerfile文件）
context	可以是dockerfile 的路径，或者是指向git 仓库的url地址
image	指定镜像
command	执行命令，覆盖容器启动后默认执行的命令（类似于 docker run）
container_name	指定容器名称，由于容器名称是唯一的， 如果指定自定义名称，则无法scale指定容器数量（同一个镜像指定多个容器数量）
deploy	指定部署和运行服务相关的配置，只能在Swarm模式使用
environment	添加环境变量
networks	加入网络，引用顶级networks下条目
networks_mode	设置容器的网络模式，如 host，bridge
ports	暴露容器端口，与-p相同，但端口不能低于60
volumes	挂载一个宿主机目录或命令卷到容器中，命令卷要在顶级volumes定义卷名称
volumes_from	从另一个服务或容器挂载卷，可选参数:ro 和:rw。仅版本'2' 支持
hostname	容器主机名
sysctls	在容器内设置内核参数
links	连接到另外一个容器，- 服务名称[:服务别名] （类似于容器互联）
privileged	用来给容器root权限，注意是不安全的，只有两个值：true或false
restart	设置重启策略，never，always, no-failure， unless-stopped never，默认策略，在容器退出时不重启容器。 on-failure，在容器非正常退出时(退出状态非0)，才会重启容器。 on-failure:3，在容器非正常退出时重启容器，最多重启3次。 always，在容器退出时总是重启容器。 unless-stopped，在容器退出时总是重启容器，但是不考虑在Docker守护进程启动时就已经停止了的容器。
depends_on	在使用Compose时，最大的好处就是少打启动命令，但一般项目容器启动的顺序是有要求的，如果直接从上到下启动容器，可能会因为容器依赖问题而启动失败。例如在没启动数据库容器的时候启动应用容器，应用容器会因为找不到数据库而退出。depends_on标签用于解决容器的依赖、启动先后的问题。

5.Docker Compose 常用命令 ：

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

6.docker-compose 中 yaml 文件的编写实例：

6.1depends_on 指定依赖关系和启动顺序

在启动php容器前，就先启动后apache容器和mysql容器，为php组件提供所需启动的依赖环境

 php:
   depends_on:
     - apache
     - mysql

6.2使用镜像：

• 如果想使用已存在的镜像，使用 image。
• 如果想使用自己构建的镜像，使用 build、dockerfile、context。

services:
  nginx:
    build:
      context: ./nginx
      dockerfile: Dockerfile

首先阐明服务为 nginx，使用 build 声明自己要构建镜像：context 指定自己要构建镜像的 Dockfile文件所在的目录，dockerfile 指定构建镜像的 Dockerfile 的文件名 

4.3引用网络:

在顶级层设置两个网络模式，在服务中引用不同的网络，可以实现网络的隔离，和网络的兼容。（可以理解为vlan） 

 networks:
   lnmp
   lamp
   
 service:
   nginx:
     networks:lnmp
     
   apache:
     networks:lamp
     
   mysql:
     networks:
       lnmp
       lamp
       
   php:
     networks:
       lnmp
       lamp 

4.4命令卷 ：

在version3，可以在顶级层中定义一个命令卷（例如：db-data），db-data 作为一个中间件，实际并不存在，只是为了做数据同步。（可以理解为vlan）

 version: "3"
 ​
 services:
 ​
   nginx:
     volumes:
     - db_data:/var/lib/db
     
   mysql:
     volumes:
     - db_data:/var/lib/backup/data
 ​
 volumes:       #在顶级层定义一个命令卷
   db_data:

三、Docker-compose 搭建nginx：

1.准备依赖文件：

mkdir -p /opt/compose-nginx/nginx /wwwroot
cd /opt/compose-nginx/nginx
 
#编写一个ngxin启动脚本，放在容器中运行
vim run.sh
#!/bin/bash
/usr/local/nginx/sbin/nginx
 
cd /opt/compose-nginx
#通过Dockerfile编写创建nginx镜像
 
vim Dockerfile
#基于基础镜像
FROM centos:7
#用户信息
MAINTAINER this is nginx image <xxxx-2022-11-26>
#添加环境包
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;" ]
 
#添加站点测试页面
echo "<h1>this is test web</h1>" > /opt/compose-nginx/wwwroot/index.html

 

2.编写配置文件docker-compose.yml：

vim /etc/sysctl.conf
net.ipv4.ip_forward=1
 
sysctl -p
systemctl restart network
systemctl restart docker

 3.查看容器状态和访问测试：

docker ps -a
cd /opt/compose-nginx/
docker-compose ps					#必须在docker-compose.yml所在目录执行此命令
 
浏览器访问：192.168.91.11:1315

四. Docker-compose 搭建tomcat:

①首先创建一个tomcat的docker_compose文件夹
mkdir -p /opt/compose_tomcat/tomcat
②将tomcat编译安装的jdk包和tomcat包放入tomcat文件夹中
③进入tomcat文件夹编写Dockerfile文件
cd /opt/compose_tomcat/tomcat
vim  Dockerfile
#文件内容如下
FROM centos:7
#基于centos:7镜像
ADD jdk-8u201-linux-x64.tar.gz  /usr/local
ADD apache-tomcat-9.0.16.tar.gz  /usr/local
RUN mv /usr/local/jdk1.8.0_201  /usr/local/java  && mv /usr/local/apache-tomcat-9.0.16 /usr/local/tomcat
#将jdk和tomcat压缩包复制到镜像的/usr/local文件夹下并改名
ENV JAVA_HOME /usr/local/java
ENV JAVA_BIN /usr/local/java/bin
ENV JRE_HOME /usr/local/java/jre
ENV CLASSPATH /usr/local/java/jre/bin:/usr/local/java/lib:/usr/local/java/jre/lib/charsets.jar
ENV PATH $JAVA_BIN:/usr/local/java/jre/bin:$PATH
#定义路径变量
RUN mkdir /usr/local/tomcat/webapps/lucien \
    && echo -e "<%@ page language=\"java\" import=\"java.util.*\" pageEncoding=\"UTF-8\"%>\n<html>\n<head>\n<title>JSP test1 page</title>\n</head>\n<body>\n<% out.println(\"123456\");%>\n</body>\n</html>" > /usr/local/tomcat/webapps/lucien/index.jsp \
    && sed -i '71a <Host name="localhost" appBase="webapps" unpackWARs="true" autoDeploy="true" xmlValidation="false" xmlNamespaceAware="false">' /usr/local/tomcat/conf/server.xml \
    && sed -i '72a <Context docBase="/usr/local/tomcat/webapps/lucien" path="" reloadable="true">'  /usr/local/tomcat/conf/server.xml \
    && sed -i '73a </Context>'  /usr/local/tomcat/conf/server.xml \
    && sed -i '74a </Host>'  /usr/local/tomcat/conf/server.xml
#首先创建tomcat主页存放路径，然后添加主页内容，修改环境变量生效
EXPOSE 8080
#定义端口
ENTRYPOINT ["/usr/local/tomcat/bin/catalina.sh","run"]
#启动tomcat
④到compose_tomcat路径下创建tomcat的yml文件
cd /opt/compose_tomcat
vim docker-compose.yml
#内容如下：
version: '3'
#docker-compose版本
services:
#定义servers
  tomcat:
#容器名tomcat
    container_name: web2
    hostname: tomcat-test
#主机名tomcat-test
    build:
      context: ./tomcat
      dockerfile: Dockerfile
#镜像构建dockerfile文件夹位置及名称
    ports:
      - 1280:8080
#端口映射
    networks:
      lnmp:
        ipv4_address: 172.19.0.100
#tomcatip定义
networks:
  lnmp:
    driver: bridge
    ipam:
      config:
          - subnet: 172.19.0.0/16
#自定义网络模式和网段，保存退出
⑤创建并启动tomcat容器，注意在/opt/compose_tomcat路径下执行
docker-compose -f docker-compose.yml up -d
#创建后台启动tomcat容器
docker ps -a 
#查看容器状态及端口映射
#访问本机的1280端口查看是否成功