Ciclo di sviluppo delle API

Questa pagina si applica a Apigee e Apigee ibridi.

Visualizza documentazione di Apigee Edge.

Le seguenti sezioni riepilogano il ciclo di vita di sviluppo delle API utilizzando Apigee.

Sviluppo di proxy API

Apigee supporta le seguenti opzioni per lo sviluppo iterativo di proxy API:

Per saperne di più sui proxy API, consulta la pagina Informazioni su API e proxy API.

Sviluppo cloud con Apigee

Sviluppa i proxy API utilizzando gli strumenti di modifica e debug dei proxy API forniti con Apigee. Mentre lavori su un proxy API, Apigee salva le iterazioni della tua configurazione come revisioni.

Quando esegui il deployment di un proxy API, devi scegliere una revisione specifica. In genere, esegui il deployment della revisione più recente se necessario, ripristina una revisione precedente. Consulta Deployment dei proxy API.

Per iniziare a sviluppare proxy API con Apigee, vedi Creazione di un proxy API semplice.

Sviluppo locale con Apigee in VS Code

Usa Apigee in Visual Studio Code (VS Code) per sviluppare i proxy API e verificare la funzionalità mediante test delle unità e manuali (ad esempio, inviare una richiesta e visualizzare i risultati).

Dopo aver completato la convalida locale, esegui il deployment delle configurazioni di proxy API come archivi negli ambienti Apigee. Consulta Deployment dei proxy API.

Per iniziare a sviluppare i tuoi proxy API localmente utilizzando Apigee in VS Code, consulta Creazione del primo proxy API utilizzando Apigee in VS Code.

Deployment dei proxy API

Puoi creare ambienti in cui eseguire il deployment dei proxy API. La distinzione tra i diversi ambienti è arbitraria: ogni ambiente viene semplicemente identificato da un insieme diverso di indirizzi di rete (URL). L'obiettivo è fornirti un dominio in cui creare e verificare i proxy API prima che l'API venga esposta a sviluppatori esterni. Per saperne di più, vedi Informazioni sugli ambienti e sui gruppi di ambienti.

Eseguendo il deployment delle tue API in più ambienti, puoi isolare il traffico tra i proxy API su cui stai lavorando in un ambiente di test e quelli a cui le app esterne accedono in fase di runtime in un ambiente di produzione.

Apigee supporta i seguenti tipi di deployment in un ambiente:

Tipo Descrizione
Proxy Sviluppa e testa i proxy API nei tuoi ambienti di sviluppo Apigee, quindi esegui il deployment in ambienti di produzione e test di integrazione Apigee. Consulta Deployment di un proxy API.
Archivia Sviluppa e testa i proxy API programmabili utilizzando Apigee in VS Code.

Aggiunta di criteri

Apigee ti consente di programmare il comportamento delle API senza scrivere alcun codice utilizzando i criteri. Un criterio è come un modulo che implementa una funzione di gestione specifica e limitata. I criteri sono progettato per consentirti di aggiungere tipi comuni di funzionalità di gestione a un'API in modo semplice e affidabile. I criteri offrono funzionalità come sicurezza, limitazione di frequenza, trasformazione e mediazione evitando di dover scrivere codice e gestire autonomamente questa funzionalità. Tu può anche scrivere script e codice personalizzati (come applicazioni JavaScript) che estendono il proxy API funzionalità e ti consentono di innovare oltre alle funzionalità di gestione di base supportate secondo i criteri di Apigee. Per ulteriori informazioni sui criteri di Apigee, consulta la sezione Che cos'è una norma?

Apigee offre criteri pronti all'uso per varie funzionalità, come la gestione del traffico, sulla mediazione ed estensioni. Per visualizzare l'elenco completo dei criteri disponibili in Apigee, vedi Panoramica dei riferimenti alle norme.

Promozione alla produzione

Sei tu a scegliere dove eseguire il deployment di un'API. Ad esempio, puoi promuovere una revisione in un ambiente di produzione per consentire agli sviluppatori di iniziare lavorare con l'API. Allo stesso tempo, potresti ripetere più revisioni in un ambiente locale o di test, in cui aggiungi funzionalità o criteri di ottimizzazione. Quando è tutto pronto, puoi eseguire il deployment della nuova revisione nell'ambiente di produzione, sovrascrivendo la revisione esistente nell'ambiente. Utilizzando questo metodo, puoi sempre avere a disposizione una revisione in tempo reale dell'API per gli sviluppatori durante lo sviluppo e il test di nuove funzionalità.

Creazione di script con l'API Apigee

Apigee fornisce un'API RESTful che consente di integrare il deployment e la gestione dei proxy API nel ciclo di vita di sviluppo del software (SDLC) della tua organizzazione. Ad esempio, per garantire la sicurezza, i requisiti di affidabilità e coerenza sono soddisfatti, un uso comune dell'API Apigee è la scrittura di script o codice eseguire il deployment dei proxy API a livello di programmazione e promuoverli da un ambiente all'altro, nell'ambito di un processo automatizzato più ampio.

Per ulteriori informazioni, consulta la pagina relativa all'API Apigee.

Gestione delle risorse dell'ambiente

Gli ambienti assicurano la segregazione di dati e risorse. Ad esempio, puoi configurare cache diverse in test e production ambienti a cui possono accedere solo i proxy API eseguiti in quell'ambiente. Inoltre, le chiavi API emesse in un ambiente di test non sono valide in un ambiente di produzione e viceversa.

Per un maggiore controllo durante la promozione, consigliamo di eseguire l'iterazione solo dei proxy API in un ambiente di test e di apportare il minor numero di modifiche necessarie per i proxy API distribuiti in un ambiente di produzione.

Per farlo, devi assicurarti che determinate risorse associate a ciascun ambiente siano configurate in modo da poter rimanere statiche in una configurazione proxy API.

  • Mappe chiave-valore (KVM): se l'ambito è l'ambiente, devi assicurarti che vengano utilizzate convenzioni di denominazione per consentire ai proxy API di per archiviare i dati senza richiedere modifiche alla configurazione durante la promozione. Per ulteriori informazioni, vedi Utilizzo delle mappe chiave-valore.
  • URL di destinazione. Capita spesso che i proxy API chiamino URL di backend diversi durante i test e la produzione. Puoi utilizzare le configurazioni TargetServer per creare configurazioni TargetEndpoint indipendenti dall'ambiente. Per ulteriori informazioni, vedi
  • Target callout di servizio: i callout di servizio possono utilizzare target diversi a seconda dell'ambiente, se, ad esempio, un ServiceCallout nell'ambiente di test utilizza un servizio demo. Consulta le norme relative a ServiceCallout.

Per rendere indipendenti dall'ambiente le configurazioni proxy API, puoi anche utilizzare istruzioni condizionali. È possibile utilizzare istruzioni condizionali create con la variabile environment.name per valutare dell'ambiente attuale prima di applicare un criterio o di eseguire il routing a un URL nel backend. Per ulteriori informazioni, consulta Condizioni con variabili di flusso.