结合 Rational Change 和 Rational ClearCase 实现无缝的变更和配置管理

Rational Change for Rational ClearCase Interface 配置工具的使用指南

本文将介绍 Rational Change for ClearCase Interface 的配置,以及如何结合使用 Rational Change 和 Rational ClearCase 来实现变更和配置管理。本文将重点强调 Rational Change 如何与 Rational ClearCase 集成,从而追踪变更请求的实现。本文面向对 Rational Change 和 Rational ClearCase 有中级知识水平的读者。

Prajna Dutt, 助理软件工程师, IBM

作者的照片Prajna Dutt 过去三年一直致力于 Rational Change 及其相关集成。在此期间,她研究的集成涉及到 Rational Synergy、Rational Change、HP Quality Center、Rational ClearCase、Rational ClearQuest 和 Rational Team Concert,这使得她精通所有这些产品。



2013 年 1 月 10 日

简介

在任何软件开发场景中,我们每天都会做出很多变更,添加新的代码,删除旧的数据,等等。为此,我们将使用 Rational ClearCase 来跟踪我们对自己的数据或代码所做的更改,并跟踪我们的软件版本。此外,在开发周期中,我们会测试所开发的软件。当我们测试某个软件时,必然会处理许多变更请求,并且需要做出很多改进。这些变更请求都在 Rational Change 中进行维护。集成这两个工具的目的是无缝地联合它们,这样我们就可以知道针对某个变更请求的代码变更是否已到位,反之亦然。该集成在 Rational Change 中的变更请求和 Rational ClearCase 中的一块代码之间创建了一个链接。

集成 Rational Change 中的变更管理和 Rational ClearCase 中的配置管理,带来更好的软件开发生命周期管理。


先决条件

IBM® Rational® Synergy
基于任务的配置管理解决方案,使分布在全球各地的开发团队在统一的配置和发布管理平台上一起工作
 
IBM® Rational® Change
一个基于 Web 的变更管理解决方案,在整个软件的开发生命周期中跟踪软件质量,并提供强大的查询和报告机制
 
IBM® Rational® ClearCase®
软件配置管理工具,可以帮助团队对其源代码和其他项目构件使用版本控制,支持并行开发和图形合并功能,从而加速开发周期
 

术语

VOB(版本对象基础)
一个 ClearCase 存储库,用于存储文件和目录元素
 
CR(变更请求)
一个 Rational Change 缺陷或改进请求
 

安装和配置集成

  1. 在 UNIX 或 Windows 计算机上安装 Rational Synergy、Rational Change 和 Rational Change for ClearCase Interface 的服务器端组件(如 Rational Change for ClearCase Interface readme 文件所述)。
  2. 在安装了 Rational Change 的同一台计算机上,或者在另一台 UNIX 或 Windows 计算机上安装 Rational ClearCase 和 Rational Change for ClearCase Interface 的客户端组件(如 Rational Change for ClearCase Interface readme 文件所述)。该客户端安装程序会安装 Rational Change for Rational ClearCase Interface - Configuration Tool,用它来收集 Rational Change 服务器详细信息并配置由集成使用的 ClearCase 触发器,如图 1 所示。
图 1. Rational Change for ClearCase Interface - 配置工具
配置工具的截屏

注:
如安装步骤中所述,Rational Change 被视为服务器,而 Rational ClearCase 被视为该集成的客户端。


集成 Rational Change 与基础 ClearCase 模型

设置集成

  1. 在 Rational ClearCase 中创建一个版本对象基础 (VOB),并打开配置工具。VOB 将列在左侧的 Rational ClearCase VOB 下面。
  2. 单击该 VOB,提供 Rational Change 服务器的详细信息,为 VOB 的签入和签出操作选择各自的触发器策略,并保存更改。可以通过 Rational Change Queries 提取查询字段的值。例如:(cvtype='problem')
  3. 选择触发器策略。常用的策略是 Prompt,它需要选择 VOB 上的签入和签出操作。
    • 如果选中了 Do not prompt users 策略,那么在出现 VOB 上的签入/签出操作时,集成不会提示用户选择一个 Rational Change 变更请求 (CR)。
    • 如果选中了 Prompt, but do not require selection(s) 策略,那么在出现 VOB 上的签入或签出操作时,集成将提示用户选择一个 Rational Change CR。CR 的选择将不是强制性的。
    • 如果选中了 Prompt, and require selection(s) 策略,当出现 VOB 上的签入/签出操作时,该集成会提示用户选择一个 Rational Change CR。CR 的选择将是强制性 的。如果没有选择 CR,该操作不会继续。

图 2 显示了为 Rational Change 配置一个 VOB。

图 2. 在一个 VOB 上配置 Rational Change
VOB 上的触发器策略配置

从 Rational ClearCase 签入和签出

接下来,您将创建 Rational Synergy 任务,同时在 Rational ClearCase 中工作,并查看如何集成 ClearCase 与 Rational Change。

  1. 转到 Rational ClearCase 资源管理器并选择您创建的 VOB - 即使用配置工具创建的、存储了 Rational Change 服务器详细信息的那个 VOB。
  2. 在该 VOB 中创建一个目录或文件。现在,这将是我们的集成的对象。通过该对象的上下文菜单,执行操作(签入或签出)。

因为在配置上选中了 Prompt, and require selection 选项作为触发器策略(参见上面的图 2),它打开一个 CR 选择对话框,其中包含来自 Rational Change 的 CR。如图 3 所示。被填入该选择对话框中的 CR 仅限于在配置中所指定的查询范围。这里的查询是:
(cvtype=problem) and (crstatus=assigned)

所以,它填入目前是 assigned 状态的 CR。

图 3. 在 Rational ClearCase 对象的签入或签出过程中的 CR 选择对话框
签入或签出过程中的 CR 列表

签入/签出操作完成后,集成任务是在 Rational Synergy 中创建的,并与上一步中所选择的 CR 关联。在 Rational Change 中的 Associated Tasks 字段中查看 CR 上的集成任务,如图 4 所示。通过提要 (synopsis) 可以很容易区分集成任务和非集成任务。例如,集成任务的提要是这样的:ClearCase Integration Task。

图 4. 与 CR 有关联的集成任务
在 Associated Tasks 下面显示的集成任务

如果已经有一个与 CR 关联的集成任务,则不会将另一个集成任务关联到同一个 CR。相反,它会将已签入或签出的对象添加到相同的集成任务。但是,本例中有一个例外:一个 CR 可以有两个集成任务,有一个集成任务已经完成。它不会重新打开已完成的集成任务,而是在来自 Rational ClearCase 的对象上进行签入或签出时创建一个新的集成任务。如图 5 所示。

图 5. CR 上的集成任务状态
在同一个 CR 上创建的另一个集成任务
  1. 在 CR 上的 Associated Tasks 的下面,单击任务 ID 链接(编号的链接)以显示任务下面的对象。

这会打开任务对话框,在任务上的 Associated Objects 字段下面显示对象。这里所列出的对象是在 Rational ClearCase 中已签入或签出的对象,CR 是针对该对象进行选择的。该字段下所列出的每个对象都会显示已签入或签出的对象名称及相应的状态,该状态可以是 integrateworking。与任务相关联的对象如图 6 所示。

图 6. 在任务上的关联对象
与 ClearCase 对象对应的对象

图 6 的大图

已签出的对象显示为 working 状态,而已签入的对象则显示为 integrate 状态。所以,在图 6 中,用户会看到该任务有两个与其有关联的对象:

  • cc2.txt,显示为 integrate 状态
  • cc4.txt,显示为 working 状态

到目前为止,您已经了解了 “CR-任务-对象” 的关联。现在,您会看到需要完成从该集成创建的任务时会发生什么。请记住以下两点:

  • 只有所有关联的对象都处于 integrate 状态时,任务才能完成。如果有任何关联的对象处于 working 状态,则无法完成任务。
  • 如果与 CR 有关联的所有集成任务都有处于 integrate 状态的对象之后,就可以直接从 Rational Change 解析 CR。解析 CR 将自动完成与 CR 有关联的集成任务。

在基础 ClearCase 上撤消签出

想像一下,如有签出了一个对象,并且在 Rational Change 上将该对象与某个 CR 上的集成任务相关联。

当您在 Rational ClearCase 中执行 Undo Checkout 时,会删除关联到集成任务的对象。如果该对象是与该集成任务有关联的惟一对象,那么还会删除集成任务。


集成 Rational Change 与 UCM ClearCase 模型

设置集成

  1. 在 Rational ClearCase 中创建一个 UCM 项目和一个 VOB,并在配置工具中选择该 VOB。
  2. 提供 Rational Change 服务器详细信息并选择触发器策略。
  3. 出于本教程的目的,请在配置工具中的 "Activities - Create activity policy" 下面选择 Prompt, and require selection(s)(参见图 7)。
图 7. 创建活动策略
创建活动策略选择选项

使用活动和对象

  1. 在 Rational ClearCase 资源管理器上,选择所创建的 VOB(配置了 Rational Change 服务器详细信息的 VOB)。
  2. 在这里面创建一个对象(文件或目录),并将它添加到源控件。

该集成会提示您创建一个新的活动,如图 8 所示。

图 8. 新活动的创建
Add to Source Control 对话框

因为您已选择了 Prompt, and require selection(s) 作为 "create activity" 的触发器策略,所以在创建一个新的活动时会提示您选择一个 CR。选择一个 CR 之后,系统会将一个集成任务关联到该 CR。任务描述会显示创建该任务所针对的任务(参见图 9)。

图 9. 任务描述会显示创建该任务所针对的任务
在 Assigned task 视图中的描述

在对象已签入或签出的情况下,如果集成任务已与选定活动的 CR 有关联,那么该集成不会再创建一个新的集成任务。但是,如果集成任务已完成,则会创建另一个集成任务,并将它与带有活动详细信息的 CR 相关联。

现在,UCM ClearCase 中已创建了一个活动,您已准备好转到 Rational ClearCase 对象。类似于基础 ClearCase,当您签入或签出对象时,集成将在 Rational Change 中创建对象并将它们与任务相关联。

在 UCM ClearCase 上撤消签出

想像一下,如果签出了一个对象,并且将该对象与某个集成任务相关联,而该集成任务又与 Rational Change 中的一个 CR 有关联。

当您在该对象上执行 Undo Checkout 操作时,会删除与任务有关联的对象。不过,没有删除任务本身,它仍然与 CR 有关联。用于对象签出的活动也没有删除。所以,即使没有对象与任务都有关联,“CR-任务” 和 “任务-活动” 关系仍保持完整。

删除活动

如果某个活动没有与它有关联的任何变更集(ClearCase 对象),那么可以删除它。当删除​​此活动时,还会删除与该活动有关联的 Rational Synergy task 任务,前提是没有其他占位符对象与该任务有关联。

交付已完成的工作

当您完成开发流中的开发和测试工作时,您需要将工作交付给集成流,以便能够与其他组件一起接受测试。

  1. 从项目资源管理器中将活动从开发流交付给集成流。

在将活动合并到目标集成流并且您对测试结果感到满意之后,就可以完成交付流程了。完成交付流程还会完成与所交付活动有关联的 Synergy 任务。集成会自动将所有与任务有关联的对象转换为 integrate 状态。

注:

  • 如果将配置工具上的交付活动策略设置为 Do not make activity obsolete on deliver(如图 10 所示),那么活动会在完成交付之后保持 unlocked 状态。这意味着,可以在 Rational ClearCase 上进一步使用该活动,并且可以在该活动下面执行工作。
图 10. 交付活动策略 - do not make activity obsolete
配置工具中 VOB 上的策略设置
  • 如果将配置工具上的交付活动策略设置为 Automatically make activity obsolete on deliver(如图 10 所示),则会淘汰该活动。
图 11. 交付活动策略 - make activity obsolete
配置工具中的另一个策略选项
  1. 您可以查看活动 Properties 对话窗口,看看活动是处于 locked 还是 obsolete 状态。

当某个活动在交付过后遭到淘汰时,就无法将该活动进一步用于工作。如果尝试将已淘汰的活动用于任何对象上的签入或签出,则会导致如图 12 所示的错误消息。

图 12. 使用已淘汰的活动时出现的错误
错误消息的弹出窗口

Rational Change 集成报告

本文中的 “先决条件” 小节提到了,Rational Change 提供一个强大的报告机制。您可以使用该特性来查看集成报告。

  1. 以用户身份登录 Rational Change,并选择 Reports > System

屏幕列出了该集成提供的 ClearCase CRs-Objects、ClearCase CRs-Tasks-Objects 和 ClearCase CRs-Tasks-Objects (Long) 报告。可以在左侧看到该列表,如图 13 所示。

图 13. 集成报告菜单
Report on Change Requests 视图
  1. 单击报告链接,以查看某个特定的报告。

ClearCase CRs-Objects 报告

该报告显示了一个 Rational Change CR 以及与该 CR 上的集成任务有关联的 Rational ClearCase 对象之间的关系。对于为 VOB 指定的查询范围内的所有的 CR,都可以看见该关联。

图 14 显示了报告中的一个这种关联。

图 14. ClearCase CRs-Objects 报告
显示 CR 到 ClearCase 对象的关系

图 14 的大图

ClearCase CRs-Tasks-Objects 报告

该报告显示了 Rational Change CR 和 Rational Synergy 任务的关系,以及 Rational Synergy 任务到与集成任务关联的 ClearCase 对象的关系。报告中的一个关联示例如图 15 所示。

图 15. ClearCase CRs-Tasks-Objects 报告
CR 到任务以及任务到对象的关系

图 15 的大图

ClearCase CRs-Tasks-Objects (Long) 报告

该报告显示了 Rational Change CR 和 Rational Synergy 任务的关系,以及 Rational Synergy 任务到与集成任务有关联的 ClearCase 对象的关系。报告中的一个关联示例,如图 16 所示。这是一个更详细的报告,因此,它列出了对象的更多属性。

图 16. ClearCase CRs-Tasks-Objects (Long) 报告
报告显示对象属性的详细信息

图 16 的大图

如果需要在报告中显示其他信息,那么可以使用 Rational Change 进一步定制这些报告。

参考资料

学习

获得产品和技术

讨论

条评论

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=854580
ArticleTitle=结合 Rational Change 和 Rational ClearCase 实现无缝的变更和配置管理
publish-date=01102013