使用 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>
在命令输出中快照名称会追加到项目名称后面:<project_ID>: <project_name> – <snapshot_name>
在 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_id> | 要导出的项目的标识。项目标识是一个 UUID。项目标识或项目名称是必需的。 在命令选项后指定项目标识。 |
-f <file_name> | bfexport 输出的 XML 文件名。如果没有提供路径名,将使用当前工作目录。
如果文件名包含空格,必须为名称加引号。 如果您没有提供文件名,会将 bfexport 输出发送到 stdout。 注: stdout 仅用于查看。请勿将 stdout 重定向至文件;结果文件包含日志记录消息,且不能用作 bfimport 命令或 UI 导入实用程序的导入文件。
|
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 中。 检查在该文件中设置的库路径变量和其他变量。 根据需要重置,然后将其导出。