持续集成之 Spring Boot 实战篇

时间  2020-06-29
标签 持续 集成 spring boot 实战 栏目 Spring 繁體版
原文   原文链接
本文做者： CODING 用户 - 何健

此次实战篇，咱们借助「CODING 持续集成」，实现一个简单的 Spring Boot 项目从编码到最后部署的完整过程。本教程还有 B 站视频版，帮助读者更好地学习理解。java

思路

  • 在线上环境构建、测试、部署

这种状况，一般会将 jenkins 安装在服务器上，确保构建测试等操做环境和线上环境一致。python

此时一般会在 jenkins 中配置好须要持续集成的仓库，以及具体流程。git

这种方式很是简单粗暴，也很是有效，可是缺点也很明显。可能 jenkins 会成为线上环境的旁站漏洞，这是很是不安全的。web

那么，咱们就须要更高级的方式，能够线上环境以外的构建测试，最终部署到线上环境。「CODING 持续集成」正是提供这类持续集成模式的平台。spring

  • 不在实际部署服务器上构建、测试

为了不占用线上服务器的资源，也为了不安全问题，咱们可使用单独的 jenkins (或者其它此类软件)完成构建、测试、分发，实际部署经过单独的 webhook 实现。这样就能够避免在线上环境安装 Jenkins，还能够避免更复杂的系统安全维护。apache

这样作的优势：不会影响在线服务；
缺点：部署地机器最好是能够公网访问的，不然会没法完成后续分发步骤。api

  • 终极解决方案：使用 SaaS 化的 Jenkins

Software as a Service，软件即服务。「CODING 持续集成」集成了 SaaS 化的 Jenkins 等主流企业开发流程工具，实现了 DevOps 流程全自动化。开箱即用，直接用它就好！安全

  • 捋一下思路

咱们此次实战针对后一种思路ruby

  1. 检出代码
  2. 构建
  3. 测试
  4. 分发
  5. 触发部署

实战

  • 实际体验，仍是很不错的。

视频地址：CODING 持续集成 - Spring Boot 项目
服务器

  • 第一步：初始化一个持续集成

一、首先，咱们须要进入准备持续集成的项目。

这里我用 start.spring.io 初始化一个 demo 示例项目，并推送到仓库。

为了方便你们，亲自体验，我准备了一个现成的仓库，能够直接 git clone 下来再 git push 到本身帐户下使用。仓库地址：demoForCI

二、解压 demo 项目，进入 demo 目录，初始化仓库。

cd g:\demo\
      git init
      git set remote giturl
      git add ./
      git commit -m 'init repo'
      git push -u origin master

别忘了 git config user.name yourname 和 git config user.email youremail

三、开始体验

仓库准备好后，就能够开始体验「CODING 持续集成」。

第一次的使用，须要先建立一个 Jenkinsfile，不少小伙伴会说，第一次用，不知道是啥。
不要紧，「CODING 持续集成」已经给咱们准备好了模板，很是容易理解，能够认为是特定格式语法写一套 task 流程。

点击一下 “简易模板”，更具实际状况修改一下就能够。

  • 第二步：编写 Jenkinsfile

为了方便理解，咱们从简易模板开始，分别修改对应阶段的任务。

一、配置构建环境，「CODING 持续集成」目前支持 java-八、python-3.五、ruby-2.三、go-1.11 等等。
在 Jenkinsfile 的 pipeline 里添加:

agent {
      // 此处设定构建环境，目前可选有
      // default, java-8, python-3.5, ruby-2.3, go-1.11 等
      // 详情请阅 https://dev.tencent.com/help/knowledge-base/how-to-use-ci#agents
      label "java-8"
    }

二、检出

这里不得不说，「CODING 持续集成」这里作的仍是很方便的，提供了适用于好几种不一样场景的模板。默认简易模板是带有检出部分的，咱们能够根据实际状况进行修改。默认状况下，env.GIT_BUILD_REF 的值就是 master 主分支，实际上咱们能够定制为其它专门用于构建发的分支。

这里，你们能够本身修改具体要检出的分支。

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

三、构建

stage("构建") {
      steps {
        echo "构建中..."
        sh 'java -version'
        sh 'mvn package'
        echo "构建完成."
        archiveArtifacts artifacts: '**/target/*.jar', fingerprint: true // 收集构建产物
      }
    }

这里须要注意，Spring Boot 的 pom 中须要添加一个插件。
修改后：

<plugins>
      <plugin>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-maven-plugin</artifactId>
      </plugin>
      <!-- 下面是添加的插件 -->
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-surefire-plugin</artifactId>
        <version>2.6</version>
        <configuration>
        <skipTests>true</skipTests>
        </configuration>
      </plugin>

四、测试

这里我偷个懒，只作了单元测试，
没有提取测试报告，你们能够根据实际项目定制这个流程。

stage("测试") {
      steps {
          echo "单元测试中..."
          sh 'mvn test'
          echo "单元测试完成."
          //junit 'target/surefire-reports/*.xml' // 收集单元测试报告的调用过程
      }
    }

五、分发 jar 包到目标服务器

这里比较无奈，我没有单独针对此次演示写部署 jar 包和上传 jar 包的 webhookApi，可是构建好的 jar 包须要要放置到待部署的服务器。

因而有了这个过程，借助 scp 和私钥来上传构建好的jar包。

这里千万记着提早部署好密钥。而且将密钥放到仓库一份，用于分发jar包。

stage("分发jar包") {
      steps {
        echo "分发中..."
        echo "chmod 600 pkey"
        sh 'chmod 600 authorized_keys.pem'
        echo "upload"
        sh 'scp -i authorized_keys.pem ./target/*.jar root@yourip:/root/'
        echo "准备部署"
      }
    }

六、部署

前面有提到，这里部署仍然须要触发一个钩子，不然只能手动部署了。

这里我写了一个最简单的，实际上咱们能够写细致一点，判断一下接口返回的结果再根据结果输出部署状况。

stage("部署") {
      steps {
        sh 'curl http://youapi'
        echo "部署完毕"
      }
    }
  • 第三步：保存 Jenkinsfile 并运行

修改好 Jenkinsfile 和 pom.xml。

咱们要保存 Jenkinsfile，编辑框能够直接编辑内容，编辑好能够直接提交到仓库下的 ./Jenkinsfile

接下来， 平台会自动读取 Jenkinsfile 并开始走持续集成的流程：

持续集成的流程是能够看到的：

每一个阶段都对应 Jenkinsfile 一个 stage， 咱们能够点击查看对应阶段的构建结果。

  • 第四步：排查持续集成的报错

若是某个过程出错，「CODING 持续集成」的流程会中止，并提示失败。此时咱们能够进入具体节点查看具体失败缘由。

好比如今是提示“分发 jar 包失败”，那么咱们能够点击对应节点展开看看日志，排查具体分发失败的缘由。

如今能够清晰地看到，报错缘由是我没有填写正确的主机 ip。

文中涉及的文件及代码

  • Jenkinsfile
pipeline {
    agent {
        // 此处设定构建环境，目前可选有
        // default, java-8, python-3.5, ruby-2.3, go-1.11 等
        // 详情请阅 https://dev.tencent.com/help/knowledge-base/how-to-use-ci#agents
        label "java-8"
    }
    stages  {
        // 检出仓库
        stage("检出") {
            steps {
                // 这里sh调用ci-init 初始化
                sh 'ci-init'
                // 这里检出仓库，默认检出分支为环境变量中的GIT_BUILD_REF
                checkout(
                  [$class: 'GitSCM', branches: [[name: env.GIT_BUILD_REF]], 
                  userRemoteConfigs: [[url: env.GIT_REPO_URL]]]
                )
            }
        }
        // 构建jar包
        stage("构建") {
            steps {
                echo "构建中..."
                // 输出java版本
                sh 'java -version'
                // 调用maven 构建jar包
                sh 'mvn package'
                echo "构建完成."
                //收集构建产物，这一步成功，咱们就能够在平台上看到构建产物
                archiveArtifacts artifacts: '**/target/*.jar', fingerprint: true // 收集构建产物
            }
        }
        // 测试
        stage("测试") {
            steps {
                echo "单元测试中..."
                // 作单元测试
                sh 'mvn test'
                echo "单元测试完成."
            }
        }
        // 分发jar包，这里只是简单的经过scp分发jar包到目标机器指定目录
        stage("分发jar包") {
            steps {
                echo "分发中..."
                echo "chmod 600 pkey"
                sh 'chmod 600 authorized_keys.pem'
                echo "upload"
                  sh 'scp -i authorized_keys.pem ./target/*.jar root@youip:/root/'
                echo "准备部署"
            }
        }
        // 部署jar包
        stage("部署") {
            // 这里须要触发一个部署的webhook，能够是一个很简单的重启java进程的操做
            steps {
                // 用curl 来触发hook
                sh 'curl http://baidu.com'
                echo "请登陆服务器手动部署"
            }
        }
    }
}
  • pom.xml

文中所用 Spring Boot 示例项目的 pom.xml

实际上，你们能够直接去 start.spring.io 参考照这份 pom 来建立一个 demo。

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.1.2.RELEASE</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <groupId>tech.hejian</groupId>
    <artifactId>codingj8</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>codingj8</name>
    <description>coding project for Spring Boot</description>

    <properties>
        <java.version>1.8</java.version>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-devtools</artifactId>
            <scope>runtime</scope>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-surefire-plugin</artifactId>
                <version>2.6</version>
                <configuration>
                <skipTests>true</skipTests>
                </configuration>
            </plugin>
        </plugins>


    </build>

</project>

总结

CODING 是一个面向开发者的云端开发平台，提供 Git/SVN 代码托管、任务管理、在线 WebIDE、Cloud Studio、开发协做、文件管理、Wiki 管理、提供我的服务及企业服务，其中「CODING 持续集成」集成了 SaaS 化的 Jenkins 等主流企业开发流程工具，实现了 DevOps 流程全自动化，为企业提供软件研发全流程管理工具，打通了从团队构建、产品策划、开发测试到部署上线的全过程。

相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程