Интеграция гибридного агента

Краткий обзор

Подключите рабочее пространство Altium 365 к локальной PLM-системе, не предоставляя к ней доступ из интернета и не открывая порты для входящего трафика. В этой статье объясняется, как Hybrid Agent передает информацию через исходящие HTTPS-соединения, и рассматриваются требования, установка и настройка, включая запуск агента в качестве службы Windows. Читайте дальше, чтобы сделать следующий шаг к настройке гибридной интеграции с PLM-системой.

- Ознакомьтесь с требованиями к лицензированию, Java и сети для Hybrid Agent.
- Узнайте, как создать API-ключ, запустить агент и настроить подключение к PLM-системе в рабочем пространстве.
- Получите рекомендации по запуску агента в качестве службы Windows и его настройке для использования нового API-ключа.
Узнайте больше с ИИ:

Гибридная интеграция применяется, когда компания, использующая Altium 365, хочет интегрировать свое рабочее пространство с PLM-системой, развернутой локально во внутренней сети компании и не имеющей общедоступного IP-адреса, то есть недоступной из интернета.

Для этого во внутренней сети компании запускается небольшая программа под названием Hybrid Agent. Эта программа взаимодействует с Altium 365, передавая данные между рабочим пространством Altium 365 и PLM-системой внутри закрытой сети. Связь с Hybrid Agent осуществляется по протоколу HTTPS, при этом открывать сетевые порты для входящего трафика из интернета не требуется. Стандартный порт HTTPS 443 необходим только для исходящего трафика.

Note:

Настройка гибридной интеграции

Скачайте архив агента () и распакуйте его содержимое в удобную папку. Архив содержит Java-приложение (hybrid-agent.jar), которое необходимо запустить на компьютере во внутренней сети компании, имеющем доступ к локальной PLM-системе и Altium 365.

Этот компьютер not обязательно должен быть доступен из интернета, но должен иметь возможность подключения к среде Altium 365, используемой вашей компанией.

  • Обратите внимание, что Hybrid Agent not обязательно запускать на компьютере, на котором размещена PLM-система, хотя такая конфигурация не должна вызывать проблем.
  • Приложение Hybrid Agent включает эквивалентные файлы сценариев оболочки (например, agent.sh) для систем на базе Linux — используйте их вместо файлов Windows *.bat в приведенных ниже инструкциях по настройке агента.

Для Hybrid Agent версии 5 и более ранних версий требуется Java Development Kit (JDK) версии 11 или более поздней. Начиная с версии 6 (выпущенной 6 июля 2026 года), для Hybrid Agent требуется JDK версии 17 или более поздней.

Рабочие пространства Altium 365 поддерживают Hybrid Agent версий 5 и 6. Поэтому, если у вас уже установлен Hybrid Agent версии 5, обновлять его до версии 6 необязательно.

После размещения приложения Hybrid Agent:

  1. Создайте ключ API на странице Hybrid Agent рабочего пространства Altium 365 ().
  2. Создайте переменную среды HYBRID_AGENT_API_KEY, указав ключ API в качестве ее значения.
  3. Запустите agent.bat с помощью приведенной ниже команды, указав в качестве аргумента параметра URL адрес вашего рабочего пространства Altium 365:
    agent.bat https://acme.365.altium.com

Во время работы Hybrid Agent создает файл журнала в папке hybrid-agent\logs приложения.

Обратите внимание, что в каждый момент времени у рабочего пространства может быть только один действующий ключ API и может работать только один экземпляр Hybrid Agent. Агент поддерживает несколько конфигураций PLM, если обе PLM-системы размещены в одной и той же закрытой сети.

В рабочей среде настоятельно рекомендуется запускать Hybrid Agent как службу Windows, а не непосредственно в терминале, хотя последний вариант можно использовать для тестирования.

Пример запуска Hybrid Agent в качестве службы Windows с помощью диспетчера служб NSSM:

  1. Выполните команду: nssm install HybridAgent.
  2. В диалоговом окне NSSM (на вкладке Application) введите путь к файлу agent.bat в поле Path и URL-адрес вашего рабочего пространства в поле Arguments, затем нажмите Install service.
    1. Поведение службы при запуске можно настроить с помощью параметра Startup type на вкладке Details диалогового окна NSSM. При необходимости выполните nssm edit HybridAgent, чтобы внести такие изменения.
    2. Вместо создания стандартных переменных среды PATH и JAVA_HOME для Java их можно добавить на вкладке Environment NSSM. В этом случае переменные будут действовать только во время работы службы HybridAgent.
    3. Аналогично, переменную HYBRID_AGENT_API_KEY также можно перенести в настройки среды NSSM, чтобы она действовала во время работы службы.

  3. Запустите службу HybridAgent с помощью средства управления Windows Services или команды NSSM: nssm start HybridAgent. Это не требуется после перезагрузки компьютера, если для службы настроен автоматический запуск.
  4. Убедитесь, что служба HybridAgent запущена, с помощью средства управления Windows Services или команды NSSM: nssm status HybridAgent.

После подключения Hybrid Agent к вашему рабочему пространству Altium 365 (обновите окно браузера, чтобы проверить его состояние) можно перейти к настройке интеграции с PLM в рабочем пространстве Altium 365. На странице Add Configuration включите параметр подключения Hybrid Agent и введите в поле URL URL-адрес вашей локальной PLM-системы, по которому она доступна внутри закрытой сети.

 

Текущий ключ API можно отозвать с помощью соответствующей команды Revoke. В этом случае необходимо создать новый ключ API и обновить значение переменной среды HYBRID_AGENT_API_KEY, указав новый ключ.

Перезапустите Hybrid Agent, чтобы использовать новый ключ: в NSSM выполните команду nssm restart HybridAgent либо остановите и снова запустите службу HybridAgent в средстве Windows Services.

AI-LocalizedЛокализовано с помощью ИИ
Если вы обнаружили проблему, выделите текст/изображение и нажмитеCtrl + Enter, чтобы отправить нам свой отзыв.
Меню
Contents
Доступность функций

Доступные вам функции зависят от того, какое решение Altium вы используете: Altium Develop, Altium Agile Teams, Altium Agile Enterprise или Altium Designer (при активной подписке).

Если вы не видите описанную функцию в используемом вами программном обеспечении, свяжитесь с отделом продаж Altium, чтобы узнать больше.