Tài liệu này cung cấp hướng dẫn chi tiết về cách thiết lập và định cấu hình trình kết nối trung tâm API Apigee cho Đám mây riêng tư và trung tâm API. Trình kết nối này giúp chuyển siêu dữ liệu API và số liệu phân tích thời gian chạy từ bản cài đặt Apigee Edge cho Đám mây riêng tư sang Trung tâm API của Google Cloud.
Việc tích hợp Apigee Edge cho Private Cloud và API Hub được thiết kế để kết nối các môi trường Apigee tại cơ sở của bạn với API Hub của Google Cloud. Việc tích hợp này cho phép truyền liền mạch siêu dữ liệu API quan trọng (chẳng hạn như định nghĩa proxy API, chính sách, v.v.) và dữ liệu phân tích thời gian chạy từ các bản cài đặt Apigee cho Đám mây riêng tư trực tiếp vào API Hub, mang đến một chế độ xem tập trung và toàn diện về hệ sinh thái API của bạn.
Tổng quan
Về cơ bản, chế độ tích hợp này cho phép người dùng Apigee cho Đám mây riêng tư đưa thông tin API của họ vào API Hub. Điều này có nghĩa là bạn có thể tận dụng các chức năng của API Hub để khám phá, quản trị và quản lý tập trung các API bắt nguồn từ việc triển khai Apigee tại cơ sở.
Các thành phần chính
- Trung tâm API (Google Cloud): Nền tảng tập trung trên đám mây, nơi siêu dữ liệu API và dữ liệu thời gian chạy được hợp nhất và quản lý.
- Trình kết nối trung tâm Apigee: Một thành phần mới được cài đặt cùng với môi trường Apigee Edge cho Đám mây riêng tư. Trình kết nối này là tác nhân chính chịu trách nhiệm trích xuất dữ liệu từ Apigee Edge cho Đám mây riêng tư và xuất bản dữ liệu đó một cách an toàn lên Google Cloud.
- Trình xử lý thông báo (MP): Các thành phần hiện có của Apigee được định cấu hình lại để "ghi kép" dữ liệu phân tích thời gian chạy vào Hệ thống tệp mạng (NFS) dùng chung, giúp trình kết nối trung tâm API Apigee có thể truy cập vào dữ liệu này.
- Hệ thống tệp mạng (NFS): Một ổ lưu trữ dùng chung để tạm thời lưu trữ dữ liệu phân tích từ MP trước khi trình kết nối trung tâm API Apigee xử lý và tải dữ liệu đó lên.
- Google Cloud Pub/Sub: Một dịch vụ nhắn tin được trình kết nối Apigee API Hub cho Đám mây riêng tư sử dụng để truyền trực tuyến một cách an toàn siêu dữ liệu API và dữ liệu thời gian chạy đến API Hub.
- Tài khoản dịch vụ Google Cloud: Dùng để xác thực và uỷ quyền một cách an toàn cho trình kết nối Apigee API Hub cho Đám mây riêng để tương tác với các dịch vụ Pub/Sub và API Hub.
Quy trình tích hợp
Quy trình tích hợp tuân theo một quy trình có cấu trúc để đảm bảo việc chuyển dữ liệu và độ chính xác:
- Thiết lập và cung cấp ban đầu:
- Bắt đầu bằng cách thiết lập một dự án Google Cloud và cung cấp API Hub trong dự án đó.
- Tạo Tài khoản dịch vụ Google Cloud và đăng ký các tổ chức Apigee cho Đám mây riêng tư với API Hub bằng cách tạo "Các phiên bản trình bổ trợ". Bước này cung cấp các chủ đề Pub/Sub và mã nhận dạng phiên bản trình bổ trợ riêng biệt, cần thiết cho việc thiết lập cấu hình.
- Apigee API hub để cài đặt trình kết nối Private Cloud:
- Trình kết nối trung tâm API Apigee cho Đám mây riêng tư (một gói RPM) được cài đặt trên một VM chuyên dụng cùng với môi trường Apigee cho Đám mây riêng tư. Bạn phải có một phiên bản Apigee for Private Cloud tương thích.
- Apigee API hub để thiết lập Private Cloudconnector:
- Trình kết nối được định cấu hình bằng thông tin chi tiết thu được trong quá trình tạo trình bổ trợ API Hub (chủ đề Pub/Sub, mã nhận dạng phiên bản trình bổ trợ, thông tin chi tiết về tài khoản dịch vụ).
- Xác thực cho cả dịch vụ Google Cloud (thông qua khoá tài khoản dịch vụ) và Apigee Management Server (thông qua thông tin đăng nhập được mã hoá base64).
- Đường dẫn đến NFS dùng chung cũng được định cấu hình tại đây.
- Cấu hình bộ xử lý thông báo (MP):
- Bộ xử lý thông báo Apigee của bạn được cập nhật để bật cơ chế "ghi kép" cho dữ liệu phân tích. Điều này có nghĩa là các bản ghi phân tích được ghi vào cả hệ thống phân tích truyền thống và thư mục dùng chung NFS được chỉ định.
- Luồng dữ liệu:
- Siêu dữ liệu API: Trình kết nối Đám mây riêng tư của trung tâm API Apigee sẽ lấy siêu dữ liệu API từ máy chủ quản lý Apigee và xuất bản siêu dữ liệu đó vào chủ đề Pub/Sub được chỉ định trong Google Cloud, sau đó sẽ được đưa vào trung tâm API.
- Dữ liệu thời gian chạy: Các trình xử lý thông báo ghi dữ liệu phân tích vào NFS dùng chung. Trình kết nối trung tâm Apigee giám sát NFS này, xử lý dữ liệu thời gian chạy và xuất bản dữ liệu đó vào chủ đề Pub/Sub dữ liệu thời gian chạy được chỉ định trong Google Cloud để nhập vào API Hub.
- Theo dõi và khắc phục sự cố:
- Điểm cuối trạng thái cục bộ trên trung tâm API Apigee cho trình kết nối Đám mây riêng tư cho phép bạn theo dõi tiến trình tải siêu dữ liệu và dữ liệu thời gian chạy lên.
- Nhật ký chi tiết có sẵn để khắc phục mọi vấn đề liên quan đến quá trình khởi động, chuyển dữ liệu hoặc kết nối.
Mối tương quan:
- Trình kết nối Apigee API Hub cho Đám mây riêng tư dựa vào NFS được gắn đúng cách và có thể truy cập được bởi chính nó và tất cả các Trình xử lý thông báo.
- Bạn phải định cấu hình Trình xử lý thông báo cho tính năng ghi kép vào NFS để bật tính năng thu thập dữ liệu trong thời gian chạy.
- Vai trò Tài khoản dịch vụ Google Cloud và thông tin chi tiết về API Hub Plugin Instance (Phiên bản trình bổ trợ API Hub) chính xác là yếu tố quan trọng đối với khả năng xác thực và xuất bản dữ liệu của trình kết nối.
Việc tích hợp này cung cấp một cơ chế mạnh mẽ để đưa các API Apigee tại cơ sở của bạn vào hoạt động quản lý và khả năng hiển thị tập trung do API Hub cung cấp, giúp cải thiện hoạt động quản trị và thông tin chi tiết về API.