docker compose服务编排简介、基于发布包构建多个webapi容器 和 基于镜像实现Nginx反向代理webapi

一. docker compose服务编排简介

1. 背景

微服务架构的应用系统中一般包含若干个微服务，每个微服务一般都会部署多个实例，如果每个微服务都要手动启停，维护的工作量会很大：

　A. 要创建镜像 Dockerfile build image 或者去dockerhub拉取image

　B. 要创建多个container

　C. 要管理这些container（启动停止删除）

因此，“服务编排” 的概念应运而生。

2. docker compose介绍

　docker compose是一个编排多容器分布式部署的工具，提供命令集管理容器化应用的完整开发周期，包括服务构建，启动和停止。使用步骤：

(1). 利用 Dockerfile 定义运行环境镜像

(2). 使用 docker-compose.yml 定义组成应用的各服务

注: 也可以自定义命名，但是需要通过 -f 指定路径

(3). 运行指令 【docker-compose up】 启动应用

如下图：

3. docker compose的安装和卸载

参照官网：https://docs.docker.com/compose/install/

(1). 安装步骤

前提：docker compose在Linux上运行，首先要安装docker (详见第一节，这里不再介绍)。

A.  通过curl下载二进制文件进行安装

(不建议使用官方地址下载，慢的要死！！！)

sudo curl -L "https://github.com/docker/compose/releases/download/1.27.3/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

PS：1.27.3 是目前最稳定版本，版本去上面的官网地址查询即可。

注. 上面是从github上下载，由于网速原因，很容易失败，也可以尝试下面的地址： (强烈推荐使用这个地址！！！)

sudo curl -L https://get.daocloud.io/docker/compose/releases/download/1.27.3/docker-compose-`uname -s`-`uname -m` > /usr/local/bin/docker-compose 

如图：

B.  通过chmod 命令将该目录设置为可运行 （对于一个目录，如果没有可执行权限，则不能cd进入）

sudo chmod +x /usr/local/bin/docker-compose

C. 查看安装成功后的版本号

docker-compose --version

(2). 卸载步骤

sudo rm /usr/local/bin/docker-compose

4. docker compose常用指令

前言：默认情况下命令读取当前目录下，名为 docker-compose.yml 或 docker-compose.yaml 的文件， 当然用户也可以使用 -f 指定其他文件名。

某个docker-compose配置文件相关指令：

(1). 参数剖析

　-f ：指定配置文件路径

　-p：指定名称，生成的镜像和容器都会以该名称开头，但是在执行后续指令的时候也需要加上-p，否则无效。如下图：

【docker-compose -f ./nginx_api_compose.yml -p yxy ps】

(2). 指令剖析

　查看镜像：【docker-compose images】

　查看容器：【docker-compose ps】【docker-compose ps -a】

　停止容器：【docker-compose stop】

　重启容器：【docker-compose restart】

　开启容器：【docker-compose start】

　删除已经停止的容器：【docker-compose rm】 加-f 强制删除无效， 且不会删除镜像和数据卷。

　停止并删除运行中的 Compose 应用(包含镜像、容器、数据卷、networks)：【docker-compose down】

　创建并启动容器：【docker-compose up -d】 -d表示以后台的方式运行，不要省略，而且它属于up的参数，必须加在up的后面，启动的过程中，如果没有images，会先构建镜像。

PS：镜像和容器的命名规则，默认是前置都会以目录命名，且默认加上 _1 _2 _3 ,可以用-p来指定名称，代替以目录命名。

(3). 常用的命令组合

　创建并启动容器(指定yml的路径)：【docker-compose -f ./xxx/xx.yml up -d】

　查看容器情况(指定yml的路径)：【docker-compose -f ./xxx/xx.yml ps】

　创建并启动容器(指定yml的路径和容器命名)：【docker-compose -f ./nginx_api_compose.yml -p yxy up -d】

　查看容器情况(指定yml的路径和容器命名)：【docker-compose -f ./nginx_api_compose.yml -p yxy ps】

二. yaml及docker compose参数剖析

1. 版本对应关系

　关于docker和docker-compose的版本对应关系，详见：https://docs.docker.com/compose/compose-file/compose-versioning/

2. Yaml和Json转换

　yaml和json 校验转换地址为：http://www.bejson.com/validators/yaml_editor/ 

　docker-compose.yml （或docker-compose.yaml）编写格式支持yml或json，个人喜好json格式。

3. docker compose配置文件详解

参考地址：

　　官方介绍：https://docs.docker.com/compose/compose-file/     (推荐)

　　中文翻译：https://blog.csdn.net/qq_36148847/article/details/79427878  (仅供参考)

分享两个docker-compose.yml文件

a. 基于发布包构建镜像

{
  "version": "3.8",
  "services": {
    "myapi1": {
      "build": "../ypfwebapi1/",
      "ports": [
        "8100:9000"
      ]
    },
    "myapi2": {
      "build": "../ypfwebapi2/",
      "ports": [
        "8101:9001"
      ]
    }
  }
}

b. stack中构建镜像

{
  "version": "3.8",
  "services": {
    "api1": {
　　　 "image": "ypfwebapi1",
      "ports": [
          "8301:9001"
      ],
      "deploy": {
        "mode": "replicated",
        "replicas": 2
      }
    },
    "api2": {
　　　 "image": "ypfwebapi2",
      "ports": [
          "8302:9002"
      ],
      "deploy": {
        "mode": "replicated",
        "replicas": 2
      }
    }
  }
}

(1). version：版本号，对应关系详见 https://docs.docker.com/compose/compose-file/compose-versioning/

(2). build：发布包目录

(3). images：镜像名称

(4). ports：端口映射，前面是容器暴露端口，后面是镜像端口

(5). expose：对外暴露端口

(7). volumes：数据卷

(9). replicas : 代表在n个节点上进行任务

三. 基于发布包构建多个webapi容器

1.  准备项目发布包

　 将ypfwebapi1和ypfwebapi2两个发布包复制到myprogram文件夹，两个的Dockerfile文件中暴露的端口分别为 9000 和 9001。

两个Dockerfile文件如下：

#See https://aka.ms/containerfastmode to understand how Visual Studio uses this Dockerfile to build your images for faster debugging.
#1.依赖两个基础镜像
FROM mcr.microsoft.com/dotnet/aspnet:5.0 AS base

#2.制作人
MAINTAINER ypf <ypf@qq.com>

#3.指定程序运行的端口(也可以在项目中通过UseUrls指定, 或者发布容器的时候通过--env ASPNETCORE_URLS=xxx动态指定)
ENV ASPNETCORE_URLS=http://*:9000
#4.容器对外暴露的端口
EXPOSE 9000
#5.指定默认工作目录
WORKDIR /userapi
COPY . /userapi/
#6.启动容器的时候执行shell命令：dotnet webapi1.dll,即运行该项目
ENTRYPOINT ["dotnet", "Yak.WebApi.Nginx.dll"]

#See https://aka.ms/containerfastmode to understand how Visual Studio uses this Dockerfile to build your images for faster debugging.
#1.依赖两个基础镜像
FROM mcr.microsoft.com/dotnet/aspnet:5.0 AS base

#2.制作人
MAINTAINER ypf <ypf@qq.com>

#3.指定程序运行的端口(也可以在项目中通过UseUrls指定, 或者发布容器的时候通过--env ASPNETCORE_URLS=xxx动态指定)
ENV ASPNETCORE_URLS=http://*:9001
#4.容器对外暴露的端口
EXPOSE 9001
#5.指定默认工作目录
WORKDIR /userapi
COPY . /userapi/
#6.启动容器的时候执行shell命令：dotnet webapi1.dll,即运行该项目
ENTRYPOINT ["dotnet", "Yak.WebApi.Nginx.dll"]

　　

发布包截图：

2. 编辑配置文件

　在myprogram文件夹下创建mycompose文件夹，用于存放各种docker compose配置文件的。

docker-compose.yml 内容如下：

{
  "version": "3.8",
  "services": {
    "myapi1": {
      "build": "../ypfwebapi1/",
      "ports": [
        "8100:9000"
      ]
    },
    "myapi2": {
      "build": "../ypfwebapi2/",
      "ports": [
        "8101:9001"
      ]
    }
  }
}

3.  创建并启动容器

　以后台的运行的方式构建容器，运行指令：【docker-compose up -d】，不要省略-d

查看镜像：

查看容器：

4. 测试端口，成功。

　http://192.168.192.140:8100/weatherforecast

　http://192.168.192.140:8101/weatherforecast

四. 基于镜像实现Nginx反向代理webapi

 1. 准备镜像  

(1). 构建一个ypfwebapi1镜像，Dockerfile中暴露的端口为 9000 （详见前面章节）

(2). 然后要下载一个nginx最新版本的镜像 【docker pull nginx】

2. 准备配置文件

　在mycompose文件夹里，新建一个 nginx_api_compose.yml 文件.

配置文件内容如下：

{
  "version": "3.8",
  "services": {
    "cnginxcontainer1": {
      "image": "nginx",
      "ports": [
        "8080:8080"
      ],
      "links": [
        "cypfwebapicontainer1"
      ],
      "volumes": [
        "./nginx/conf.d:/etc/nginx/conf.d"
      ]
    },
    "cypfwebapicontainer1": {
      "image": "ypfwebapi1",
      "expose": [
        "9000"
      ]
    }
  }
}

3. 创建配置文件

　在当前目录下运行创建对应的文件夹

mkdir -p ./nginx/conf.d

　

并在该目录新建一个配置文件 ypfnginx.conf，会自动同步到容器中（数据卷挂载），内容如下：

server {
    listen 8080;
    access_log off;

    location / {
        proxy_pass http://cypfwebapicontainer1:9000;
    }

}

4. 创建容器并启动

回到mycompose文件夹，运行指令 【 docker-compose -f ./nginx_api_compose.yml up -d 】   ./是当前目录，可以省略

查看镜像和容器：

　　　　　　　　　　　　　　　　　　　　　　

 

docker-compose -f nginx_api_compose.yml images

5. 测试

　因为监听的是8080端口，所有直接访问 http://192.168.192.140:8080/weatherforecast， 测试成功。

docker-compose ps

docker-compose rm

鸣谢：

https://www.cnblogs.com/yaopengfei/p/13672708.html

https://blog.csdn.net/weixin_48447848/article/details/122612981?spm=1001.2014.3001.5501

https://blog.csdn.net/weixin_48447848/article/details/122630687