Gérer les projets d'analyse

Utilisez bobctl understand cli pour gérer les projets d'analyse Z Understand et copier des fichiers sources dans la charge de travail.

La commande bobctl understand cli fournit une interface en ligne de commande pour gérer les projets d'analyse. Elle exécute des commandes directement dans le pod Z Understand depuis votre environnement local.

./bobctl understand cli
FlagDescription
-aLance une session shell bash interactive dans le pod Z Understand.
<args>Arguments transmis directement au script cli-tunnel.sh s'exécutant dans le pod Z Understand.

Exemples courants :

./bobctl understand cli --list-projects               # lister les projets
./bobctl understand cli -b MyProject                  # compiler un projet
./bobctl understand cli -c COBOL.ini MyProject        # créer un projet à partir d'un fichier d'initialisation
./bobctl understand cli -si -api-key <key> MyProject  # générer un index sémantique
./bobctl understand cli -doc -api-key <key> MyProject # générer la documentation
./bobctl understand cli -a                            # ouvrir un shell interactif

Créer un projet à partir d'un fichier ini

L'indicateur -c nécessite que le fichier .ini soit déjà présent dans le répertoire de projet du pod. Un exemple de fichier .ini est fourni dans le sous-répertoire samples.

Ouvrez un shell interactif dans le pod Z Understand :

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

Copiez l'exemple de fichier .ini dans le répertoire du projet :

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"
Remarque :

Lorsque vous utilisez Db2 comme base de données de projet, le fichier .ini doit spécifier une valeur DBName unique. Chaque projet nécessite son propre DBName distinct. Si une valeur existante est réutilisée, la création du projet est bloquée. Ouvrez le fichier .ini copié et attribuez une valeur unique à DBName avant de continuer.

Remarque :

Pour les projets SQL Server, le paramètre DBName n'est pas requis dans le fichier .ini. Le nom du projet est automatiquement utilisé comme nom de base de données.

Quittez le shell interactif :

exit

Créez le projet en utilisant le fichier .ini :

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

Copier des fichiers sources dans un projet

Avant de compiler un projet, copiez les fichiers sources de l'application dans le répertoire de projet approprié. Chaque projet contient des sous-répertoires spécifiques aux sources, tels que :

  • Cobol
  • JCL
  • PL1
  • Assembler

Pour examiner la structure du projet et copier des fichiers sources :

Ouvrez un shell interactif dans le pod Z Understand :

./bobctl understand cli -a

Récupérez le nom du pod :

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

Copiez des fichiers individuels ou des répertoires avec oc cp :

oc cp \
  /chemin/local/vers/sources \
  <nom-pod>:/bobz-understand/projects/<nom-projet>/<sous-dossier>/ \
  -n <instance-namespace>

Vous pouvez également utiliser oc rsync pour des synchronisations répétées d'un répertoire :

oc rsync \
  /chemin/local/vers/sources/ \
  <nom-pod>:/bobz-understand/projects/<nom-projet>/<sous-dossier>/ \
  -n <instance-namespace>
Comment trouvez-vous ce sujet ?