创建所有用户的电子邮件列表

Question

有时我需要给所有 Jenkins 用户发送电子邮件，例如警告他们 Jenkins 将离线进行维护。下面的脚本为我提供了 Jenkins 认识的所有人的电子邮件地址，但它包括没有帐户的人，这些人已经提交了触发构建的更改。我想将他们从电子邮件列表中删除，即列表应该只包含您在 securityRealm 页面上看到的用户。我正在寻求修改脚本的帮助。谢谢。

import hudson.model.User
import hudson.tasks.Mailer

def users = User.getAll()
for (User u : users) {
    def mailAddress = u.getProperty(Mailer.UserProperty.class).getAddress()
    print(mailAddress + "; ")
}

Answer 1

首先您应该知道，Jenkins 不会总是能够告诉您用户是否存在。来自Jenkins' javadoc：

例如，当安全领域位于 servlet 实现之上时，就会发生这种情况，甚至无法知道给定名称的用户是否存在。

我找到了两个解决方案。

解决方案 1

HudsonPrivateSecurityRealm.html#getAllUsers() 返回所有可以登录系统的用户。这对我有用：

import hudson.model.User
import hudson.tasks.Mailer
import jenkins.model.Jenkins

def realm = Jenkins.getInstance().getSecurityRealm()
def users = realm.getAllUsers()
for (User u : users) {
    def mailAddress = u.getProperty(Mailer.UserProperty.class).getAddress()
    print(mailAddress + "; ")
}

注意：这取决于 Jenkins 配置，并且可能无法在使用另一个（不是 HudsonPrivateSecurityRealm）安全领域的系统上运行。

解决方案 2

SecurityRealm#loadUserByUsername如果用户存在则返回用户详细信息，否则抛出UsernameNotFoundException：

import hudson.model.User
import hudson.tasks.Mailer
import jenkins.model.Jenkins
import org.acegisecurity.userdetails.UsernameNotFoundException

def realm = Jenkins.getInstance().getSecurityRealm()
def users = User.getAll()
for (User u : users) {
    try {
        realm.loadUserByUsername(u.getId()) // throws UsernameNotFoundException
        def mailAddress = u.getProperty(Mailer.UserProperty.class).getAddress()
        print(mailAddress + "; ")
    } catch (UsernameNotFoundException e) { }
 }

这是一个棘手的问题，但应该适用于所有安全领域，因为我们使用存在于顶级抽象类 (SecurityRealm) 中的方法。