Diagnostica problemas comuns do Z Understand and Refactor e remove permanentemente a carga de trabalho quando necessário.

Resolução de problemas

O pod do Z Understand não está em execução

Verifica o estado do pod:

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

Revê os logs do pod:

oc logs -n <instance-namespace> \
  -l app=ibm-bobz-understand

Verifica o estado do recurso personalizado:

oc get bob <cr-name> \
  -n <instance-namespace> \
  -o jsonpath='{.status.understand.status}'

O estado permanece em `ReconcileError`

O operador repete automaticamente o processo de reconciliação e o bobctl continua a consultar atualizações de estado. Se o estado persistir, monitoriza os logs do operador:

oc logs \
  -n <operator-namespace> \
  deploy/ibm-bob-operator -f

Falha na criação do secret ou na atualização do recurso personalizado

Verifica que as permissões necessárias estão configuradas corretamente e que o cluster está acessível:

oc auth can-i create secret -n <instance-namespace>

oc get bob -n <instance-namespace>

oc get pods -n <operator-namespace> \
  -l app=ibm-bob-operator

Desinstalação

Usa o procedimento de desinstalação apenas quando pretenderes remover permanentemente o Z Understand and Refactor.

Aviso:

A desinstalação remove todos os dados e configurações da carga de trabalho. Esta ação não pode ser desfeita.

Desativar a carga de trabalho retém todos os dados e configurações existentes. Em contraste, o comando uninstall remove permanentemente todos os volumes persistentes, permitindo que a carga de trabalho seja reinstalada a partir de um estado limpo.

Desativa a carga de trabalho atualizando config.yaml:

bob:
  understand:
    enabled: false

Aplica a alteração:

./bobctl upgrade

Executa o comando de desinstalação:

./bobctl understand uninstall

Flag	Descrição
`--yes`	Ignora o pedido de confirmação. Adequado para implementações com scripts ou automatizadas.
`--no-wait`	Atualiza o CR e sai imediatamente sem aguardar que o operador termine.
`--dry-run`	Apresenta as ações que seriam realizadas sem aplicar quaisquer alterações.

Reinstalação

Após a conclusão do processo de desinstalação, podes instalar novamente a carga de trabalho Z Understand and Refactor como uma nova implementação.

Ativa a carga de trabalho em config.yaml:

bob:
  understand:
    enabled: true

Aplica a configuração:

./bobctl upgrade

Executa novamente a configuração:

./bobctl understand setup --config setup.json

Resolução de problemas e desinstalação