Rational Team Concert "> 团队音乐会|詹金斯插件必威国际有限公司 - betway必威足彩

Team Concert

ID:teamconcert
请注意
在GitHub上查看此帮助页面README.adoc如果链接导航遇到问题。

集成了詹金斯与必威国际有限公司Rational Team Concert源控制而且构建使用构建工具包更丰富的特性而不是命令行。

通过构建工具包,该插件添加了从Jenkins构建到RTC构建结果、工作区和快照的可追溯性链接。必威国际有限公司它还发布到工作项、更改集和快照中捕获的文件内容的链接。它利用了当前RTC功能和用户已经熟悉的工作流程,如邮件、烤面包机弹出窗口、报告、仪表板等。

表的内容

文档

产品名称改变

在7.0版本发布时,Rational Team Concert现在被称为工程工作流管理。Team Concert Plugin支持RTC版本6.0到6.0.6.1和EWM版本7.0到7.0.2。在本文档中,无论您在哪里找到Rational Team Concert(RTC),您都可以用工程工作流管理(EWM)代替它。

需求

必威国际有限公司

  • Team Concert Plugin v 2.1.0或更高版本需要Jenkins 2.60必威国际有限公司.1或更高版本,Java 8或更高版本。必威国际有限公司Jenkins 2.277.1 LTS已经在最新版本中进行了测试。

  • Team Concert Plugin v 1.2.0.5或更高版本需要Jenkins 1.62必威国际有限公司5.1或更高版本。修复Jenkin必威国际有限公司s -26100需要Jenkins 2.60或更高版本,工作流-job 2.12或更高版本。

  • Team Concert Plugin v 1.1.9.3到v 1.2.0.4需要Jenkins 1.580必威国际有限公司.1或更高版本。

  • Team Concert Plugin v 1.1.2及以后版本依赖于必威国际有限公司Jenkins凭证插件版本1.10或更高版本。

清债信托公司

  • 这个插件需要Rational Team Concert构建工具包版本6.0或更新。该插件的旧版本支持从3.0.1.5开始的构建工具包版本。看到安装构建系统工具包帮助主题以学习如何安装构建工具包。

  • 对于所有支持的构建配置—构建定义、存储库工作区、流和快照—在主机器和代理机器上都应该提供有效的构建工具包Jenkins作必威国际有限公司业应该配置为使用这个工具包。

  • 一些特性依赖于特定的Rational Team Concert构建工具包或服务器版本。见下文。

    • 流配置只能在构建工具包v5.0.2或更高版本中工作。

    • Team Concert Plugin v. 1.2.0.3中引入的Build后交付Build定义配置依赖于Rational Team Concert服务器版本6.0.4或更高版本。

    • 构建定义中对加载规则的支持对用于创建构建定义的RTC客户机的版本有一些要求。看到加载规则支持章节了解更多详情。

    • 如果要获取包含符号链接的工作区,则需要进行一些额外的符号链接设置。看到符号链接的支持章节了解更多详情。

    • 只有使用构建工具包版本6.0及以上,才能在构建日志中获得构建工具包的版本详细信息。

必威国际有限公司詹金斯配置

添加一个新的Build Toolkit

  1. 导航到Jenkins全局工具配置必威国际有限公司页面(Jenkins >管理Jenkins >全局工具配置),并找到“RTC构建工具包”部分。此部分用于定义插件可用的一个或多个构建工具包。如果你使用詹金斯1。必威国际有限公司x,这将在(Jenkins→管理Jenkins必威国际有限公司→配置系统)

    图像
  2. 单击“RTC构建工具包安装…”按钮并添加一个新的构建工具包。

    1. 看到安装构建系统工具包帮助主题以学习如何安装构建工具包。

    2. 可以有多个RTC构建工具包与一个jenkins实例相关联。必威国际有限公司

      图像
  3. 单击“Apply”按钮应用更改。

更新RTC全局配置

  1. 进入“Jenkins全局配置”页必威国际有限公司面(管理Jenkins→配置系统)。

  2. 找到“Rational Team Concert (RTC)”部分。本节用于定义全局连接设置,这些设置将是使用插件创建的任何作业的默认设置。如果将在每个作业上设置连接设置,则跳过此部分。

  3. 选择一个构建工具包

    图像
  4. 控件管理凭据凭证插件.Team Concert插件支持用户名和密码类型凭据。凭据可以在域或文件夹中定义(如果您使用文件夹的插件)。您可以使用应用程序密码来代替常规密码。

    图像
  5. 选择登录到RTC进行轮询和接受/加载源代码时要使用的凭据。

    图像
    • 如果您正在使用Team Concert插件的1.0.12(或更早的)版本,而不是凭证,您将需要提供userId和密码或密码文件。

  6. 单击“测试连接”按钮以验证存储库连接细节。

    图像
  7. 单击保存按钮保存设置并返回到Jenkins主页。必威国际有限公司

作业配置-自由式作业

请注意
本节展示了如何在freestyle作业中配置Team Concert Plugin来从RTC SCM加载源代码。
  1. 创建一个新的自由风格的软件项目,并找到源代码管理部分。

  2. 选择“Rational Team Concert (RTC)”。

  3. 如果未在上面配置全局连接设置或不适用于此作业,则检查覆盖全局RTC存储库连接复选框并在这里输入连接设置。

    图像
  4. 单击“测试连接”按钮以验证存储库连接细节。

    图像
  5. 在1.2.0.0之前,作业只能使用构建定义或存储库工作区来配置RTC SCM。从1.2.0.0开始,支持使用SCM流或SCM快照配置RTC SCM。

为生成定义进行配置

  1. 要从这个插件和RTC构建之间的集成中获益最多,请从构建配置下拉菜单中选择“构建定义”,并输入一个构建定义ID。看到哈德逊/詹金斯必威国际有限公司建造发动机类型帮助主题学习如何创建Jenkins构建定义。必威国际有限公司按照以下步骤设置Jenkins构建定义和Jenkins作业,必威国际有限公司以避免陷入两难境地。Je必威国际有限公司nkins作业需要Hudson/Jenkins构建定义,Hudson/Jenkins构建定义需要Jenkins作业。RTC实际上不允许在没有选择作业的情况下保存构建定义。然而,Jenkin必威国际有限公司s允许您在没有构建定义的情况下保存作业。因此,以这种方式配置您的构建定义和作业非常重要。

    1. 在Je必威国际有限公司nkins中,首先使用RTC创建作业以进行源代码控制,但不使用构建定义。离开构建的定义文本框空白。

    2. 保住詹金斯的工作。必威国际有限公司

    3. 在RTC中,创建连接到Jenkin必威国际有限公司s服务器的Jenkins构建引擎。看到创建构建引擎.在RTC中,创建使用在步骤b中创建的构建引擎的构建定义,并选择在步骤a中创建的作业。请参见创建构建定义

    4. 最后,在Jenkins必威国际有限公司中,打开Jenkins作业并设置构建的定义字段,使用在步骤c中创建的构建定义的id。

      图像
    5. 注意“Build Configuration”下拉菜单。这替换了Team Concert Plugin 1.2.0.0版本之前的构建定义和构建工作区的单选按钮。

    6. 单击“Validate”按钮以验证RTC构建定义是否存在。

配置存储库工作区

  1. 要将RTC存储库工作区加载到Jenkins工作区中,请从Build Configurat必威国际有限公司ion下拉菜单中选择“Build workspace”。看到专门建立工作区帮助主题以了解如何创建构建工作区。

    图像
  2. 单击“Validate”按钮以验证RTC构建工作区是否存在。

  3. 要在所有包含的工作项中向Jenkins构建添加“Related Artifa必威国际有限公司ct”链接,请选择该选项添加Je必威国际有限公司nkins构建链接到已接受的工作项选择。

    图像

配置为快照

  1. 要使用快照加载jenki必威国际有限公司ns构建工作区,请从build Configuration下拉菜单中选择“build napshot”。此配置主要用于捕获快照中RTC SCM工作空间/流的当前状态的构建,并启动下游构建,这些构建将从创建的快照和从上游构建传递的快照填充jenkins构建工作空间。必威国际有限公司

    图像

    注意:要启动下行快照构建,需要使用Parameterized Trigger插件。

  2. 以下步骤说明如何配置父Jenkins作业以触发下游Jenkins作业。必威国际有限公司父作业被配置为使用Build Definition、Repository Workspace或SCM流。下游作业被配置为使用SCM快照。父作业触发下游作业,传递将用于加载源的快照UUID。

    1. 考虑一个配置为从RTC存储库工作区加载的父作业。当构建运行时,Team Concert Jenkins插件在构建工作必威国际有限公司区上创建一个快照。快照uuid可以作为构建环境属性team_scm_snapshotUUID使用。

      1. 添加一个生成后操作,以触发其他项目上的参数化生成。

        图像
    2. 配置下行快照构建

      1. 创建一个新作业,其字符串参数名为rtcBuildSnapshot.为此,您可以使用任何参数名。

        图像
      2. 在Source Control选项下配置Rational Team Concert以从快照构建。

        图像
    3. 现在,当上游构建启动并完成后,它将使用在工作区上创建的快照的UUID触发下游构建。
      注意:快照配置不支持生成更改日志和轮询。

配置的流

  1. 要使用流加载jenkin必威国际有限公司s构建工作区,请从构建配置下拉菜单中选择“构建流”。

    图像
  2. 单击“Validate”按钮以验证构建流是否存在。

  3. 此配置支持从指定流的当前状态构建。

  4. 后续构建捕获自上一个构建以来对流所做的更改。

  5. 在此配置中,可以通过比较当前构建与之前成功构建来选择生成更改日志。默认情况下,此选项未选中。

    图像

    注意:对于此配置,全局配置的RTC用户或此作业需要具有将快照附加到流的权限。

加载选项

在1.2.0.0中,一些以前只能在RTC构建定义中配置的加载和接受选项现在可以配置为存储库工作区、流和快照配置。

  1. 可以指定构建机器上装入存储库文件的目录。

  2. 加载目录的内容可以在重新加载之前删除

  3. Load Policy字段,在1.2.0.4中新增,用于配置加载组件。您可以指定要加载的组件,也可以选择使用远程加载规则文件或动态加载规则,以确定要加载哪些组件。

    1. 指定要加载的组件

    2. 当指定要加载的组件时,您可以选择为组件创建文件夹,在这种情况下,加载目录将有位于顶层的组件文件夹,每个文件夹将有该组件的文件/文件夹。

    3. 您还可以选择排除一些组件。

      图像
    4. 使用加载规则文件加载组件

      图像
    5. 使用动态加载规则加载

      图像
      请注意
      有关加载规则支持和如何配置动态加载规则的详细信息,请参见加载规则支持部分。

接受的选项

请注意
仅适用于Repository工作区配置
  1. 当从RTC存储库工作区加载jenk必威国际有限公司ins构建工作区时,有一个选项可以配置在加载之前是否接受最新的更改。缺省情况下,该选项被选中。

    图像

可追溯性的选择

请注意
仅适用于存储库工作区和流配置
  1. 添加一个相关的工件链接到所有包含的工作必威国际有限公司项中的Jenkins构建,选择选项“添加Jenkins构建链接到接受的工作项”选项。这适用于存储库工作区和流配置。

    图像

建立触发器

通过轮询更改来触发构建

调查SCM,只有当Team Concert Plugin检测到的变化。对于构建定义、存储库工作区和流配置,计算新更改的逻辑是不同的。对于构建定义和存储库工作空间,Team Concert Plugin将存储库工作空间与流目标进行比较。对于流,快照来自以前的构建与流进行比较。如果前一个构建没有快照,则考虑该构建之前的构建。

新的更改可以是以下任何一种或全部更改

  • 流目标中的更改没有出现在存储库工作区中。

  • 在流目标中丢弃的更改,或者在存储库工作区中创建的更改,没有交付到流。

  • 在流目标中添加的组件

  • 从流目标中删除的组件。

配置轮询,

  1. 找到建立触发器部分。

  2. 检查调查SCM选中复选框以轮询新更改。

  3. 输入一个时间表。单击“Schedule”字段旁边的帮助按钮以获得语法方面的帮助。

  4. 单击保存按钮保存设置并返回作业页面。

请注意
对于管道作业,设置民意调查布尔属性设置为true结帐步骤中,除了配置上述步骤中提到的轮询间隔之外。

触发建立在一个时间表上

您可以将作业配置为在特定时间构建,而不管源代码中是否有新的更改。

  1. 找到建立触发器部分。

  2. 检查建立定期复选框。

  3. 输入一个时间表。单击“Schedule”字段旁边的帮助按钮以获得语法方面的帮助。

  4. 单击保存按钮保存设置并返回作业页面。

为后生成交付配置Jenk必威国际有限公司ins作业(仅针对生成定义配置)

请注意
从1.2.0.3开始,Build Definition配置支持Post Build Deliver。RTC服务器版本应该是6.0.4或更高版本。

要为后生成交付进行配置,
.使用后生成交付配置配置RTC生成定义。
.在Jenkin必威国际有限公司s Freestyle作业配置中,添加RTC后构建交付文章构建的行动。选择失败的错误,如果您希望在生成后交付失败时生成失败。
.在Pipeline作业中,在脚本结束之前添加以下代码片段,以执行构建后交付,作为构建的最后一步。

step([$class: 'RTCPostBuildDeliverPublisher', failOnError: true])

从代码片段生成器为团队协调插件生成管道代码段,用于RTC SCM和后构建交付

对于管道作业,您可以使用管道代码片段生成器为Team Concert Plugin生成代码片段。看到帮助文档有关如何创建代码段的详细信息。在代码片段生成器中,

  • 对于RTC单片机片段,

    • 单击样一步下拉菜单并选择checkout。然后选择Rational Team Concert从下拉。*对于后构建交付片段,

    • 选择一步样一步下拉选择RTC后构建交付

使用Snippet Generator时的最佳实践

如果您选择在管道片段中使用Team Concert Plugin的全局配置(在Jenkins→Settings中),则删除对serverURI、credentialsId的引用。必威国际有限公司

即使您不选择覆盖在System Settings中定义的Team Concert Plugin的全局配置,代码段生成器也会复制的值serverUricredentialsId而且buildtoolkit从代码片段中的全局配置复制。如果将此代码段复制到管道脚本中,当您打算更改全局服务器URI、凭据和构建工具包时,它可能会产生维护问题。如果您打算对RTCScm配置使用全局设置,那么请删除代码片段中的以下属性

  • serverURI

  • credentialsId

  • 超时

  • buildTool

  • overrideGlobal

然后将生成的代码片段复制到管道脚本中。

使用SCM中的管道脚本

Team Concert Plugin支持SCM中的管线脚本,但不支持轻量级签出。在RTC SCM中使用这个管道特性的一些方法使用Team Concert插件与供应链管理的管道

使用声明式管道时的注意事项

如果使用声明式管道,则每代理指令将导致签出发生在代理中,使用与SCM中的Pipeline Script相同的配置。当使用构建定义、流或工作区配置时,这将导致在每种情况下发生接受,导致在每个代理中加载不同的内容。在构建定义的情况下,如果从Jenkins触发构建,则将创建一个附加的构建结果。必威国际有限公司这可能是你想要的,也可能不是。如果你想防止每个代理指令的额外签出,在代理指令下面添加一个options指令skipDefaultCheckout(真正的)

选项{skipDefaultCheckout(真正)}

主/代理配置

这个插件支持主和代理配置。参见Jenkin必威国际有限公司s文档分布式构建为更多的信息。主服务器需要RTC构建工具包主路径才能测试连接和构建工件。

  1. 导航到计算机页面(Jenkins >管理Jenkins >管理必威国际有限公司节点),并单击“新节点”链接。

  2. 输入名称并创建一个新节点。

  3. 在节点配置页面中,找到节点属性部分,检查工具的位置复选框。

  4. 从工具位置列表中,选择要为节点定义的构建工具包,并在首页字段。

    图像

    注意:如果您不希望覆盖工具位置,那么Team Concert Plugin将尝试在全局工具配置中指定的相同位置定位工具包

构建工具包也可以自动安装在代理上。标签可以用来匹配构建工具包和代理。但是,在主节点中需要一个有效的工具包来执行连接测试,以构建工件和执行轮询。

图像

RTC日志

您可以从Team Concert插件捕获日志,以调试您可能遇到的任何问题。

配置Java日志

  1. 导航到Jenkins日志页面(J必威国际有限公司enkins > Manage Jenkins > System Log),并单击添加新的日志记录器按钮。

  2. 例如,提供一个名称RTC日志并单击添加按钮,添加日志记录器。

  3. 为其输入记录器com.ibm.team.build并设置日志级别为

    图像
  4. 单击保存按钮。

  5. 如果在使用该插件时遇到问题,则返回此日志。日志将有助于识别问题。

  6. 登录代理

    1. 在代理上,虽然消息是在FINER级别记录的,但日志永远不会返回。

在生成控制台日志中配置日志记录

  1. 支持调试标志,它将导致调试输出进入构建的控制台日志

  2. 环境变量com.ibm.team.build.debug与价值真正的将激活代理上的调试日志记录。

  3. 要在单个代理上配置所有版本的调试标志,

    1. 进入Jenk必威国际有限公司ins >管理Jenkins >管理节点。

    2. 将鼠标悬停在节点的链接上进行配置。从弹出的上下文菜单中选择Configure。

    3. 在“节点属性”部分,选择并选中“环境变量”复选框

    4. 单击键值对列表旁边的Add按钮。

    5. 供应com.ibm.team.build.debug正如名字和真正的的价值

    6. 单击Save按钮。

  4. 也可以在主代理和所有代理上配置调试标志

    1. 必威国际有限公司Jenkins >管理Jenkins >配置系统

    2. 在“全局属性”部分中,选择并选中“环境变量”复选框

    3. 单击键值对列表旁边的Add按钮。

    4. 输入com.ibm.team.build.debug正如名字和真正的的价值

    5. 单击Save按钮。

  5. 要为单个作业配置调试,请添加com.ibm.team.build.debug作为作业的参数,并将其值设置为真正的

调试标志目前只记录与类装入器设置相关的信息。在主服务器或代理服务器上运行不会影响其他逻辑,因此如果需要这些日志,请考虑在主服务器上运行以获取详细的日志。

记录构建工具包的版本

如果您已打开该变量com.ibm.team.build.debug,通过环境变量或作为作业参数,则该生成的主和代理中使用的生成工具包的版本将出现在生成日志中。

您应该在构建日志中看到如下消息。

" on master is "6.0.4". Version of build toolkit "" on "" is "6.0.4".">
主版上的构建工具包“”版本为“6.0.4”。构建工具包“”在“”上的版本是“6.0.4”。

为不同的构建配置收集节拍器日志

为生成定义进行配置
  1. 将以下生成属性添加到生成定义中。

    1. 的名字,team.build.reportStatistics

    2. 价值——真正的

  2. 在RTC Eclipse或RTC Web UI中打开构建定义编辑器,单击Properties选项卡并添加属性。

  3. 从詹金斯控制台运行必威国际有限公司一个构建。

  4. 打开与Jenkins构建相关联的构建结果。必威国际有限公司

  5. 单击“日志”页签。

  6. 您应该会看到两个文件统计数据——<时间戳> . log而且statisticsData——<时间戳> . log

配置存储库工作区、流和快照
  1. 将以下String Job属性添加到Jenkins作业中。必威国际有限公司

    1. 的名字,team.build.reportStatistics

    2. 价值——真正的

  2. 从詹金斯控制台运行必威国际有限公司一个构建。

  3. 在托管Jenkins主机的机器中,转到必威国际有限公司<必威国际有限公司jenkins config dir>/jobs//builds//teamconcert/diagnostics . /jobs//builds//teamconcert/diagnostics .

  4. 您应该会看到两个文件统计数据——<时间戳> . log而且statisticsData——<时间戳> . log

在Jenkins构建期间可用的RTC构建属性必威国际有限公司

在Rational Team Concert源代码控制步骤完成后,可以在构建中作为环境变量访问以下属性。

财产 描述

team_scm_changesAccepted

在构建期间接受或忽略的更改的数量。

team_scm_snapshotUUID

接受修改后创建的快照的UUID。如果不创建快照,则不设置。

team_scm_workspaceUUID

构建中使用的Repository工作区的UUID。仅在构建使用构建定义时设置。

buildResultUUID

构建结果的UUID。仅在构建使用构建定义时设置

RTCBuildResultUUID

构建结果的UUID。仅在构建使用构建定义时设置

requestUUID

构建请求的UUID。仅在构建使用构建定义时设置。

buildDefinitionId

构建所使用的构建定义的UUID。仅在构建使用构建定义时设置。

repositoryAddress

RTC存储库的地址。

buildEngineId

与生成请求/结果相关联的生成引擎的名称(如果存在生成结果)。一个RTC构建引擎实际上没有运行,但是一些ant任务需要引擎id。

buildEngineHostName

运行构建所依赖的Jenkins主机必威国际有限公司或代理的主机名。

buildRequesterUserId

请求启动生成的RTC用户的用户id。仅在构建使用构建定义时设置

personalBuild

如果构建是个人构建(从RTC请求),则为True,否则不设置

rtcTempRepoWorkspaceName

在使用流配置构建期间创建的临时存储库工作区的名称

rtcTempRepoWorkspaceUUID

在使用流配置构建期间创建的临时存储库工作区的UUID

除了这些内置属性外,在使用构建定义配置时,所有在构建定义中设置的以及在请求构建时可能修改的构建属性都将在Team Concert插件运行后作为Jenkins构建中的环境变量可用。必威国际有限公司

在Freestyle作业中访问RTC属性

在自由式作业中,在Team Concert Plugin完成将源代码下载到Jenkins工作区之后,您可以使用以下语法访问Team Concert Plugin导出的属性。必威国际有限公司

在Windows上

% < propertyname > %

在Unix / Linux

propertyname美元

Team Concert Plugin导出一些标准属性和用户定义的构建属性(仅用于构建定义配置)。有关内建属性的列表,请参见本节

在签出步骤之前访问Pipeline作业中的RTC属性-仅构建定义

在构建定义配置中,如果Jenkins构建是从RTC启动的,则您甚至可以在签出步骤运行之前必威国际有限公司访问管道构建中RTC构建结果中设置的构建属性。这些属性可以是在生成结果中设置的任何RTC内置属性,也可以是用户定义的生成属性。

要从构建定义访问RTC构建属性,必须在Jenkins作业中创建与RTC构建属性同名的String参数。必威国际有限公司实际值将由启动Jenkins构建的RTC构建结果设置。必威国际有限公司在请求RTC生成时,可以向用户定义的RTC生成属性提供不同的值。

即使在签出步骤运行之前,Jenkins构建也可以使用以下内置属性。必威国际有限公司

财产 描述

buildResultUUID

构建结果的UUID。仅在构建使用构建定义时设置

requestUUID

构建请求的UUID。仅在构建使用构建定义时设置。

buildDefinitionId

构建所使用的构建定义的UUID。仅在构建使用构建定义时设置。

repositoryAddress

RTC存储库的地址。

buildEngineId

与生成请求/结果相关联的生成引擎的名称(如果存在生成结果)。一个RTC构建引擎实际上没有运行,但是一些ant任务需要引擎id。

buildEngineHostName

运行构建所依赖的Jenkins主机必威国际有限公司或代理的主机名。

buildRequesterUserId

请求启动生成的RTC用户的用户id。仅在构建使用构建定义时设置

personalBuild

如果构建是个人构建(从RTC请求),则为True,否则不设置

例如,考虑这样一个场景,您想知道启动此管道构建的RTC构建结果是否是个人构建。

  1. 首先在Jenkins管道作业中创建一个作业参数“personalBuild”类型为String,并将默认值设置为false。必威国际有限公司

图像

2.在与Jenkins作业关联的RTC构建定义中请求一个个人构建。必威国际有限公司

3.在管道脚本中,您可以检查RTC构建是否是个人构建,如下所示

如果(“$ {env。personalBuild}" == "true") {// Do something} else {// Do something}} //或if ("${personalBuild}" == "true") {// Do something} else {// Do something}}

4.要在脚本中访问buildRequesterUserId属性,需要为Jenkins作业定义一个名为“buildRequesterUserId”的新String参数,并将默认值设置为空字符串。必威国际有限公司

5.回到管道脚本中,您可以访问属性为

“$ {env。构建RequesterUserId}" // or "${buildRequesterUserId}"
请注意
这与在签出步骤运行后访问personalBuild属性不同。在这种情况下,personalBuild属性将被签出步骤重置,并且只能通过${env}变量访问。在这里,该属性是在启动Jenkins构建时由RTC设置的,甚至在签出步骤运行之前。必威国际有限公司

签出步骤后在管道作业中访问RTC属性

道具结帐step现在返回一个由Team Concert插件填充的映射。例如,您可以将结帐步骤的返回值存储到scmvars变量中,并使用“$\{scmvars”语法访问它们。< rtc环境变量>}”。有关导出到环境的内置属性列表,请参见本节

checkoutstep

def scmvars = checkout([$class: 'RTCScm'…])

当您使用Team Concert Plugin版本> 1.2.0.5,Jenkins版本> 2.60,workflow-cps版本> 2.40时,此功能可用必威国际有限公司。指发行26100有关问题。

使用env对象在管道作业中访问RTC属性

您可以在签出步骤运行后使用env对象访问RTC Environment属性。您将需要使用工作流-cps插件版本> 2.40。

例如,在每次签出之后,您可以将快照UUID值保存到一个单独的变量中,如下所示

“$ {env回响。节点{checkout([$class: 'RTCScm'…])//此时,env包含来自第一个签出def snapshotUUID1 = "${env. $ $class: 'RTCScm'…]的RTC相关环境变量。team_scm_snapshotUUID}" echo "${snapshotUUID1}" checkout([$class: 'RTCScm' ....]) // At this point, env contains RTC related environment variables from the second checkout. The environment variables contributed by the first checkout are overwritten. def snapshotUUID2 = "${env.team_scm_snapshotUUID}" echo "${snapshotUUID2}" }

参考文献

请注意
报告的问题缺陷370979 -在管道脚本中,如果在运行teamconcert签出步骤之前访问了env对象,则快照的环境变量、构建结果UUID为空这个问题在jazz.net上报道过论坛帖子如果你使用新的工作流-cps插件,将会间接修复。

通过RTCBuildResultAction对象访问RTC属性

如果您正在使用workflow-cps < 2.40,请遵循下面提到的解决方法。

在管道作业中,如果在RTC SCM签出步骤之前访问了一次env对象,则Team Concert Jenkins插件发布的环境变量为空。必威国际有限公司例如,下面的脚本将返回Team Concert插件发布的快照的UUID。

节点('master'){//运行teamconcert SCM步骤echo "${env. $ "team_scm_snapshotUUID} "}

但是在下面给出的脚本中,在运行签出步骤之前访问一次env对象,因此从env对象访问快照UUID返回null

“$ {env回响。BUILD_NUMBER}" node('master'){//运行teamconcert scm step echo "${env. step "team_scm_snapshotUUID} "}

尽管Team Concert插件在调用签出时发布环境变量,但在管道脚本中,一旦构建了env对象,就不会用任何稍后发布的环境变量进行刷新。

如果您在访问Team Concert插件发布的环境变量时遇到问题,建议的解决方法是访问由Team Concert插件添加到构建中的RTCBuildResultAction对象。下面的代码返回存储在RTCBuildResultAction对象中的构建属性。这可以在管道脚本中使用,以获取快照UUID。

def buildProps = action. getbuildproperties () println(buildProps['team_scm_snapshotUUID'])

如果您多次调用RTC SCM,那么在构建中将会有许多RTCBuildResultActions。因此,应该使用currentBuild.build(). getactions (com.ibm.team.build.internal.hjplugin.RTCBuildResultAction.class)。由RTC SCM的最后一次调用添加的操作应该在列表的末尾可用。例如,如果有两个RTCScm签出,第二个RTCBuildResultAction可以按如下方式访问。

def actions = currentBuild.build().getActions(com.ibm.team.build.internal.hjplugin.RTCBuildResultAction.class) def buildProps = actions.get(1).getBuildProperties() println(buildProps['team_scm_snapshotUUID'])
请注意
Jenki必威国际有限公司ns管理员应该将这些方法列入白名单,以便在管道脚本中访问它们。您应该考虑将这些方法添加到全局共享库中。这将在下一节中进行解释。
包装代码以访问全局共享库中的RTCBuildResultAction

如果没有管理员将Jenkins中的api列入白名单,就不能在管道脚本中直接使用上述代码。必威国际有限公司您可以将此代码包装在方法中,并将其添加到全局共享库中。然后可以从管道脚本调用该方法。

如果您已经在您的环境中使用全局共享库,请在一个名为rtcutils的文件中添加以下代码。Groovy,并将该文件放在var目录,

def getSnapshotUUID(actionNum){//第n个RTCBuildResultAction。def actions = currentBuild.build().getActions(com.ibm.team.build.internal.hjplugin.RTCBuildResultAction.class) if (actions != null && actions.size() > 0 && actionNum > 0 && actionNum <= actions.size()) {def buildProps = actions.get(actionNum-1).getBuildProperties() return (buildProps['team_scm_snapshotUUID'])} return null}

然后,在管道脚本中,您可以编写以下代码来获取签出步骤的snapshotUUID。

@Library('your-shared-library')_ node {checkout([$class: 'RTCScm'…])//如果从RTC获取共享库,则通过2或更大的值,否则通过1。//如果库从RTC获取,则有一个RTCBuildResultAction对应于该签出。//因此你需要通过2个或更多,这取决于在@Library指令之后调用了多少个EWM (RTC)签出。def snapshotUUID = rtcutils.getSnapshotUUID(2) echo "${snapshotUUID}"}

如果您的环境中没有定义全局共享库,请参见使用共享库进行扩展用于在管道脚本中创建和访问共享库。注意,如果您使用RTC托管全局共享库,那么将从RTC签出源代码。RTCBuildResultAction将在库签出到管道脚本的位置添加到构建中。

符号链接的支持

请注意
符号链接在Java版本7及更高版本中开箱即用。以下信息为较老的Java版本保留。

对符号链接的RTC支持需要一个或两个附加库(.dll/。所以文件)。

  1. RTC文件系统本机

  2. Eclipse文件系统原生程序

原因是Java 6和更早的版本不支持创建/查看符号链接的属性。Java 7支持在linux上工作的符号链接,但是在Windows上创建链接时有一些限制(如果目标尚未创建,则默认类型为文件,如果是目录则不好)。如果您正在运行Linux并且可以使用Java 7,那么您只需要Eclipse原生版本。否则,您将同时需要RTC和Eclipse原生版本。

在构建引擎目录(<您的RTC构建安装目录>\buildengine\eclipse\plugins)中,查找(或您的平台/版本的等价jar)。

  1. com.ibm.team.filesystem.client_3.1.600.v20130415_0257.jar(RTC文件系统本机)

  2. org.eclipse.core.filesystem.win32.x86_1.1.201.r36x_v20100727 - 0745. - jar(Eclipse文件系统本机)

从要提取的com.ibm.team. filessystem .client jar中+ winfsnatives.dll ++ libfsnatives.so +在linux上)。获取所有的.dll/。org。eclipse。core。filesystem jar中的文件。把它们直接放在一个目录中。c: \当地人\ winfsnatives.dll)。

在启动Jenkins时,我们需必威国际有限公司要将目录的信息告知java,以便它能够从该目录加载库。为此,您可以将目录添加到搜索路径中。

改变路径变量或+ LD_LIBRARY_PATH +变量在启动Jenkins之前。必威国际有限公司方法启动Java时也可以指定它+ -Djava.library.path +设置。
如。

java -Djava.library.path="c:\本机;%Path%" -jar jenki必威国际有限公司ns-1.509.1.war . Path ="c:\本机

如果您在Windows上运行,则需要确保您拥有创建符号链接的权限。的符号链接的文章在jazz.net库中描述了如何。

请注意
如果您在代理上运行jenkins构建,而符号链接必威国际有限公司加载失败,那么本机库也应该包含在代理的JVM库路径中。

加载规则支持

  1. 当jenkin必威国际有限公司s构建配置了RTC构建定义时,将在加载jenkins构建工作区时应用RTC构建定义中指定的组件加载规则(如果有的话)。构建中的组件加载规则描述如何在生成定义中指定加载规则。

  2. 当jenkin必威国际有限公司s构建配置了RTC存储库工作区、流或快照加载规则时,可以通过将加载策略字段设置为“使用加载规则文件加载组件”来指定加载规则。图像

  3. 要在管道构建中配置加载策略,请将“loadPolicy”字段设置为“useComponentLoadConfig”、“useLoadRules”或“useDynamicLoadRules”中的一个。

    1. 当loadPolicy设置为useComponentLoadConfig时,您可以通过将“componentLoadConfig”的值设置为“loadAllComponents”或“excludeSomeComponents”来选择加载所有组件或排除某些组件。

  4. 只能使用6.0.5 RTC客户端设置RTC构建定义的加载策略字段。

  5. 组件加载规则也可以通过动态加载规则扩展来指定。更多详情请参阅DynamicLoadRules必威国际有限公司JenkinsPlugin.所有构建配置都支持动态加载规则特性

    • 构建定义、存储库工作区、流和快照。

  6. 在生成定义配置中,当在生成定义中配置了加载规则并且还提供了动态加载规则时,动态加载规则优先于组件加载规则。

Team Concert Plugin版本>= 1.2.0.4中的加载规则行为

从1.2.0.4开始,Jenkins构建中的加载规则行为与RTC SCM(在Eclips必威国际有限公司e客户端或SCM CLI中)相当。因此,只有那些指定了加载规则的组件才会根据这些规则被加载;没有指定加载规则的所有其他组件将不会被加载。为了在配置了RTC构建定义的Jenkins构建中保持向后兼容性,将强制执行旧的必威国际有限公司加载规则行为,除非将构建定义中的加载策略字段设置为使用加载规则。您可以通过从Eclipse客户机迁移旧的构建定义来更改加载策略,以使用新的加载格式。

Team Concert Plugin版本< 1.2.0.4中的加载规则行为

在1.2.0.4之前,Jenkins构建中使用RTC构建定义中指定的组件加载规则或动态加载规必威国际有限公司则扩展生成的加载规则时,加载规则的行为与eclipse客户端执行加载规则的方式不同。假设,您有一个加载规则文件,它加载工作空间中的部分组件,但不是所有组件。当使用该加载规则文件在eclipse客户机中加载工作空间时,将只加载加载规则文件中指定的那些组件。当在RTC构建定义中配置相同的加载规则文件时,将加载来自工作区的所有组件,包括加载规则文件中未指定的组件;那些指定了加载规则的组件将根据指定的加载规则加载,所有其他组件将按原样加载。组件来排除选项,在RTC构建定义中可以用来限制在构建过程中加载哪些组件-更多详细信息请参考创建RTC构建定义

先进的管道能力

只执行轮询并生成更改日志,同时跳过下载Jenkins构建中的源代码必威国际有限公司

您可以将管道作业配置为在RTC构建定义或存储库工作区上轮询,但在管道构建运行时,通过使用仅轮询选项跳过下载源代码。您可以选择提供snapshotUUID来为Jenkins构建生成更改日志。必威国际有限公司快照应该属于构建定义中配置的存储库工作区。

要启用仅轮询选项,请在签出步骤中添加文本“pollingOnly: true”。如果您更喜欢使用代码片段生成器生成带有轮询选项的签出步骤,请遵循以下步骤:

  1. 打开Jenkins必威国际有限公司 Web UI。

  2. 导航到管道作业。

  3. 在左窗格中,单击“Pipeline Syntax”。

  4. 在Steps下,从Sample Step下拉列表中选择签出。

  5. 在SCM下,选择Rational Team Concert (RTC)。

  6. 将生成配置更改为生成定义或存储库工作区。

  7. 对于生成定义配置,输入生成定义的ID。

  8. 对于Repository工作区配置,请输入Repository工作区的名称。

  9. 单击高级。

  10. 选择“执行轮询但不接受或加载存储库工作区”。

  11. 要生成变更日志,请输入引用快照UUID的变量。例如,$ {ret.snapshotUUID}。

    1. 要从构建结果中检索Jazz SCM快照细节,可以使用“Get SCM snapshot”任务。

  12. 单击“生成管道脚本”。

请注意
生成的脚本中的所有值都用单引号括起来。如果使用单引号,则像${ret。buildResultUUID} is interpreted literally by the pipeline build. To expand such values, modify the script to enclose the value within double quotes, for example "${ret.snapshotUUID}".

rtcBuild一步

rtcBuild是一个从管道作业与RTC Build交互的管道步骤。该步骤提供了以下任务

  • 请求建立

  • 等待建立

  • 日志列表

  • 工件列表

  • 下载日志

  • 下载工件

请求建立

要从管道作业请求RTC构建,请使用“请求构建”任务。成功创建构建请求后,该步骤将在管道脚本中可用的对象中返回构建结果UUID。要从对象中检索构建结果UUID,请使用语法${obj。buildResultUUID},其中obj是对象的名称。

要生成请求构建的管道片段,请执行以下步骤

  1. 打开Jenkins必威国际有限公司 Web UI。

  2. 导航到管道作业。

  3. 在左窗格中,单击“Pipeline Syntax”

  4. 在Steps下,从Sample Step下拉列表中选择rtcbuild。

  5. 选择Build工具包。

  6. 输入RTC服务器URI值或接受默认值。

  7. 选择适当的凭据或接受默认凭据。

  8. 从任务下拉列表中选择“请求构建”。

  9. 输入一个生成定义ID。

  10. 若要在请求构建时删除属性,请选中“删除属性”。

    1. 点击“添加属性”,输入要删除的属性名称。

  11. 若要在请求构建时添加新属性或覆盖现有属性的值,请选择“添加或覆盖属性”。

    1. 单击“Add Property”并在构建请求中添加要添加或覆盖的属性的名称和值。

  12. 要插入与构建请求相关联的构建结果链接到Jenkins管道构建,选择“插入EWM(RTC)构建链接到Jenkins管道构建”。必威国际有限公司

  13. 单击生成管道脚本。

请注意
生成的脚本中的所有值都用单引号括起来。如果使用单引号,则像${ret。buildResultUUID} is interpreted literally by the pipeline build. To expand such values, modify the script to enclose the value within double quotes, for example "${ret.buildResultUUID}".

下面的代码片段请求生成并在步骤完成在RTC中请求生成后打印生成结果UUID

def ret = rtcBuild buildTool: '', credentialsId: '', serverURI: '', task: [buildDefinitionId: '', name: 'requestBuild'], timeout: 480], timeout: 480 echo "${ret. buildresultuuid}"

下面的代码片段请求一个带有一个新属性和几个已删除属性的构建,并在rtcBuild步骤完成在RTC中请求构建后打印构建结果UUID。

def ret = rtcBuild buildTool: '', credentialsId: '', serverURI: '', task: [buildDefinitionId: '', name: 'requestBuild', addOrOverrideProperties: true, propertiesToAddOrOverride: [[propertyName: 'addProp', propertyValue: 'newValue']], propertiesToDelete: [[propertyName: 'deleteProp1'], [propertyName:'deleteProp2']], timeout: 480], timeout: 480 echo "${ret.buildResultUUID}"

下面的代码片段请求构建,在rtcBuild步骤完成在RTC中请求构建后打印构建结果UUID,并将构建结果的链接添加到Jenkins管道构建中。必威国际有限公司

def ret = rtcBuild buildTool: '', credentialsId: '', serverURI: '', task: [buildDefinitionId: '', name: 'requestBuild', linkEWMBuild: true], timeout: 480], timeout: 480 echo "${ret. buildresultuuid}"
等待建立

要使管道生成暂停,直到RTC生成更改状态或超时到期,请使用“等待生成”任务。一旦步骤成功完成,以下情况之一为真:

  • 超时已过。

  • RTC构建已经达到了所需的状态之一。

为等待生成,必须提供以下参数。

  • 构建结果UUID。

以下参数是可选的。

  • 构建等待的状态

    • 步骤将在其上等待的构建结果的不同状态。如果构建结果进入其中一种状态,则步骤从执行中返回。默认情况下,直到构建结果进入COMPLETED或incomplepete状态,该步骤才会完成。当构建被放弃时,它进入INCOMPLETE状态。

  • 等待超时

    • 此步骤将等待的时间(以秒为单位)。默认情况下,该步骤永远等待到达指定的构建状态。对于较长的构建,建议等待较短的超时,并使用管道脚本中可用的循环构造进行重试。

该步骤返回以下值。

  • 构建的状态——OK、ERROR、WARNING或INFO。

  • 构建的状态——完全、不完全、IN_PROGRESS、取消或NOT_STARTED。

  • 步骤是否超时。如果此值为false,则构建的状态是步骤所等待的构建状态之一。

要生成等待构建的管道片段,请执行以下任务

  1. 打开Jenkins必威国际有限公司 Web UI。

  2. 导航到管道作业。

  3. 在左窗格中,单击“Pipeline Syntax”。

  4. 在Steps下,从示例步骤下拉列表中选择rtcBuild。

  5. 选择Build工具包。

  6. 输入RTC服务器URI值或接受默认值。

  7. 选择适当的凭据或接受默认凭据。

  8. 在任务下拉列表中,选择“等待生成”。

  9. 在“生成结果UUID”文本框中输入一个值。此值通常是通过请求构建获得的参数。例如,要引用从“请求构建”任务获得的构建结果UUID,输入${re . buildresultuuid}。

  10. 在“生成等待的状态”文本框中,输入要等待的状态,中间用逗号分隔。默认值为COMPLETED和INCOMPLETED。其他值为IN_PROGRESS、cancelled和NOT_STARTED。

  11. 2 .在“等待超时时间(秒)”文本框中输入等待超时时间(秒)。这个值应该大于零。默认值是-1,这将使步骤等待直到构建结果进入指定的状态。

  12. 单击生成管道脚本。

请注意
生成的脚本中的所有值都用单引号括起来。如果使用单引号,则像${ret。buildResultUUID} is interpreted literally by the pipeline build. To expand such values, modify the script to enclose the value within double quotes, for example "${ret.buildResultUUID}".

在下面的代码片段中,“等待生成”任务使用来自“请求生成”任务的生成结果UUID来等待生成结果进入COMPLETED或INCOMPLETE状态120秒。一旦该步骤完成,它将从返回值中打印以下字段。

* buildState * buildStaus *超时
', credentialsId: '', serverURI: '', task: [buildResultUUID: "${ret.buildResultUUID}", name: 'waitForBuild', buildStates: 'COMPLETED,INCOMPLETE,CANCELED', waitBuildTimeout: 120], timeout: 480 echo "${ret2.buildState}" echo "${ret2.buildStatus}" echo "${ret2.timedout}"">
def ret1 = rtcBuild buildTool: '', credentialsId: '', serverURI: '', task: [buildDefinitionId: '', name: 'requestBuild'], timeout: 480 echo "${ret. xml。buildResultUUID}" def ret2 = rtcBuild buildTool: '', credentialsId: '', serverURI: '', task: [buildResultUUID: "${ret。buildResultUUID}",名称:'waitForBuild', buildStates: 'COMPLETED,INCOMPLETE, cancelled ', waitBuildTimeout: 120], timeout: 480 echo "${ret2。buildState} $ {ret2“回声”。构建Status}" echo "${ret2.timedout}"
日志列表

使用“列表日志”任务从EWM构建结果中检索日志的详细信息。日志出现在EWM构建结果的“日志”选项卡中。

请注意
日志的内容可以存储在EWM存储库或一些外部存储中。此任务将检索内容存储在EWM存储库中的日志的详细信息。可以使用EWM构建工具包中的logPublisher ant任务将这些日志上传到构建结果。日志的出版商

要从EWM构建结果中为列表日志生成管道片段,请执行以下步骤

  1. 打开Jenkins必威国际有限公司 Web UI。

  2. 导航到管道作业。

  3. 在左窗格中,单击“Pipeline Syntax”。

  4. 在Steps下,从示例步骤下拉列表中选择rtcBuild。

  5. 选择Build工具包。

  6. 输入RTC服务器URI值或接受默认值。

  7. 选择适当的凭据或接受默认凭据。

  8. 在“任务”下拉列表中,选择“列出日志”。

  9. 在“生成结果UUID”文本框中输入一个值。此值通常是通过请求构建获得的参数。例如,要引用从“请求构建”任务获得的构建结果UUID,输入${re . buildresultuuid}。这是一个必选参数。注意:记得引用${ret。buildResultUUID} once the snippet is copied to the pipeline script.

  10. 在“文件名或模式”文本框中,输入一个文件名或模式,以限制将检索到的详细信息的日志。如果不指定值,则将检索内容存储在EWM存储库中的所有日志的详细信息。是-参数说明取值样例可选参数。

  11. 在“组件名称”文本框中,输入组件名称,以限制将检索到的详细信息的日志。如果不指定值,则将检索属于任何组件或不属于任何组件的所有日志的详细信息。要检索不属于任何组件的日志的详细信息,请将此字段保留为空。是-参数说明取值样例可选参数。

  12. 在“Maximum number of results”文本框中,输入将获取详细信息的最大日志数。默认值为512,最大值为2048。如果构建结果中有超过2048条日志,则通过提供文件名模式或组件名称来限制结果集。

  13. 单击生成管道脚本。

请注意
生成的脚本中的所有值都用单引号括起来。如果使用单引号,则像${ret。buildResultUUID} is interpreted literally by the pipeline build. To expand such values, modify the script to enclose the value within double quotes, for example "${ret.buildResultUUID}".

一旦步骤完成执行,就可以使用for循环访问关于每个日志的信息。

*文件名*组件名*描述*类型*内容id *大小

下面的代码片段检索构建结果中所有日志的详细信息,并使用for循环将它们输出到控制台日志。

def ret1 = rtcBuild buildTool: '', credentialsId: '', serverURI: '', task: [buildResultUUID: "${ret。buildResultUUID}", name: 'listLogs'], timeout: 480 for(i=0;i< ret1. fileinfo .length;i++) {echo "${ret1. fileinfo [i]. $;文件名}“回声”$ {ret1.fileInfos[我].componentName}“回声”$ {ret1.fileInfos[我].description}“回声”$ {ret1.fileInfos[我]。类型}“回声”$ {ret1.fileInfos[我]。版权id}有些过火“回声”$ {ret1.fileInfos[我]。大小}"}
工件列表

使用“List Artifacts”任务从EWM构建结果中检索工件的详细信息。工件出现在EWM构建结果的“Downloads”选项卡中。

请注意
工件的内容可以存储在EWM存储库或一些外部存储中。该任务将检索内容存储在EWM存储库中的工件的详细信息。可以使用EWM构建工具包中的artifactFilePublisher蚁任务将这些构件上传到构建结果中。工件的出版商

要从EWM构建结果中为列表日志生成管道片段,请执行以下步骤

  1. 打开Jenkins必威国际有限公司 Web UI。

  2. 导航到管道作业。

  3. 在左窗格中,单击“Pipeline Syntax”。

  4. 在Steps下,从示例步骤下拉列表中选择rtcBuild。

  5. 选择Build工具包。

  6. 输入RTC服务器URI值或接受默认值。

  7. 选择适当的凭据或接受默认凭据。

  8. 在Task下拉列表中,选择“list artifacts”。

  9. 在“生成结果UUID”文本框中输入一个值。此值通常是通过请求构建获得的参数。例如,要引用从“请求构建”任务获得的构建结果UUID,输入${re . buildresultuuid}。名称必选参数。注意:记得引用${ret。buildResultUUID} once the snippet is copied to the pipeline script.

  10. 在文件名或模式文本框中,输入文件名或模式,以限制将检索其详细信息的工件。如果没有指定值,那么将检索内容存储在EWM存储库中的所有工件的详细信息。是-参数说明取值样例可选参数。

  11. 在“组件名称”文本框中,输入组件的名称,以限制将检索其详细信息的构件。如果没有指定值,那么将检索属于任何组件或不属于任何组件的所有构件的详细信息。要检索不属于任何组件的构件的详细信息,请将此字段保留为空。是-参数说明取值样例可选参数。

  12. 在结果的最大数量文本框中,输入将检索其详细信息的工件的最大数量。默认值为512,最大值为2048。如果构建结果中有超过2048个构件,那么通过提供文件名模式或组件名称来限制结果集。

  13. 单击生成管道脚本。

请注意
生成的脚本中的所有值都用单引号括起来。如果使用单引号,则像${ret。buildResultUUID} is interpreted literally by the pipeline build. To expand such values, modify the script to enclose the value within double quotes, for example "${ret.buildResultUUID}".

一旦步骤完成执行,您就可以使用for循环访问关于每个工件的信息。

*文件名*组件名*描述*类型*内容id *大小

下面的代码片段检索构建结果中所有构件的详细信息,并使用for循环将它们输出到控制台日志。

def ret1 = rtcBuild buildTool: '', credentialsId: '', serverURI: '', task: [buildResultUUID: "${ret。buildResultUUID}", name: 'listArtifacts'], timeout: 480 for(i=0;i< ret1. fileinfo .length;i++) {echo "${ret1. fileinfo [i]. $;文件名}“回声”$ {ret1.fileInfos[我].componentName}“回声”$ {ret1.fileInfos[我].description}“回声”$ {ret1.fileInfos[我]。类型}“回声”$ {ret1.fileInfos[我]。版权id}有些过火“回声”$ {ret1.fileInfos[我]。大小}"}
下载日志

若要从构建结果下载日志,请使用“下载日志”任务。可以使用日志名称或内容ID下载日志。

如果在创建脚本时不知道日志的全名,则可以使用“List logs”任务检索以特定前缀开头的所有日志的详细信息。然后,您可以使用内容id或文件名将日志内容下载到Jenkins工作区或运行此任务的代理中的任何文件夹中。必威国际有限公司

请注意
日志的内容可以存储在EWM存储库或一些外部存储中。此任务将下载存储在EWM存储库中的日志内容。可以使用EWM构建工具包中的logPublisher ant任务将这些日志上传到构建结果。此任务类似于EWM构建工具包中的logretriver ant任务。指日志的出版商而且日志寻回犬

要从EWM构建结果中为下载日志生成管道片段,请执行以下步骤

  1. 打开Jenkins必威国际有限公司 Web UI。

  2. 导航到管道作业。

  3. 在左窗格中,单击“Pipeline Syntax”。

  4. 在Steps下,从示例步骤下拉列表中选择rtcBuild。

  5. 选择Build工具包。

  6. 输入RTC服务器URI值或接受默认值。

  7. 选择适当的凭据或接受默认凭据。

  8. 在“任务”下拉列表中选择“下载日志”。

  9. 在“生成结果UUID”文本框中输入一个值。此值通常是通过请求构建获得的参数。例如,要引用从“请求构建”任务获得的构建结果UUID,输入${re . buildresultuuid}。名称必选参数。注意:记得引用${ret。buildResultUUID} once the snippet is copied to the pipeline script.

  10. 2 .在“文件名”文本框中输入日志的全名。如果在编写脚本时还不知道日志的全名(例如,日志的名称有一个时间戳作为后缀),那么使用列表日志任务检索匹配文件名模式的所有日志的详细信息,并提供文件名属性作为参考,例如${ret2.fileName}。如果有多个日志匹配给定的文件名,则下载第一个匹配的日志。如果日志可能具有相同的名称,则使用内容ID属性作为参考,例如${ret2.contentId}。必须提供文件名或内容ID参数中的一个,但不能同时提供两个参数。

  11. 2 .在“组件名称”文本框中输入该日志所属的组件名称。如果在不同的组件中有多个名称相同的日志,那么提供组件名称将下载特定组件下的日志。是-参数说明取值样例可选参数。

  12. 在Content Id字段中,从List logs任务的返回值中提供对contentId属性的引用。必须提供文件名或内容ID参数中的一个,但不能同时提供两个参数。

  13. 在“目标文件名”文本框中,为要下载内容的文件提供名称。如果目标中已经存在同名的文件,那么将通过将目标文件名与当前时间戳附加在一起来创建一个文件。是-参数说明取值样例可选参数。

请注意
生成的脚本中的所有值都用单引号括起来。如果使用单引号,则像${ret。buildResultUUID} is interpreted literally by the pipeline build. To expand such values, modify the script to enclose the value within double quotes, for example "${ret.buildResultUUID}".

一旦步骤完成执行,您就可以访问关于下载的日志的以下字段。

* fileName -磁盘上文件的名称。这可能与目标文件名或日志名称匹配,也可能与不匹配(如果没有提供目标文件名)。* filePath -磁盘上文件的完整路径。

下面的代码片段检索构建结果中名称以“build”开头的所有日志的详细信息,并使用for循环将它们输出到控制台日志。然后,它将当前工作目录切换到Jenkins工作区中的一个子文件夹,下载每个日志,然后在磁盘上打印文件的名称和路径。必威国际有限公司

', credentialsId: '', serverURI: '', task: [buildResultUUID: "${ret.buildResultUUID}", name: 'downloadLog', contentId: "${ret1.contentId}" ], timeout: 480 echo "${ret2.fileName}" echo "${ret2.filePath}" } // end for } // end dir">
def ret1 = rtcBuild buildTool: '', credentialsId: '', serverURI: '', task: [buildResultUUID: "${ret。buildResultUUID}", name: 'listLogs', fileNameOrPattern: "build*"], timeout: 480 for(i=0;i< ret1. fileinfo .length;i++) {echo "${ret1. fileinfo [i]. $;文件名}“回声”$ {ret1.fileInfos[我].componentName}“回声”$ {ret1.fileInfos[我].description}“回声”$ {ret1.fileInfos[我]。类型}“回声”$ {ret1.fileInfos[我]。版权id}有些过火“回声”$ {ret1.fileInfos[我]。大小}"}// Switch to a subdirectory in the Jenkins workspace dir('downloads') { // Download each log using content ID for(i=0;i< ret1.fileInfos.length;i++) { def ret2 = rtcBuild buildTool: '', credentialsId: '', serverURI: '', task: [buildResultUUID: "${ret.buildResultUUID}", name: 'downloadLog', contentId: "${ret1.contentId}" ], timeout: 480 echo "${ret2.fileName}" echo "${ret2.filePath}" } // end for } // end dir
下载工件

要从构建结果下载工件,请使用“下载工件”任务。您可以使用工件的名称或内容ID下载工件。

如果您在创建脚本时不知道工件的全名,那么您可以使用“List工件”任务检索以特定前缀开头的所有工件的详细信息。然后,您可以使用内容id或文件名将工件的内容下载到Jenkins工作区或运行此任务的代理中的任何文件夹中。必威国际有限公司

请注意
工件的内容可以存储在EWM存储库或一些外部存储中。此任务将下载存储在EWM存储库中的工件内容。可以使用EWM构建工具包中的artifactPublisher蚁任务将这些构件上传到构建结果中。此任务类似于EWM构建工具包中的artifactretriver蚂蚁任务。指工件的出版商而且工件寻回犬

要从EWM构建结果中为下载工件任务生成管道片段,请执行以下步骤

  1. 打开Jenkins必威国际有限公司 Web UI。

  2. 导航到管道作业。

  3. 在左窗格中,单击“Pipeline Syntax”。

  4. 在Steps下,从示例步骤下拉列表中选择rtcBuild。

  5. 选择Build工具包。

  6. 输入RTC服务器URI值或接受默认值。

  7. 选择适当的凭据或接受默认凭据。

  8. 在“任务”下拉列表中选择“下载日志”。

  9. 在“生成结果UUID”文本框中输入一个值。此值通常是通过请求构建获得的参数。例如,要引用从“请求构建”任务获得的构建结果UUID,输入${re . buildresultuuid}。名称必选参数。注意:记得引用${ret。buildResultUUID} once the snippet is copied to the pipeline script.

  10. 在File name文本框中,输入工件的全名。如果在编写脚本时还不知道工件的全名(例如,日志的名称有一个时间戳作为后缀),那么使用列表工件任务检索匹配文件名模式的所有日志的详细信息,并提供文件名属性作为参考,例如${ret2.fileName}。如果有多个日志匹配给定的文件名,则下载第一个匹配的日志。如果工件可能具有相同的名称,那么使用内容ID属性作为引用,例如${ret2.contentId}。必须提供文件名或内容ID参数中的一个,但不能同时提供两个参数。

  11. 在“组件名称”文本框中,输入此构件所属的组件的名称。如果在不同的组件中有多个具有相同名称的构件,那么提供组件名称将下载特定组件下的日志。是-参数说明取值样例可选参数。

  12. 在Content Id字段中,从List Artifacts任务的返回值中提供对contentId属性的引用。必须提供文件名或内容ID参数中的一个,但不能同时提供两个参数。

  13. 在“目标文件名”文本框中,为要下载内容的文件提供名称。如果目标中已经存在同名的文件,那么将通过将目标文件名与当前时间戳附加在一起来创建一个文件。

请注意
生成的脚本中的所有值都用单引号括起来。如果使用单引号,则像${ret。buildResultUUID} is interpreted literally by the pipeline build. To expand such values, modify the script to enclose the value within double quotes, for example "${ret.buildResultUUID}".

一旦步骤完成执行,您就可以访问关于下载的日志的以下字段。

* fileName -磁盘上文件的名称。这可能与目标文件名或工件的名称匹配,也可能与之不匹配(如果没有提供目标文件名)。* filePath -磁盘上文件的完整路径。

下面的代码片段检索构建结果中名称以“build”开头的所有构件的详细信息,并使用for循环将它们输出到控制台日志。然后,它将当前工作目录切换到Jenkins工作区中的子文件夹,下载每个artfact,然后在磁盘上打印文件的名称和路径。必威国际有限公司

', credentialsId: '', serverURI: '', task: [buildResultUUID: "${ret.buildResultUUID}", name: 'downloadArtifact', contentId: "${ret1.contentId}" ], timeout: 480 echo "${ret2.fileName}" echo "${ret2.filePath}" } // end for } // end dir">
def ret1 = rtcBuild buildTool: '', credentialsId: '', serverURI: '', task: [buildResultUUID: "${ret。buildResultUUID}", name: 'listArtifacts', fileNameOrPattern: "build*"], timeout: 480 for(i=0;i< ret1.fileInfos.length;i++) { echo "${ret1.fileInfos[i].fileName}" echo "${ret1.fileInfos[i].componentName}" echo "${ret1.fileInfos[i].description}" echo "${ret1.fileInfos[i].type}" echo "${ret1.fileInfos[i].contentId}" echo "${ret1.fileInfos[i].size}" } // Switch to a subdirectory in the Jenkins workspace dir('downloads') { // Download each artifact using content ID for(i=0;i< ret1.fileInfos.length;i++) { def ret2 = rtcBuild buildTool: '', credentialsId: '', serverURI: '', task: [buildResultUUID: "${ret.buildResultUUID}", name: 'downloadArtifact', contentId: "${ret1.contentId}" ], timeout: 480 echo "${ret2.fileName}" echo "${ret2.filePath}" } // end for } // end dir
得到SCM快照

检索给定EWM (RTC)构建结果的Jazz SCM快照细节。

如果构建结果具有Jazz SCM快照贡献,那么任务将返回快照的名称和UUID。如果构建结果没有这样的贡献,那么任务将为快照名称和UUID返回空值。此任务不检查生成结果的状态,以查看在任务运行时生成结果是否正在进行中。由调用者负责确保在任务运行之前已将快照添加到构建结果中。您可以使用Wait for构建任务来等待特定的时间或状态更改,然后调用此任务来检索快照详细信息。

要为“获取SCM快照”任务生成管道片段,执行以下步骤

  1. 打开Jenkins必威国际有限公司 Web UI。

  2. 导航到管道作业。

  3. 在左窗格中,单击“Pipeline Syntax”。

  4. 在Steps下,从示例步骤下拉列表中选择rtcBuild。

  5. 选择Build工具包。

  6. 输入RTC服务器URI值或接受默认值。

  7. 选择适当的凭据或接受默认凭据。

  8. 在Task下拉列表中,选择“Get SCM Snapshot”。

  9. 在“生成结果UUID”文本框中输入一个值。此值通常是通过请求构建获得的参数。例如,要引用从“请求构建”任务获得的构建结果UUID,输入${re . buildresultuuid}。名称必选参数。

请注意
生成的脚本中的所有值都用单引号括起来。如果使用单引号,则像${ret。buildResultUUID} is interpreted literally by the pipeline build. To expand such values, modify the script to enclose the value within double quotes, for example "${ret.buildResultUUID}".

一旦步骤完成执行,您就可以访问以下关于Jazz SCM快照的字段。

* snapshotName—Jazz SCM快照的名称。snapshotUUID——Jazz SCM UUID的UUID。
按步骤访问Jenki必威国际有限公司ns构建参数和groovy变量

要在管道脚本中访问Jen必威国际有限公司kins构建参数以代替字符串值,请使用以下语法

" $ {env.parameter_name}”。

脚本中出现双引号将导致groovy解释器执行字符串插值。

要在管道脚本中访问groovy变量以代替字符串值,请使用语法“{$var}”。如果变量是一个对象,并且您需要使用该对象的一个字段的值,请使用语法

" $ {var.field_name} "
下载日志或神器到代理的jenkins工作区的已知警告必威国际有限公司

在管道构建中,如果“使用groovy沙箱”选项未选中,那么在构建开始时Jenkins不会分配工作空间目录。必威国际有限公司如果试图在工作空间目录下创建文件或文件夹,则会失败,因为工作空间目录不存在。

如果您使用“Download Log”或“Downalod Artifact”任务将文件下载到Jenkins工作区,那么您必须在运行该任务之前创建工作区目录。必威国际有限公司下面的代码片段展示了如果工作空间目录不存在,如何创建它,然后在工作空间目录下创建一个子目录来存储日志和工件。

Def workspace = "${env. "WORKSPACE}" echo "${WORKSPACE}" withEnv([" WORKSPACE =${WORKSPACE}"]) {sh " ' echo "${WORKSPACE}" if [!- e $ {workspace}];then mkdir -p "${workspace}" fi " '} dir("){//切换到下载日志或工件的目录}
将下载的日志或工件发布到Jenkins构建必威国际有限公司

要将下载的日志或构件发布到Jenkins构建中,请使用“archiveArtifacts”步骤。必威国际有限公司下面的代码片段将所有扩展名为.log的文件发布到Jenkins构建中。必威国际有限公司

archiveArtifacts: '*.log', followSymlinks: false

已知的限制

  1. 在1.2.0.0版本中,当选中“避免在主(实验性)上使用工具箱”时,对流和快照构建配置不支持轮询。

  2. 在1.2.0.0版本中,创建了临时工作区以支持从流和快照加载。Teamconcert插件在完成时删除临时工作区。如果在构建过程中出现网络问题,可以保留这些临时工作空间。可以通过搜索以前缀“HJP_”开头的工作区来定位临时工作区。

  3. 在1.1.9.5版本中,当“避免使用主(实验)上的工具包”被选中时,验证连接失败。这个问题似乎与maven依赖有关。在工作项中跟踪问题验证连接时显示错误,选中了避免在主选项上使用工具箱

  4. 在将Team Concert插件更新到新版本时,必威国际有限公司或者在自动安装新的构建工具包时,您可能需要回收Jenkins和代理。

  5. 以下是工作流支持的已知问题

    1. 删除工作流构建不会删除相应的RTC构建结果

    2. 365198年:[工作流插件在工作流作业中使用代码片段生成器为TeamConcert步骤生成的groovy脚本会在RTCScm中抛出NPE]。为了解决问题,将生成的脚本从teamconcert([值:"buildDefinition", buildDefinition:"<>")]更改为teamconcert buildType:[值:"buildDefinition", buildDefinition:"<>"]。有关此问题的更多信息,请参阅必威国际有限公司詹金斯- 29711

  6. 通过使用com.ibm.team.build.debug来了解特定任务代理中的RTC构建工具包版本在代理处理的第一次构建中不能工作。作业在同一代理上的后续构建将输出正在使用的构建工具包版本。看到461155:在代理重新启动后由代理处理的第一次构建中,在代理上记录构建工具包版本的日志不起作用。

RTC更新版本中修复的已知局限性

  1. RTC 6.0构建工具包和加载规则的问题。由于RTC 6.0的一个突破性变化,在使用RTC 6.0构建工具包时,加载规则将无法工作。在6.0 Ifix07构建工具包(工作项362564)参考工作项Jenkins插件和RTC 6.0构建工具包破坏了加必威国际有限公司载规则(361926)为更多的细节。如果您正在使用加载规则,那么建议使用RTC 5.0.2构建工具包,而不是RTC 6.0构建工具包。请注意,此建议仅适用于或版本的RTC构建工具包,而不适用于RTC服务器。RTC服务器可以是5.0.2或6.0,因为RTC支持n-1兼容性(即旧的客户端可以连接到新服务器),构建工具包的5.0.2版本将与RTC 6.0服务器一起工作。

  2. 从RTC发起的每个构建请求都在Jenkins工作流作业中创建一个buildResultUUID参数必威国际有限公司

    1. 此问题在RTC v6.0.1或更高版本和6.0 ifix04、5.0.2 ifix12版本中得到修复。

    2. 要想解决问题,请遵循下面列出的步骤

      1. 在工作流作业配置页面中,删除除一个buildResultUUID参数外的所有参数。

      2. 在工作流作业config.xml中的<流定义>标记下添加以下内容
        < >操作
        < hudson.model.ParametersDefinitionProperty >
        < parameterDefinitions >
        < hudson.model.StringParameterDefinition >
        <名称> buildResultUUID < /名称>
        RTC中构建结果的UUID。它由通过RTC发起的构建提供。对于通过Hudson/Jenkins发起的构建,不应提供任何值必威国际有限公司
        < defaultValue > < / defaultValue >
        < / hudson.model.StringParameterDefinition >
        < / parameterDefinitions >
        < / hudson.model.ParametersDefinitionProperty >
        > < /行动

      3. 单击“管理Jenkins→必威国际有限公司从磁盘重新加载配置”。

最佳实践

参考最佳实践文档在这里

参考文献

  1. 在流水线作业中使用Team Concert插件-Team Concert插件中的管道支持

  2. 在Team Concert插件中使用动态加载规则-使用Team Concert插件动态加载规则

释放

2.4.0 2021年6月22日

  • 与Team Concert插件的管道作业相关的增强

    • 引入了与EWM构建交互的新管道步骤rtcBuild。

  • 兼容性改变,删除通用的消化2,并使用通用的消化3

    • 把请求20.合并并作为2.4.0的一部分发布。

注意:Team Concert Plugin从2.60.1开始继续支持LTS版本

2.2.1 2021年3月30日

2020年12月22日

  • 支持SAML/OIDC应用程序密码。

    • 工作项515283

  • 在EWM 7.0.2中使用构建定义配置和加载规则时,支持优化增量负载。只有当EWM服务器和构建工具包版本都为7.0.2时才支持此特性。有关更多信息,请参见EWM 7.0.2新的和值得注意的

2020年7月18日,魅惑

  • 在EWM 7.0.1中使用Build Definition配置时,支持优化的增量负载。只有当EWM服务器和构建工具包版本都为7.0.1时才支持此特性。有关更多信息,请参见EWM 7.0.1EWM 7.0.1新的和值得注意的

  • 升级到Jenkins 必威国际有限公司2.60.1版本和Java 8

  • 移除对RTC 5的支持。x版本。

1.3.1 2020年1月7日

  • 修正了安全问题#1605

1.3.0 2019年5月1日

请注意
当使用Repository Workspace或Stream作业配置(由工作项388795引入)时,在所有接受的工作项中创建必威国际有限公司“相关工件”链接到Jenkins构建的默认行为已经更改。在1.2.0.5中,将在所有接受的工作项中创建链接。在1.3.0中,不会在所有接受的工作项中创建链接。在Job配置中有一个新的选项“添加Jenkins构建链必威国际有限公司接到已接受的工作项”来创建这些链接,默认情况下是未选中的。您必须选择Job配置中的选项,以在所有接受的工作项中创建到Jenkins构建的相关工件链接。必威国际有限公司参见工作项461859了解更多细节。
  • 您可以为所有构建配置收集节拍器信息。有关详细信息,请参阅收集节拍器日志一节。

    • 参见工作项目438208:增强团队音乐会插件收集节拍器日志,如JBE

  • 在这个版本中,我们改变了在所有被接受的工作项388795最初引入的Jenkins构建中创建“相关工件”链接的行为。必威国际有限公司您必须在Jenkins作业配置中选择“向接受的工作项添加Jenk必威国际有限公司ins构建链接”选项,以在所有接受的工作项中创建到Jenkins构建的“相关工件”链接。

    • 参见工作项461859:将“创建Jenkins构建链接到已接受的变更集中的工作项”作为用必威国际有限公司户在Repository Workspace和Stream配置中的选择。

  • 我们修复了一个与管道作业不兼容的问题,其中来自Team Concert Plugin的消息不会打印到构建日志中。

    • 参见工作项目478877:管道构建不从RTCScm输出消息

1.2.0.5 2018年6月15日

重要信息:Jenkins的最低要求版本现在是1.625.1。必威国际有限公司升级之后,建议在一些作业中检查Team Concert插件(RTCScm)配置是否完整。

  • 在存储库工作区和流构建配置中,插件现在在附加到变更集的工作项中创建到Jenkins构建的链接必威国际有限公司

    • 参见工作项388795:在Team Concert Jenkins Plu必威国际有限公司gin中,当使用构建工作区/流配置时,在包含的工作项中创建到Jenkins构建的反向链接

  • 通过将com.ibm.team.build.debug = true添加到环境或作为作业参数,您可以在构建日志中查看主和代理中使用的构建工具包的版本。

    • 参见WorkItem 449539: [Je必威国际有限公司nkins]在构建日志中记录构建工具包的版本

  • 通过将RTCScm导出的环境变量赋值给groovy变量,您可以在签出步骤中访问它。

  • 其他修复

    • 工作项目398804:升级父pom版本到2.x

    • 工作项448725:Jenkins必威国际有限公司构建错误:发现一个无效的XML字符(Unicode: 0x10)

    • 工作项目458158:移动到Java 7 -升级最低要求的Jenkins版本到1.625.1必威国际有限公司

1.2.0.4 2017年12月4日

  1. 在配置了RTC存储库工作区、流或快照的Jenkins必威国际有限公司作业中支持加载规则。

  2. 根据签出动态加载规则配置。

  3. 解决403254:动态加载规则应该优先于构建定义中的加载规则

  4. 已弃用动态加载规则扩展中的getComponentLoadRules方法。相反,动态加载规则必须通过新添加的getPathToLoadRuleFile方法返回。有关更多信息,请参见DynamicLoadRules必威国际有限公司JenkinsPlugin

  5. https://jazz.net/jazz/resource/itemName/com.ibm.team.workitem.WorkItem/367019(367019:

  6. 410454: team_scm_workspaceUUID应该作为基于Repository工作区的构建的环境变量可用。

1.2.0.3 2017年6月16日

  1. 在构建定义配置中,当使用Rational Team Concert服务器6.0.4或更高版本时,支持Post Build Deliver。您可以在RTC中编辑“生成定义”,以包括“生成后交付”配置。配置信息将被插件用于执行后构建交付。

1.2.0.2 2016年12月6日

  1. 支持自定义构建过程中创建的快照的名称。可以在快照名称中使用Je必威国际有限公司nkins作业参数和/或环境变量。在构建过程中,参数将被解析为它们的值,以构造快照名称。

  2. 在流配置中,允许在构建过程中使用SCM CLI签入并交付更改。现在,在构建结束时删除为加载内容而创建的临时Repository Workspace,从而允许签入和交付操作。在构建期间创建的临时Repository Workspace的名称和UUID可以通过以下方式获得rtcTempRepoWorkspaceName而且rtcTempRepoWorkspaceUUID

  3. 修复了以下问题

1.2.0.1 2016年8月16日

  1. 可以在“构建定义”、“存储库工作区”或“流作为”的文本字段中提供字符串参数$ {paramater_name}增强324449https://jazz.net/jazz/web/projects/Rational%20Team%20Concert action = com.ibm.team.workitem.viewWorkItem&id = 324449 (-必威国际有限公司Jenkins Team concert插件支持流、工作区和构建定义字段的参数

  2. 快照的作用域可以是存储库工作区或流。任务392790 -= com.ibm.team.workitem.viewWorkItem&id = 392790 (https://jazz.net/jazz/web/projects/Rational%20Team%20Concert行动构建快照配置,提供指定项目区域/团队区域和所有者工作区/流的选项]

  3. 一个流可以被定义为一个项目区域/团队区域。任务391633https://jazz.net/jazz/web/projects/Rational%20Team%20Concert action = com.ibm.team.workitem.viewWorkItem&id = 391633 (-在构建流配置中,使用项目区域/团队区域值(如果已配置)来解析由名称指定的流]

  4. 支持配置级验证,而不是验证Rational Team Concert部分中的单个字段。

  5. 为快照和流配置创建的临时存储库工作区有一个注释形式为“由Team Concert Plugin为Jenkins服务器中的作业创建”。必威国际有限公司Task 388924—向临时工作区添加注释,以便更容易将其标识为构建工作区

  6. 到构建中使用的构建定义、存储库工作区、流的链接现在出现在构建页面中。Task 396340 -为Jenkins作业的构建中使用的当前配置添加链接必威国际有限公司

1.2.0.0 2016年4月22日

  1. 增强376827:支持在Jenkins作业加载前加载目录和删除必威国际有限公司

  2. 增强382347:支持RTC BuildDefinition在Jenkins作业中的接受选项必威国际有限公司

  3. 增强366909:支持从快照加载

  4. 增强版375548:支持从流加载

  5. 增强376098:为各种构建配置提供下拉组合框支持

  6. 修复了以下问题

1.1.9.9 2016年1月25日

  1. 提供一种在Jenkins Team Concert插件中生成和输入Load Rules文件的机制必威国际有限公司.动态加载规则特性允许用户在构建过程中为组件提供加载规则。有关更多信息,请参见DynamicLoadRules必威国际有限公司JenkinsPlugin

  2. 修复了以下问题

2015年12月21日1.1.9.8

(。Aui-icon .aui-icon-small .aui-iconfont-info .confluence-information-macro-icon]# #

修复了工作项379521- RTC Jenkins插件在工作必威国际有限公司区中留下。jazzlock文件的问题,在1.1.9.8中不可用。该问题已修复1.1.9.9

2015年10月26日

  1. 修复了以下问题

  2. 请注意1.1.9.6和1.1.9.7版本是相同的,1.1.9.7是1.1.9.6版本的衍生版本,用于修复1.1.9.6.1版本中的错误

1.1.9.6.1 2015年10月26日

  1. 无效的插件发布,不使用

2015年8月4日1.1.9.4

2015年7月26日1.1.9.3

  1. 实现对FreeStyle项目类型的安静期支持。工作项362725

  2. 工作流作业的初始实现。362121: RTC 必威国际有限公司Jenkins插件-工作流支持.指使用指南和文档为更多的细节。

  3. 注意,这是一个有一些限制和问题的初始实现,请参阅限制部分了解问题和解决方法。

2015年6月11日1.1.9.2

1.1.9.1 2015年3月26日

  1. 在Team Concert插件中提供一个Group ID工作项336266

  2. RTC构建插件詹金斯重复重置“安静期”必威国际有限公司工作项350379

1.1.9 2014年10月9日

这个版本对迁移有影响。请参阅下面的迁移部分。

  1. 当Jenkin必威国际有限公司s构建被删除时,相应的RTC构建结果(如果有的话)将从RTC中删除。如果被标记为不允许删除,RTC生成结果将不会被删除。工作项330249

  2. 改进对“多SCMs”插件的支持。您现在可以指定引用不同服务器的多个RTC SCM配置(当构建从Jenkins启动时)。必威国际有限公司工作项300164

  3. 支持,以便RTC的Build Definition编辑器可以在Jenkins作业不指向该定义时警告用户必威国际有限公司工作项276139

  4. 线程的上下文类加载器没有正确重置+处理加载LogFactory类的意外失败工作项322272

1.1.8 2014年7月10日

  1. Jenki必威国际有限公司ns主配置页面没有显示所选的Build工具包工作项320832

  2. 当生成工作区的组件对生成用户不可见时,在控制台日志中添加警告工作项203294

  3. 当SCM提供者是“Multiple SCM”插件时,构建的详细更改不会列出更改细节工作项323307

1.1.2 2014年6月11日

  1. 已经添加了对Jenkin必威国际有限公司s凭证的支持,这引入了对凭证插件.如果作业已经配置为使用用户ID和密码(或密码文件),它将继续运行,但这些字段是只读的。任何更改都需要后续的凭证。使用凭据插件提供了更多的灵活性,并解决了一些问题。

    1. 可以在多个作业中定义和使用多个凭据

    2. 当RTC URL被覆盖时,是否可以使用全局用户ID和密码(或密码文件)发行21537

    3. 提高了安全性发行21038而且工作项295009

  2. 与使用RTC构建结果启动构建相关的工作已从主服务器转移到代理(假设作业在代理上运行)。工作项306172

  3. 当构建在RTC中启动时,服务器将通过定期轮询Jenkins来管理构建结果的生命周期,以确定构建是否完成。必威国际有限公司在RTC 5.0中,构建定义支持布尔属性com.ibm.rational.connector.hudson.queueOnly.当与此版本的插件一起使用时,该插件将在构建完成时终止RTC构建结果(就像在Jenkins中开始构建时一样)。必威国际有限公司如果很多构建都是从RTC内部开始的,这将更加有效。需要RTC 5.0或更高版本。工作项308749

  4. 在执行配置、轮询和构建结果管理(与构建工具包相反)时使用rest服务调用与RTC服务器通信的新选项。这意味着,如果所有作业都配置了此功能并在代理上运行,则工具箱类将不会加载到主服务器上。需要RTC 5.0或更高版本。

1.0.12(及更早)2013年10月23日

  1. 这个插件版本没有任何Jenkins特定的依赖项。必威国际有限公司

  2. 要根据Team Concert服务器进行身份验证,需要用户id和密码。密码可以直接提供,也可以放在密码文件

  3. RTC构建工具包用于在Jenkins主进程和代理进程中执行与构建相关的任务(与使用命令行客户机相反)。必威国际有限公司与RTC相关的任务包括验证配置、轮询和使用RTC构建结果,以及执行构建的Accept和Checkout阶段。

  4. 支持简单的构建工作区

    1. 从流目标引用的流的更改被接受到构建工作区中

    2. 为构建创建工作区的快照

    3. 创建更改日志

    4. 已加载构建工作区

  5. 对构建定义的集成支持

    1. 从Jenkins构建到RTC构建结果、工作区和快照的必威国际有限公司可追溯性链接。

    2. 发布到快照中捕获的工作项、更改集和文件内容的链接。

    3. 构建工作区由构建定义标识

    4. 从流目标引用的流的更改被接受到构建工作区中

    5. 为构建创建工作区的快照

    6. 构建定义中可用的其他SCM配置选项

    7. 创建RTC构建结果是为了与构建中包含的工作项进行更深层次的集成

    8. 构建(包括个人构建)可以从RTC开始

    9. 在RTC生成定义中定义的环境变量可在生成环境中使用

  6. RTC构建环境变量可在构建环境中使用

    财产 描述

    team_scm_changesAccepted

    接受了多少更改。如果没有变化就不会设置。

    team_scm_snapshotUUID

    接受修改后创建的快照的UUID。如果不创建快照,则不设置。

    RTCBuildResultUUID

    构建结果的UUID。仅在构建使用构建定义时设置

    requestUUID

    构建请求的UUID。仅在构建使用构建定义时设置。

    buildDefinitionId

    构建所使用的构建定义的UUID。仅在构建使用构建定义时设置。

    repositoryAddress

    RTC存储库的地址。

    buildEngineId

    与生成请求/结果相关联的生成引擎的名称(如果存在生成结果)。一个RTC构建引擎实际上没有运行,但是一些ant任务需要引擎id。

    buildEngineHostName

    运行构建所依赖的Jenkins主机必威国际有限公司或代理的主机名。

    buildRequesterUserId

    请求启动生成的RTC用户的用户id。仅在构建使用构建定义时设置

    personalBuild

    如果构建是个人构建(从RTC请求),则为True,否则不设置

迁移

1.1.9

  1. 环境变量buildResultUUID是从RTC开始构建时提供给Jenkins作业的参数。必威国际有限公司它有时也会被更新(由这个插件贡献),即使构建是在Jenkins中开始的。必威国际有限公司为了更好地支持使用multiple SCM插件构建多个项目,这个插件不会更新环境变量。无论构建从哪里开始,构建结果UUID仍然可以从RTCBuildResultUUID获得。

1.1.2

  1. 必威国际有限公司凭证插件现在用于存储用户ID和密码。对于现有的全局配置和作业,用户ID和密码(或密码文件)字段将是只读的。如果作业正在使用密码文件并且需要更改密码,则可以替换密码文件的内容。否则,要更新密码,作业将需要开始使用凭据。如果这是不可接受的,插件可以通过设置系统/环境属性在旧模式下工作:com.ibm.team.build.credential.edit=true。

1.0.10

  1. 在Linux上,带有以“/”开头的加载目录的构建定义。"/any/folder")过去被解释为相对路径,但现在被正确地解释为绝对路径。因此,任何依赖于前面行为的构建定义只需要在加载目录前面加上一个“。”(即。”。/任何/文件夹”)。

安全警告

Baidu