Vous pouvez démarrer le serveur vRealize Orchestrator en mode débogage pour déboguer les problèmes lors du développement d'un plug-in.

Conditions préalables

Installez et configurez l'outil de ligne de commande Kubernetes sur votre machine locale. Reportez-vous à Installer et configurer kubectl.

Procédure

  1. Connectez-vous à la ligne de commande du dispositif vRealize Orchestrator Appliance en tant qu'utilisateur racine.
  2. Exécutez la commande kubectl -n prelude edit deployment vco-app.
  3. Modifiez le fichier de déploiement YAML en ajoutant une variable d'environnement de débogage au conteneur vco-server-app. La variable doit être ajoutée sous la section env du conteneur vco-server-app. 
    containers:
      - command:
      ...
        env:
        - name: DEBUG_PORT
          value: "your_desired_debug_port"
      ...
	name: vco-server-app
      ...
    Note : Lorsque vous ajoutez la variable d'environnement de débogage à la section env, vous devez suivre la mise en forme de la mise en retrait YAML comme présenté dans l'exemple précédent.
  4. Enregistrez les modifications dans le fichier de déploiement.
    Si la modification apportée au fichier de déploiement réussit, vous recevez le message deployment.extensions/vco-app edited.
  5. Générez le fichier de configuration Kubernetes, en exécutant la commande vracli dev kubeconfig.
    Comme kubeconfig est un environnement de développement, vous êtes invité à confirmer que vous souhaitez continuer. Entrez oui pour continuer ou non pour arrêter.
  6. Copiez le contenu du fichier de configuration généré depuis apiVersion: v1 jusqu'au contenu client-key-data.
  7. Enregistrez le fichier de configuration Kubernetes généré sur votre machine locale.
  8. Déconnectez-vous de vRealize Orchestrator Appliance.
  9. Terminez la configuration du mode de débogage sur votre machine locale.
    1. Ouvrez un shell de ligne de commande.
    2. Liez la variable d'environnement KUBECONFIG au fichier de configuration enregistré.
      Note : Cet exemple est basé sur un environnement Linux. 
      export KUBECONFIG=/file/path/fileName
    3. Pour vérifier si les services sont en cours d'exécution, exécutez la commande kubectl cluster-info.
    4. Pour terminer la configuration du mode de débogage, exécutez la demande d'API Kubernetes suivante.
      Note : La valeur de la variable localhost_debug_port est le port défini dans la configuration de débogage distant de votre environnement de développement intégré. La valeur de la variable vro_debug_port est générée au cours de l'étape 3 de cette procédure. 
      kubectl port-forward pod/vco_app_pod_ID localhost_debug_port:vro_debug_port
    Important : Lors de la configuration de votre outil de débogage, fournissez les paramètres DNS et IP de la machine locale sur laquelle vous avez effectué la commande de transfert de port.

Résultats

Vous avez configuré le débogage du serveur pour votre dispositif vRealize Orchestrator Appliance.