Questo documento fornisce istruzioni dettagliate per la configurazione del connettore dell'hub delle API Apigee per Private Cloud e dell'hub delle API, che facilita il trasferimento dei metadati delle API e dell'analisi del runtime dall'installazione di Apigee Edge per Private Cloud all'hub delle 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, criteri e così via) e dati di analisi del runtime dalle tue 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 e i dati di runtime delle API.
- 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 in modalità "dual-write" 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 MP prima che il connettore dell'hub API Apigee li elabori e li carichi.
- Google Cloud Pub/Sub: un servizio di messaggistica utilizzato dal connettore Apigee API Hub per Private Cloud per trasmettere in streaming in modo sicuro i metadati e i dati di runtime delle API ad API Hub.
- 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 Analytics 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 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 hub API corretti sono fondamentali per le funzionalità di autenticazione e pubblicazione dei dati del connettore.
Questa integrazione fornisce un meccanismo efficace per portare le tue API Apigee on-premise nella gestione e nella visibilità centralizzate fornite dall'hub API, consentendo una migliore governance e approfondimenti delle API.