CI/CD系列之阿里云云效2020应用篇

Posted 2020-12-18 chinawu

目录

• 前言
• 实战
  • 制品仓库
    • maven配置
    • 项目pom配置
  • 代码管理
  • 流水线
• 参考资料

前言

前不久登录阿里云后台，看到云效的介绍，出于好奇便点进去看了看，刚开始以为云效是类似Jenkins的一套自动化部署方案，了解之后发现云效的野心很大哦，从需求管理、业务开发、代码管理、缺陷测试、部署上线全方位掌控，试图提供一站式DevOps平台，将原先零散的管理平台整合成一个掌管项目全生命周期的综合性管理平台，想法倒是蛮好的，目前东一个平台，西一个平台切换来切换去也颇有点麻烦，能整合起来还是要点赞的，另外目前也是免费使用，那就尝试下吧。

实战

在阿里云后台点击云效后会有二个云效，一个叫“云效”，一个叫“云效2020”，本文主要介绍云效2020，以下简称云效。云效涉及功能较多，本章节以自动化部署展开说明。

涉及云效中制品仓库，代码管理，流水线三大功能，示例已原有项目接入展开说明。

制品仓库

制品仓库其实就是Maven仓库，云效已为每个企业提供一个maven私库，省去自己搭建maven私库。

maven配置

点击进入云效中的制品仓库后，会看到如下图界面

点击任意仓库地址后，会跳转至maven配置指南，详细说明该如何配置，这点做得蛮友好的

如果原先本地对maven配置项没有调整过的话，直接按照制品仓库说明文档中的方式一直接下载覆盖本地文件即可。相信大多数应该都不是默认配置，那就按照方式二说明进行调整即可。
首先将仓库凭证信息复制至本地maven配置项中servers节点，如下图，可以发现凭证信息都是成对出现的，我这边添加了3组凭证配置项

其次将仓库地址信息复制至本地maven配置项中profiles节点下的repositories节点，如下图

项目pom配置

本地maven配置项调整好后，我们需在项目中根目录下的pom.xml增加相应配置，找到根节点pom.xml文件后，将云效中制品上传配置复制过来即可，如下图

另外也需将制品仓库中的settings.xml，复制项目根目录下，该文件在后续构建过程中需使用，如下图

到这里涉及maven的调整已经完成，有个注意点这边配置项中的id属性值需上下一一对应，且不可重复

代码管理

云效中目前支持的代码源如下图

如果原先项目已采用上述代码源中的一种并且支持公网访问的话，那恭喜你可直接跳过该步骤，直接进入流水线配置。如果项目未采用上述代码源管理的话，那就赶紧选择一项，这边推荐使用云效Codeup，毕竟是已整合在云效中。关于Git的配置及使用本文不做介绍，可自行百度即可。

流水线

点击云效中的流水线模块，进入流水线管理页面，如下图

点击新建流水线后，选择Java最基础的构建模板

之后进入流程配置页，如下图

第一步：选择项目源，在项目源选择好上一步配置好的代码源即可。
第二步：配置构建参数，在这步需进行二项操作，Java构建参数配置及构建物上传配置，如下图

在Java构建中选择项目运行的Java版本，我这边项目是基于jdk1.8开发，所以也选择jdk1.8。
在构建命令中可根据自己项目实际情况，更改构建命令，我这边使用如下命令

mvn -B clean package -Dmaven.test.skip=true -Dautoconfig.skip -s settings.xml -P pro

命令参数	说明
-s	用户maven配置文件的路径
-P	maven会激活项目中pom.xml配置的profiles标签，如项目中有用到环境配置则需添加该配置

构建物上传这边需在打包路径进行设置，根据项目情况进行调整，我这边项目最终输出为一个war包，则配置好构建后的路径。这边打包路径为当前构建产生的构建产物在当前工作区下的相对路径。如"target/"
第三步：主机部署配置，如下图

在制品选项栏中点击下拉选择会自动选中选项，目前该选项不可自行配置，选择默认的即可。
在主机组选项中对于首次使用流水线的，需新建主机组，目前支持阿里云ECS及自有主机（只要能通过外网访问都支持），如下图

我这边已经配置过阿里云ECS，这边就不重复操作了，选择相应的主机组即可，大家可根据自身实际情况添加主机。
在下载路径配置中选择存放上一步构建物构建后上传至该服务器的文件路径，我这边选择默认配置。
在执行用户中选择部署脚本执行用户，我这边是root用户。
在部署脚本中主要做的任务就是将上传至该服务器的构建物进行解压，然后根据项目部署方式进行部署。我这边主要做了如下操作：
1.将构建物进行解压，解压出的war包保存至指定目录

tar zxvf /home/admin/app/package.tgz -C /home/admin/fms/

2.执行部署脚本

sh /home/admin/deploy.sh restart

3.在命令中先执行tomcat停止命令

stop_application() {
  echo "stoping java process"
  service tomcat stop
  echo "stoped java process"
}

4.将原先项目老版本进行备份，备份后删除老版本，将新版本解压至tomcat运行目录

start_init() {
	# 创建项目备份路径
	mkdir -p ${TOMCAT_HOME}/bf/${SERVICE_DAY_STR2}/
	cp -r ${TOMCAT_APP_HOME} ${TOMCAT_HOME}/bf/${SERVICE_DAY_STR2}/
	rm -rf ${TOMCAT_APP_HOME}*
	#cp -r ${APP_HOME} /opt/tomcat8/webapps/
 	unzip ${WAR_NAME} -d ${TOMCAT_APP_HOME}
}

5.执行tomcat启动命令

start_application() {
    echo "starting java process"
    #nohup java -jar ${JAR_NAME} > ${JAVA_OUT} 2>&1 &
    service tomcat start
    echo "started java process"
}

根据云效给的部署脚本示例，结合自身项目实际部署情况进行调整，完整部署脚本如下
官方部署实例脚本
https://thoughts.aliyun.com/sharespace/5e86a419546fd9001aee81f2/docs/5e86a416546fd9001aee81b9

#APP_NAME为云效上的应用名
APP_NAME=fms


PROG_NAME=$0
ACTION=$1
APP_START_TIMEOUT=20    # 等待应用启动的时间
APP_PORT=8080          # 应用端口
HEALTH_CHECK_URL=http://127.0.0.1:${APP_PORT}  # 应用健康检查URL
APP_HOME=/home/admin/${APP_NAME} # 从package.tgz中解压出来的jar包放到这个目录下
WAR_NAME=${APP_HOME}/${APP_NAME}.war # jar包的名字
JAVA_OUT=${APP_HOME}/logs/start.log  #应用的启动日志
TOMCAT_HOME=/opt/tomcat8
TOMCAT_APP_HOME=${TOMCAT_HOME}/webapps/fms/
SERVICE_DAY_STR=`date --date=‘0 days ago‘ +%Y-%m-%d`
SERVICE_DAY_STR2=`date --date=‘0 days ago‘ +%Y%m%d%H%M%S`
# 创建出相关目录
mkdir -p ${APP_HOME}
mkdir -p ${APP_HOME}/logs
usage() {
    echo "Usage: $PROG_NAME {start|stop|restart}"
    exit 2
}

health_check() {
    exptime=0
    echo "checking ${HEALTH_CHECK_URL}"
    while true
        do
            status_code=`/usr/bin/curl -L -o /dev/null --connect-timeout 5 -s -w %{http_code}  ${HEALTH_CHECK_URL}`
            if [ "$?" != "0" ]; then
               echo -n -e "
application not started"
            else
                echo "code is $status_code"
                if [ "$status_code" == "200" ];then
                    break
                fi
            fi
            sleep 1
            ((exptime++))

            echo -e "
Wait app to pass health check: $exptime..."

            if [ $exptime -gt ${APP_START_TIMEOUT} ]; then
                echo ‘app start failed‘
               exit 1
            fi
        done
    echo "check ${HEALTH_CHECK_URL} success"
}
start_application() {
    echo "starting java process"
    #nohup java -jar ${JAR_NAME} > ${JAVA_OUT} 2>&1 &
    service tomcat start
    echo "started java process"
}

stop_application() {
  echo "stoping java process"
  service tomcat stop
  echo "stoped java process"
}
start_init() {
	# 创建项目备份路径
	mkdir -p ${TOMCAT_HOME}/bf/${SERVICE_DAY_STR2}/
	cp -r ${TOMCAT_APP_HOME} ${TOMCAT_HOME}/bf/${SERVICE_DAY_STR2}/
	rm -rf ${TOMCAT_APP_HOME}*
	#cp -r ${APP_HOME} /opt/tomcat8/webapps/
 	unzip ${WAR_NAME} -d ${TOMCAT_APP_HOME}
}
start() {
    start_init
    start_application
    health_check
}
stop() {
    stop_application
}
case "$ACTION" in
    start)
        start
    ;;
    stop)
        stop
    ;;
    restart)
        stop
        start
    ;;
    *)
        usage
    ;;
esac

流程配置完后还有二项配置，触发设置和变量和缓存配置，这二项配置是最近出来的，原先是没有的（阿里的迭代还是蛮快的）我这边主要说明部署过程，如有需要可自行体验，点击保存即可完成流水线的配置工作。
配置完后点击配置的流水线，点击运行即可体验自动化部署下带来的便捷了，部署过程中可时刻关注日志输出，便于刚开始部署调试，后续就一劳永逸了。

参考资料

https://thoughts.aliyun.com/sharespace/5e86a419546fd9001aee81f2/docs/5e86a414546fd9001aee8195

---