如何增加“Atom feed for all”的默认值

120次阅读

问题描述

在Jenkins的任何作业中，页面底部有一个名为“Atom feed for all”的按钮。点击该按钮会生成一个包含最近10次构建详情的XML文件。用户想知道是否有办法增加这个值，以获取更多的构建详情。用户是否需要管理员权限来进行操作？

解决方案

请注意以下操作注意版本差异及修改前做好备份。

方案1

在原始的Jenkins中，这个行为是硬编码的，无法更改或配置（你可以通过编写自己的插件来配置这个行为）。具体来说，行为是这样的：只要作业中至少有10个已完成的构建，Atom feed就应该至少包含10个构建。只有在过去7天内有超过10个已完成的构建时，Atom feed中才会有超过10个构建。
从源代码来看，rssAll页面使用newBuilds()方法获取所有新的构建：

public void doRssAll(StaplerRequest req, StaplerResponse rsp) throws IOException, ServletException {
    RSS.rss(req, rsp, "Jenkins:" + getDisplayName() + " (all builds)", getUrl(), getBuilds().newBuilds());
}

newBuilds()方法返回过去7天内的所有已完成构建，或者如果过去7天内的构建少于10个，则返回最近的10个构建：

public RunList<R> newBuilds() {
    GregorianCalendar cal = new GregorianCalendar();
    cal.add(Calendar.DAY_OF_YEAR, -7);
    final long t = cal.getTimeInMillis();
    // can't publish on-going builds
    return filter((Predicate<R>) r -> !r.isBuilding())
    // put at least 10 builds, but otherwise ignore old builds
    .limit(new CountingPredicate<R>() {
        @Override
        public boolean apply(int index, R r) {
            return index < 10 || r.getTimeInMillis() >= t;
        }
    });
}

因此，根据Jenkins的源代码，无法直接更改Atom feed中的构建数量。如果你需要获取更多的构建详情，你可以考虑以下解决方案：
1. 使用Jenkins插件：Jenkins有许多插件可以扩展其功能。你可以搜索并尝试使用一些与Atom feed相关的插件，看看是否有插件可以满足你的需求。
2. 编写自定义插件：如果没有现成的插件可以满足你的需求，你可以考虑编写自己的插件来实现自定义的Atom feed行为。你可以参考Jenkins插件开发文档来了解如何编写插件。

方案2

使用脚本或工具来修改Atom feed的默认值可能会增加复杂性，并且需要确保操作正确。
另一种方法是使用脚本或工具来修改Atom feed的默认值。你可以使用Jenkins提供的API或一些第三方工具来实现这个目标。以下是一个示例脚本，可以通过Jenkins API来修改Atom feed的默认值：

#!/bin/bash
# 获取当前作业的配置
JOB_CONFIG=$(curl -s -u username:password "http://jenkins.example.com/job/job_name/config.xml")
# 将Atom feed的默认值修改为20
NEW_CONFIG=$(echo "$JOB_CONFIG" | sed 's/<entries>10<\/entries>/<entries>20<\/entries>/')
# 更新作业的配置
curl -X POST -u username:password -H "Content-Type: application/xml" -d "$NEW_CONFIG" "http://jenkins.example.com/job/job_name/config.xml"

在这个示例中，我们首先使用curl命令获取当前作业的配置，并将其保存到变量JOB_CONFIG中。然后，我们使用sed命令将Atom feed的默认值从10修改为20，并将修改后的配置保存到变量NEW_CONFIG中。最后，我们使用curl命令将修改后的配置更新到Jenkins作业中。
请注意，上述示例中的username和password需要替换为你自己的Jenkins用户名和密码，jenkins.example.com需要替换为你的Jenkins服务器地址，job_name需要替换为你要修改的作业名称。
这种方法需要你具有足够的权限来修改作业的配置，并且需要确保脚本中的操作正确。在使用脚本或工具修改Jenkins配置之前，请务必做好备份，并在测试环境中进行测试，以确保操作不会对生产环境造成影响。

正文完