Tích hợp tác tử lai

Hybrid Integration á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ẽ được 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 Workspace Altium 365 và hệ thống PLM bên trong mạng kín. Việc giao tiếp với Hybrid Agent được thực hiện qua HTTPS và không cần mở bất kỳ cổng mạng nào cho lưu lượng truy cập đi vào từ internet. Chỉ cần cổng HTTPS tiêu chuẩn 443 cho lưu lượng truy cập đi ra.

Thiết lập Hybrid Integration

Tải xuống gói lưu trữ của 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 vào vị trí:

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 log trong thư mục hybrid-agent\logs của ứng dụng.

Rất khuyến nghị chạy Hybrid Agent dưới dạng 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 vẫn có thể dùng để kiểm thử.

Một ví dụ về cách chạy Hybrid Agent dưới dạng 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 Install service.
   1. Bạn có thể đặt 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. Thay vì tạo các biến môi trường chuẩn PATH và JAVA_HOME cho Java, chúng cũ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 PLM on-premises của bạn, như được nhìn thấy trong mạng kín của bạn, vào trường URL.