Che cos'è Apigee hybrid?

Immagine stilizzata del deployment

Apigee hybrid è una piattaforma per lo sviluppo e la gestione dei proxy API che offre un modello di deployment ibrido. Il modello ibrido include un piano di gestione ospitato da Apigee nel cloud e un piano di runtime che installi e gestisci su una delle piattaforme Kubernetes supportate.

Gestisci tutte le tue API in un unico posto

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

Con la gestione unificata delle API, puoi fornire a sviluppatori, partner e clienti un'esperienza coerente del programma API.

Risolvi i problemi di sicurezza e conformità

Se le tue considerazioni in materia di conformità e sicurezza rendono il deployment on-premise un must per le tue applicazioni, con un gateway ibrido di livello enterprise, puoi ospitare e gestire il piano di runtime ibrido Apigee on-premise.

Sei tu a gestire e controllare il runtime, in modo da sfruttare l'infrastruttura esistente di conformità, governance e sicurezza.

Supporta la tua strategia multi-cloud

L'equilibrio tra costi e prestazioni può portare a una strategia ibrida.

Che tu stia semplicemente esplorando diversi cloud provider o che tu abbia già scelto una strategia ibrida, la tua piattaforma di gestione delle API dovrebbe offrirti la flessibilità di cui hai bisogno. Ospita e gestisci gateway ibridi di livello aziendale nel tuo data center, su Google Cloud o in entrambi.

 

Per scoprire di più sulla versione ibrida:

Continua a leggere

 

 

Per installare un modello ibrido:

Iniziamo!

 

Programmi API in un mondo ibrido

Apigee hybrid è costituito da un piano di gestione gestito da Google e da un piano di runtime che puoi installare su una piattaforma Kubernetes supportata. Entrambi gli aerei utilizzano i servizi della piattaforma Google Cloud, come mostra la seguente immagine:

Una visione generale della piattaforma ibrida, inclusi il piano di gestione, il piano di runtime e i servizi Google Cloud

Come puoi vedere, "Hybrid" è costituito dai seguenti componenti principali:

  • Piano di gestione Apigee-run: 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 set di servizi di runtime containerizzati che hai configurato e gestito nel tuo cluster Kubernetes. Tutto il traffico dell'API passa ed viene 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 altri vantaggi operativi dei container.

  • Google Cloud: una suite di servizi Cloud ospitata da Google.

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

Il seguente video fornisce un approfondimento sull'architettura ibrida:

Informazioni sul piano di runtime

Il piano di runtime è un insieme di servizi di runtime containerizzati che puoi configurare e gestire nel tuo cluster Kubernetes in esecuzione su una piattaforma Kubernetes supportata. Tutto il traffico delle 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 in esecuzione su una piattaforma Kubernetes supportata che gestisci.

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

Servizi principali in esecuzione sul piano di runtime ibrido

Per informazioni generali sui componenti di runtime, consulta le sezioni riportate di seguito. Inoltre, consulta la panoramica della configurazione del servizio di runtime.

Le seguenti sezioni descrivono in modo più dettagliato ciascuno di questi servizi principali del piano di runtime.

processore di messaggi

I processori di messaggi ibridi (MP) forniscono l'elaborazione delle richieste API e l'esecuzione dei criteri sul piano di runtime. Gli MP caricano tutti i proxy, risorse, server di destinazione, certificati e archivi di chiavi di cui è stato eseguito il deployment dallo spazio di archiviazione locale. Puoi configurare un gateway in entrata Apigee per esporre gli MP alle richieste provenienti dall'esterno del cluster.

Sincronizzatore

Il programma di sincronizzazione recupera i dati di configurazione relativi a 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 programma di sincronizzazione esegue periodicamente il polling del server di gestione per individuare eventuali modifiche e scarica una nuova configurazione ogni volta che vengono rilevate delle modifiche. I dati di configurazione vengono recuperati e archiviati in locale come file JSON nel file system locale, dove 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 i dati archiviati localmente come configurazione. Se la connessione tra il piano di gestione e quello di runtime non funziona, i servizi sul piano di runtime continuano a funzionare.

I dati di configurazione scaricati dal programma di sincronizzazione includono:

Datastore Cassandra

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

Cassandra è un sistema di dati distribuito che fornisce la persistenza dei dati sul piano di runtime. Puoi eseguire il deployment del database Cassandra come pool di nodi StatefulSet nel tuo cluster Kubernetes. Localizzare queste entità vicino ai servizi di elaborazione di runtime, aiuta a supportare i requisiti di sicurezza e alta scalabilità.

Il database Cassandra archivia informazioni sulle seguenti entità:

  • Sistema di gestione delle chiavi (KMS)
  • Mappa chiave-valore (KVM)
  • OAuth
  • API di gestione per dati di runtime (MART)
  • Dati sulla monetizzazione
  • Quote
  • Cache risposte

API di gestione per i dati di runtime (MART)

I dati che appartengono alla tua organizzazione e ai quali si accede durante le chiamate API di runtime vengono archiviati da Cassandra nel piano di runtime.

Questi dati includono:

  • Configurazioni di applicazioni
  • Dati del sistema di gestione delle chiavi (KMS)
  • Cache
  • Mappe chiave-valore (KVM)
  • Prodotti basati su API
  • App sviluppatore

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

Questa sezione descrive il ruolo di 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. MS autentica e autorizza la richiesta, quindi la inoltra a MART sul piano di runtime. Alla richiesta è allegato un token generato da MS utilizzando un account di servizio preconfigurato.

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

Cassandra archivia i dati di runtime elaborati da MART (si tratta, dopo tutto, di 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 conserva il proprio stato in fase di runtime.

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 chiami direttamente MART.

Inoltre, MART non riceve richieste proxy API; queste chiamate vengono gestite dal controller in entrata del runtime e vengono instradate ai processori di messaggi del cluster.

 

È importante sottolineare che sia MART che i processori di messaggi hanno accesso allo stesso datastore di runtime (Cassandra), ovvero il modo in cui vengono condivisi dati come KMS, KVM e cache.

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

Flusso di chiamate API in modalità ibrida

UDCA (UDCA)

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

Per maggiori informazioni, consulta Raccolta dei dati relativi a debug, analisi e stato del deployment.

Informazioni sul piano di gestione

Il piano di gestione viene eseguito su Google Cloud. Comprende servizi amministrativi quali:

  • UI ibrida di Apigee:fornisce agli sviluppatori un'interfaccia utente per 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: fornisci 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 del deployment dal piano di runtime.

La seguente immagine mostra i servizi principali che vengono eseguiti sul piano di gestione:

Servizi che vengono eseguiti sul piano di gestione ibrida Apigee

Informazioni sui servizi Google Cloud

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

Servizio Google Cloud Descrizione
Identità L'autenticazione degli account utente utilizza gli account Google Cloud. L'autorizzazione utilizza gli account di servizio Google Cloud.
Ruoli La gestione degli accessi per gli ambienti ibridi utilizza il motore dei ruoli di Google, IAM e supporta i ruoli Apigee predefiniti.
Gerarchia delle risorse Le risorse sono organizzate in progetti Google Cloud (collegati alle organizzazioni Apigee).
Operazioni 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à tipiche Aree di interesse
Amministratori di sistema/operatori
  • Installa e configura i servizi sul piano di runtime di ibrido
  • Configura gli account Google Cloud, Apigee e di servizio
  • Creare servizi e progetti Google Cloud
  • Gestisci il cluster Kubernetes
  • Mantieni tutti i parametri precedenti
  • Risolvere i problemi relativi ai proxy API
Sviluppatori
  • Crea proxy API utilizzando l'interfaccia utente ibrida di Apigee 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é gli ambienti ibridi vengono distribuiti e eseguiti in container, puoi ottenere implementazioni graduali, scalabilità automatica e altri vantaggi operativi offerti da un sistema containerizzato.
Latenza ridotta
Tutte le comunicazioni con il piano di gestione ibrido sono asincrone e non avvengono nell'ambito dell'elaborazione delle richieste API client.
Aumento dell'adozione dell'API
Sebbene sia possibile elaborare le API interne utilizzando Apigee, la riduzione della latenza e dell'efficienza che si possono ottenere con gli ambienti ibridi rendono l'elaborazione delle API interne con approccio ibrido un'opzione interessante. Parte di questa efficienza viene raggiunta perché il gateway API viene eseguito on-premise, in prossimità dei servizi di backend. Inoltre, se utilizzi Apigee, puoi aumentare l'adozione di Apigee elaborando le API interne tramite approccio ibrido.
Maggiore controllo
Molte aziende stanno intraprendendo una strategia ibrida. La capacità di gestire i runtime delle API di cui è stato eseguito il deployment in data center privati è un requisito chiave per le grandi aziende. Attualmente, è possibile eseguire il deployment del piano di runtime ibrido in Google Cloud o nel tuo data center.

Passaggio successivo

Consulta il quadro generale: una panoramica del processo di installazione ibrida.