关于项目

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

除了项目,还可以创建库。与项目不同,库没有用于确定在何处进入步骤的选择器。

关于“项目”面板

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

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

“详细信息”选项卡

您可以在“详细信息”选项卡上指定各种项目属性。

作业控制器
选择项目引擎类型的作业控制器。选项是 Java 主作业控制器或 Perl 引擎。系统使用 Java 主作业控制器以执行主作业控制器项目。 系统仅使用 Perl 引擎来执行 Perl 引擎项目。 有关引擎类型的更多信息,请参阅系统配置设置主题中的设置使用 Java 主作业控制器作为作业执行引擎。您还可以参阅管理 Perl 引擎部分中的主题。
名称
项目的名称。系统使用此名称来引用列表和数据库中的项目。

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

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

“标记”选项卡

使用“标记”选项卡可管理项目的构建标记。

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

“寄存器”选项卡

使用项目寄存器可存储构建中持久存在的信息。

寄存器
项目寄存器的名称。
目录
寄存器的值。

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

“注释”选项卡

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

对于每条注释,该选项卡将显示以下项:

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

“快照”选项卡

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

使用此选项卡可查看和更改快照名称以及向快照名称添加注释。


反馈