bobctl understand cliを使用してZ Understand分析プロジェクトを管理し、ソースファイルをワークロードにコピーします。

bobctl understand cli コマンドは、分析プロジェクトを管理するためのコマンドラインインターフェースを提供します。ローカル環境から直接Z Understand Pod内でコマンドを実行します。

./bobctl understand cli

フラグ	説明
`-a`	Z Understand Pod内でインタラクティブな `bash` シェルセッションを起動します。
`<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                            # インタラクティブシェルを開く

ini ファイルからのプロジェクト作成

-c フラグを使用するには、.ini ファイルが Pod のプロジェクトディレクトリにあらかじめ存在している必要があります。サンプルの .ini ファイルは samples サブディレクトリに用意されています。

Z Understand Pod 内でインタラクティブシェルを開きます。

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 パラメーターは必要ありません。プロジェクト名が自動的にデータベース名として使用されます。

インタラクティブシェルを終了します。

exit

.ini ファイルを使用してプロジェクトを作成します。

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

プロジェクトへのソースファイルのコピー

プロジェクトをビルドする前に、適切なプロジェクトディレクトリにアプリケーションソースファイルをコピーします。各プロジェクトにはソース固有のサブディレクトリが含まれています：

Cobol

JCL

PL1

Assembler

プロジェクト構造を確認してソースファイルをコピーするには：

Z Understand Podでインタラクティブなシェルを開きます：

./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 ファイルからのプロジェクト作成

プロジェクトへのソースファイルのコピー

このページ