Sie können den vRealize Orchestrator-Server im Debug-Modus starten, um Probleme beim Entwickeln eines Plug-Ins zu debuggen.

Voraussetzungen

Installieren und konfigurieren Sie das Kubernetes-Befehlszeilentool auf Ihrem lokalen Computer. Weitere Informationen finden Sie unter Installieren und Einrichten von kubectl.

Prozedur

  1. Melden Sie sich bei der Befehlszeile der vRealize Orchestrator Appliance als root an.
  2. Führen Sie den Befehl kubectl -n prelude edit deployment vco-app aus.
  3. Bearbeiten Sie die YAML-Bereitstellungsdatei, indem Sie eine Debug-Umgebungsvariable für den Container vco-server-app hinzufügen. Die Variable muss im Abschnitt env des vco-server-app-Containers hinzugefügt werden. 
    containers:
      - command:
      ...
        env:
        - name: DEBUG_PORT
          value: "your_desired_debug_port"
      ...
	name: vco-server-app
      ...
    Hinweis: Wenn Sie die Debug-Umgebungsvariable zum Abschnitt env hinzufügen, müssen Sie die im vorherigen Beispiel dargestellte YAML-Einrückungsformatierung befolgen.
  4. Speichern Sie die Änderungen an der Bereitstellungsdatei.
    Wenn die Bearbeitung der Bereitstellungsdatei erfolgreich war, erhalten Sie die Meldung deployment.extensions/vco-app edited.
  5. Generieren Sie die Kubernetes-Konfigurationsdatei, indem Sie den Befehl vracli dev kubeconfig ausführen.
    Da kubeconfig eine Entwicklerumgebung ist, werden Sie aufgefordert zu bestätigen, dass Sie fortfahren möchten. Geben Sie ja ein, um fortzufahren, oder nein, um zu beenden.
  6. Kopieren Sie den Inhalt der generierten Konfigurationsdatei von apiVersion: v1 bis einschließlich des Inhalts client-key-data.
  7. Speichern Sie die generierte Kubernetes-Konfigurationsdatei auf Ihrem lokalen Computer.
  8. Melden Sie sich von der vRealize Orchestrator Appliance ab.
  9. Beenden Sie die Konfiguration des Debug-Modus auf Ihrem lokalen Computer.
    1. Öffnen Sie eine Befehlszeilen-Shell.
    2. Binden Sie die KUBECONFIG-Umgebungsvariable an die gespeicherte Konfigurationsdatei.
      Hinweis: Dieses Beispiel basiert auf einer Linux-Umgebung. 
      export KUBECONFIG=/file/path/fileName
    3. Führen Sie den Befehl kubectl cluster-info aus, um zu überprüfen, ob die Dienste ausgeführt werden.
    4. Um die Konfiguration des Debug-Modus abzuschließen, führen Sie die folgende Kubernetes-API-Anforderung aus.
      Hinweis: Der Wert der localhost_debug_port-Variablen ist der Port, der in Ihrer Remote-Debugging-Konfiguration Ihrer Integrated Development Environment (IDE) festgelegt ist. Der Wert der vro_debug_port-Variablen wird in Schritt 3 dieses Verfahrens generiert. 
      kubectl port-forward pod/vco_app_pod_ID localhost_debug_port:vro_debug_port
    Wichtig: Geben Sie beim Konfigurieren des Debugging-Tools die DNS- und IP-Einstellungen der lokalen Maschine an, auf der Sie den Befehl für die Portweiterleitung ausgeführt haben.

Ergebnisse

Sie haben das Server-Debugging für Ihre vRealize Orchestrator Appliance konfiguriert.