Для решения проблем, возникших при разработке подключаемого модуля, можно запустить сервер Automation Orchestrator в режиме отладки.

Необходимые условия

Установите и настройте средство командной строки Kubernetes на локальном компьютере. См. раздел Установка и настройка kubectl.

Процедура

  1. Войдите в командную строку Automation Orchestrator Appliance в качестве пользователя root.
  2. Выполните команду kubectl -n prelude edit deployment vco-app.
  3. Отредактируйте файл развертывания YAML, добавив переменную среды отладки в контейнер vco-server-app. Переменная должна быть добавлена в раздел env контейнера vco-server-app. 
    containers:
      - command:
      ...
        env:
        - name: DEBUG_PORT
          value: "your_desired_debug_port"
      ...
	name: vco-server-app
      ...
    Примечание: При добавлении переменной среды отладки в раздел env необходимо следовать форматированию отступов YAML, как показано в предыдущем примере.
  4. Сохраните изменения в файле развертывания.
    При успешном внесении изменений в файл развертывания появляется сообщение deployment.extensions/vco-app edited.
  5. Создайте файл конфигурации Kubernetes, запустив команду vracli dev kubeconfig.
    Так как kubeconfig является средой разработчика, появится запрос подтвердить дальнейшие действия. Введите yes (да) для продолжения или no (нет), чтобы прервать процедуру.
  6. Скопируйте содержимое созданного файла конфигурации, начиная со строки apiVersion: v1 и заканчивая строкой client-key-data включительно.
  7. Сохраните созданный файл конфигурации Kubernetes на локальном компьютере.
  8. Выйдите из Automation Orchestrator Appliance.
  9. Завершите настройку режима отладки на локальном компьютере.
    1. а. Откройте оболочку командной строки.
    2. б. Привяжите переменную среды KUBECONFIG к сохраненному файлу конфигурации.
      Примечание: В качестве примера используется среда Linux. 
      export KUBECONFIG=/file/path/fileName
    3. в. Чтобы проверить, запущены ли службы, выполните команду kubectl cluster-info.
    4. г. Чтобы завершить настройку режима отладки, выполните следующий запрос API-интерфейса Kubernetes.
      Примечание: Значение переменной порт_отладки_локального_узла — это порт, заданный в конфигурации удаленной отладки интегрированной среды разработки (IDE). Значение переменной порт_отладки_vro генерируется при выполнении шага 3 данной процедуры. 
      kubectl port-forward pod/vco_app_pod_ID localhost_debug_port:vro_debug_port
    Важно!: При настройке средства отладки укажите параметры DNS и IP-адреса для локального компьютера, на котором была выполнена команда переадресации портов.

Результаты

Отладка сервера для Automation Orchestrator Appliance настроена.