bfexport 参考

使用 bfexport 命令可以将项目数据导出到命名的 XML 文件或将项目数据发送到显示终端(stdout)以供查看。导出文件包含单个项目或项目快照的项目配置数据。

语法

bfexport

bfexport [-l]
bfexport [-l] <project_name>
bfexport [-c "<comment>"] [-f <file_name>] [-g] [-s] [-C] [-L ] [-n ] 
<project_name> | <project_name> <snapshot_name> | <project_id>

用法

要完成常见的项目导出任务,需要使用以下命令选项:
  • 要显示命令语法,请使用不带任何选项的 bfexport。
  • 要列出 Build Forge 数据库中存储的项目名称和项目标识,请使用 bfexport -l。

    在命令输出中快照名称会追加到项目名称后面:<project_ID>: <project_name> – <snapshot_name>

  • 要将项目数据发送到 XML 文件,请使用 bfexport -f <file_name>。 必须指定 -f <file_name> 选项以生成可用于导入项目数据的文件。
  • 在 z/Linux 平台上,您必须将该命令作为 bfexport.pl 运行。在所有其他平台上,该命令都不需要扩展名。

先决条件和限制

在 Build Forge 安装目录中查找 bfexport 实用程序。

服务器授权密码未包含在导出文件中;导入后,您必须在 UI 中手动输入服务器授权密码。

此 bfexport 命令必须能够找到 buildforge.conf 文件并访问 Build Forge 数据库。从 buildforge.conf 所在的目录运行 bfexport,即 <bfinstall>(在 Windows 上)和 <bfinstall>/Platform(在 UNIX 和 Linux 上)。

示例

要将输出写入文件,请使用 -f <file_name> 选项。在下面的示例中,helloworld 为输出文件名称,并使用项目标识代替项目名称。

bfexport -c "Saving a copy of project before making changes" 
 -f helloworld 675B57CC-8366-11DD-B2E0-043C04E44E1A

要只导出缺省项目快照,请使用 <project_name>。

bfexport -f helloworld test_project

要导出项目的一个快照,请使用 <project_name> <snapshot_name>。

bfexport -f helloworld test_project snapshot_1

如果父项目快照不是缺省项目,那么必须指定后跟父关键字的 <project_name> 以导出父项目快照。

bfexport -f helloworld test_project parent

选项描述

选项 描述
<project_name> 要导出的项目的名称。项目名称或项目标识是必需的。如果项目名称包含空格,必须为名称加引号。

在命令选项后指定项目名称。

<snapshot_name> 要导出的项目快照的名称;项目名称是必需的,如下面的语法中所示:
<project_name> <snapshot_name>

在命令选项后指定项目名称和快照名称。如果项目名称或快照名称包含空格,必须为名称加引号。

<project_id> 要导出的项目的标识。项目标识是一个 UUID。项目标识或项目名称是必需的。

在命令选项后指定项目标识。

-f <file_name> bfexport 输出的 XML 文件名。如果没有提供路径名,将使用当前工作目录。 如果文件名包含空格,必须为名称加引号。

如果您没有提供文件名,会将 bfexport 输出发送到 stdout。

注: stdout 仅用于查看。请勿将 stdout 重定向至文件;结果文件包含日志记录消息,且不能用作 bfimport 命令或 UI 导入实用程序的导入文件。
parent 必需的关键字,用于在父级不是缺省项目快照时导出父级项目快照。

在项目快照名称后指定父级关键字:

bfexport -f helloworld test_project parent
-l 按名称和项目标识列出数据库中的项目。不能将 -l 选项与其他选项一起使用。
-c "<comment>" 包含一段注释。必须为注释加上引号(例如,"my project version 50")。注释将添加到 <buildforge> XML 元素。
-g 将指定要接收通知的访问组的成员用户保存到 XML 文件。用户及其属性列于 <user> XML 元素中。需要 -s。
-s 将管理控制台中定义的服务器保存到 XML 文件。服务器及其属性列于 <server> XML 元素中,而且还包含所有关联的 <auth> 和 <collector> 信息。
-L 将 UI 中定义的 LDAP 域控制器保存到 XML 文件。LDAP 域控制器及其属性列于 <ldap> XML 元素中。
-n 将为项目及步骤指定的通知模板保存到 XML 文件。通知模板及其属性列于 <mail-template> XML 元素中。
-C 将为项目服务器指定的收集器保存到 XML 文件。收集器及其属性列于 <collector> XML 元素中。需要 -s。

故障诊断

如果您遇到有关无法找到报告文件或库的错误,请确保库路径设置正确。

正确的设置在 <bfinstall>/rc/buildforge 中。 检查在该文件中设置的库路径变量和其他变量。 根据需要重置,然后将其导出。


反馈