Puede iniciar el servidor de vRealize Orchestrator en modo de depuración si desea depurar problemas cuando está desarrollando un complemento.

Requisitos previos

Instale y configure la herramienta de línea de comandos Kubernetes en su máquina local. Consulte Instalar y configurar kubectl.

Procedimiento

  1. Inicie sesión en la línea de comandos de vRealize Orchestrator Appliance como raíz.
  2. Ejecute el comando kubectl -n prelude edit deployment vco-app.
  3. Para editar el archivo YAML de la implementación, agregue una variable de entorno al contenedor de vco-server-app. La variable debe agregarse en la sección env del contenedor de vco-server-app.
    containers:
          - command:
          ...
            env:
            - name: DEBUG_PORT
              value: "your_desired_debug_port"
          ...
    	name: vco-server-app
          ...
    Nota: Al agregar la variable de entorno de depuración a la sección env, debe seguir el formato de sangría de YAML que se muestra en el ejemplo anterior.
  4. Guarde los cambios en el archivo de implementación.
    Si la edición en el archivo de implementación es correcta, recibirá el mensaje deployment.extensions/vco-app editado.
  5. Para generar el archivo de configuración de Kubernetes ejecute el comando vracli dev kubeconfig.
    Dado que kubeconfig es un entorno de desarrollador, se le pedirá que confirme que desea continuar. Introduzca para continuar o no para detener.
  6. Copie el contenido del archivo de configuración generado a partir de apiVersion: v1 incluyendo el contenido de client-key-data.
  7. Guarde el archivo de configuración de Kubernetes generado en su máquina local.
  8. Cierre sesión en vRealize Orchestrator Appliance.
  9. Termine de configurar el modo de depuración en su máquina local.
    1. Abra un shell de la línea de comandos.
    2. Enlace la variable de entorno KUBECONFIG con el archivo de configuración guardado.
      Nota: Este ejemplo se basa en un entorno de Linux.
      export KUBECONFIG=/file/path/fileName
    3. Para validar que los procesos se están ejecutando, ejecute el comando kubectl cluster-info.
    4. Para finalizar la configuración del modo de depuración, realice la siguiente solicitud de la API de Kubernetes.
      Nota: El valor de la variable localhost_debug_port es el puerto establecido en la configuración de depuración remota del entorno de desarrollo integrado (Integrated Development Environment, IDE). El valor de la variable vro_debug_port se genera durante el paso 3 de este procedimiento.
      kubectl port-forward pod/vco_app_pod_ID localhost_debug_port:vro_debug_port
    Importante: Al configurar la herramienta de depuración, proporcione la configuración de IP y DNS de la máquina local en la que ejecutó el comando de reenvío del puerto.

Resultados

Ha configurado la depuración del servidor de vRealize Orchestrator Appliance.