Gerir projetos de análise

Usa bobctl understand cli para gerir projetos de análise do Z Understand e copiar ficheiros de código-fonte para a carga de trabalho.

O comando bobctl understand cli fornece uma interface de linha de comandos para gerir projetos de análise. Executa comandos dentro do pod do Z Understand diretamente a partir do teu ambiente local.

./bobctl understand cli
FlagDescrição
-aInicia uma sessão interativa bash dentro do pod do Z Understand.
<args>Argumentos passados diretamente ao script cli-tunnel.sh em execução dentro do pod do Z Understand.

Exemplos comuns:

./bobctl understand cli --list-projects               # listar projetos
./bobctl understand cli -b MyProject                  # compilar um projeto
./bobctl understand cli -c COBOL.ini MyProject        # criar um projeto a partir de um ficheiro de inicialização
./bobctl understand cli -si -api-key <key> MyProject  # gerar um índice semântico
./bobctl understand cli -doc -api-key <key> MyProject # gerar documentação
./bobctl understand cli -a                            # abrir uma shell interativa

Criar um projeto a partir de um ficheiro ini

A flag -c requer que o ficheiro .ini já esteja presente no diretório de projetos do pod. Um ficheiro .ini de amostra é fornecido no subdiretório samples.

Abre uma shell interativa dentro do pod do Z Understand:

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

Copia o ficheiro .ini de amostra para o diretório de projetos:

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

Ao usar o Db2 como base de dados do projeto, o ficheiro .ini deve especificar um valor único para DBName. Cada projeto requer o seu próprio DBName distinto. Se um valor existente for reutilizado, a criação do projeto é bloqueada. Abre o ficheiro .ini copiado e atribui um valor único a DBName antes de continuar.

Nota:

Para projetos SQL Server, o parâmetro DBName não é obrigatório no ficheiro .ini. O nome do projeto é usado automaticamente como nome da base de dados.

Sai da shell interativa:

exit

Cria o projeto usando o ficheiro .ini:

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

Copiar ficheiros de código-fonte para um projeto

Antes de compilar um projeto, copia os ficheiros de código-fonte da aplicação para o diretório de projeto adequado. Cada projeto contém subdiretórios específicos por tipo de código-fonte, tais como:

  • Cobol
  • JCL
  • PL1
  • Assembler

Para rever a estrutura do projeto e copiar ficheiros de código-fonte:

Abre uma shell interativa no pod do Z Understand:

./bobctl understand cli -a

Obtém o nome do pod:

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

Copia ficheiros individuais ou diretórios usando oc cp:

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

Em alternativa, usa oc rsync para sincronizações repetidas de um diretório:

oc rsync \
  /local/path/to/sources/ \
  <pod-name>:/bobz-understand/projects/<project-name>/<subfolder>/ \
  -n <instance-namespace>
Como está este tópico?