Bu belgede, Apigee Edge for Private Cloud yüklemenizden Google Cloud'un API Hub'ına API meta verilerinin ve çalışma zamanı analizlerinin aktarılmasını kolaylaştıran Private Cloud ve API Hub için Apigee API Hub bağlayıcısının kurulumu ve yapılandırılmasıyla ilgili ayrıntılı talimatlar verilmektedir.
Private Cloud için Apigee Edge ve API Hub entegrasyonu, şirket içi Apigee ortamlarınızı Google Cloud'un API Hub'ına bağlamak için tasarlanmıştır. Bu entegrasyon, kritik API meta verilerinin (ör. API proxy tanımları, politikalar vb.) ve çalışma zamanı analiz verilerinin Apigee for Private Cloud yüklemelerinizden doğrudan API Hub'a sorunsuz bir şekilde aktarılmasını sağlayarak API ortamınızın merkezi ve kapsamlı bir görünümünü sunar.
Genel Bakış
Bu entegrasyon, temel olarak Özel Bulut için Apigee kullanıcılarının API bilgilerini API Hub'a aktarmasına olanak tanır. Bu sayede, şirket içi Apigee dağıtımlarınızdan kaynaklanan API'lerin keşfi, yönetimi ve merkezi yönetimi için API Hub'ın özelliklerinden yararlanabilirsiniz.
Temel bileşenler
- API hub'ı (Google Cloud): API meta verilerinin ve çalışma zamanı verilerinin birleştirilip yönetildiği merkezi bulut tabanlı platform.
- Apigee hub bağlayıcı: Apigee Edge for Private Cloud ortamınızla birlikte yüklenen yeni bir bileşen. Bu bağlayıcı, Apigee Edge for Private Cloud'dan veri ayıklamaktan ve bu verileri Google Cloud'da güvenli bir şekilde yayınlamaktan sorumlu birincil aracıdır.
- Mesaj işlemciler (MP'ler): Çalışma zamanı analiz verilerini paylaşılan bir Ağ Dosya Sistemi'ne (NFS) "çift yazma" işlemi yapacak şekilde yeniden yapılandırılan mevcut Apigee bileşenleri. Bu sayede, veriler Apigee API hub bağlayıcısı için kullanılabilir hale gelir.
- Ağ dosya sistemi (NFS): Apigee API hub bağlayıcısı tarafından işlenip yüklenmeden önce MP'lerden gelen analiz verilerini geçici olarak depolamak için kullanılan paylaşılan bir depolama birimi.
- Google Cloud Pub/Sub: Apigee API Hub for Private Cloud bağlayıcısı tarafından API meta verilerini ve çalışma zamanı verilerini API Hub'a güvenli bir şekilde aktarmak için kullanılan bir mesajlaşma hizmetidir.
- Google Cloud hizmet hesapları: Apigee API Hub for Private Cloud bağlayıcısının Pub/Sub ve API Hub hizmetleriyle etkileşim kurması için güvenli kimlik doğrulama ve yetkilendirme amacıyla kullanılır.
Entegrasyon akışı
Entegrasyon, veri aktarımını ve doğruluğunu sağlamak için yapılandırılmış bir süreç izler:
- İlk kurulum ve hazırlama:
- Öncelikle bir Google Cloud projesi oluşturun ve bu proje içinde API Hub'ı sağlayın.
- "Eklenti örnekleri" oluşturarak Google Cloud hizmet hesapları oluşturun ve Apigee for Private Cloud kuruluşlarınızı API Hub'a kaydedin. Bu adımda, yapılandırma için gerekli olan benzersiz Pub/Sub konuları ve eklenti örneği kimlikleri sağlanır.
- Private Cloud bağlayıcısı kurulumu için Apigee API hub'ı:
- RPM paketi olan Private Cloud için Apigee API Hub bağlayıcısı, Private Cloud için Apigee ortamınızın yanında özel bir sanal makineye yüklenir. Bunun için Private Cloud için uyumlu bir Apigee sürümü gerekir.
- Private Cloudconnector yapılandırması için Apigee API hub'ı:
- Bağlayıcı, API Hub eklentisi oluşturma sırasında elde edilen ayrıntılarla (Pub/Sub konuları, eklenti örneği kimlikleri, hizmet hesabı ayrıntıları) yapılandırılır.
- Hem Google Cloud hizmetlerinde (hizmet hesabı anahtarları aracılığıyla) hem de Apigee Management Server'da (base64 kodlu kimlik bilgileri aracılığıyla) kimlik doğrulama işlemi gerçekleştirilir.
- Paylaşılan NFS'nin yolu da burada yapılandırılır.
- İleti işlemcisi (MP) yapılandırması:
- Apigee mesaj işlemcileriniz, analiz verileri için "çift yazma" mekanizmasını etkinleştirecek şekilde güncellenir. Bu durumda, analiz kayıtları hem geleneksel analiz sistemine hem de belirlenen NFS paylaşımına yazılır.
- Veri akışı:
- API meta verileri: Özel Cloud bağlayıcısı için Apigee API merkezi, API meta verilerini Apigee yönetim sunucusundan çeker ve Google Cloud'daki belirlenen meta veri Pub/Sub konusuna yayınlar. Bu meta veriler daha sonra API merkezine aktarılır.
- Çalışma zamanı verileri: Mesaj işlemciler, analiz verilerini paylaşılan NFS'ye yazar. Apigee hub bağlayıcısı bu NFS'yi izler, çalışma zamanı verilerini işler ve API Hub'a aktarılmak üzere Google Cloud'daki belirlenen çalışma zamanı verileri Pub/Sub konusuna yayınlar.
- İzleme ve sorun giderme:
- Private Cloud bağlayıcısı için Apigee API Hub'daki yerel durum uç noktası, meta veri ve çalışma zamanı verisi yüklemelerinin ilerleme durumunu izlemenize olanak tanır.
- Başlatma, veri aktarımı veya bağlantıyla ilgili sorunları gidermek için ayrıntılı günlükler kullanılabilir.
Karşılıklı bağımlılıklar:
- Private Cloud için Apigee API Hub bağlayıcısı, NFS'nin doğru şekilde monte edilmesine ve hem kendisi hem de tüm Mesaj İşleyiciler tarafından erişilebilir olmasına bağlıdır.
- Çalışma zamanı veri toplama özelliğinin etkinleştirilmesi için ileti işlemcilerinin NFS'ye çift yazma işlemi yapacak şekilde yapılandırılması gerekir.
- Bağlayıcının kimlik doğrulama ve veri yayınlama özellikleri için doğru Google Cloud hizmet hesabı rolleri ve API Hub eklenti örneği ayrıntıları çok önemlidir.
Bu entegrasyon, şirket içi Apigee API'lerinizi API Hub'ın sunduğu merkezi yönetim ve görünürlüğe taşıyarak daha iyi API yönetimi ve analizler elde etmenizi sağlayan güçlü bir mekanizma sunar.