# 邮件配置规则

# 流水线任务邮件通知

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脚本时可自定义想要获取的数据回填到该数据区

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

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

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

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

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

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

1、${templateName} : 模板名称

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

3、${templateType} : 模板类型

4、${templateDescription} : 模板描述

5、${templateResultName} : 操作结果

6、${templateTime} : 通知时间

# 自定义附件说明

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

文件名与上传文件同名

上次更新: 2023/4/12上午11:26:39