Questo documento fornisce istruzioni dettagliate per la configurazione del connettore dell'hub API Apigee per Private Cloud e dell'hub API, che facilita il trasferimento dei metadati API e dell'analisi del runtime dall'installazione di Apigee Edge per Private Cloud all'hub API di Google Cloud.
L'integrazione di Apigee Edge for Private Cloud e dell'hub API è progettata per collegare gli ambienti Apigee on-premise con l'hub API di Google Cloud. Questa integrazione consente il flusso continuo di metadati API critici (come definizioni di proxy API, policy e così via) e dati di analisi del runtime dalle installazioni di Apigee per Private Cloud direttamente nell'hub API, fornendo una visione centralizzata e completa del tuo panorama API.
Panoramica
In sostanza, questa integrazione consente agli utenti di Apigee per Private Cloud di integrare le informazioni sulle API in API Hub. Ciò significa che puoi sfruttare le funzionalità dell'hub API per il rilevamento, la governance e la gestione centralizzata delle API provenienti dalle tue implementazioni Apigee on-premise.
Componenti chiave
- Hub API (Google Cloud): la piattaforma centrale basata sul cloud in cui vengono consolidati e gestiti i metadati API e i dati di runtime.
- Connettore hub Apigee:un nuovo componente installato insieme all'ambiente Apigee Edge for Private Cloud. Questo connettore è l'agente principale responsabile dell'estrazione dei dati da Apigee Edge for Private Cloud e della loro pubblicazione sicura su Google Cloud.
- Processori di messaggi (MP): componenti Apigee esistenti riconfigurati per scrivere i dati di analisi di runtime in un Network File System (NFS) condiviso, rendendoli disponibili per il connettore dell'hub API Apigee.
- File system di rete (NFS): un volume di archiviazione condiviso utilizzato per archiviare temporaneamente i dati di analisi dei processori di messaggi prima che il connettore dell'hub API Apigee li elabori e li carichi.
- Google Cloud Pub/Sub: un servizio di messaggistica utilizzato dal connettore dell'hub API Apigee per Private Cloud per trasmettere in streaming in modo sicuro i metadati API e i dati di runtime all'hub API.
- Service account Google Cloud:utilizzati per l'autenticazione e l'autorizzazione sicure del connettore Apigee API Hub for Private Cloud per interagire con i servizi Pub/Sub e API Hub.
Il flusso di integrazione
L'integrazione segue un processo strutturato per garantire il trasferimento e l'accuratezza dei dati:
- Configurazione iniziale e provisioning:
- Inizia configurando un progetto Google Cloud ed eseguendo il provisioning dell'hub API al suo interno.
- Crea service account Google Cloud e registra le tue organizzazioni Apigee per Private Cloud con API Hub creando "istanze del plug-in". Questo passaggio fornisce argomenti Pub/Sub e ID istanza plug-in unici essenziali per la configurazione.
- Installazione del connettore dell'hub API Apigee per Private Cloud:
- Il connettore Apigee API Hub per Private Cloud, un pacchetto RPM, viene installato su una VM dedicata insieme all'ambiente Apigee per Private Cloud. È necessaria una versione compatibile di Apigee per il cloud privato.
- Configurazione del connettore dell'hub API Apigee per Private Cloud:
- Il connettore è configurato con i dettagli ottenuti durante la creazione del plug-in API Hub (argomenti Pub/Sub, ID istanza plug-in, dettagli del service account).
- Viene stabilita l'autenticazione sia ai servizi Google Cloud (tramite le chiavi del service account) sia ad Apigee Management Server (tramite credenziali codificate in base64).
- Anche il percorso della condivisione NFS è configurato qui.
- Configurazione del processore di messaggi (MP):
- I processori di messaggi Apigee vengono aggiornati per abilitare un meccanismo di "scrittura doppia" per i dati di analisi. Ciò significa che i record di analisi vengono scritti sia nel sistema di analisi tradizionale sia nella condivisione NFS designata.
- Flusso di dati:
- Metadati API:il connettore dell'hub API Apigee per Private Cloud estrae i metadati API dal server di gestione Apigee e li pubblica nell'argomento Pub/Sub dei metadati designato in Google Cloud, che poi vengono inseriti nell'hub API.
- Dati di runtime:i processori di messaggi scrivono i dati di analisi nell'NFS condiviso. Il connettore hub Apigee monitora questo NFS, elabora i dati di runtime e li pubblica nell'argomento Pub/Sub dei dati di runtime designato in Google Cloud per l'importazione in API Hub.
- Monitoraggio e risoluzione dei problemi:
- Un endpoint di stato locale nell'hub API Apigee per il connettore Private Cloud ti consente di monitorare l'avanzamento dei caricamenti di metadati e dati di runtime.
- Sono disponibili log dettagliati per la risoluzione dei problemi relativi all'avvio, al trasferimento dei dati o alla connettività.
Interdipendenze:
- Il connettore Apigee API Hub per Private Cloud si basa sul corretto montaggio e sull'accessibilità di NFS sia da parte sua che da parte di tutti i processori di messaggi.
- I processori di messaggi devono essere configurati per la doppia scrittura su NFS per abilitare la raccolta dei dati di runtime.
- I ruoli del service account Google Cloud e i dettagli dell'istanza del plug-in dell'hub API corretti sono fondamentali per le funzionalità di autenticazione e pubblicazione dei dati del connettore.
Questa integrazione fornisce un meccanismo efficace per importare le API Apigee on-premise nella gestione centralizzata e nella visibilità fornite dall'hub API, consentendo una migliore governance e approfondimenti delle API.