问题报告

如何报告问题

詹金斯J必威国际有限公司IRA不是一个支持网站。如果您需要帮助或有一般问题,请访问我们在聊天,或者给其中一个发邮件邮件列表

在产生问题之前

首先,确定这是什么样的问题。有三种主要类型的用法在本页解释:

  • 错误如某事没有按照预期的那样工作。

  • 新功能:你希望Jenkins必威国际有限公司有新的功能。

  • 改进:现有功能应改变。

其他类型(补丁任务)在JIRA中没有广泛使用。这两者都不会在这里解释。如果你想提出一个补丁,创建一个以上三种类型之一的问题,然后创建一个在GitHub上拉请求

在报告错误之前

  • 首先,搜索错误消息或一般问题描述.这可以帮助你找到解决方案,如果它实际上是一个配置问题,或指向你早些时候的报告,以防你不是第一个遇到这个问题。你可以在问题跟踪器中使用搜索,或者使用网络搜索。堆栈溢出也可能是一个搜索的好地方。任何结果通常会指向您早期发布的报告,如果它真的是一个bug。然后,您可以看着他们而且为他们投票JIRA。投票可以帮助我们确定bug的影响和它们的优先级。如果您怀疑您正在经历的问题与您发现的问题完全相同,那么可以提交一个新的问题(并在描述中提到您发现的问题)。

  • 确保问题出在詹金斯身上必威国际有限公司.如果你的构建似乎无缘无故地失败了,试着在Jenkins之外构建你的项目,但在相同的一般环境中(例如,相同的机器,相同的用户帐户,…)必威国际有限公司如果詹必威国际有限公司金斯与其他系统交互,确保它们能正常工作。如果Jenkins控制器和代理之间的连接失败,请确保网必威国际有限公司络是可靠的。

  • 检查更新日志查看受影响组件的较新版本中是否已修复该问题。对于詹金必威国际有限公司斯本身,回顾一下长期支持变更日志,LTS升级指南,每周的更新日志.如果您认为问题出在某个插件上,请查看特定插件的变更日志插件的网站.插件文档也可以通过点击插件名称直接访问管理詹金斯必威国际有限公司»管理插件»安装.如果您仍然无法解决问题,并且在Jenkins或插件的新版本中无法找到现有的问题报告或相关修复,请提交一个必威国际有限公司错误JIRA

在请求改进或特性之前

  • 检查Jenkins或插件的新版本必威国际有限公司这个特性。他们可能已经拥有这个功能了!

  • 搜索JIRA以查找现有的请求这个特性。然后,您可以关注他们,为他们投票.投票可以帮助我们确定请求的需求和优先级,所以您应该真正找到这些请求,而不是报告重复的请求。

如果你找不到任何东西,就提交一个改进新功能请求在JIRA

通过搜索现有的问题,我们可以更容易地处理问题报告,并通过选民和观察员的数量显示哪些问题被社区认为是重要的。它增加了相关变化的可能性。当一个问题被单独报道几次,每次只有几个观察者时,这就不那么明显了。

创建问题

你需要注册一个账户如果你还没有。然后,选择创建问题JIRA主页

  • 项目选择:

    • 必威国际有限公司关于詹金斯的一般性问题必威国际有限公司

    • 安全问题如果您想私下报告安全问题

  • 基础设施,如果您正在报告与由詹必威国际有限公司金斯项目运营的詹金斯服务,打开一个问题在Github上的专用帮助台

  • 输入简短但有意义的问题描述为总结

  • 优先级,请参阅在这里查看级别的描述。这不是多么迫切希望它固定.尽量现实一点:大多数bug应该优先级为Minor或Major。如果你找到了一个变通办法,降低优先级,即使这是一个严重的问题。

  • 作为组件中,选择核心如果是Jenkins本身的问题,而不是任何插件必威国际有限公司的问题。否则,选择插件的名称;它们都应该有一个相关的组件。你也可以选择多个组件,例如,如果问题出在组件的交互上,或者当你不确定的时候。

  • 离开受让人字段自动。

为环境和描述提供什么信息

很多关于如何用聪明的方式问问题也可以帮助你写出优秀的问题报告。

环境主要与bug报告相关:遇到问题的配置是什么?根据问题的类型,以下往往是相关的:

  • 操作系统(包括版本,是否32/64位)的所有系统(你的客户端,Jenkins服务器,所有代理节点),必威国际有限公司

  • 所有相关的JRE/JDK厂商及版本(如Oracle JRE, OpenJDK,…)和参数设置。

  • 必威国际有限公司Jenkins和插件版本,使用下面的代码片段必威国际有限公司管理Jenkins >脚本控制台

println("必威国际有限公司Jenkins: " + Jenkins.instance. getversion ()) println("OS: " +System.getProperty(' OS .name') + "- " +System.getProperty(' OS .version')) println "——"Jenkins .instance. pluginmanager .plugins .collect() .sort {it.getShortName()} .each {plugin -> println("${plugin. getshortname ()}:${plugin. getversion()}")}返回
  • 无论你是直接查詹金斯或是必威国际有限公司藏在集装箱里比如Tomcat(哪一个,在哪个版本?)

  • 是否通过a必威国际有限公司反向代理(如果是,它是如何配置的?)

  • 你是如何安装Jenkins的必威国际有限公司(Windows安装程序,deb/rpm,…),和你是如何启动相关特工的(通过SSH, web浏览器,命令行,…)

  • 你的网页浏览器(+版本)。确保问题发生支持的浏览器

如果这些信息对于Environment字段来说太多了,那么只需要在描述中添加一些即可。

Jenkin必威国际有限公司s的每个装置都有/系统信息带有关于Jenkins信息的URL。必威国际有限公司如果您不确定要提供什么信息,那么从复制页面上的所有内容开始是一个不错的选择。另一种选择是安装支持核心插件,它允许从Jenkins下载包含与调查bug报告相关信息的zip文件。必威国际有限公司


描述应该是全面的,以便让其他人立即了解问题或改进请求。关于包含哪些内容的一些建议(同样,主要适用于bug报告):

  • 了这个问题发生在升级之后詹金斯必威国际有限公司或其他插件?如果是,以前的版本是什么,现在的版本是什么?降级能解决问题吗?对于插件来说,以前的版本通常可以在Plugin Manager中看到(它提供降级到以前的版本)。

  • 包括日志输出和堆栈跟踪来自UI或任何客户端程序的错误消息。

  • 提供一个完整的一步一步的描述如何再现问题.我们看不到你的屏幕,所以要全面。考虑通过改变你的网页浏览器的配置来把Jenki必威国际有限公司ns的用户界面切换成英语,以获得正确的标签。

  • 如果可能,提供信息情况下问题发生(或不发生),例如。“仅当通过SSH启动代理时”,“仅当使用Tomcat作为容器时”,等等-这可能是一些工作,但它将使复制和修复问题更容易!

  • 如果新的Jenkins安装没有重用任何旧的配置或数据,会出现这个必威国际有限公司问题吗?尝试用全新的Jenkins安装重现这个问题必威国际有限公司尽可能少的定制。

  • 如果问题发生在与其他系统的交互(例如SCM),包括它们的版本和其他相关的配置。

  • 如果詹金斯用户必威国际有限公司界面不再响应,获取线程转储例如(在Linux上)杀死-3 jstack -l <必威国际有限公司Jenkins PID>

在创建问题之后

一旦你制造了一个问题,一定要回复额外信息的请求,否则您的问题可能会被视为“不完整”。

如果您在Jenkins中报告了一个回归(即在更新Jenkins之必威国际有限公司后出现了一个bug),请考虑离开社区的反馈在更新日志让别人知道。

保持问题的更新.这包括,例如:

  • 如果您发现了可能与问题相关的其他信息,请将其添加到问题描述或撰写评论。

  • 如果发现您报告的错误实际上是其他问题,那么就解决它。(如果你只找到了一个解决方法,那么现在就不要解决它。)

  • 如果新的Jenki必威国际有限公司ns版本不再受该问题的影响,或实现了您要求的功能,请确保将您的问题标记为已修复。例如,如果有其他关于这个问题的报告,或者开发者自己注意到这个问题,这种情况就会发生。

Baidu