使用 Jazz Team Build 创建软件构建

在 Rational Team Concert 中使用 Jazz Team Build 特性的指南

Veena H. Balakrishnaiah 概述了如何配置 Rational Team Concert 的源代码控制和 Jazz Team Build 组件,从而定义和管理您的构建。Jazz 构建针对来自指定的构建存储库工作区的文件运行,并包括变更集 (change set) 和工作项之间的可追溯性。Jazz Team Build 为团队常规构建的自动化、监控和感知提供了支持。

Veena H. Balakrishnaiah, 构建及发布工程师, IBM

Veena H. Balakrishnaiah 是位于印度 IBM 软件实验室 Operations Software Engineering Service 团队的成员,主要从事于各种产品构建。她在 SCM 和自动化工具方面有着丰富的经验,这些工具包括 IBM Rational ClearCase、IBM Configuration Management Version Control (CMVC)、Rational Team Concert 和 Rational Build Forge。



2013 年 4 月 25 日

下载 IBM® Rational® Team Concert 试用版  |  在线试用 IBM Rational 协作化生命周期管理解决方案
下载更多的 IBM 软件试用版,并加入 IBM 软件下载与技术交流群组,参与在线交流。

简介

本文介绍了 Jazz™ 技术平台的 Team Build 特性,它为团队常规构建的自动化、监控和感知提供了支持。Jazz Team Build 提供一个模型来表示团队的构建定义、构建引擎和构建结果。虽然构建工具包最适合用于 Apache Ant 构建,但您可以使用任何能够调用 Ant 的脚本技术。例如,团队可以使用 Perl、DOS 批处理文件或 Make 来创建与 Jazz Team Build 交互的构建脚本。

一个团队通常会拥有一个构建系统,从专用的构建机器运行构建。所有构建相关项都属于一个项目区域。构建相关的操作由该项目的流程管理。


配置 Rational Team Concert 组件

本节将介绍如何配置 IBM® Rational Team Concert™ 的源代码控制和 Builds 组件。Jazz 构建包括变更集和工作项之间的可追溯性。通常为来自某个指定的构建存储库工作区的文件运行构建,该工作区的传入流中包括团队的主开发流。

在运行构建之前,所有最新变更均从团队的流接收,并创建一个可复制的文件快照。记录包含在构建中的变更集和工作项,以便以后进行查看。

先决条件

本文基于以下假设:

  • 已经安装 Rational Team Concert 3.0.1.3 服务器,并且可以通过客户端 Rational Team Concert Eclipse 访问服务器。
  • 构建所需的源代码显示在 Rational Team Concert 项目区域源代码控制中
  • 已经使用 IBM Installation Manager 安装了 Build System Toolkit。

使用存储库工作区

  1. 启动 Rational Team Concert Eclipse 客户端。
  2. 根据您的团队邀请,登录并连接到现有的存储库连接。
  3. 连接到现有的项目区域,或使用 Scrum 模板创建一个新的项目区域。
  4. 从所需的源代码控制组件的流创建一个新的存储库工作区,它有一个本地副本或开发工作区,可以在其中对存储库文件进行更改:
    1. 右键单击所需的流,并选中 New
    2. 从下一个菜单中选择 Repository Workspace,如图 1 所示。
    3. 在 Repository Workspace Name 字段输入相应的名称,并单击 Next(图 2)。
    4. 在下一个对话窗口中,保留默认选择。

注意:
如果您不是管理员,并且无法创建项目区域,那么请将请求发送到 Rational Team Concert 项目管理,以便用默认 Scrum 模板创建一个项目区域。

图 1. Source Control 菜单
创建新的存储库工作区
图 2. 创建新的存储库工作区
Repository Workspace Name 字段输入
  1. 选中需要添加到 My Repository Workspace 中的组件。如果希望添加所有组件,那么请选择 Select All 选项,或根据需要逐个选中组件,并单击 Finish(参见图 3)。
图 3. 选中要添加到新存储库工作区的组件
Components to Add 视图,其中包含组件列表
  1. 从 Load Repository Workspace 窗口中的选项列表选择一个选项,加载在上一步选中的组件,并单击 Next,如图 4 所示。

注意:
如果您选择 "Load the root folders of the components as projects"(图 4),根文件夹的名称就是 Rational Team Concert 源代码控制中的组件的名称。根据项目文件夹的定义,由您决定是否需要选择其他加载选项。

  1. 在选择了加载选项后,就会看到提示,要求选择需要将每个组件的哪些文件夹加载到 Eclipse 工作区中,如图 5 中的 Load Repository Workspace 视图所示。
图 4. 加载组件内的所有项目
选中:Load component root folders as projects
图 5. 要加载到 Eclipse 工作区中的文件夹
选择要加载的存储库文件夹
  1. 要查看已加载的组件,请导航至 Eclipse 客户端窗口的右下部分。右键单击组件名称,选中 Show 并选择 Repository Files,查看该组件中的所有文件和文件夹。
图 6. 扩展的存储库组件,以便列出存储库文件
组件名称被选中,两个下拉菜单
  1. 展开文件夹,查看所需的文件。右键单击文件,并单击 Open Local file 在编辑模式中打开它。如果只想查看文件,那么请双击文件名。
图 7. 打开本地存储库文件进行更改
在编辑模式中打开的存储库文件
  1. 对文件进行必要的代码更改,Save 并关闭文件。
  2. 单击 Pending Changes 选项卡,并展开文件夹。
  3. 右键单击修改后的文件,然后选中 Check-in and Deliver,以便集成变更与 Rational Team Concert 源代码控制的主流。如有需要,可以在注释部分添加一个注释。
图 8: 在 Pending Changes 菜单上的 Check-in and Deliver 选项
选中 Check-in and Deliver
  1. 为了交付变更,必须将文件与一个 Rational Team Concert 工作项相关联。如果已经创建了工作项,那么请选择 Select an existing work item 选项;否则选择 Create a work item,这样您就可以关联已完成的变更,如图 9 所示。
图 9. 关联变更与工作项
Associate Work item 对话窗口
  1. 在创建工作项时,需要填写所有必填字段,其中包括 SummaryFiled Against,然后单击 Finish,如图 10 所示。
图 10. New Work Item 对话窗口
必填字段:Summary 和 Filed Against

变更将反映在所连接的项目的源代码控制的主要集成流中,并且它们将与您创建的工作项相关联。

使用 Rational Team Concert Builds 组件

  1. 要创建新的构建引擎,请展开 Builds,右键单击 Build Engines,选中 NewBuild Engine
  2. 在 New Build Engine 对话窗口中(图 11),输入 ID这将是构建引擎的名称。从 "Available build engine types" 中选中 Jazz Build Engine,然后单击 Finish
图 11. 可用的构建引擎类型
选中 Jazz Build Engine
  1. 在保存构建引擎配置之后,因为 Jazz Build Engine 没有运行,所以您将看到以下警告信息:The build engine process may not be running。
    1. 从命令行在 Build System Toolkit 安装目录中运行 Jazz Build Engine (JBE)(斜体字会根据您的环境而有所不同):
      Usage: jbe -vm "location of Java developer kit" 
      –repositoryrepository URL-userIdbuild username
      -passbuild user password-engineIdBuildEngine_Identifier
    2. 要创建一个加密的密码文件,请在命令行中键入以下内容(pass.txt 可以是任意文件名):
      jbe -createPasswordFile pass.txt
    3. 在看到提示时输入密码。密码被加密并保存在一个 pass.txt 文件中,该文件位于 Build System Toolkit 安装目录中。
      Usage: jbe -vm "location of Java developer kit" 
      –repositoryrepository URL-userIdbuild username
      -passwordFilebuild user password file -engineId BuildEngine_Identifier

注意:
Java 开发人员工具包的位置 是包含在 Rational Team Concert Eclipse 客户端下载中的 jdk 文件夹的路径。

图 12. 从命令行运行 Jazz Build Engine,使用加密的密码文件
所执行的 jbe 命令,带参数

注意:
在构建引擎被创建后,它就会显示在项目区域的 Build Engine 视图中的 Builds 下面。

  1. 要创建新的构建定义,请右键单击 Builds,并选中 New Build Definition
  2. 根据构建所使用的构建工具,在 New Build Definition 窗口中,从列表中选择可用的构建模板,如图 13 所示。
    • 如果使用 Ant 作为构建工具,那么构建模板将会是 Ant-Jazz Build Engine
    • 如果使用任何其他工具或脚本语言,并选择 Command Line-Jazz Build Engine,那么您将能够通过运行脚本或命令来运行构建。
图 13. 使用 Command Line - Jazz Build Engine 创建构建定义
New Build Definition 窗口,其中有模板列表
  1. 在该步骤中,您会看到提示,要求您根据步骤 5 中所选择的选项对构建定义进行定制。如果要求进行定制,请选中 Jazz Source Control 并单击 Finish
  2. 在 Build Definition 对话窗口中输入相应的详细信息:
    1. 在 Overview 选项卡下面,通过单击 Edit 按钮,可以选中已创建的构建引擎。如果想创建新的构建引擎,那么请单击 Create 按钮。
    2. 在 Schedule 选项卡下面,基于将要执行的构建定义来定义时间表。
    3. 在 Properties 选项卡下面(图 14),根据构建脚本的要求来添加属性的名称和值。
图 14. Build Definition 对话窗口的 Properties 选项卡
添加属性的名称和值
  1. 在 Build Definition 窗口中,如果您选择了 Jazz Source Control(如步骤 6 所示),则需要填写 Workspace and Load Directory 字段,如图 15 所示:
    1. 对于 Build Workspace,请单击 Select,并从下拉菜单中选择工作区或流。
    2. 在 Load Directory 字段中,必须加载流的本地副本所在的绝对目录。
      • 如果文件夹在加载前已经存在,并且需要删除它,那么请选择 Delete directory before loading
      • 如果必须为每个组件创建文件夹,那么请选择 Create folders for components ,这样可以解决两个或多个组件的文件夹名称相同时产生的冲突。
    3. 在 Accept Options 部分的下面,为了在加载前自动接受变更,请单击已列出的两个复选框。

注意:
如果您在快照上创建构建,而不是在主流上工作,那么请从流创建一个快照:

  • 右键单击流,选中 New,并选择 Snapshot
  • 然后,在 Jazz Source Control 选项卡中,选中已创建的快照,而不是流。
图 15. Build Definition 视图的 Jazz Source Control 选项卡
Jazz Source Control 选项卡视图
  1. 在图 16 所示的 Build Definition 窗口的 Command Line 选项卡中:
    1. 在 Command 字段中输入构建脚本或构建文件或构建命令。当用户请求一个构建时,会调用该脚本或命令。
    2. 在 Arguments 字段中,输入命令行参数(如果有的话)。
    3. 在 Working directory 字段中,输入所调用命令将要使用的工作目录。
    4. 如果构建正在使用任何外部属性文件,则在 Properties file 字段中输入文件名称。

注意:
在 Command 字段中,可以直接指定 Ant 文件 (build.xml) 或调用 Ant 的任何脚本。

图 16. Build Definition 的 Command Line 选项卡
Command line 选项卡视图
  1. 输入了 Build Definition 选项卡中的所有信息后,Save 定义。
  2. 要请求一个构建,右键单击所创建的构建定义,并从下拉菜单选中 Request Build
  3. 在 Request Build 窗口中,Browse 在 Build 选项下创建的构建引擎。在 Build 属性中输入构建属性(如果有的话),并单击 Submit
图 17. 通过可用的构建引擎请求一个构建
Request Build 对话窗口

注意:
对于要启动的构建,确保 Jazz Build Engine (JBE) 正在运行,并且用户名与工作区所有者的用户名相同。

  1. 构建从将源文件加载到本地构建机器开始,然后执行构建命令。
  2. 在完成构建后,屏幕上会显示有关的详细信息,以及日志文件(图 18)。

提示:
如果需要创建工作项,那么可以通过单击 Create Work itemAssociate on existing work item 来创建工作项。

图 18. Rational Team Concert 的构建状态摘要
绿色区域显示构建状态为 Completed

参考资料

学习

获得产品和技术

  • 下载 Rational Team Concert 试用版,并在最多 10 个项目上 免费 试用它,时间不限(要求注册)。如果您愿意,您可以在沙盒中试用它,而无需将它安装到自己的系统上。
  • 以最适合您的方式 评估其他 IBM 软件:下载产品试用版、在线试用产品、在云环境中使用 产品,或在 SOA Sandbox 中花几小时学习如何高效地实现面向服务的架构。

讨论

条评论

developerWorks: 登录

标有星(*)号的字段是必填字段。


需要一个 IBM ID?
忘记 IBM ID?


忘记密码?
更改您的密码

单击提交则表示您同意developerWorks 的条款和条件。 查看条款和条件

 


在您首次登录 developerWorks 时,会为您创建一份个人概要。您的个人概要中的信息(您的姓名、国家/地区,以及公司名称)是公开显示的,而且会随着您发布的任何内容一起显示,除非您选择隐藏您的公司名称。您可以随时更新您的 IBM 帐户。

所有提交的信息确保安全。

选择您的昵称



当您初次登录到 developerWorks 时,将会为您创建一份概要信息,您需要指定一个昵称。您的昵称将和您在 developerWorks 发布的内容显示在一起。

昵称长度在 3 至 31 个字符之间。 您的昵称在 developerWorks 社区中必须是唯一的,并且出于隐私保护的原因,不能是您的电子邮件地址。

标有星(*)号的字段是必填字段。

(昵称长度在 3 至 31 个字符之间)

单击提交则表示您同意developerWorks 的条款和条件。 查看条款和条件.

 


所有提交的信息确保安全。


static.content.url=http://www.ibm.com/developerworks/js/artrating/
SITE_ID=10
Zone=Rational
ArticleID=900721
ArticleTitle=使用 Jazz Team Build 创建软件构建
publish-date=04252013