搭建CI环境

2017-05-23 本文已影响870人 KevinLive

Jenkins

原文地址：LoveDev

Jenkins 是一款领先的开源自动化服务器，提供了数百个插件来支持任何项目的构建，部署和自动化

前往官网下载最新的 war 包，war 包使用起来比起安装到系统中方便一些，这篇文章中用到的是 2.46.2 版本的 war 包

启动命令：

# --httpPort 参数可以指定启动的端口，避免端口冲突
$ java -jar jenkins.war --httpPort=1111

初次进入 Jenkins 时需要初始密码，密码会在启动日志中打印出来：

Jenkins initial setup is required. An admin user has been created and a password generated.
Please use the following password to proceed to installation:

f1bfd39676da4339afbb93dd3e07606b

This may also be found at: /home/.jenkins/secrets/initialAdminPassword

进入以后会有两个选项，建议选择左边的一个，会安装一些常用的插件，然后就是创建账号，创建账号的时候命令行可能会报 403 错误码，此时需要进入 系统管理 -> Configure Global Security，关闭 防止跨站点请求伪造 选项

进入首页之后，需要在 Global Tool Configuration 中配置 JDK、Gradle 信息

Global Tool Configuration

JDK和Gradle的配置最好跟项目中使用的相同，我的配置如下：

JDK Gradle

编译 Android 项目怎么能少得了 SDK，SDK 的配置需要到 系统设置 中配置：

系统设置

在 全局属性 中增加键值对，我的配置如下：

ANDROID_HOME

随便配置一下插件 Extended E-mail Notification：

邮件通知

到此，编译环境配置完成，接下来需要创建项目并配置项目，首先点击新建创建一个自由风格的软件项目：

创建项目

创建完成后会自动跳转到项目的配置界面，里面有很多的配置项，该文章只介绍一些必须的配置项，日后会陆续更新补充

配置源码管理

源码管理

点击 Add 按钮可以添加密钥：

添加密钥

配置构建触发器

构建触发器

配置 Gradle

点击 增加构建步骤，选择图中选项：

增加构建步骤

具体配置：

Invoke Gradle script

Tasks 选项里面的内容可以根据自己的需求填写

邮箱通知插件

全局的邮件插件已经配置过了，现在需要在项目中进行具体的配置，配置步骤很简单：

邮箱通知配置

邮件通知内容模板：

<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>${ENV, var="JOB_NAME"}-第${BUILD_NUMBER}次构建日志</title>
</head>

<body leftmargin="8" marginwidth="0" topmargin="8" marginheight="4"
    offset="0">
    <table width="95%" cellpadding="0" cellspacing="0"
        style="font-size: 11pt; font-family: Tahoma, Arial, Helvetica, sans-serif">
        <tr>
            <td>(本邮件是程序自动下发的，请勿回复！)</td>
        </tr>
        <tr>
            <td><h2>
                    <font color="#0000FF">构建结果 - ${BUILD_STATUS}</font>
                </h2></td>
        </tr>
        <tr>
            <td><br />
            <b><font color="#0B610B">构建信息</font></b>
            <hr size="2" width="100%" align="center" /></td>
        </tr>
        <tr>
            <td>
                <ul>
                    <li>项目名称 ： ${PROJECT_NAME}</li>
                    <li>项目描述 ： ${JOB_DESCRIPTION}</li>
                    <li>构建编号 ： 第${BUILD_NUMBER}次构建</li>
                    <li>触发原因： ${CAUSE}</li>
                    <li>下载地址： http://fir.im/t6k7</li>
                    <li>构建日志： <a href="${BUILD_URL}console">${BUILD_URL}console</a></li>
                    <li>构建  Url ： <a href="${BUILD_URL}">${BUILD_URL}</a></li>
                    <li>项目  Url ： <a href="${PROJECT_URL}">${PROJECT_URL}</a></li>
                </ul>
            </td>
        </tr>
        <tr>
            <td><b><font color="#0B610B">Changes Since Last
                        Successful Build:</font></b>
            <hr size="2" width="100%" align="center" /></td>
        </tr>
        <tr>
            <td>
                <ul>
                    <li>历史变更记录 : <a href="${PROJECT_URL}changes">${PROJECT_URL}changes</a></li>
                </ul> ${CHANGES_SINCE_LAST_SUCCESS,reverse=true, format="Changes for Build #%n:<br />%c<br />",showPaths=true,changesFormat="<pre>[%a]<br />%m</pre>",pathFormat="    %p"}
            </td>
        </tr>
        <tr>
            <td><b><font color="#0B610B">构建日志 (最后 100行):</font></b>
            <hr size="2" width="100%" align="center" /></td>
        </tr>
        <!-- <tr>
            <td>Test Logs (if test has ran): <a
                href="${PROJECT_URL}ws/TestResult/archive_logs/Log-Build-${BUILD_NUMBER}.zip">${PROJECT_URL}/ws/TestResult/archive_logs/Log-Build-${BUILD_NUMBER}.zip</a>
                <br />
            <br />
            </td>
        </tr> -->
        <tr>
            <td><textarea cols="80" rows="30" readonly="readonly"
                    style="font-family: Courier New">${BUILD_LOG, maxLines=100}</textarea>
            </td>
        </tr>
    </table>
</body>
</html>

上传APK到fir

官方文档在这里

这里具体介绍一下怎么上传 git 中的 commit 信息到fir，需要用到 Environment Injector Plugin 插件，具体步骤如下：

输出 commit 文件内容，增加构建步骤 -> Execute shell ->在Command输入以下内容（注意替换Jenkins的username，password，IP，端口）：

CHANGELOG=$(curl -u username:password "http://localhost:8080/job/$JOB_NAME/$BUILD_NUMBER/api/xml?wrapper=changes&xpath=//changeSet//comment" | sed -e "s/<\/comment>//g; s/<comment>//g; s/<\/*changes>//g" | sed '/^$/d;G')
echo CHANGELOG=$CHANGELOG > change_log_vars

设置 commit 文件参数：增加构建步骤->Inject environment variables->在Properties File Path输入change_log_vars
输出 commit 作者文件内容：增加构建步骤->Execute shell->在Command输入以下内容：

CHANGEAUTHOR=$(curl -u username:password "http://localhost:8080/job/$JOB_NAME/$BUILD_NUMBER/api/xml?wrapper=changes&xpath=//changeSet//fullName" | sed -e "s/<\/fullName>//g; s/<fullName>//g; s/<\/*changes>//g" | sed '/^$/d;G')
echo CHANGEAUTHOR=$CHANGEAUTHOR > change_author_vars

设置 commit 作者文件参数：增加构建步骤->Inject environment variables->在Properties File Path输入change_author_vars
最后设置到 fir 插件中：增加构建后操作步骤->Upload to fir.im，然后在Build Notes中输入:

$CHANGELOG
by $CHANGEAUTHOR

最后上一张 fir 插件的配置图：

commit 信息提取

fir 插件配置

常见问题

构建失败

  Fix the issues identified by lint, or add the following to your build script to proceed with errors:
  ...
  android {
      lintOptions {
          abortOnError false
      }
  }
  ...

已经提示了怎么处理该错误，在 Gradle 文件中加入提示的代码即可

测试邮件发送失败

Failed to send out e-mail

javax.mail.AuthenticationFailedException: 535 Error: authentication failed

    at com.sun.mail.smtp.SMTPTransport$Authenticator.authenticate(SMTPTransport.java:809)
    at com.sun.mail.smtp.SMTPTransport.authenticate(SMTPTransport.java:752)
    at com.sun.mail.smtp.SMTPTransport.protocolConnect(SMTPTransport.java:669)
    at javax.mail.Service.connect(Service.java:317)
    at javax.mail.Service.connect(Service.java:176)
    at javax.mail.Service.connect(Service.java:125)
    at javax.mail.Transport.send0(Transport.java:194)
    at javax.mail.Transport.send(Transport.java:124)
    at hudson.tasks.Mailer$DescriptorImpl.doSendTestMail(Mailer.java:581)
    at java.lang.invoke.MethodHandle.invokeWithArguments(MethodHandle.java:627)
    at org.kohsuke.stapler.Function$MethodFunction.invoke(Function.java:343)

认证失败，注意配置邮箱的密码并不是登录密码，而是授权码