Jenkins 配置 Job 来拉取 GitHub 或者 GitLab 项目

我们先进入 jenkins 中选择新建项目，我们这里选择新建一个自由风格的项目，有人想新建 maven 项目也是可行，这里我选择新建自由风格的项目，自己取一个 job 项目名称，点击确定

• 通用

  # 描述中进行简单介绍项目
  
  # 我这里勾选了 Discard old builds 抛弃老的构建，我在保持最大构建天数中写 10 天，我这里配置了，其实有的人不想在这里配置也行，那可以在构建后操作中选择构建后删除也行，配这些主要是为了避免服务器存满拉取的项目导致服务器瘫痪，在构建环境中选择在开始时删除工作空间这样其实也行
  
  # 我勾选了 This project is Parameterized 项目参数化，因为我的项目确实需要 jenkins 此 job 中将参数传进去，不要 job 传参的这个不需要勾选
  

• 源码管理

  # 我拉取的是公司的 gitlab 项目，因此先勾选 git
  
  # Repository URL 填写仓库地址，支持 https 拉取的项目可以填写上 github 或者 gitlab 的 https 地址，我项目上用 ssh，因此我这里写着 ssh 的项目地址
  
  # Credentials 填写凭证，对于 https 的话很好做，点添加后直接输入 github 或者 gitlab 的用户名和密码即可，对于 ssh 的话有点麻烦，点击添加后，类型中选择 ssh 那一个，点击私钥，然后在点击添加，然后再将本地私钥复制上去即可（私钥和公钥是成对的），至于不知道私钥怎么获得，可以看下面我总结的文章
  https://blog.csdn.net/abcnull/article/details/103806125
  
  # 分支选择，我的项目在其他分支上，默认是 master
  

• 构建和触发器

  # 这里我没有配置，当然项目经常有定时构建的方式，这需要勾选 Poll SCM，其中以某种格式写定时时间，这个格式请百度，这里不做赘述
  

• 构建环境

  # 构建环境这里我也没有配置，不过除了在通用中配置保留旧的构建多少天，在构建后操作配置是否构建完删除构建，这里也可以配置在开始时是否先删除 workspace，都是为了保证服务器不被拉取项目堆积
  

• 构建

  # 这里我选择 Invoke top-level Maven targets
  
  # Maven 版本选择已经在 jenkins 全局工具配置中配好的 maven
  
  # 目标填写，因为 job 拉取到的项目中直接就含有 pom，而不是拉取到的项目中下一层或下面多层中含有 pom
  -X clean test
  

• 构建后操作

  这里主要做邮件配置工作

  这里配置麻烦一点

  • Publish HTML reports 发布 html 报告

    # HTML directory to archive 选择什么样的文件来存档，我这里选择了项目产生 html 报告
    target/test-output
    
    # Index page[s] 具体文件名
    index.html
    
    # Index page title[s] (Optional) 主页标题自起名
    
    # Report title 报告标题自起名
    

  • E-mail Notification 邮件通知（构建不稳定时）

    # Recipients 收件人添加，我添加了我自己的公司邮箱，添加其他人的邮箱请用空格隔开
    [email protected]
    
    # 勾选每次不稳定时通知
    

  • Editable E-mail Notification 可编辑的邮件通知（需要 jenkins 插件支持）

    比 E-mail Notification 好用，它提供了可定制的模板，以及众多样式的邮件触发机制

    # Project Recipient List 项目收件人列表，我这里也是只配了我一个人
    [email protected]
    
    # 其他采用默认
    
    # Content Type 类型选择了 HTML (text/html)
    
    # Attachments 文件附属填写了如下，这个地址其实就是我项目中产生的报告
    target/test-output/report/*.html
    
    # Attach Build Log 附上构建日志我选上的就是 Attach Build Log
    
    # 点击 Advanced Settings... 进一步配置
    
    # 进一步配置中其他采用默认的
    
    # Triggers 中选择 Always，Send To 中选择 Recipient List 和 Developers 即可
    

Jenkins Job 配置完成！