属性

可以为许多不同对象(其中包括组件、环境、进程和应用程序)设置属性。还可以为系统设置全局属性。

可供您使用的属性取决于上下文。例如,在组件进程中,您可以访问当前组件的组件属性。在应用程序进程中,您可以访问应用程序属性和环境属性,但无法访问任何组件属性。下表显示了每种类型的属性在其中可用的进程。

要查看可供某个进程使用的属性,请运行该进程。完成该进程时,请转至进程请求的属性选项卡。此选项卡列示了可供该过程使用的所有属性。

下表列示了可供进程使用的属性类型以及哪些进程有权访问每种类型的属性。
表 1. 属性和这些属性在其中可用的进程
属性类型 可以访问该属性的进程 示例语法
通用进程属性 通用进程 ${p:ProcessProp1}
应用程序进程属性 应用程序进程和组件进程 ${p:ProcessProp1}
组件进程属性 组件进程 ${p:componentProcess/ProcessProp1}
组件版本属性 包括版本的组件进程类型,例如,“部署”和“可操作(带有版本)” ${p:version/VersionProp1}
资源属性 所有进程 ${p:resource/ResourceProp1}
环境属性 组件进程和应用程序进程 ${p:environment/EnvProp1}
应用程序属性 应用程序进程和组件进程 ${p:application/AppProp1}
系统属性 所有进程 ${p:system/SystemProp1}
请求属性 所有进程
  • ${p:request.user.id}
  • ${p:request.user.name}
  • ${p:request.user.displayName}
表 2. 属性上下文
上下文 描述
环境

在组件或环境的“属性”选项卡上可用。

引用:${p:environment/propertyName}

这两个版本都使用相同的语法。对组件环境设置的值将覆盖直接对环境属性设置的同名值。组件环境属性帮助您集中管理属性,例如,对类型和缺省值进行跟踪。环境属性专门提供了“属性/值”对的列表。

资源 选择环境中具有相同值的所有属性。
资源角色 选择资源中具有相同值的所有属性。
应用程序

在应用程序的“属性”选项卡(应用程序 > [所选应用程序] > 属性)上可用。

引用:${p:application/propertyName}

组件 选择系统中具有相同值的所有属性。
进程

在应用程序的“属性”选项卡(应用程序 > [所选应用程序] > 属性)上可用。

引用:${p:application/propertyName}

进程步骤有权访问由进程中其他步骤先前设置的属性、由启动了组件进程的应用程序设置的属性以及目标环境和资源的属性。步骤属性值在组件进程结束后变为不可用。

引用:${p:propertyName}

系统

系统(全局)属性在“设置”选项卡(设置 > 属性)上可用。

引用:${p:system/propertyName}

表 3. IBM UrbanCode Deploy 属性
属性 描述
version.name 用户定义的名称,用于将该版本与其他版本区分开。版本名称在导入新版本时输入。
version.id 分配给版本的编号。在代码站中导入新版本时,将创建版本标识。
component.name 用户定义的名称,用于将该组件与其他组件区分开。组件名称在您创建新组件时输入。
component.id IBM® UrbanCode Deploy 分配的唯一编号,用于将该组件与其他组件区分开。在 IBM UrbanCode Deploy 中创建组件时,将创建组件标识。
resource.name 用户定义的名称,用于将该资源与其他资源区分开。资源名称在您编辑或创建新资源时输入。
resource.id 分配给资源的唯一编号。创建新资源时,将分配资源标识。
application.name 用户定义的名称,用于将该应用程序与其他应用程序区分开。应用程序名称在您编辑或创建新应用程序时输入。
application.id 分配给应用程序的唯一编号。在 IBM UrbanCode Deploy 中创建新应用程序时,将分配应用程序标识。
environment.name 用户定义的名称,用于将该环境与其他环境区分开。环境名称在您编辑或创建新环境时输入。
environment.id 分配给环境的唯一编号。创建新环境时,将分配环境标识。
agent.id IBM UrbanCode Deploy 分配给代理程序的唯一编号,用于将该代理程序与其他具有类似名称的代理程序区分开。在系统上安装代理程序时,将分配代理程序标识。
agent.name 用户定义的名称,用于将该代理程序与其他代理程序区分开。可以通过编辑代理程序的 conf/agent/installed.properties 文件并重新启动代理程序来输入代理程序的名称。
stepnamepropertyname

所有步骤都具有以下属性:exitCode、status 和 lines of interest(LOI,它们是处理后脚本在步骤的输出日志中查找的项)。

要查看这些属性,可以使用组件的“日志”窗格来检查步骤的输出日志(组件 > [所选组件] > [“查看请求”操作] > [“输入/输出属性”操作])。

使用 status 属性定义的库存状态和版本状态可以用在应用程序审批门中(请参阅环境门)。其他属性可以由处理后脚本使用,请参阅创建插件

可以使用处理后脚本来设置可以在同一进程的其他步骤中使用的输出属性,这将启用复杂的工作流程。按以下方式引用先前步骤的输出属性:

${p:stepName/propName}

例如,要通过处理后脚本来设置环境属性,请在处理后脚本中设置步骤的输出属性。然后使用 Set Environment Property 步骤,它将使用该输出属性。

property_name 组件进程或应用程序进程的属性;在进程的“属性”选项卡上进行定义。由进程的运行者提供值。
component/property_name 组件定制属性;在组件的“属性”选项卡上进行设置。
environment/property_name 环境属性。在组件或环境的“属性”选项卡上进行定义。虽然组件和环境的“属性”选项卡使用相同的语法,但后者未与任何特定组件相关联。将对相关联的环境或组件提供值。对组件环境设置的值将覆盖直接对环境属性设置的同名值。
resource/property_name 资源属性。这些属性可以包括内置代理程序属性和任何定制属性。其中每个属性都在该资源上有一个选项卡。
resource/role_name/property_name 资源角色属性。将对资源角色定义这些属性,并且这些属性的值在您将角色添加到资源时进行设置。
application/property_name 应用程序定制属性。将在应用程序的“属性”选项卡上设置这些属性。
system/property_name 全局系统属性。将在“设置”区域中的“系统属性”选项卡上设置这些属性。

以下所有属性都是以逗号分隔的一系列“名称/值”对,其中包括对象的每个属性。此表对于标记替换很有用。

表 4. “名称/值”对
属性 描述
component/allProperties 选择组件中具有相同值的所有属性。
environment/allProperties 选择环境中具有相同值的所有属性。
resource/allProperties 选择资源中具有相同值的所有属性。
system/allProperties 选择系统中具有相同值的所有属性。

反馈