V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
Coding.NET 轻量级社交
开源项目广场
使用帮助
意见反馈
CodingNET
V2EX  ›  Coding

基于 CODING 的 Spring Boot 持续集成项目

  •  
  •   CodingNET · 2019-02-20 10:11:39 +08:00 · 3173 次点击
    这是一个创建于 1864 天前的主题,其中的信息可能已经有所发展或是发生改变。

    本文作者:CODING 用户 - 廖石荣

    持续集成的概念

    持续集成(Continuous integration,简称 CI )是一种软件开发实践,即团队开发成员经常集成他们的工作,通常每个成员每天至少集成一次,也就意味着每天可能会发生多次集成。每次集成都通过自动化的构建(包括编译,发布,自动化测试)来验证,从而尽早地发现集成错误。

    持续集成的模式

    如图所示:

    图片

    1. CI 过程:代码编写 -> 源代码库( GitHub or gitlab )-> CI 服务器(代码构建、自动化测试、结果反馈 [构建结果] )
    2. 涉及 CI 工具:Jenkins、Travis CI、TeamCity、Gitlab CI、CircleCI、Codeship 等,相关资料可以查询对应的官网,其中应用广泛的 Jenkins 和 Travis CI,市场上也推出了智能化的持续集成服务商,比如「 CODING 持续集成」,它是基于 Jenkins 配置集成服务,真正实现了一键提交代码,持续集成,部署服务。

    持续集成的优点

    1.解放了重复性劳动。
    自动化部署工作可以解放集成、测试、部署等重复性劳动,而机器集成的频率明显比手工高很多。

    2.更快地修复问题。
    持续集成更早的获取变更,更早的进入测试,更早的发现问题,解决问题的成本显著下降。

    3.更快的交付成果。
    更早发现错误减少解决错误所需的工作量。集成服务器在构建环节发现错误可以及时通知开发人员修复。集成服务器在部署环节发现错误可以回退到上一版本,服务器始终有一个可用的版本。

    4.减少手工的错误。
    在重复性动作上,人容易犯错,而机器犯错的几率几乎为零。

    5.减少了等待时间。
    缩短了从开发、集成、测试、部署各个环节的时间,从而也就缩短了中间可以出现的等待时机。持续集成,意味着开发、集成、测试、部署也得以持续。

    6.更高的产品质量。
    集成服务器往往提供代码质量检测等功能,对不规范或有错误的地方会进行标致,也可以设置邮件和短信等进行警告。

    持续集成服务的选择

    关于网上集成服务的工具很多,其中尤其以 Jenkins 服务最受欢迎,但是 Jenkins 服务需要在自己服务器上进行配置安装,以及安装各种插件,对于刚上手的小白来说,可能存在一定的门槛,操作步骤繁多,操作不够智能,不是真正的自动化运维,缺少一键发布构建服务。所以我们选择了「 CODING 持续集成」

    CODING 提供的集成服务是什么

    「 CODING 持续集成」是基于 Jenkins 的,兼容 Jenkinsfile 配置文件,如果您之前有使用过或者写过 Jenkinsfile 相信您会很快上手。

    如何使用 CODING 持续集成服务

    「 CODING 持续集成」是基于 Jenkins 的,通过 Jenkinsfile 配置文件完成 CI 的步骤,接下来将引导您一步步创建一个持续集成示例。

    • 登录 CODING,进入项目中心,点击左边菜单集成服务,开通集成服务,配置完成之后会手动触发第一次构建过程。

    2.png

    • 找到或者创建 Jenkinsfile,如果你对于 Jenkins 比较熟悉的话,可以自己编写 Jenkinsfile 配置文件,也可以采用 CODING 提供的模板文件,如下我就采用了 Jenkinsfile 模板文件来实行自动化持续集成服务,您可以在修改 Jenkinsfile 的时候修改触发方式,您可以自行选择是推送到某个标签或者某个分支时间触发构建。Jenkins 以及能够为 agent 默认配置好 timezone 和 localtime (默认中国上海)。

    3.png

    • 配置好 Jenkinsfile 文件以及配置好环境变量,点击保存,便可以进行持续集成项目了。

    如图所示,集成步骤分为拉取代码-》构建-》测试-》部署等步骤,点击每个步骤可以看到相应的命令执行情况,下面来一个一个步骤配合 Jenkinsfile 文件解释命令的一些执行情况:

    代码工程结构如图所示: image.png

    1.检出项目,如下所示 Jenkinsfile 配置文件第一步通过 Git 检出在远程仓库分支的代码,至于哪个分支可以通过环境变量配置读取 REF 这个环境变量

    stage("检出") {
                steps {
                    sh 'ci-init'
                    checkout(
                      [$class: 'GitSCM', branches: [[name: env.GIT_BUILD_REF]], 
                      userRemoteConfigs: [[url: env.GIT_REPO_URL]]]
                    )
                }
            }
    

    4.png 如上图所示,第一步主要是执行从 Git 仓库远程拉取代码,所以命令都是 Git 里面的,包括读取 Git 配置的环境变量包括更新 Jenkinsfile 文件

    2.构建项目,如下命令所示构建这一步主要是初始化代码和打包代码,因为我们这个工程是以 Java 为主要开发语言,所以重点关注 Java 版本和安装 Maven 命令即可打包,目前 CODING 提供的语言环境包括了 java-1.8.0_181, go-1.7.4, node-10.11.0, php-7.0.30, ruby-2.3, python-2.7.13 等。如有需要可以联系客服开通其它语言环境。

    stage("构建") {
                steps {
                    echo "构建中..."
                    sh 'go version'
                    sh 'node -v'
                    sh 'java -version'
                    // sh 'php -v'
                    // sh 'python -V'
                    // sh 'gcc -v'
                    // sh 'make -v'
                    // 请在这里放置您项目代码的单元测试调用过程,例如:
                    sh 'mvn clean' // mvn 清除缓存
                    sh 'mvn install' // 构建 Maven 工程
                    // sh 'make' // make 示例
                    echo "构建完成."
                    // archiveArtifacts artifacts: '**/target/*.jar', fingerprint: true // 收集构建产物
                }
            }
    

    因为这个 SpringBoot 项目是以 Java 为主的项目,所以在 Jenkinsfile 文件命令里面其实可以把其它语言的检查版本命令去掉,只需要执行 java -version 命令即可。

    第一次构建失败: image.png 如上图所示,第一次执行执行构建 jar 包失败,因为在本地可以正常 mvn install,所以起初我百思不得其解,上网找了很多资料,经过多番查找,最后在 Stack Overflow 找到了答案,这是由于 OpenJDK 1.8.0_181 这个版本中存在的一个 bug 所致,原文如下:链接,最终解决方案采用更改 pom.xml 文件:

    <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-surefire-plugin</artifactId>
        <configuration>
            <useSystemClassLoader>false</useSystemClassLoader>
          	<skipTests>true</skipTests>
        </configuration>
    </plugin>
    

    成功构建结果如下image.png

    3.测试项目,如下所示,我们 SpringBoot 工程通过 mvn test 测试命令即可,比如下面我们测试其中一个用户信息相关的单元测试:

    stage("测试") {
                steps {
                    echo "单元测试中..."
                    // 请在这里放置您项目代码的单元测试调用过程,例如:
                    sh 'mvn test -Dtest=com.my.v2ex.website.Pwdtest'  //测试其中一个单元测试
                    echo "单元测试完成."
                }
            }
    

    第一次失败测试结果如下: image.png image.png

    后来经检查,是单元测试代码其中存在 bug,修正之后,正确的第二次测试结果如下: 图片

    4.部署项目,如下所示,部署项目命令可以执行自己写的部署脚本文件。各位可以结合自己项目的真实环境,编写简单的部署脚本,比如上传 jar 包到服务器,然后通过 java - jar XXXX.jar 包执行方式,以及上传 war 包到 tomcat 服务器,然后启动 tomcat 服务器等,也可以结合自己公司项目需要编写复杂的执行脚本文件,然后调用执行脚本命令,比如下面举一个简单的执行脚本例子。

    部署命令:

    stage("部署") {
                steps {
                    echo "部署中..."
                    sh './deploy.sh start' // 启动 tomcat 服务
                    // sh './deploy.sh stop' // 停止 tomcat 服务
                    echo "部署完成"
                }
            }
    

    deploy.sh 脚本:(其中一些 tomcat 服务路径配置根据自己需要进行修改)

    #!/bin/bash 
    tomcat_home=/usr/tomcat/apache-tomcat-8.0.48  //修改为自己服务器的 tomcat 路径
    SHUTDOWN=$tomcat_home/bin/shutdown.sh 
    STARTTOMCAT=$tomcat_home/bin/startup.sh 
    case $1 in
    start) 
    echo "启动$tomcat_home"
    $STARTTOMCAT 
    ;; 
    stop) 
    echo "关闭$tomcat_home"
    $SHUTDOWN 
    pidlist=`ps -ef |grep tomcat |grep -v "grep"|awk '{print $2}'` 
    kill -9 $pidlist 
    #!/bin/bash 
    tomcat_home=/usr/tomcat/apache-tomcat-8.0.48 
    SHUTDOWN=$tomcat_home/bin/shutdown.sh 
    STARTTOMCAT=$tomcat_home/bin/startup.sh 
    case $1 in
    start) 
    echo "启动$tomcat_home"
    $STARTTOMCAT 
    ;; 
    stop) 
    echo "关闭$tomcat_home"
    $SHUTDOWN 
    pidlist=`ps -ef |grep tomcat |grep -v "grep"|awk '{print $2}'` 
    kill -9 $pidlist 
    stop) 
    echo "关闭$tomcat_home"
    $SHUTDOWN 
    pidlist=`ps -ef |grep tomcat |grep -v "grep"|awk '{print $2}'` 
    kill -9 $pidlist 
    #删除日志文件,如果你不先删除可以不要下面一行 
    rm $tomcat_home/logs/* -rf 
    #删除 tomcat 的临时目录 
    rm $tomcat_home/work/* -rf 
    ;; 
    restart) 
    echo "关闭$tomcat_home"
    $SHUTDOWN 
    pidlist=`ps -ef |grep tomcat |grep -v "grep"|awk '{print $2}'` 
    kill -9 $pidlist 
    #删除日志文件,如果你不先删除可以不要下面一行 
    rm $tomcat_home/logs/* -rf 
    #删除 tomcat 的临时目录 
    rm $tomcat_home/work/* -rf 
    sleep 5 
    echo "启动$tomcat_home"
    $STARTTOMCAT 
    #看启动日志 
    #tail -f $tomcat_home/logs/catalina.out 
    ;; 
    logs) 
    cd /mnt/alidata/apache-tomcat-7.0.68/logs
    tail -f catalina.out 
    ;; 
    esac 
    

    服务启动展示

    系统主页如下图所示: 图片

    文章详情如下图所示: 图片

    归档页面如下图所示: 图片

    系统后台管理如图所示: 图片

    总结

    CODING 是一个面向开发者的云端开发平台,提供 Git/SVN 代码托管、任务管理、在线 WebIDE、Cloud Studio、开发协作、文件管理、Wiki 管理、提供个人服务及企业服务,其中实现了 DevOps 流程全自动化,为企业提供软件研发全流程管理工具,打通了从团队构建、产品策划、开发测试到部署上线的全过程。「 CODING 持续集成」集成了 Jenkins 等主流企业开发流程工具,如上所示,这个以 SpringBoot 打造的 CMS 社区系统便可以在 CODING 上面实现团队协作开发,一键部署作为团队以及公司文档共享社区论坛等作用。

    本文适量引用:“持续集成”词条的百度百科

    1 条回复    2019-02-20 10:18:27 +08:00
    huihoo
        1
    huihoo  
       2019-02-20 10:18:27 +08:00
    这个还是很赞的,持续关注 CODING。
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   我们的愿景   ·   实用小工具   ·   5399 人在线   最高记录 6543   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 30ms · UTC 06:57 · PVG 14:57 · LAX 23:57 · JFK 02:57
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.