Asp.net Core 使用Jenkins + Docker 实现持续集成、自动化部署（四）：发布与回滚

写在前面

我们以前windows跑.net Framework程序的时候，发布，自己乖乖的替换程序；备份，也是自己一个一个的重命名备份；回滚，发布遇到问题的回滚更是不用说了；运维很是怕我们 这些用windows的啊；

那全面拥抱linux的一一.net core 时代 ，是如何处理这些个问题的呢？

噔噔蹬蹬~请往下看。

运行环境

centos：7.2
cpu:1核 2G内存 1M带宽

Jenkins ver. 2.150.1

一台安装jenkins的机器。

（本文例子不一定要安装jenkins，但实际项目是要用jenkins的）

背景

我们目前的应用部署环境是这样划分的(暂定)：

开发环境

环境变量：Development

开发环境就是我们平时的开发用的机器，错误、异常尽可能多的报出来这种。css、js、页面文件等各种静态资源也不做压缩处理，连接测试库；

开发环境的部署：开发人员按自己习惯自己部署；

测试环境

环境变量：Staging

测试环境也就是测试同学测试用的环境，为了贴合生产环境的多机器部署，我们测试机器也有多台，目前我们搭建了jenkins可由测试同学自己部署；错误信息已做捕捉处理，静态文件同样不压缩，连接测试库；

测试环境的部署：docker+docker-compose部署，我们在项目里面编写好了Staging.Dockerfile、docker-compose.yml还有对应的测试环境发布的shell脚本，借助jenkins来进行参数化的构建。参数包括程序运行的端口、绑定的ip，consul配置等等。哦对了，我们目前的构建步骤大概是：

1. 去gitlab拉取最新程序代码；

2. 执行单元测试和集成测试，只有通过单元测试和集成测试才能继续步骤3，否则部署失败终止：

3. dotnet restore->build->publish，将生成产品打包成一个镜像；

4. 使用docker-compose down 停止、移除上次的构建；

5. 使用docker-compose up 这个强大的命令，构建新的镜像、启动容器；

6. 清除临时镜像，构建完成；

单元测试用dotnet test 命令；

这里我们还可以看到，配置文件也一并被打包到镜像里面了，修改配置文件也需要重新构建的；

预生产环境

环境变量：Staging

预生产环境是相对于测试环境来说，无论数据、配置还是架构都是更加接近生产环境的存在了。一般还是连接的数据库是预生产环境的数据库(同步了生产环境的数据的)，甚至有的使用会直接连接生产环境的库(一般不练、只读账号等控制)；不过我们公司还是连接的测试库

然后静态文件压缩啊、什么的这些，生产环境怎么处理，这里也怎么处理；

通过测试环境测试的程序才可以部署到这里，这里测试通过后，才可以部署到生产环境；

预生产环境的部署：由项目负责人或者运维部署，需要比较大权限才可以；

生产环境

环境变量：Production

生产环境一般应配置为最大限度地提高安全性、性能和应用可靠性，包括但不限于以下举措：

1. 全面启用分布式缓存
2. 客户端资源被捆绑和缩小，并可能从 CDN (网络分发)提供。
3. 必须禁用诊断错误页。
4. 启用友好错误页、一致的错误响应。
5. 启用生产记录和监视。

生产环境的部署：运维部署，我们开发没有权限了；

部署的背景我们的条件等等大概讲完了，下面我们说说生产环境我们怎么设计容器的。

生产环境的容器设计

由于生产环境经常需要修改配置、保留日志信息、需考虑程序的备份与回滚等等，我们不能像上面的测试环境一样，把整个发布的产品打包成一个镜像了，我们需要做特殊的处理；

熟悉docker的同学，肯定会想到：挂载

对的，我们就这么处理，我们用docker -v 处理这头痛的问题；

程序的目录结构

我们程序的目录结构是这样的：

backs:放历史版本的程序文件，按备份日期压缩命名；

logs:程序的运行日志文件；

program:当前运行的程序；

logs 和 program 目录，使用 docker -v 挂载；

backs目录截图:

发布

发布步骤

1. 同步通过测试的预生产环境的程序文件；

2. 压缩、备份上一版本的程序文件；

3. 通过更改文件夹名称的方式，当前运行程序替换为最新的；

4. 重启程序；

5. 心跳检测：通过输出部署成功，未通过执行回滚操作。

发布脚本(Production.Publish.sh)

#!/bin/bash

function success()
{
  echo -e "\033[32m $1 \033[0m"
}
function error()
{
   echo -e "\033[31m\033[01m $1 \033[0m"
}

echo "publish beging。。。。。。"
remotePath=$1
healthCheckUrl=$2
defaulPaht= $3;
bashPath=${defaulPaht:=`pwd`}

if [ ! $remotePath ]; then
    echo "warn:remotePath should't be empty!"
    exit
fi

if [ ! $bashPath ]; then
    error "error:bashPath should't  be empty!"
    exit
fi
echo "bashpath is ${bashPath}"
programPath="${bashPath}/program"
logPath="${bashPath}/logs"
backPath="${bashPath}/backs"
publisTemp="${bashPath}/publisTemp"
mkdir -p $programPath
mkdir -p $logPath
mkdir -p $backPath
mkdir -p $publisTemp

#remote git or scp
#这里同步预生产环境的程序文件，这里写死了ip只是示例，scp也只是示例
#大家可以采用更安全，更有效率的同步文件方式
scp -r  root@139.199.196.67:${remotePath}"/.*"  ${publisTemp}

if [ $? ]; then
    echo "info:copy successful!"
    #压缩、备份当前运行程序到backs文件夹
    backFileName=`date +%Y%m%d%H%M%S`".tar.gz"
    `cd ${programPath} && tar -zcPf ${backPath}/${backFileName} *`  

    #replace
    #替换程序
    if [ $? ]; then
        mv $programPath ${programPath}"Old"
        mv $publisTemp ${programPath}
        rm -r ${programPath}"Old"

        #publis fail ，then Production.Rollback
        if [ $healthCheckUrl ]; then
            curl $healthCheckUrl
            if [ $? -ne 0 ]; then
                error "error:public failed！"
                #心跳检测失败，执行回滚
                if [ -f "Production.Rollback.sh" ];then
                    echo "************************************ exec Rollbacking...... ************************************"
                    ./Production.Rollback.sh ${backPath}
                else
                    error "error:Production.Rollback.sh is not existing！";
                fi
                exit
            fi  
        fi
        success "publish Successful！"
    else
        error "error:file tar failed！"
    fi 
else
    error "error:remote files copy failed,Maybe you should checkout your ssh auth!"
fi 

Dockerfile

Dockerfile比较简单

FROM microsoft/dotnet:2.1-aspnetcore-runtime AS base
WORKDIR /app
ARG RUN_PORT=${RUN_PORT:-""} 
ARG CONSUL_TO_NETCOREHOST=${CONSUL_TO_NETCOREHOST:-""} 
ARG ASPNETCORE_ENVIRONMENT=${ASPNETCORE_ENVIRONMENT:-""} 
ENV RUN_PORT=${RUN_PORT} CONSUL_TO_NETCOREHOST=${CONSUL_TO_NETCOREHOST} ASPNETCORE_ENVIRONMENT=${ASPNETCORE_ENVIRONMENT}
ENTRYPOINT ["dotnet", "Member.WebApi.dll"]

docker-compose

version: '3.4'

services:
  member.webapi:
    image: memberwebapi${RUN_PORT}
    build:
      context: .
      dockerfile: ${ASPNETCORE_ENVIRONMENT}.Dockerfile
    network_mode: "host"
    restart: always

    environment:
      - RUN_PORT=${RUN_PORT}
      - ASPNETCORE_ENVIRONMENT=${ASPNETCORE_ENVIRONMENT}
      - CONSUL_TO_NETCOREHOST=${CONSUL_TO_NETCOREHOST}

    command:
      - "--port"
      - "${RUN_PORT}"

	#就是这里挂载
    volumes:
      - ../program/:/app/
      - ../logs/:/app/logs

回滚

回滚其实就是发布的逆操作；

发布是:同步最新程序->备份当前运行程序->替换；

回滚是->找到上一次的备份->删掉的当前运行程序->替换；

Production.Rollback.sh

#!/bin/bash

echo "rollback beging。。。。。。"
defaulPaht= $1;
bashPath=${defaulPaht:=`pwd`}
programPath="${bashPath}/program"
backPath="${bashPath}/backs"
lastFile=`cd ${backPath} &&ls -t |head -n1|awk '{print $0}'`

if [ ! $lastFile ];then
    echo "error:none backup program！"
fi

lastFilePath="${backPath}/${lastFile}"
echo $lastFilePath
if [ -f $lastFilePath ];then
    echo "rollback program:${lastFilePath}"    
    programOldPath="${programPath}Old"
    mkdir -p ${programOldPath}
    tar zxvf ${lastFilePath} -C ${programOldPath}

    #replace
    if [ $? ]; then
        rm -r ${programPath}
        mv ${programOldPath} ${programPath}
        echo  "rollback Successful！"
    else
        echo "error:backup program is not existing!"
    fi    
else
    echo "error:backup program is not existing!"
fi

最后贴一个运行截图：

总结

毫不夸张地说，Jenkins + Dockor 让.net 完全从一个刀耕火种的原始人一下子穿越到了全自动化的现代；

文章的思路可以借鉴，脚本改改也可以用，但需理解思路；

有的同学可能会问，为什么生产环境的部署，不能像测试环境一样直接拉取master的代码构建，我这里的回答是涉及到配置的权限问题、devops的学习到位问题。历史原因等，我们暂定这样，后面实践，我乐于分享；

本文的实践都有很大的局限性，比如有现成的工具、有更强大的插件等等可以更简单的去解决这个问题之类的，我可能还不知道；比如我的shell写的一塌糊涂等等。。欢迎沟通，不理赐教。

晚安~