Analyseprojekte verwalten
bobctl understand cli verwenden, um Z-Understand-Analyseprojekte zu verwalten und Quelldateien in den Workload zu kopieren.
Der Befehl bobctl understand cli stellt eine Kommandozeilenschnittstelle zur Verwaltung von Analyseprojekten bereit. Er führt Befehle direkt aus deiner lokalen Umgebung im Z-Understand-Pod aus.
./bobctl understand cli| Flag | Beschreibung |
|---|---|
-a | Startet eine interaktive bash-Shell-Sitzung im Z-Understand-Pod. |
<args> | Argumente, die direkt an das cli-tunnel.sh-Skript im Z-Understand-Pod weitergegeben werden. |
Häufige Beispiele:
./bobctl understand cli --list-projects # Projekte auflisten
./bobctl understand cli -b MyProject # Projekt erstellen
./bobctl understand cli -c COBOL.ini MyProject # Projekt aus einer Initialisierungsdatei erstellen
./bobctl understand cli -si -api-key <key> MyProject # Semantischen Index generieren
./bobctl understand cli -doc -api-key <key> MyProject # Dokumentation generieren
./bobctl understand cli -a # Interaktive Shell öffnenProjekt aus einer ini-Datei erstellen
Das Flag -c setzt voraus, dass die .ini-Datei bereits im Projektverzeichnis des Pods vorhanden ist. Ein Beispiel für eine .ini-Datei befindet sich im Unterverzeichnis samples.
Öffne eine interaktive Shell im Z-Understand-Pod:
oc exec -it <pod-name> -n <instance-namespace> -- bashKopiere die Beispiel-.ini-Datei in das Projektverzeichnis:
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"Bei der Verwendung von Db2 als Projektdatenbank muss die .ini-Datei einen eindeutigen DBName-Wert angeben. Jedes Projekt benötigt seinen eigenen eindeutigen DBName. Wenn ein vorhandener Wert wiederverwendet wird, wird die Projekterstellung blockiert. Öffne die kopierte .ini-Datei und weise DBName einen eindeutigen Wert zu, bevor du fortfährst.
Bei SQL-Server-Projekten ist der Parameter DBName in der .ini-Datei nicht erforderlich. Der Projektname wird automatisch als Datenbankname verwendet.
Beende die interaktive Shell:
exitErstelle das Projekt mithilfe der .ini-Datei:
./bobctl understand project create -c <path-to-ini>Quelldateien in ein Projekt kopieren
Bevor du ein Projekt erstellst, kopiere die Anwendungsquelldateien in das entsprechende Projektverzeichnis. Jedes Projekt enthält quelldatei-spezifische Unterverzeichnisse, wie z. B.:
CobolJCLPL1Assembler
So überprüfst du die Projektstruktur und kopierst Quelldateien:
Öffne eine interaktive Shell im Z-Understand-Pod:
./bobctl understand cli -aPod-Namen abrufen:
oc get pods \
-n <instance-namespace> \
-l app=ibm-bobz-understand \
-o nameKopiere einzelne Dateien oder Verzeichnisse mit oc cp:
oc cp \
/local/path/to/sources \
<pod-name>:/bobz-understand/projects/<project-name>/<subfolder>/ \
-n <instance-namespace>Alternativ verwende oc rsync für wiederholte Synchronisierungen eines Verzeichnisses:
oc rsync \
/local/path/to/sources/ \
<pod-name>:/bobz-understand/projects/<project-name>/<subfolder>/ \
-n <instance-namespace>