开发插件时,可以在调试模式下启动 Automation Orchestrator 服务器,以调试遇到的问题。

前提条件

在本地计算机上安装并配置 Kubernetes 命令行工具。请参见安装并设置 kubectl

过程

  1. root 用户身份登录到 Automation Orchestrator Appliance 命令行。
  2. 运行 kubectl -n prelude edit deployment vco-app 命令。
  3. 编辑部署 YAML 文件,向 vco-server-app 容器中添加调试环境变量。该变量必须添加到 vco-server-app 容器的 env 部分下。
    containers:
          - command:
          ...
            env:
            - name: DEBUG_PORT
              value: "your_desired_debug_port"
          ...
    	name: vco-server-app
          ...
    注: 将调试环境变量添加到 env 部分时,必须采用 YAML 缩进格式,如上述示例所示。
  4. 保存对部署文件所做的更改。
    如果编辑部署文件成功,您将收到 deployment.extensions/vco-app edited 消息。
  5. 通过运行 vracli dev kubeconfig 命令生成 Kubernetes 配置文件。
    由于 kubeconfig 是开发人员环境,因此系统会提示您确认是否继续。输入 yes 继续;输入 no 停止。
  6. 复制所生成配置文件的内容,从 apiVersion: v1 直到 client-key-data 内容(并包括该内容)。
  7. 将生成的 Kubernetes 配置文件保存在本地计算机上。
  8. 注销 Automation Orchestrator Appliance
  9. 在本地计算机上完成调试模式的配置。
    1. 打开命令行 shell。
    2. KUBECONFIG 环境变量绑定到保存的配置文件。
      注: 此示例基于 Linux 环境。
      export KUBECONFIG=/file/path/fileName
    3. 要验证服务是否正在运行,请运行 kubectl cluster-info 命令。
    4. 要完成调试模式的配置,请执行以下 Kubernetes API 请求。
      注: localhost_debug_port 变量的值是在集成开发环境 (IDE) 的远程调试配置中设置的端口。 vro_debug_port 变量的值在此过程的步骤 3 中生成。
      kubectl port-forward pod/vco_app_pod_ID localhost_debug_port:vro_debug_port
    重要说明: 配置调试工具时,请提供在其中执行端口转发命令的本地计算机的 DNS 和 IP 设置。

结果

您已为 Automation Orchestrator Appliance 配置服务器调试。