关于项目

项目是可执行的多组步骤,拥有其自己的环境组和服务器属性。

除了项目,还可以创建库。库类似于项目,但不含用于确定步骤运行位置的选择器。

关于“项目”面板

使用“项目”面板可创建新项目并查看或编辑现有项目。要访问“项目”面板,请单击左侧菜单中的项目

“项目”面板提供以下选项卡:

“详细信息”选项卡

在“详细信息”选项卡上,您可以指定有关项目的各种属性。
“项目”面板中“项目详细信息”选项卡的屏幕图像
名称
项目的名称。系统使用此名称来引用列表和数据库中的项目。

在运行项目时,项目名称用于构造项目目录。因为项目可能包含运行于不同操作系统的步骤,所以请避免在项目名称中使用特殊字符和符号。如果项目名称必须使用导致无效目录名的字符, 请将这些字符添加到“无效的相对目录字符”系统配置设置中。在创建项目目录时,此设置中列出的字符将转换为下划线 (_)。使用 & 符号可能导致无意生成 HTML 实体作为产品名称的一部分。

访问
有权查看和使用项目的访问组。 访问属性随许可权一起用于确定用户可以执行的操作。例如,要启动某个作业,您必须是为项目指定的访问组的成员,并且还必须是具有“执行作业”许可权的组的成员。有关访问组的更多信息,请参阅访问概述
禁用
选中此复选框可禁用项目。当用户尝试运行禁用的项目时,Rational Build Forge 会显示一条消息,表明该项目处于不活动状态并且不会运行项目。
最大线程数
允许项目启动的并行处理的最大数量。使用该字段可防止项目使用过多的系统资源。每个支持线程的步骤和任何内联项目(它们自己可能启动支持线程的步骤)都会产生并行处理,但所有这些处理都计入父项目的最大数量。当达到“最大线程数”值时,系统会停止启动新的并行处理,并等待项目的并行处理数量降到低于“最大线程数”值,然后再继续。有关线程化的更多信息,请参阅线程化:并行运行步骤
运行限制
运行限制属性设置项目在同一时刻允许的最大作业数。
  • 如果启动项目且活动作业数等于“运行限制”,那么新作业在“等待”队列中等待,直到至少完成一个作业为止。
  • 如果调度尝试启动项目而活动作业数等于“运行限制”且“硬运行限制”系统配置设置具有值“是”,那么系统不会启动新作业。 如果“硬运行限制”设置为“否”,那么系统忽略对已调度构建的“运行限制”设置。
  • 通过内联启动的项目不被视为原始项目的实例,不计入其“运行限制”内。
必须将每个项目指定给一个类,类用于为作业组指定全局属性。有关更多信息,请参阅
选择器
在选择项目服务器时使用的选择器的名称。对于项目内未指定它们自己的选择器的所有步骤,系统使用该选择器作为缺省的选择器。请参阅选择器。如果未指定选择器,那么项目将被添加到“库”面板,而不是“项目”面板。库使用调用步骤的选择器;如果该步骤没有选择器,那么库将使用调用项目的选择器。
通过链,失败链
选择在项目构建通过或失败时运行的项目。在项目级别设置通过/失败链使您可以根据项目的通过/失败状态来调用单独的通过/失败操作。该功能类似于在项目内的步骤级别设置通过/失败操作。在项目级别,通过/失败操作是由项目运行状态而不是步骤状态触发。
环境
在“服务器”环境之后、“步骤”环境之前应用的环境。有关环境如何协同工作的更多信息,请参阅关于变量
固定
启用“固定”复选框可以强制项目中使用缺省项目选择器的所有步骤都停留在同一服务器上,如果该服务器正忙,那么等待它变为可用。有关此选项的更多信息,请参阅使步骤固定在服务器中
启动通知、通过通知、失败通知
通过对这些字段中的一个或全部选择访问组,使用这些字段可以指示系统在项目启动、通过和/或失败时发送通知电子邮件。

“标记”选项卡

使用“标记”选项卡可管理项目的构建标记。
标记格式
使用纯文本和标记变量引用定义项目标记的字符串。有关标记格式的更多信息,请参阅作业期间更改构建标记
标记同步
同步两个项目的标记变量。选择要将其标记变量与当前项目进行同步的项目。当两个项目进行同步时,它们的变量从同一个池中提取,所以当它们依次运行时,一个项目获得值 1,下一个获得值 2,如此类推。有关更多信息,请参阅同步标记
标记名称
变量的名称。当您以标记格式使用标记变量时,请使用格式 $<Tag Name> 引用其名称。例如,要创建使用 MainVer 和 B 变量的标记,请使用标记格式“Build_$MainVer.$B”获取类似 Build_005.1 的标记。
初始值
设置标记变量的值。若不使用自动增加选项,变量将保留该值直至您更改它。
填充
如果选择了除 None 外的填充值,那么如需在标记中使用变量来确保数字数量等于填充值时,系统将向变量值前添加零。 例如,如果变量当前为 2,而“填充”为 3,那么系统会将值表示成 002。“填充”范围为 1 到 8。
自动增加
若设置为 Yes,系统对于项目的每个作业按 1 递增变量值。

“寄存器”选项卡

使用项目寄存器可存储构建之间持久存在的信息。
寄存器
项目寄存器的名称。
目录
寄存器的值。

有关更多信息,请参阅项目寄存器

“注释”选项卡

使用“注释”选项卡可存储项目中感兴趣的项。

对于每条注释,选项卡显示:

  • 用户创建注释的日期和时间
  • 输入注释的用户
  • 注释

“快照”选项卡

项目快照是项目实例。“快照”选项卡提供快照名称。

使用此选项卡可查看或更改快照名称以及有关快照的注释。


反馈