使用 bobctl understand cli 管理 Z Understand 分析项目并将源文件复制到工作负载中。

bobctl understand cli 命令提供了一个命令行界面，用于管理分析项目。它可直接从本地环境在 Z Understand Pod 内运行命令。

./bobctl understand cli

标志	描述
`-a`	在 Z Understand Pod 内启动交互式 `bash` shell 会话。
`<args>`	直接传递给 Z Understand Pod 内运行的 `cli-tunnel.sh` 脚本的参数。

常见示例：

./bobctl understand cli --list-projects               # 列出项目
./bobctl understand cli -b MyProject                  # 构建项目
./bobctl understand cli -c COBOL.ini MyProject        # 从初始化文件创建项目
./bobctl understand cli -si -api-key <key> MyProject  # 生成语义索引
./bobctl understand cli -doc -api-key <key> MyProject # 生成文档
./bobctl understand cli -a                            # 打开交互式 shell

从 ini 文件创建项目

-c 标志要求 .ini 文件已存在于 Pod 的项目目录中。samples 子目录中提供了一个示例 .ini 文件。

在 Z Understand Pod 内打开交互式 shell：

oc exec -it <pod-name> -n <instance-namespace> -- bash

将示例 .ini 文件复制到项目目录：

cp "/bobz-understand/storage/IBM Application Discovery Build Client CLI/config/projects/samples/new_proj_db2.ini" \
   "/bobz-understand/IBM Application Discovery Build Client CLI/config/projects/new_proj_db2.ini"

注意：

当使用 Db2 作为项目数据库时，.ini 文件必须指定唯一的 DBName 值。每个项目都需要自己唯一的 DBName。如果重复使用现有值，则会阻止项目创建。在继续之前，打开复制的 .ini 文件并为 DBName 分配一个唯一的值。

注意：

对于 SQL Server 项目，.ini 文件中不需要 DBName 参数。项目名称将自动用作数据库名称。

退出交互式 shell：

exit

使用 .ini 文件创建项目：

./bobctl understand project create -c <path-to-ini>

将源文件复制到项目中

在构建项目之前，请将应用源文件复制到相应的项目目录中。每个项目包含特定于源代码的子目录，例如：

Cobol

JCL

PL1

Assembler

查看项目结构并复制源文件：

在 Z Understand Pod 中打开交互式 shell：

./bobctl understand cli -a

获取 Pod 名称：

oc get pods \
  -n <instance-namespace> \
  -l app=ibm-bobz-understand \
  -o name

使用 oc cp 复制单个文件或目录：

oc cp \
  /local/path/to/sources \
  <pod-name>:/bobz-understand/projects/<project-name>/<subfolder>/ \
  -n <instance-namespace>

或者，使用 oc rsync 对目录进行重复同步：

oc rsync \
  /local/path/to/sources/ \
  <pod-name>:/bobz-understand/projects/<project-name>/<subfolder>/ \
  -n <instance-namespace>

管理分析项目

从 ini 文件创建项目

将源文件复制到项目中

本页内容