# Jenkins教程 - 6 接收构建通知

在 Jenkins 构建成功或失败的时候,我们可以配置邮件通知来相关的人员。

# 6.1 邮箱配置

这里我们是学习,所以使用免费的邮件服务,如果在实际的开发中,可以使用公司的邮件服务。

这里以 126 邮箱为例,使用 126 的邮件服务来发送邮件,使用 QQ 邮箱作为相关人员来接收通知。

首先需要有一个 126 的邮箱,然后在设置中找到 POP3/SMTP/IMAP 配置。


开启 POP3/SMTP服务 ,按照操作开启即可。

POP3、SMTP 和 IMAP 是与电子邮件相关的三种常见协议,它们分别用于接收和发送电子邮件:

  • POP3 :用于接收电子邮件;
  • SMTP :用于发送电子邮件;
  • IMAP :用于接收电子邮件,类似于 POP3,但提供更多的功能。

这里开启 POP3/SMTP服务 即可。

开启的时候,会有一个授权密码,需要记录下来。

在下面可以看到邮件服务器地址:

IVQDUJIZIDACKCKI
1

# 6.2 Jenkins配置

系统管理 --> 系统配置中配置:

# 1 配置Jenkins Location

找到 Jenkins Location 并配置

# 2 配置Extended E-mail Notification

在初始化 Jenkins 的时候,如果安装了推荐的插件,那么可以找到 Extended E-mail Notification 配置,如果没有安装,需要安装一下 Email Extension Plugin 插件。

这里针对构建事件发送通知的个性化配置:


添加邮箱凭证:

添加完邮箱凭证,然后选择使用这个凭证。

邮件格式选择 HTML 格式的,这样可以发送有格式的邮件内容:


后面还有邮件的主题、内容,我们可以编写自己的邮件格式:

Jenkins 内置了一些变量,可以在邮件标题和内容中引用。

这是我的邮件内容,可以参考一下:

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Jenkins 构建通知</title>
    <style>
        body {
            font-family: Arial, sans-serif;
            line-height: 1.6;
            margin: 20px;
        }
        .container {
            max-width: 600px;
            margin: 0 auto;
        }
        .header {
            background-color: #4CAF50;
            color: white;
            text-align: center;
            padding: 1em;
        }
        .content {
            padding: 1em;
        }
        .footer {
            text-align: center;
            padding: 1em;
        }
    </style>
</head>
<body>
    <div class="container">
        <div class="header">
            <h1>Jenkins 构建通知</h1>
        </div>
        <div class="content">
            <p>尊敬的团队成员:</p>
            <p>项目 <strong>${PROJECT_NAME}</strong> 的 Jenkins 构建已完成。</p>
            <p><strong>触发原因:</strong> ${CAUSE}</p>
            <p><strong>构建结果:</strong> ${BUILD_STATUS}</p>
            <p><strong>构建编号:</strong> ${BUILD_NUMBER}</p>
            <p><strong>构建链接:</strong> <a href="${BUILD_URL}">${BUILD_URL}</a></p>
            <p>谢谢!</p>
            <p>Jenkins 服务器</p>
        </div>
        <div class="footer">
            <p>这是来自 Jenkins 的自动邮件,请勿回复。</p>
        </div>
    </div>
</body>
</html>

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53

最后还有触发器的配置,什么时候发送邮件。

这里选择 Always ,成功失败都发送。

这里把成功和失败都勾选上。

# 3 配置邮件通知

邮件通知是系统级别的通知,系统出现问题的时候,会发送的通知。

不勾选 Use SSL,SMTP Port 为 25;勾选 Use SSL,SMTP Port 为 465 。


下面还有一个测试功能,看看配置是否有效。

测试是否成功,如果成功会收到邮件。

# 6.3 项目配置

需要在项目的构建后操作中配置接收人。

Project Recipient List 表示接收人列表。

点击高级配置,需要配置触发事件的接收人:


在前面我们配置了发送邮件的时机是 Always,所以这里针对 Always 配置新增一下 Recipient List,表示发送给上面配置的接收人邮箱。

如果针对 Failure 和 Success 也配置接收人列表,则会发送两次邮件,所以如果有 Failure 和 Success,就将其删掉。

# 6.3 测试通知

现在构建项目,查看是否能收到通知。

构建的时候,查看控制台信息,可以看到发送邮件的日志。


查看邮箱,可以看到接收到邮件了: