写在前面
我们以前windows跑.net Framework程序的时候,发布,自己乖乖的替换程序;备份,也是自己一个一个的重命名备份;回滚,发布遇到问题的回滚更是不用说了;运维很是怕我们 这些用windows的啊;
那全面拥抱linux的一一.net core 时代 ,是如何处理这些个问题的呢?
噔噔蹬蹬~请往下看。
运行环境
centos:7.2
cpu:1核 2G内存 1M带宽
一台安装jenkins的机器。
(本文例子不一定要安装jenkins,但实际项目是要用jenkins的)
背景
我们目前的应用部署环境是这样划分的(暂定):
开发环境
环境变量:Development
开发环境就是我们平时的开发用的机器,错误、异常尽可能多的报出来这种。css、js、页面文件等各种静态资源也不做压缩处理,连接测试库;
开发环境的部署:开发人员按自己习惯自己部署;
测试环境
环境变量:Staging
测试环境也就是测试同学测试用的环境,为了贴合生产环境的多机器部署,我们测试机器也有多台,目前我们搭建了jenkins可由测试同学自己部署;错误信息已做捕捉处理,静态文件同样不压缩,连接测试库;
测试环境的部署:docker+docker-compose部署,我们在项目里面编写好了Staging.Dockerfile、docker-compose.yml还有对应的测试环境发布的shell脚本,借助jenkins来进行参数化的构建。参数包括程序运行的端口、绑定的ip,consul配置等等。哦对了,我们目前的构建步骤大概是:
去gitlab拉取最新程序代码;
执行单元测试和集成测试,只有通过单元测试和集成测试才能继续步骤3,否则部署失败终止:
dotnet restore->build->publish,将生成产品打包成一个镜像;
使用docker-compose down 停止、移除上次的构建;
使用docker-compose up 这个强大的命令,构建新的镜像、启动容器;
清除临时镜像,构建完成;
单元测试用dotnet test 命令;
这里我们还可以看到,配置文件也一并被打包到镜像里面了,修改配置文件也需要重新构建的;
预生产环境
环境变量:Staging
预生产环境是相对于测试环境来说,无论数据、配置还是架构都是更加接近生产环境的存在了。一般还是连接的数据库是预生产环境的数据库(同步了生产环境的数据的),甚至有的使用会直接连接生产环境的库(一般不练、只读账号等控制);不过我们公司还是连接的测试库
然后静态文件压缩啊、什么的这些,生产环境怎么处理,这里也怎么处理;
通过测试环境测试的程序才可以部署到这里,这里测试通过后,才可以部署到生产环境;
预生产环境的部署:由项目负责人或者运维部署,需要比较大权限才可以;
生产环境
环境变量:Production
生产环境一般应配置为最大限度地提高安全性、性能和应用可靠性,包括但不限于以下举措:
- 全面启用分布式缓存
- 客户端资源被捆绑和缩小,并可能从 CDN (网络分发)提供。
- 必须禁用诊断错误页。
- 启用友好错误页、一致的错误响应。
- 启用生产记录和监视。
生产环境的部署:运维部署,我们开发没有权限了;
部署的背景我们的条件等等大概讲完了,下面我们说说生产环境我们怎么设计容器的。
生产环境的容器设计
由于生产环境经常需要修改配置、保留日志信息、需考虑程序的备份与回滚等等,我们不能像上面的测试环境一样,把整个发布的产品打包成一个镜像了,我们需要做特殊的处理;
熟悉docker的同学,肯定会想到:挂载
对的,我们就这么处理,我们用docker -v 处理这头痛的问题;
程序的目录结构
我们程序的目录结构是这样的:
backs:放历史版本的程序文件,按备份日期压缩命名;
logs:程序的运行日志文件;
program:当前运行的程序;
logs 和 program 目录,使用 docker -v 挂载;
backs目录截图:
发布
发布步骤
同步通过测试的预生产环境的程序文件;
压缩、备份上一版本的程序文件;
通过更改文件夹名称的方式,当前运行程序替换为最新的;
重启程序;
心跳检测:通过输出部署成功,未通过执行回滚操作。
发布脚本(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写的一塌糊涂等等。。欢迎沟通,不理赐教。
晚安~