Passaggio 10: esegui il deployment di un proxy API

Al momento stai visualizzando la versione 1.9 della documentazione di Apigee hybrid. Per saperne di più, consulta Versioni supportate.

Version 1.9 (unsupported)

Versioni supportate:

• v1.12 (più recente)                        
• Versione 1.11                         
• Versione 1.10                                        
• Elenco delle versioni supportate

Versioni non supportate:

• Versione 1.9                                         
• Versione 1.8                                         
• Versione 1.7                                         
• Versione 1.6                                         
• Versione 1.5                                         
• Versione 1.4                                         
• Versione 1.3                                         
• Versione 1.2                                         
• Versione 1.1                                         

Ora che hai configurato Google Cloud e la UI di Apigee e installato e configurato il runtime, puoi vedere come funzionano insieme.

1. Crea un nuovo proxy API utilizzando l'interfaccia utente di Apigee

Questa sezione descrive come creare un nuovo proxy API nell'interfaccia utente utilizzando la procedura guidata API proxy.

Nota: è disponibile una nuova versione dell'interfaccia utente di Apigee, integrata con la console Google Cloud. La nuova UI si chiama Apigee nella console Cloud. Le istruzioni nelle prime due schede di seguito spiegano come utilizzare Apigee nella console Cloud o Apigee versione classica.

Apigee nella console Cloud

Per creare un nuovo proxy API utilizzando Apigee nella console Cloud:

1. Apri la UI di Apigee nella console Cloud in un browser.
2. Seleziona la tua organizzazione dal menu a discesa nell'angolo in alto a sinistra.
3. Seleziona Sviluppo proxy > Proxy API nella visualizzazione principale.
4. Fai clic su Crea.Viene avviata la procedura guidata proxy API.
5. Seleziona proxy inverso (opzione più comune).

   Viene visualizzata la visualizzazione Dettagli proxy.

6. Configura il proxy con le seguenti impostazioni:
   • Nome proxy:inserisci myproxy. I passaggi rimanenti in questa sezione presuppongono che questo sia l'ID del proxy.
   • Percorso di base: impostato automaticamente su / seguito dal nome del proxy, che in questo esempio è /myproxy. Il percorso di base fa parte dell'URL utilizzato per effettuare richieste all'API. Edge utilizza l'URL per associare e instradare le richieste in entrata al proxy API appropriato.
   • (Facoltativo) Descrizione: inserisci una descrizione per il nuovo proxy API, ad esempio "Test di Apigee hybrid con un proxy semplice".
   • Target (API esistente): inserisci "https://mocktarget.apigee.net". Questo definisce l'URL di destinazione che Apigee richiama su una richiesta al proxy API. Il servizio fittizio è ospitato su Apigee e restituisce dati semplici. Non richiede chiavi API o token di accesso.

   I dettagli del proxy API dovrebbero avere il seguente aspetto:

   

7. Tocca Avanti.
8. Nella schermata Criteri, seleziona Passthrough (nessuna autorizzazione) come opzione di sicurezza.
9. Tocca Avanti.
10. In Esegui il deployment (facoltativo), nel campo Ambienti di deployment, puoi selezionare uno o più ambienti in cui eseguire il deployment del proxy. Se preferisci non eseguire il deployment del proxy in questo momento, lascia vuoto il campo Ambienti di deployment. Puoi sempre eseguire il deployment del proxy in un secondo momento.
11. Fai clic su Crea. Apigee genera il proxy (a volte indicato come pacchetto proxy).

Apigee mostra la visualizzazione Riepilogo proxy. Se hai scelto di eseguire il deployment del proxy, la sezione Deployment mostra il numero di Revisione, che è 1 al primo deployment. La colonna Stato mostra gli ambienti in cui viene eseguito il deployment del proxy con un indicatore di stato verde.

Sotto, viene visualizzata la sezione Endpoint:

• Endpoint del proxy: il percorso di base impostato per il proxy, che in questo esempio è /myproxy.
• Endpoint di destinazione: il percorso di base impostato per la destinazione, che in questo esempio è https://mocktarget.apigee.net.

Versione classica di Apigee

Per creare un nuovo proxy API utilizzando la versione classica di Apigee:

1. Apri l'UI di Apigee in un browser.
2. Seleziona la tua organizzazione dal menu a discesa nell'angolo in alto a sinistra.
3. Seleziona Sviluppo > Proxy API nella visualizzazione principale.
4. Fai clic su Crea nuovo.Viene avviata la procedura guidata proxy API.
5. Seleziona proxy inverso (opzione più comune).

   Viene visualizzata la visualizzazione Dettagli proxy.

6. Configura il proxy con le seguenti impostazioni:
   • Nome proxy:inserisci "myproxy". I passaggi rimanenti in questa sezione presuppongono che questo sia l'ID del proxy.
   • Percorso di base del proxy:impostato automaticamente su "/myproxy". Il percorso di base del proxy fa parte dell'URL utilizzato per effettuare richieste all'API. Edge utilizza l'URL per associare e instradare le richieste in entrata al proxy API appropriato.
   • (Facoltativo) Descrizione: inserisci una descrizione per il nuovo proxy API, ad esempio "Test di Apigee hybrid con un proxy semplice".
   • Target (API esistente): inserisci "https://mocktarget.apigee.net". Questo definisce l'URL di destinazione che Apigee richiama su una richiesta al proxy API. Il servizio fittizio è ospitato su Apigee e restituisce dati semplici. Non richiede chiavi API o token di accesso.

   I dettagli del proxy API dovrebbero avere il seguente aspetto:

   

7. Tocca Avanti.
8. Nella schermata Criteri, seleziona Passthrough (nessuna autorizzazione) come opzione di sicurezza.
9. Tocca Avanti.
10. Nella schermata Riepilogo, seleziona un ambiente in cui eseguire il deployment del proxy e fai clic su Crea e implementa.

    Hybrid genera il proxy (a volte indicato come pacchetto proxy):

    

11. Fai clic su Vai all'elenco dei proxy.

    Apigee mostra la vista proxy, che include un elenco di proxy API. Il nuovo proxy dovrebbe essere visualizzato con un indicatore di stato verde, che indica che il deployment è stato eseguito.

2. Chiamare il proxy API

Quando la UI indica che è stato eseguito il deployment del proxy, puoi provare a chiamarlo utilizzando cURL o il client REST di tua scelta. Ad esempio:

1. Assicurati che la variabile di ambiente DOMAIN sia impostata sul nome di dominio utilizzato come nome host per il gruppo di ambienti in Configurazione di progetti e organizzazioni - Passaggio 3: crea un gruppo di ambienti.

   echo $DOMAIN

2. Trova l'indirizzo IP esterno e la porta del gateway in entrata Apigee con il seguente comando:

   kubectl get svc -n apigee -l app=apigee-ingressgateway

   L'output dovrebbe essere simile al seguente:

   NAME                                        TYPE           CLUSTER-IP    EXTERNAL-IP     PORT(S)                                      AGE
   apigee-ingressgateway-prod-hybrid-37a39bd   LoadBalancer   192.0.2.123   233.252.0.123   15021:32049/TCP,80:31624/TCP,443:30723/TCP   16h

3. Esporta l'IP esterno e la porta in variabili:

   export INGRESS_IP_ADDRESS=EXTERNAL_IP_ADDRESS
   export INGRESS_PORT=PORT_NUMBER

4. Chiama il proxy API:

   curl  -H Host:$DOMAIN --resolve \
     $DOMAIN:$INGRESS_PORT:$INGRESS_IP_ADDRESS  \
     https://$DOMAIN:$INGRESS_PORT/myproxy -k

   Ad esempio:

   curl  -H Host:example.com --resolve example.com:443:233.252.0.123 https://example.com:443/myproxy -k

Per scoprire di più sulla creazione e sul deployment dei proxy API, vedi Creare la prima panoramica del proxy.

Congratulazioni!

Hai installato Apigee hybrid. Per scoprire di più sulla creazione e sul deployment dei proxy API, consulta Introduzione alla creazione di proxy API.