Diagnostica problemas comunes de Z Understand and Refactor y elimina la carga de trabajo de forma permanente cuando sea necesario.

Solución de problemas

El pod de Z Understand no está en ejecución

Comprueba el estado del pod:

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

Revisa los logs del pod:

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

Comprueba el estado del recurso personalizado:

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

El estado permanece en `ReconcileError`

El operador reintenta automáticamente el proceso de reconciliación y bobctl continúa consultando el estado. Si el estado persiste, monitorea los logs del operador:

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

Fallo al crear el secreto o al actualizar el recurso personalizado

Verifica que los permisos requeridos están configurados correctamente y que el clúster es accesible:

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

Desinstalación

Usa el procedimiento de desinstalación solo cuando quieras eliminar Z Understand and Refactor de forma permanente.

Advertencia:

La desinstalación elimina todos los datos y la configuración de la carga de trabajo. Esta acción no se puede deshacer.

Deshabilitar la carga de trabajo conserva todos los datos y la configuración existentes. En cambio, el comando uninstall elimina de forma permanente todos los volúmenes persistentes, lo que permite reinstalar la carga de trabajo desde un estado limpio.

Deshabilita la carga de trabajo actualizando config.yaml:

bob:
  understand:
    enabled: false

Aplica el cambio:

./bobctl upgrade

Ejecuta el comando de desinstalación:

./bobctl understand uninstall

Flag	Descripción
`--yes`	Omite el prompt de confirmación. Adecuado para despliegues automatizados o scripted.
`--no-wait`	Actualiza el CR y sale inmediatamente sin esperar a que el operador termine.
`--dry-run`	Muestra las acciones que se realizarían sin aplicar ningún cambio.

Reinstalación

Una vez completado el proceso de desinstalación, puedes instalar de nuevo la carga de trabajo Z Understand and Refactor como un nuevo despliegue.

Habilita la carga de trabajo en config.yaml:

bob:
  understand:
    enabled: true

Aplica la configuración:

./bobctl upgrade

Ejecuta la configuración de nuevo:

./bobctl understand setup --config setup.json

Solución de problemas y desinstalación