Tích hợp tác nhân lai

Tích hợp lai áp dụng cho trường hợp một công ty sử dụng Altium 365 muốn tích hợp Workspace của mình với một hệ thống PLM được lưu trữ on-premises, bên trong mạng của công ty, không có địa chỉ IP công khai – tức là không được đưa ra internet.

Để thực hiện việc này, một chương trình nhỏ có tên là Hybrid Agent sẽ chạy bên trong mạng của công ty. Chương trình này giao tiếp với Altium 365, chuyển tiếp thông tin giữa Altium 365 Workspace và hệ thống PLM nằm trong mạng khép kín. Việc giao tiếp với Hybrid Agent diễn ra qua HTTPS và không cần mở bất kỳ cổng mạng nào cho lưu lượng đi vào từ internet. Chỉ cần cổng HTTPS tiêu chuẩn 443 cho lưu lượng đi ra.

Thiết lập Hybrid Integration

Tải xuống gói lưu trữ Agent () và giải nén nội dung của nó vào một vị trí đã biết. Gói này chứa một ứng dụng Java (hybrid-agent.jar) cần được chạy trên một máy nằm trong mạng của công ty, từ đó có thể truy cập được hệ thống PLM on-premises và Altium 365.

Máy đó not không cần phải có thể truy cập công khai từ internet, nhưng cần có khả năng kết nối với môi trường Altium 365 mà công ty bạn đang sử dụng.

Sau khi ứng dụng Hybrid Agent đã được đặt đúng chỗ:

1. Tạo API key trong trang Hybrid Agent của Altium 365 Workspace ().
2. Tạo một biến môi trường HYBRID_AGENT_API_KEY với giá trị là API key đó.

3. Chạy agent.bat bằng ngữ cảnh lệnh sau, trong đó đối số tham số URL phải là URL của Altium 365 Workspace của bạn:
   agent.bat https://acme.365.altium.com

Khi hoạt động, Hybrid Agent sẽ tạo một tệp nhật ký trong thư mục hybrid-agent\logs của ứng dụng.

Rất khuyến nghị chạy Hybrid Agent như một dịch vụ Windows trong môi trường production thay vì chạy trực tiếp trong terminal, mặc dù cách sau có thể dùng để kiểm thử.

Một ví dụ về cách chạy Hybrid Agent như một dịch vụ Windows bằng trình quản lý dịch vụ NSSM:

1. Chạy lệnh: nssm install HybridAgent.
2. Trong cửa sổ hộp thoại NSSM (ở tab Application), nhập đường dẫn tệp agent.bat vào trường Path và URL Workspace của bạn vào trường Arguments, rồi nhấp vào Install service.
   1. Bạn có thể thiết lập hành vi khởi động của dịch vụ bằng tùy chọn Startup type trong tab Details của hộp thoại NSSM. Nếu cần, hãy chạy nssm edit HybridAgent để thực hiện các thay đổi đó.
   2. Như một phương án thay thế cho việc tạo các biến môi trường chuẩn PATH và JAVA_HOME cho Java, chúng có thể được thêm trong tab Environment của NSSM. Với cách này, các biến sẽ chỉ hoạt động khi dịch vụ HybridAgent đang chạy.

   3. Tương tự như trên, biến HYBRID_AGENT_API_KEY cũng có thể được chuyển sang phần thiết lập môi trường của NSSM để nó hoạt động khi dịch vụ đang chạy.

3. Khởi động dịch vụ HybridAgent bằng công cụ quản lý Services của Windows, hoặc bằng lệnh NSSM: nssm start HybridAgent. Việc này không cần thiết (sau khi khởi động lại PC) nếu dịch vụ được đặt tự động khởi động.
4. Đảm bảo dịch vụ HybridAgent đang chạy trong công cụ quản lý Services của Windows, hoặc bằng lệnh NSSM: nssm status HybridAgent.

Sau khi Hybrid Agent đã kết nối với Altium 365 Workspace của bạn (làm mới cửa sổ trình duyệt để kiểm tra trạng thái), bạn có thể tiếp tục cấu hình PLM Integration trong Altium 365 Workspace. Trong trang Add Configuration, hãy bật tùy chọn kết nối Hybrid Agent và nhập URL của hệ thống PLM on-premises của bạn, như được nhìn thấy bên trong mạng khép kín của bạn, vào trường URL.