4.10_邮件配置规则与自定义附件说明

1、邮件配置规则

1.1）流水线任务邮件通知

    DevOps平台对构建任务、部署任务的邮件通知提供相应的构建邮件模板与部署邮件模板，可在系统参数和项目参数进行相关配置，用户可以根据自身的项目需求，设置自定义的模板

    a)系统参数，可以在DevOps的管理平台》系统配置》系统信息》系统参数 中对邮件模板进行配置

    b)编辑邮件模板，可对邮件模板进行配置，现DevOps提供默认的模板配置

    c)项目参数，可在具体项目的管理》高级》项目参数 中进行配置，默认为空，可根据情况进行添加配置，模板内容参考系统参数的邮件模板

    d)邮件使用规则：

      当项目参数的邮件模板进行了相应配置，则该项目优先使用该项目下项目参数的邮件模板，如果该项目下的项目参数的邮件模板未配置，则统一使用系统参数的邮件模板进行邮件发送

    e)邮件模板默认参数说明

          构建邮件模板参数：（默认参数，不可更改）

              1、${projectName} : 项目名称

               2、${buildDefinitionName} : 构建定义名称

               3、${buildResultName} : 构建执行结果

               4、${buildNumber} : 构建号

               5、${buildDate} : 构建时间

          部署邮件模板参数：（默认参数，不可更改）

               1、${projectName} : 项目名称

               2、${releaseDefinitionName} : 发布定义名称

               3、${deployResultName} : 部署发布结果

               4、${releaseEnvName} :发布环境

               5、${releaseInstanceName} : 发布实例名称

               6、${releaseDate} : 部署时间

    f)自定义的邮件模板参数

      邮件模板提供额外参数: 流水线任务的global区数据   

      global区数据说明：http://doc.primeton.com/pages/viewpage.action?pageId=26674388

      流水线任务赋值的global区数据，如有需要，可在邮件模板中进行添加

      示例：

      Groovy脚本中：pipelineContext.global.nexusArtifactUrl = stageResult.artifactUrl；

      邮件模板中可添加 ${nexusArtifactUrl} 获得；

      用户在拓展groovy脚本时可自定义想要获取的数据回填到该数据区

     注意：定义属性名称是唯一的，不可重复

1.2）构建定义、发布定义导出模板通知

     DevOps平台对构建定义、发布定义的导出模板功能提供模板邮件通知，可在系统参数进行相关配置，用户可以根据自身的项目需求，设置自定义的模板

a)系统参数，可以在DevOps的管理平台》系统配置》系统信息》系统参数 中对模板通知邮件进行配置

b)编辑模板通知邮件，可对模板通知邮件进行配置，现DevOps提供默认的模板配置

c)模板通知邮件默认参数说明（固定参数，不可更改）

     1、${templateName} : 模板名称

     2、${templateOperationType}:模板操作类型

     3、${templateType} : 模板类型

     4、${templateDescription} : 模板描述

     5、${templateResultName} : 操作结果

     6、${templateTime} : 通知时间

2、自定义附件 DevOps平台对构建任务、部署任务的邮件通知提供自定义的附件发送，该功能对需要发送关键文件进行通知提供解决方案

a)通过在任务流程中添加脚本执行，编写groovy脚本进行添加附件

b）groovy示例

       def attachment1 = [:]
       def attachment2 = [:]
       attachment1 = ['attachmentName':'附件.txt','attachmentUrl':'http://...','attachmentContent':null]
       attachment2 = ['attachmentName':'附件2.txt','attachmentUrl':null,'attachmentContent':'附件内容...']

       def attachments = []
       attachments.add(attachment1)
       attachments.add(attachment2)

       pipelineContext.global.notificationAttachments = attachments

      附件优先使用url发送附件，没有url则使用附件内容发送附件

c)groovy脚本参数说明（固定参数）

      pipelineContext.global.notificationAttachments :自定义附件标识

      attachmentName : 附件名称

      attachmentUrl : 附件URL

      attachmentContent : 附件内容

d)通过在任务流程中添加上传nexus任务，添加自定义附件

e)上传nexus附件规则

      上传文件至nexus，在属性导出里填写：artifactUrl|attachmentUrl（固定值） 即可，即 artifactUrl | attachmentUrl

      文件名与上传文件同名