Você pode iniciar o servidor do vRealize Orchestrator no modo de depuração para depurar problemas ao desenvolver um plug-in.

Pré-requisitos

Instale e configure a ferramenta de linha de comando Kubernetes em sua máquina local. Consulte Instalar e configurar kubectl.

Procedimento

  1. Faça login na linha de comando do vRealize Orchestrator Appliance como raiz.
  2. Execute o comando kubectl -n prelude edit deployment vco-app.
  3. Edite o arquivo YAML de implantação adicionando uma variável de ambiente de depuração ao contêiner vco-server-app. A variável deve ser adicionada na seção env do contêiner vco-server-app. 
    containers:
      - command:
      ...
        env:
        - name: DEBUG_PORT
          value: "your_desired_debug_port"
      ...
	name: vco-server-app
      ...
    Observação: Ao adicionar a variável de ambiente de depuração à seção env, você deve seguir a formatação de recuo YAML conforme apresentado no exemplo anterior.
  4. Salve as alterações no arquivo de implantação.
    Se a edição para o arquivo de implantação for bem-sucedida, você receberá a mensagem deployment.extensions/vco-app edited.
  5. Gere o arquivo de configuração Kubernetes executando o comando vracli dev kubeconfig.
    Como o kubeconfig é um ambiente de desenvolvedor, você será solicitado a confirmar que deseja continuar. Insira yes para continuar ou no para parar.
  6. Copie o conteúdo do arquivo de configuração gerado do apiVersion: v1 até e incluindo o conteúdo client-key-data.
  7. Salve o arquivo de configuração Kubernetes gerado na sua máquina local.
  8. Faça logoff do vRealize Orchestrator Appliance.
  9. Conclua a configuração do modo de depuração na sua máquina local.
    1. Abra um shell de linha de comando.
    2. Vincule a variável de ambiente KUBECONFIG ao arquivo de configuração salvo.
      Observação: Este exemplo se baseia em um ambiente Linux. 
      export KUBECONFIG=/file/path/fileName
    3. Para validar que os serviços estão em execução, execute o comando kubectl cluster-info.
    4. Para concluir a configuração do modo de depuração, execute a seguinte solicitação de API do Kubernetes.
      Observação: O valor da variável localhost_debug_port é o conjunto de portas na sua configuração de depuração remota do seu Ambiente de Desenvolvimento Integrado (IDE). O valor da variável vro_debug_port é gerado durante a etapa 3 deste procedimento. 
      kubectl port-forward pod/vco_app_pod_ID localhost_debug_port:vro_debug_port
    Importante: Ao configurar sua ferramenta de depuração, forneça as configurações de DNS e IP da máquina local na qual você executou o comando de encaminhamento de porta.

Resultados

Você configurou a depuração de servidor para a sua vRealize Orchestrator Appliance.