将文本添加到由 Jenkins 远程 API 触发的构建页面答案

【问题标题】：Adding text to the page of a build triggered by the Jenkins remote API将文本添加到由 Jenkins 远程 API 触发的构建页面
【发布时间】：2026-01-05 03:10:02
【问题描述】：

我为一个项目建立并运行了一个 Jenkins 构建系统。构建是通过 Jenkins 的远程 API 功能触发的。当对项目进行提交时，我们会向本地服务器上运行的 Jenkins 进程发送 HTTP 请求构建触发器；带有一个参数，该参数指定我们要签出和构建的 SVN 存储库中的主干项目文件夹的修订版。

我们还将修订版的 SVN 用户名和提交消息作为附加的 http 参数发送。所以 URL 看起来像：

http://server:8080/job/ProjectName/buildWithParameters?description=[commit message]&REVISION=[revision number]

我想在构建页面的某处显示此描述参数，但我没有发现通过远程 API 触发构建的明显方法。

我需要将参数命名为特定的名称还是此功能所需的插件？

【问题讨论】：

标签： http jenkins jenkins-plugins remoteapi

【解决方案1】：

添加描述的一种方法是添加构建描述。 Jenkins 在项目页面左侧的构建列表中的每个构建下显示一个简短的文本描述。

您可以使用Description Setter plugin 在您的构建中设置构建描述。

或者您可以使用 POST 将构建描述设置为 http://server:8080/job/ProjectName/latestBuild/submitDescription，并使用 POST 数据：description="YOUR_DESCRIPTION_HERE"。 latestBuild 令牌可以替换为特定的内部版本号（如果有）。

【讨论】：

/latestBuild 对我不起作用，但 /lastBuild 可以。唯一的问题是这设置了最后运行的构建的描述。如果你刚刚触发的构建还在排队，那么它不会有想要的结果

【解决方案2】：

有这个插件可以显示构建参数

https://wiki.jenkins-ci.org/display/JENKINS/Show+Build+Parameters+Plugin

【讨论】：

我试过这个插件，包含参数的框似乎不支持换行符。因此，如果提交消息中有任何换行符，那么它们似乎会被切断。有没有办法为这些字段启用文本换行？
或者，是否没有内置方法/插件可以仅编辑显示“无更改”的区域。还是通过远程 API 的“由用户匿名启动”文本？这似乎是一个非常基本的理想功能。