Che cos'è Apigee hybrid?

Immagine stilizzata del deployment

Apigee Hybrid è una piattaforma per lo sviluppo e la gestione di proxy API che presenta un modello di deployment ibrido. Il modello ibrido include un piano di gestione ospitato da Apigee nel cloud e un piano di runtime che puoi installare e gestire su una delle piattaforme Kubernetes supportate.

Gestire tutte le API da un'unica posizione

Apigee hybrid ti aiuta a gestire le API interne ed esterne con in Google Cloud.

Grazie alla gestione unificata delle API, puoi fornire agli sviluppatori, ai partner e ai clienti un'esperienza coerente del programma relativo alle API.

Risolvi i problemi di sicurezza e conformità

Se le tue strategie di conformità e sicurezza richiedono il deployment on-premise per le tue applicazioni, con un gateway ibrido di livello enterprise potrai ospitare e gestire il piano di runtime Apigee hybrid nel tuo ambiente on-premise.

Puoi gestire e controllare il runtime, sfruttando l'infrastruttura di conformità, governance e sicurezza esistente.

Sostieni la tua strategia multi-cloud

La necessità di trovare un equilibrio tra costi e prestazioni può spingerti verso una strategia ibrida.

Sia che tu stia solo esplorando diversi cloud provider o che tu abbia già scelto un strategia ibrida, la tua piattaforma di gestione delle API dovrebbe darti la flessibilità di cui hai bisogno. Ospita e gestisci gateway ibridi di livello enterprise nel tuo data center, in Google Cloud o in entrambi.

 

Per scoprire di più sul modello ibrido:

Continua a leggere

 

 

Per installare la versione ibrida:

Iniziamo.

 

Programmi API in un mondo ibrido

Apigee hybrid è costituito da un piano di gestione gestito da Google e un piano di runtime su una piattaforma Kubernetes supportata. Entrambi i piani utilizzano i servizi Google Cloud Platform, come mostrato nella seguente immagine:

Un indirizzo
  vista della piattaforma ibrida, inclusi piano di gestione, piano di runtime e servizi Google Cloud

Come puoi vedere, l'ibrido è costituito dai seguenti componenti principali:

  • Piano di gestione eseguito da Apigee: un insieme di servizi ospitati nel cloud e gestiti da Google. Questi servizi includono UI, API di gestione e analisi.
  • Piano di runtime gestito dal cliente: un di servizi di runtime containerizzati che configuri e gestisci nel tuo ambiente Kubernetes in un cluster Kubernetes. Tutto il traffico API passa ed è elaborato all'interno del piano di runtime.

    Gestisci il runtime containerizzato sul tuo cluster Kubernetes per una maggiore agilità con implementazioni graduali, scalabilità automatica e gli altri vantaggi operativi dei container.

  • Google Cloud: una suite di servizi cloud ospitati da Google.

Una cosa fondamentale da sapere sugli ambienti ibridi è che tutto il traffico delle API viene elaborato entro i limiti del della rete e sotto il tuo controllo, mentre i servizi di gestione come l'interfaccia utente e l'analisi delle API eseguono nel cloud e sono gestiti da Google. Per ulteriori informazioni, vedi Dove vengono archiviati i tuoi dati?

Il seguente video fornisce un'analisi approfondita dell'architettura ibrida:

Informazioni sul piano di runtime

Il piano di runtime è un insieme di servizi di runtime containerizzati che configuri e gestisci nel tuo il tuo cluster Kubernetes in esecuzione su una piattaforma Kubernetes supportata. Tutto il traffico API passa ed è elaborato all'interno del piano di runtime. Il piano di runtime include i seguenti componenti principali:

Il piano di runtime viene eseguito in un cluster Kubernetes su una piattaforma Kubernetes supportata di tua gestione.

L'immagine seguente mostra i servizi principali in esecuzione sul piano di runtime:

Servizi principali che vengono eseguiti nel piano di runtime ibrido

Per informazioni generali sui componenti di runtime, consulta le sezioni seguenti. Inoltre, consulta la Panoramica della configurazione dei servizi di runtime.

Le sezioni seguenti descrivono in maggiore dettaglio ciascuno di questi servizi del piano di runtime principale.

processore di messaggi

I processori di messaggi ibride (MP) forniscono l'elaborazione delle richieste API e l'esecuzione delle norme nel piano di runtime. I file MP caricano tutti i proxy, le risorse, i server di destinazione, i certificati gli archivi chiavi dallo spazio di archiviazione locale. Configura un gateway di ingresso Apigee per esporre gli MP alle richieste provenienti dall'esterno del cluster.

Sincronizzatore

Il sincronizzatore recupera i dati di configurazione di un ambiente API dal piano di gestione e li propaga nel piano di runtime. Questi dati scaricati sono chiamati anche contratto e vengono archiviati nel file system locale.

Il sincronizzatore esegue periodicamente un polling del server di gestione per rilevare le modifiche e scarica una nuova configurazione ogni volta che vengono rilevate. I dati di configurazione vengono recuperati e archiviati localmente come file JSON nel file system locale, dove i Message Processor possono accedervi.

I dati di configurazione scaricati consentono al piano di runtime di funzionare indipendentemente dal piano di gestione. Con il contratto, I processori di messaggi sul piano di runtime utilizzano e archiviare i dati come configurazione. Se la connessione tra di gestione e runtime smette di funzionare, i servizi continuano a funzionare.

I dati di configurazione scaricati dal sincronizzatore includono:

Datastore Cassandra

Apache Cassandra è il data store di runtime che fornisce la persistenza dei dati per il piano di runtime.

Cassandra è un sistema di dati distribuito che garantisce la persistenza dei dati nel piano di runtime. Esegui il deployment del database Cassandra come pool di nodi StatefulSet nel cluster Kubernetes. La collocazione di queste entità vicino ai servizi di elaborazione di runtime contribuisce a supportare i requisiti di sicurezza e alta scalabilità.

Il database Cassandra memorizza informazioni sulle seguenti entità:

  • Sistema di gestione delle chiavi (KMS)
  • Mappa valori chiave (KVM)
  • OAuth
  • API di gestione per i dati di RunTime (MART)
  • Dati sulla monetizzazione
  • Quote
  • Cache delle risposte

API di gestione per i dati di runtime (MART)

I dati che appartengono all'organizzazione a cui si accede durante le chiamate API di runtime e archiviato da Cassandra nel piano di runtime.

Questi dati includono:

  • Configurazioni delle applicazioni
  • Dati del Key Management System (KMS)
  • Cache
  • Mappe chiave-valore (KVM)
  • Prodotti basati su API
  • App per sviluppatori

Per accedere a questi dati e aggiornarli, ad esempio per aggiungere una un nuovo KVM o per rimuovere un ambiente, puoi utilizzare la UI ibrida Apigee o le API Apigee. MART (API di gestione per i dati di runtime) elabora le chiamate API rispetto al runtime datastore.

Questa sezione descrive il ruolo svolto da MART quando chiami le API Apigee per accedere al datastore di runtime.

 
Che cos'è MART

Per chiamare un'API Apigee, devi inviare una richiesta autenticata al server di gestione (MS) sul piano di gestione. Il server Microsoft autentica e autorizza la richiesta e poi inoltra la richiesta a MART sul piano di runtime. Alla richiesta è allegato un token generato dal sistema MS utilizzando un account di servizio preconfigurato.

MART riceve la richiesta, la autentica e la autorizza, quindi esegue l'attività una convalida. Ad esempio, se l'app fa parte di un prodotto API, MART garantisce che si tratti di una richiesta valida. Dopo aver stabilito che una richiesta è valida, MART la elabora.

Cassandra memorizza i dati di runtime elaborati da MART (dopo tutto, è un datastore di runtime). MART potrebbe leggere i dati da Cassandra o aggiornarli, a seconda del tipo di richiesta.

Come la maggior parte dei servizi ibridi, MART è stateless: non mantiene il proprio stato runtime.

Che cosa non è MART

Il piano di gestione comunica con MART tramite l'agente Apigee Connect, che utilizza un account di servizio con il ruolo Agente Apigee Connect (l'account di servizio MART nella maggior parte delle installazioni). Non chiamare direttamente MART.

Inoltre, MART non riceve richieste di proxy API; queste chiamate vengono gestite dal Controller Ingress Runtime e inoltrate ai processori di messaggi del cluster.

 

Vale la pena notare che sia i processori MART che i processori di messaggi hanno accesso lo stesso datastore di runtime (Cassandra), che è il modo in cui vengono condiviso.

L'immagine seguente mostra il flusso di una chiamata API Apigee:

Flusso di chiamate API in
  ibrido

UDCA

L'Universal Data Collection Agent (UDCA) è un servizio in esecuzione nel pod di raccolta dei dati nel piano di runtime che estrae i dati di analisi, debug e stato di implementazione e li invia all'UAP.

Per ulteriori informazioni, consulta la sezione relativa alla raccolta dei dati di debug, analisi e stato di implementazione.

Informazioni sul piano di gestione

Il piano di gestione viene eseguito su Google Cloud. Include servizi amministrativi come come:

  • Interfaccia utente di Apigee hybrid: fornisce un'interfaccia utente per consentire agli sviluppatori di creare ed eseguire il deployment di proxy API, configurare criteri, creare prodotti API e creare app per sviluppatori. Gli amministratori possono utilizzare l'interfaccia utente ibrida di Apigee per monitorare lo stato del deployment.
  • API Apigee: forniscono un'interfaccia programmatica per la gestione della tua organizzazione e dei tuoi ambienti.
  • Unified Analytics Platform (UAP): riceve ed elabora i dati di analisi e sullo stato di implementazione dal piano di runtime.

L'immagine seguente mostra i servizi principali in esecuzione sul piano di gestione:

Servizi in esecuzione sul piano di gestione ibrida Apigee

Informazioni sui servizi Google Cloud

La tabella seguente descrive i servizi principali di Google Cloud sfruttati da ibrido:

Servizio Google Cloud Descrizione
Identità L'autenticazione dell'account utente utilizza account Google Cloud. Usi dell'autorizzazione Google Cloud.
Ruoli La gestione degli accessi per ambienti ibridi utilizza il motore dei ruoli di Google, IAM e supporta la piattaforma Apigee predefinita ruoli.
Gerarchia delle risorse Le risorse sono organizzate in progetti Google Cloud (collegati alle organizzazioni Apigee).
Operazioni di Google Cloud Fornisce analisi dei dati di logging e delle metriche.
 

Tipi di utenti

Apigee ha identificato i seguenti tipi principali di utenti ibridi:

Ruolo Responsabilità/attività tipiche Aree di interesse
Amministratori di sistema/operatori
  • Installa e configura i servizi nel piano di runtime di hybrid
  • Configurare Google Cloud, Apigee e gli account di servizio
  • Creare servizi e progetti Google Cloud
  • Gestisci il cluster Kubernetes
  • Mantieni tutte le risposte precedenti
  • Risoluzione dei problemi dei proxy API
Sviluppatori
  • Crea proxy API utilizzando l'interfaccia utente di Apigee Hybrid o le API Apigee
  • Esegui il deployment dei proxy API nel piano di runtime
  • Risolvere i problemi relativi ai proxy API
  • Testa i proxy API
 

Vantaggi

Apigee hybrid offre i seguenti vantaggi:

Maggiore agilità
Poiché il modello ibrido viene distribuito ed eseguito in container, puoi realizzare implementazioni graduali, scalabilità automatica e altri vantaggi operativi di un sistema containerizzato.
Latenza ridotta
Tutte le comunicazioni con il piano di gestione ibrida sono asincrone e non avvengono nell'ambito dell'elaborazione delle richieste dell'API client.
Maggiore adozione delle API
Sebbene sia possibile elaborare le API interne utilizzando Apigee, la latenza e l'efficienza ridotte che puoi ottenere con la versione ibrida rendono l'elaborazione delle API interne con la versione ibrida un'opzione interessante. Parte di questa efficienza è ottenuta perché il gateway API viene eseguito on-premise, vicino ai tuoi servizi di backend. Inoltre, se utilizzi Apigee, puoi aumentare l'adozione di Apigee elaborando le API interne tramite la versione ibrida.
Maggiore controllo
Molte aziende stanno adottando una strategia ibrida. La possibilità di gestisci i runtime API di cui è stato eseguito il deployment in privato data center è un requisito fondamentale per le grandi imprese. Attualmente, il piano di runtime ibrido può essere implementato su Google Cloud o nel tuo data center.

Passaggio successivo

Consulta la panoramica, una panoramica del processo di installazione ibrida.