Ce document fournit des instructions détaillées pour configurer le connecteur de hub d'API Apigee pour Private Cloud et le hub d'API. Il facilite le transfert des métadonnées d'API et des données analytiques d'exécution de votre installation Apigee Edge pour Private Cloud vers le hub d'API de Google Cloud.
L'intégration d'Apigee Edge pour Private Cloud et du hub d'API est conçue pour faire le lien entre vos environnements Apigee sur site et le hub d'API de Google Cloud. Cette intégration permet de transférer facilement les métadonnées d'API critiques (comme les définitions de proxy d'API, les règles, etc.) et les données d'analyse d'exécution de vos installations Apigee pour le cloud privé directement dans le hub d'API. Vous obtenez ainsi une vue centralisée et complète de votre paysage d'API.
Présentation
Cette intégration permet aux utilisateurs d'Apigee pour Private Cloud d'intégrer les informations de leur API dans le hub d'API. Cela signifie que vous pouvez exploiter les fonctionnalités du hub d'API pour la découverte, la gouvernance et la gestion centralisée des API provenant de vos déploiements Apigee sur site.
Composants clés
- Hub d'API (Google Cloud) : plate-forme cloud centralisée où les métadonnées et les données d'exécution des API sont consolidées et gérées.
- Connecteur de hub Apigee : nouveau composant installé avec votre environnement Apigee Edge pour le cloud privé. Ce connecteur est l'agent principal chargé d'extraire les données d'Apigee Edge pour le cloud privé et de les publier de manière sécurisée sur Google Cloud.
- Processeurs de messages (PM) : composants Apigee existants qui sont reconfigurés pour "écrire en double" les données d'analyse du runtime dans un système de fichiers réseau (NFS) partagé, ce qui les rend disponibles pour le connecteur Apigee API Hub.
- Système de fichiers réseau (NFS) : volume de stockage partagé utilisé pour stocker temporairement les données analytiques des MP avant que le connecteur Apigee API Hub ne les traite et les importe.
- Google Cloud Pub/Sub : service de messagerie utilisé par le connecteur Apigee API Hub pour Private Cloud afin de diffuser en toute sécurité les métadonnées et les données d'exécution des API vers le hub d'API.
- Comptes de service Google Cloud : utilisés pour l'authentification et l'autorisation sécurisées du connecteur Apigee API Hub for Private Cloud afin d'interagir avec les services Pub/Sub et API Hub.
Processus d'intégration
L'intégration suit un processus structuré pour assurer le transfert et l'exactitude des données :
- Configuration et provisionnement initiaux :
- Commencez par configurer un projet Google Cloud et provisionnez le hub d'API dans ce projet.
- Créez des comptes de service Google Cloud et enregistrez vos organisations Apigee pour le cloud privé auprès d'API Hub en créant des "instances de plug-in". Cette étape fournit des ID d'instance de plug-in et des sujets Pub/Sub uniques, essentiels à la configuration.
- Installation du connecteur du hub d'API Apigee pour Private Cloud :
- Le connecteur Apigee API Hub pour Private Cloud, un package RPM, est installé sur une VM dédiée à côté de votre environnement Apigee pour Private Cloud. Cela nécessite une version compatible d'Apigee pour le cloud privé.
- Configuration du connecteur du hub d'API Apigee pour Private Cloud :
- Le connecteur est configuré avec les informations obtenues lors de la création du plug-in API Hub (sujets Pub/Sub, ID d'instance de plug-in, informations sur le compte de service).
- L'authentification auprès des services Google Cloud (via les clés de compte de service) et du serveur de gestion Apigee (via les identifiants encodés en base64) est établie.
- Le chemin d'accès au partage NFS est également configuré ici.
- Configuration du processeur de messages (MP) :
- Vos processeurs de messages Apigee sont mis à jour pour activer un mécanisme de "double écriture" pour les données analytiques. Cela signifie que les enregistrements d'analyse sont écrits à la fois dans le système d'analyse traditionnel et dans le partage NFS désigné.
- Flux de données :
- Métadonnées de l'API : le connecteur Apigee API Hub pour Private Cloud extrait les métadonnées de l'API du serveur de gestion Apigee et les publie dans le sujet Pub/Sub de métadonnées désigné dans Google Cloud, qui alimente ensuite API Hub.
- Données d'exécution : les processeurs de messages écrivent les données analytiques dans le partage NFS. Le connecteur de hub Apigee surveille ce NFS, traite les données d'exécution et les publie dans le sujet Pub/Sub désigné pour les données d'exécution dans Google Cloud, afin qu'elles soient ingérées dans API Hub.
- Surveillance et dépannage :
- Un point de terminaison d'état local sur le connecteur Apigee API Hub pour Private Cloud vous permet de surveiller la progression des importations de métadonnées et de données d'exécution.
- Des journaux détaillés sont disponibles pour résoudre les problèmes liés au démarrage, au transfert de données ou à la connectivité.
Interdépendances :
- Le connecteur Apigee API Hub pour le cloud privé repose sur le montage correct du système NFS et sur son accessibilité par lui-même et par tous les processeurs de messages.
- Les processeurs de messages doivent être configurés pour la double écriture sur le NFS afin d'activer la collecte des données d'exécution.
- Il est essentiel de fournir les rôles de compte de service Google Cloud et les détails de l'instance du plug-in API Hub corrects pour que le connecteur puisse s'authentifier et publier des données.
Cette intégration fournit un mécanisme robuste pour importer vos API Apigee sur site dans la gestion et la visibilité centralisées fournies par API Hub. Vous pouvez ainsi améliorer la gouvernance et les insights des API.