Dokumen ini memberikan petunjuk mendetail untuk menyiapkan dan mengonfigurasi konektor hub API Apigee untuk Private Cloud dan hub API, yang memfasilitasi transfer metadata API dan analisis runtime dari penginstalan Apigee Edge untuk Private Cloud ke Hub API Google Cloud.
Integrasi Apigee Edge untuk Cloud Pribadi dan hub API dirancang untuk menghubungkan lingkungan Apigee on-premise Anda dengan Hub API Google Cloud. Integrasi ini memungkinkan alur metadata API penting (seperti definisi proxy API, kebijakan, dll.) dan data analisis runtime yang lancar dari instalasi Apigee for Private Cloud Anda langsung ke API Hub, sehingga memberikan tampilan terpusat dan komprehensif tentang lanskap API Anda.
Ringkasan
Pada dasarnya, integrasi ini memungkinkan pengguna Apigee untuk Private Cloud mengintegrasikan informasi API mereka ke API Hub. Artinya, Anda dapat memanfaatkan kemampuan API Hub untuk penemuan, tata kelola, dan pengelolaan terpusat API yang berasal dari deployment Apigee on-premise Anda.
Komponen utama
- Hub API (Google Cloud): Platform berbasis cloud terpusat tempat metadata API dan data runtime digabungkan dan dikelola.
- Konektor hub Apigee: Komponen baru yang diinstal bersama lingkungan Apigee Edge for Private Cloud Anda. Konektor ini adalah agen utama yang bertanggung jawab untuk mengekstrak data dari Apigee Edge untuk Private Cloud dan memublikasikannya secara aman ke Google Cloud.
- Pemroses pesan (MP): Komponen Apigee yang ada dan dikonfigurasi ulang untuk melakukan "penulisan ganda" data analisis runtime ke Network File System (NFS) bersama, sehingga tersedia untuk konektor hub API Apigee.
- Network file system (NFS): Volume penyimpanan bersama yang digunakan untuk menyimpan data analisis dari MP untuk sementara sebelum diproses dan diupload oleh konektor hub API Apigee.
- Google Cloud Pub/Sub: Layanan pesan yang digunakan oleh konektor Apigee API Hub untuk Private Cloud guna melakukan streaming metadata API dan data runtime ke hub API secara aman.
- Akun layanan Google Cloud: Digunakan untuk autentikasi dan otorisasi yang aman dari konektor Apigee API Hub untuk Private Cloud agar dapat berinteraksi dengan layanan Pub/Sub dan API Hub.
Alur integrasi
Integrasi mengikuti proses terstruktur untuk memastikan transfer dan akurasi data:
- Penyiapan & penyediaan awal:
- Mulailah dengan menyiapkan project Google Cloud dan menyediakan API Hub di dalamnya.
- Buat Akun Layanan Google Cloud dan daftarkan organisasi Apigee for Private Cloud Anda ke API Hub dengan membuat "Instance Plugin". Langkah ini menyediakan topik Pub/Sub unik dan ID Instance Plugin yang penting untuk konfigurasi.
- Hub API Apigee untuk penginstalan konektor Private Cloud:
- Konektor hub API Apigee untuk Private Cloud, paket RPM, diinstal di VM khusus bersama dengan lingkungan Apigee untuk Private Cloud Anda. Hal ini memerlukan versi Apigee untuk Private Cloud yang kompatibel.
- Hub API Apigee untuk konfigurasi Private Cloudconnector:
- Konektor dikonfigurasi dengan detail yang diperoleh selama pembuatan plugin API Hub (topik Pub/Sub, ID Instance Plugin, detail Akun Layanan).
- Autentikasi ke layanan Google Cloud (melalui kunci akun layanan) dan Apigee Management Server (melalui kredensial yang dienkode base64) telah dilakukan.
- Jalur ke NFS bersama juga dikonfigurasi di sini.
- Konfigurasi pemroses pesan (MP):
- Prosesor pesan Apigee Anda diperbarui untuk mengaktifkan mekanisme "penulisan ganda" untuk data analisis. Artinya, rekaman analisis ditulis ke sistem analisis tradisional dan berbagi NFS yang ditentukan.
- Aliran data:
- Metadata API: Konektor hub API Apigee untuk Cloud Pribadi menarik metadata API dari server pengelolaan Apigee dan memublikasikannya ke topik Pub/Sub metadata yang ditetapkan di Google Cloud, yang kemudian dimasukkan ke hub API.
- Data runtime: Pemroses pesan menulis data analisis ke NFS bersama. Konektor hub Apigee memantau NFS ini, memproses data runtime, dan memublikasikannya ke topik Pub/Sub data runtime yang ditetapkan di Google Cloud untuk penyerapan ke API Hub.
- Pemantauan & pemecahan masalah:
- Endpoint status lokal di hub API Apigee untuk konektor Private Cloud memungkinkan Anda memantau progres upload metadata dan data runtime.
- Log mendetail tersedia untuk memecahkan masalah terkait startup, transfer data, atau konektivitas.
Interdependensi:
- Konektor Apigee API Hub untuk Private Cloud mengandalkan NFS yang terpasang dengan benar dan dapat diakses oleh konektor itu sendiri dan semua Pemroses Pesan.
- Prosesor Pesan harus dikonfigurasi untuk penulisan ganda ke NFS agar pengumpulan data runtime dapat dilakukan.
- Peran Akun Layanan Google Cloud dan detail Instance Plugin Hub API yang benar sangat penting untuk kemampuan autentikasi dan publikasi data konektor.
Integrasi ini menyediakan mekanisme yang andal untuk menghadirkan API Apigee on-premise Anda ke dalam pengelolaan dan visibilitas terpusat yang disediakan oleh API Hub, sehingga memungkinkan tata kelola dan insight API yang lebih baik.