CircleCI 与持续集成

CircleCI 入门

最近在完成老师的作业：使用 CircleCI 进行持续集成，现将过程书写下来，与大家一起学习进步。

A. What is CircleCI？

1. 什么是持续集成

持续集成（Continuous Integration）通常缩写为 CI， 持续集成指的是，当代码有变更时，立即进行构建和测试，反馈运行结果，我们可以根据测试结果，确定新代码是否可以和原有代码正确的集成在一起。 让你能够在开发中随时发现问题，在快速的产品迭代中还可以保持很高的质量。因为修复问题的成本随着时间的推移而增长，越早发现，修复成本越低。

2. 什么是持续部署

持续部署（Continuous Deployment）通常缩写为 CD， 持续部署指的是，当代码有变更时，自动进行测试和构建，如果一切顺利则自动部署到服务器上。

3. 什么是 CircleCI

CircleCI 是一个持续集成/持续部署的服务，开源项目可以免费使用，他的价格取决于你需要并发构建实例的数量，单个实例是免费的。

官网地址

4. CircleCI 能做什么

他可以绑定 GitHub/Bitbucket，只要你的代码有变更，就会自动抓取，根据你的配置，提供运行环境，执行测试、构建和部署。

5. CircleCI 的工作流程

B. 使用 CircleCI 持续集成和自动部署到 GitHub，进行 junit 单元测试

建议完成该实验最好在 Linux 环境下进行，能避免很多问题，CircleCI 的构建环境也只有 Linux 和 MacOS，并不包含 Windows。

如果是 Windows 系统，这里我建议使用 WSL，简单方便快捷，还特别好用，毕竟是最强的 Linux 发行版（滑稽）。

1. 创建测试目录

创建一个名为 circleTest 的测试文件夹，移动至该文件夹下。

mkdir circleTest
cd circleTest

2. 单元测试

我们先在本地进行单元测试。

首先导入 maven 依赖：

<dependencies>
    <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>4.12</version>
    </dependency>
</dependencies>

建立测试文件：

package test;

import org.junit.Assert;
import org.junit.Test;

public class TestClass {

    @Test
    public void testName() {
        Assert.assertEquals(1, 1);
    }

}

本地执行一下：

可以看到没有问题，我们将 java 项目导出为 jar 包。运行命令：

mvn package

复制 target 目录下的 jar 文件到之前创建好的 circleciTest 目录下：

然后在 circleciTest 目录下执行命令：

java -cp ./RunUt-1.0-SNAPSHOT.jar:RunUt/* org.junit.runner.JUnitCore test.TestClass

查看测试用例通过。

3. CircleCI 本地配置

要使用 CircleCI，首先在项目 circleciTest 目录下创建一个名为 .circleci 的文件夹，并新建 config.yml 文件。

config.yml：

version: 2
jobs:
  build:
    docker:
      - image: circleci/openjdk:8u181-jdk
    steps:
      - checkout
      - run:
          name: Testing application
          command: java -cp ./RunUt-1.0-SNAPSHOT.jar:RunUt/* org.junit.runner.JUnitCore test.TestClass

关于该配置文件的详细信息，可以参考 官方文档

4. 使用 GitHub 实现持续集成

进入 CircleCI 官网，点击 Explore Integrations，跳转后选择 Start Building for Free，然后选择 Sign Up With GitHub，与自己的GitHub 账号进行相关联。

关联后便进入控制界面。

5. 上传测试文件到 GitHub

在 GitHub 建立一个新的 repository ，关联本地仓库，进入本地的 circleciTest 目录，执行以下命令：

git init
git add ./
git commit -m "first commit"
git push origin master

6. 更改 GitHub 设置选项

将本地代码上传至远程仓库后，我们点击 Settings，选择 Webhooks 选项，再点击 Edit 按钮：

选择 Just the push event：

7. 使用 CircleCI 进行单元测试

在 CircleCI 控制面板选择 Add Project，然后关联之前上传的 circleciTest 项目：

如果我们重新提交了代码，可以在 GitHub 仓库下的 commits 界面下看到我们的提交记录，并且 CircleCI 会实现自动部署，可以很直观的查看到提交的代码是否正确通过运行：

点击 Details 进行 CircleCI 该项目的设置界面，我们便能完整的看到运行情况了：

测试通过：Success!

C. 测试用例

circleciTest

参考

<https://www.jianshu.com/p/36af6af74dfc>