Integracja agenta hybrydowego

W skrócie

Połącz swoją przestrzeń roboczą Altium 365 z lokalnym systemem PLM bez udostępniania go w internecie ani otwierania portów dla ruchu przychodzącego. W tym artykule wyjaśniamy, jak Hybrid Agent przekazuje informacje za pośrednictwem wychodzących połączeń HTTPS, oraz omawiamy wymagania, instalację i konfigurację, w tym uruchamianie agenta jako usługi systemu Windows. Czytaj dalej, aby zrobić kolejny krok w kierunku skonfigurowania hybrydowej integracji z systemem PLM.

- Poznaj wymagania dotyczące licencji, środowiska Java i sieci dla Hybrid Agent.
- Dowiedz się, jak wygenerować klucz API, uruchomić agenta i skonfigurować połączenie z systemem PLM w swojej przestrzeni roboczej.
- Znajdź wskazówki dotyczące uruchamiania agenta jako usługi systemu Windows i aktualizowania jego konfiguracji w celu użycia nowego klucza API.
Zagłęb się w temat dzięki AI:

Integracja hybrydowa ma zastosowanie, gdy firma korzystająca z Altium 365 chce zintegrować swoją przestrzeń roboczą z systemem PLM hostowanym lokalnie, w sieci firmowej, który nie ma publicznego adresu IP — nie jest dostępny z internetu.

W tym celu wewnątrz sieci firmowej uruchamiany jest niewielki program o nazwie Hybrid Agent. Program ten komunikuje się z Altium 365, pośrednicząc w wymianie informacji między przestrzenią roboczą Altium 365 a systemem PLM w zamkniętej sieci. Komunikacja z Hybrid Agent odbywa się przez HTTPS i nie wymaga otwierania żadnych portów sieciowych dla ruchu przychodzącego z internetu. Standardowy port HTTPS 443 jest wymagany wyłącznie dla ruchu wychodzącego.

Note:

Konfiguracja integracji hybrydowej

Pobierz archiwum agenta () i rozpakuj jego zawartość do znanej lokalizacji. Zawiera ono aplikację Java (hybrid-agent.jar), którą należy uruchomić na komputerze w sieci firmowej, mającym dostęp do lokalnego systemu PLM i Altium 365.

Ten komputer nie musi not być publicznie dostępny z internetu, ale musi mieć możliwość łączenia się ze środowiskiem Altium 365 używanym przez firmę.

  • Pamiętaj, że Hybrid Agent nie musi not być uruchomiony na komputerze hostującym system PLM, choć taka konfiguracja nie powinna powodować problemów.
  • Aplikacja Hybrid Agent zawiera równoważne pliki skryptów powłoki (takie jak agent.sh) dla systemów opartych na Linuksie — użyj ich zamiast plików *.bat dla systemu Windows w poniższych instrukcjach konfiguracji agenta.

Hybrid Agent w wersji 5 i wcześniejszych wymaga Java Development Kit (JDK) w wersji 11 lub nowszej. Począwszy od wersji 6 (wydanej 6 lipca 2026 r.), Hybrid Agent wymaga JDK w wersji 17 lub nowszej.

Przestrzenie robocze Altium 365 obsługują Hybrid Agent zarówno w wersji 5, jak i 6. Jeśli więc masz już zainstalowany Hybrid Agent w wersji 5, aktualizacja do wersji 6 nie jest konieczna.

Gdy aplikacja Hybrid Agent jest już gotowa:

  1. Wygeneruj klucz API na stronie Hybrid Agent przestrzeni roboczej Altium 365 ().
  2. Utwórz zmienną środowiskową HYBRID_AGENT_API_KEY i przypisz jej klucz API jako wartość.
  3. Uruchom agent.bat, korzystając z poniższej składni polecenia, w której argument parametru URL powinien wskazywać Twoją przestrzeń roboczą Altium 365:
    agent.bat https://acme.365.altium.com

Podczas działania Hybrid Agent generuje plik dziennika w folderze hybrid-agent\logs aplikacji.

Pamiętaj, że w danej chwili przestrzeń robocza ma tylko jeden ważny klucz API i może działać tylko jedna instancja Hybrid Agent. Agent może obsługiwać więcej niż jedną instancję konfiguracji PLM, jeśli oba systemy PLM są hostowane w tej samej zamkniętej sieci.

W środowisku produkcyjnym zdecydowanie zaleca się uruchamianie Hybrid Agent jako usługi systemu Windows, a nie bezpośrednio w terminalu, choć ten drugi sposób można wykorzystać do testów.

Przykładowy sposób uruchamiania Hybrid Agent jako usługi systemu Windows przy użyciu menedżera usług NSSM:

  1. Uruchom polecenie: nssm install HybridAgent.
  2. W oknie dialogowym NSSM (na karcie Application) wprowadź ścieżkę do pliku agent.bat w polu Path i adres URL swojej przestrzeni roboczej w polu Arguments, a następnie kliknij Install service.
    1. Sposób uruchamiania usługi możesz ustawić za pomocą opcji Startup type na karcie Details okna dialogowego NSSM. W razie potrzeby uruchom nssm edit HybridAgent, aby wprowadzić takie zmiany.
    2. Zamiast tworzyć standardowe zmienne środowiskowe PATH i JAVA_HOME dla Java, można dodać je na karcie Environment w NSSM. W takim przypadku zmienne będą aktywne tylko wtedy, gdy uruchomiona jest usługa HybridAgent.
    3. Podobnie jak powyżej, zmienną HYBRID_AGENT_API_KEY również można przenieść do konfiguracji środowiska NSSM, aby była aktywna podczas działania usługi.

  3. Uruchom usługę HybridAgent za pomocą narzędzia administracyjnego Services systemu Windows lub polecenia NSSM: nssm start HybridAgent. Nie jest to wymagane (po ponownym uruchomieniu komputera), jeśli usługa ma ustawione automatyczne uruchamianie.
  4. Upewnij się, że usługa HybridAgent jest uruchomiona, korzystając z narzędzia administracyjnego Services systemu Windows lub polecenia NSSM: nssm status HybridAgent.

Gdy Hybrid Agent połączy się z Twoją przestrzenią roboczą Altium 365 (odśwież okno przeglądarki, aby sprawdzić jego stan), możesz przejść do konfiguracji integracji PLM w przestrzeni roboczej Altium 365. Na stronie Add Configuration włącz opcję połączenia Hybrid Agent i w polu URL wprowadź adres URL lokalnego systemu PLM, pod którym jest on dostępny w zamkniętej sieci.

 

Bieżący klucz API można unieważnić za pomocą powiązanego z nim polecenia Revoke. W takim przypadku należy wygenerować nowy klucz API i zaktualizować zmienną środowiskową HYBRID_AGENT_API_KEY, przypisując jej wartość nowego klucza.

Uruchom ponownie Hybrid Agent, aby użyć nowego klucza — w NSSM użyj polecenia nssm restart HybridAgent lub zatrzymaj i uruchom usługę HybridAgent w narzędziu Services systemu Windows.

AI-LocalizedTłumaczenie SI
Jeśli znajdziesz błąd, zaznacz tekst/obraz i naciśnij Ctrl + Enter aby wysłać nam wiadomość.
Contents
Dostępność funkcji

Dostępne funkcje zależą od tego, z którego rozwiązania Altium korzystasz – Altium Develop, Altium Agile Teams, Altium Agile Enterprise lub Altium Designer (w ramach aktywnej subskrypcji terminowej).

Jeśli opisana funkcja nie jest widoczna w Twoim oprogramowaniu, skontaktuj się z działem sprzedaży Altium, aby dowiedzieć się więcej.