< 上一课 | 下一课 >

课程 2:创建组件进程

组件进程是用户定义的在组件上运行的任务。

组件进程是一连串命令,这些命令称为步骤。步骤可以处理文件、运行系统命令、设置属性、将信息传递至其他步骤以及运行程序。步骤由自动化插件提供。进程将通过拖放进程编辑器进行设计,您可以在该编辑器中将插件步骤拖至设计编辑器并按您的需要进行配置。产品附带了若干插件,并且可以使用其他插件,这些插件适用于许多不同类型的软件。在本教程中,您将使用两个插件,都是本产品所附带:FileUtilsIBM UrbanCode Deploy。组件可以具有为其定义的任何数目的进程,但组件必须至少具有一个进程。

在本课程中,您将为 helloWorld 组件创建一个部署进程。稍后,您将创建一个使用该组件进程来部署此组件的应用程序进程。

要创建组件进程,请完成以下步骤:

  1. 定义组件进程:
    1. 在“组件:helloWorld”页面上,单击进程选项卡,然后单击创建新进程
    2. 在“创建新进程”窗口的名称字段中,输入 helloProcess
    3. 进程类型列表中,选择部署 对于卸载或配置组件的进程,此列表具有其他选项。
    4. 接受其他字段的缺省值,然后单击保存 缺省工作目录字段变成代理程序用来执行其工作(例如,下载工件和创建临时文件)的文件夹。对于本教程,该值变成 \agent_install\var\work\helloWorld
    该进程列示在“进程”窗格上。
  2. 从进程列表中,选择 helloProcess 将在进程编辑器中打开该进程。进程编辑器列示插件和步骤。必需的启动完成步骤表示进程的开始和结束,将自动放置在设计区域。通过将步骤拖至设计区域并将其排列在启动完成步骤之间,可以将步骤添加到进程。
    进程设计编辑器
  3. 添加一个从工作目录中移除文件的步骤。 要确保代理程序使用最新的文件,请移除先前工作遗留的文件:
    1. 可用插件步骤列表中,展开实用程序 > FileUtils
    2. 单击删除文件和目录步骤并将其拖至进程编辑器。 将打开“编辑属性”窗口,该窗口中显示了此步骤的属性。其中某些属性是此步骤所独有的,而其他属性对于所有步骤都相同。
    3. 名称字段中,指定一个名称,例如,清除工作空间
    4. 基本目录字段中,指定单个句点 (.)。 此值将解析为您已指定为代理程序工作目录的文件夹。
    5. 包括字段中,指定一个星号 (*)。 此参数指示代理程序移除工作目录中的所有文件。
    6. 接受其他属性的缺省值,然后单击保存
    新步骤将显示在设计区域。每个步骤的右上角都有两个图标。单击编辑图标 以重新打开“编辑属性”窗口,可以在该窗口中修改步骤属性。 单击 X 图标 以删除该步骤及其连接。
    具有一个步骤的新进程
  4. 启动步骤连接至清除工作空间步骤。从启动开始,步骤之间的连接确定进程流。可以在放置步骤时定义连接,也可以稍后定义。
    1. 将鼠标悬停在启动上。 将显示箭头图标,如下图所示。请使用此图标将步骤相互连接。
      箭头图标
    2. 单击箭头图标并将其拖至清除工作空间步骤上。 连接箭头链接这两个步骤,如下图所示。箭头方向定义进程流的方向。
      箭头连接头两个步骤
  5. 添加一个步骤来从代码站存储库下载组件工件的最新版本。 下载工件步骤用在大多数部署类型的进程中。此步骤将组件工件的指定版本下载到最近进行了清除的代理程序工作目录。运行该进程时,请指定要使用的组件工件的版本。
    1. 可用插件步骤下,展开存储库 > 工件 > IBM UrbanCode Deploy,然后将下载工件步骤拖至进程编辑器。
    2. 在“编辑属性”窗口中,接受缺省值,然后单击保存
    3. 清除工作空间步骤连接至下载工件步骤。 除了与启动的连接以外,每个连接都有一个条件标志。条件标志表示在可以遵循连接之前必须具有的进程状态。仅当起源步骤已完成并且满足指定的条件时,才会遵循连接。可能的条件如下:success、failure 或 both。缺省条件是 success,它由绿色复选标记表示,如下图所示。在此示例中,仅当清除工作空间步骤完成并且条件为 success 时,才会启动下载工件步骤。可以通过单击图标来更改条件标志。
      条件标志
  6. 添加一个步骤来创建压缩文件。 在此示例中,压缩文件包含上一步骤中下载的文件。
    1. 展开实用程序 > FileUtils,然后将创建 .zip 文件步骤拖至进程编辑器。
    2. 在“编辑属性”窗口中,指定名称压缩工件
    3. .zip 文件名字段中,输入 helloWorld.zip
    4. 基本目录字段中,输入单个句点 (.)。 将在代理程序工作目录中创建该压缩文件。
      注: 如果您指定最终目标目录而不是代理程序工作目录,那么不必执行下一步骤。但是,除了移动文件之外,下一步骤还说明了如何使用您先前创建的属性。
    5. 包括字段中,输入一个星号 (*)。 压缩文件包含从存储库下载的所有文件。
    6. 接受其他字段中的缺省值,然后单击保存
    7. 下载工件步骤连接至压缩工件步骤。
  7. 添加一个步骤来移动工件。 此步骤将压缩文件移至目标文件夹。为了简单起见,本教程将该文件移至 \helloWorld 文件夹中的目录。
    1. 展开实用程序 > FileUtils,然后将移动目录步骤拖至进程编辑器。
    2. 在“编辑属性”窗口中,指定名称部署工件
    3. 源目录字段中,输入单个句点 (.)。
    4. 目标目录字段中,输入以下值:${p:helloHome}/target ${p:helloHome} 值将引用您先前创建的属性。/target 目录相对于属性值。例如,如果将属性值定义为 /home/user1/artifacts/shared/helloWorld,那么该文件将移至 /home/user1/artifacts/shared/helloWorld/target。有关使用属性的信息,请参阅 属性
    5. 包括文件字段中,输入:*.zip
    6. 接受其他字段中的缺省值,然后单击保存
  8. 通过单击工具下的保存 图标保存该进程。
完整的 helloWorld 组件的进程类似于下图:
完整的 helloWolrd 组件的进程

课程检查点

在本课程中,您创建了用于部署 helloWorld 组件的组件进程。
您可以使用组件进程来使组件上的许多任务自动化。在本教程中的后面部分,您将创建应用程序进程来部署该组件。
< 上一课 | 下一课 >

反馈