Ora che hai configurato Google Cloud e la UI di Apigee e installato e configurato runtime, puoi vedere come funziona.
1. Crea un nuovo proxy API utilizzando la UI di Apigee
Questa sezione descrive come creare un nuovo proxy API nell'interfaccia utente utilizzando la procedura guidata API Proxy.
Apigee nella console Cloud
Per creare un nuovo proxy API utilizzando Apigee nella console Cloud:
- Apri la UI di Apigee nella console Cloud in un browser.
- Seleziona la tua organizzazione dal menu a discesa nell'angolo in alto a sinistra.
- Seleziona Sviluppo proxy > Proxy API nella visualizzazione principale.
- Fai clic su Crea.Viene avviata la procedura guidata del proxy API.
- Seleziona Inverti proxy (più comune).
Viene visualizzata la visualizzazione Dettagli del proxy.
- Configura il proxy con le seguenti impostazioni:
- Nome del proxy: inserisci myproxy. I passaggi rimanenti di questa sezione presuppongono che questo sia l'ID del proxy.
- Percorso di base: impostato automaticamente su / seguito dal che in questo esempio è /myproxy. La base fa parte dell'URL utilizzato per effettuare richieste all'API. Edge utilizza l'URL per le richieste in entrata e il routing al proxy API corretto.
- (Facoltativo) Descrizione:inserisci una descrizione per il nuovo proxy API, ad esempio come "Testing Apigee hybrid con un proxy semplice".
- Target (API esistente): inserisci "https://mocktarget.apigee.net". Questo definisce il parametro URL di destinazione che Apigee richiama su una richiesta al proxy API. Il servizio mocktarget ospitati su Apigee e restituisce dati semplici. Non richiede chiavi API o token di accesso.
I dettagli del proxy API dovrebbero essere simili ai seguenti:
- Fai clic su Avanti.
- In Esegui il deployment (facoltativo), puoi selezionare una o più opzioni ambienti in cui eseguire il deployment del proxy, nel campo Ambienti di deployment. Se preferisci non eseguire il deployment del proxy a questo indirizzo lascia vuoto il campo Ambienti di deployment. Puoi sempre eseguire il deployment il proxy in un secondo momento.
- Fai clic su Crea. Apigee genera il proxy (a volte indicato come pacchetto proxy).
Apigee visualizza la visualizzazione Riepilogo proxy. Se hai scelto di eseguire il deployment del proxy, la sezione Deployment mostra la Revisione. che è 1 al momento del primo deployment. La colonna Stato mostra degli ambienti in cui viene eseguito il deployment del proxy con un indicatore di stato verde.
Sotto questo valore, la sezione Revisioni mostra tutte le revisioni apportate al proxy. Di facendo clic su uno degli elementi VIEW (VISTA) nella colonna Endpoint summary (Riepilogo endpoint), 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 il target, che in questo
un esempio è
https://mocktarget.apigee.net
.
Versione classica di Apigee
Per creare un nuovo proxy API utilizzando la versione classica di Apigee:
- Apri la UI di Apigee in un browser.
- Seleziona la tua organizzazione dal menu a discesa nell'angolo in alto a sinistra.
- Seleziona Sviluppo > Proxy API nella vista principale.
- Fai clic su Crea nuovo.Viene avviata la procedura guidata del proxy API.
- Seleziona Inverti proxy (più comune).
Viene visualizzata la visualizzazione Dettagli del proxy.
- Configura il proxy con le seguenti impostazioni:
- Nome del proxy: inserisci "myproxy". I passaggi rimanenti di questa sezione presuppongono che questo sia l'ID del proxy.
- Percorso di base del proxy: impostato automaticamente su "/myproxy". La base del proxy Percorso fa parte dell'URL utilizzato per effettuare richieste all'API. Edge utilizza l'URL per le richieste in entrata e il routing al proxy API corretto.
- (Facoltativo) Descrizione:inserisci una descrizione per il nuovo proxy API, ad esempio come "Testing Apigee hybrid con un proxy semplice".
- Target (API esistente): inserisci "https://mocktarget.apigee.net". Questo definisce il parametro URL di destinazione che Apigee richiama su una richiesta al proxy API. Il servizio mocktarget ospitati su Apigee e restituisce dati semplici. Non richiede chiavi API o token di accesso.
I dettagli del proxy API dovrebbero essere simili ai seguenti:
- Fai clic su Avanti.
- Nella schermata Norme comuni, seleziona Passthrough (nessuna autorizzazione) come l'opzione di sicurezza.
- Fai clic su Avanti.
- Nella schermata Riepilogo, seleziona un ambiente in cui eseguire il deployment del proxy
Fai clic su Crea ed esegui il deployment.
Il proxy ibrido genera il proxy (a volte indicato come pacchetto proxy) e ne esegue il deployment nell'ambiente selezionato.
- Fai clic su Vai all'elenco dei proxy.
Apigee mostra la vista Proxy, che mostra un elenco di proxy API. Il tuo Il nuovo proxy dovrebbe essere visualizzato con un indicatore di stato verde che indica che il deployment è stato eseguito.
2. Chiama il proxy API
Quando la UI indica che è stato eseguito il deployment del proxy, puoi provare a chiamarlo utilizzando cURL o REST a un client di tua scelta. Ad esempio:
- Assicurati che la variabile di ambiente
DOMAIN
sia impostata sul nome di dominio che hai utilizzato il nome host del tuo gruppo di ambienti in Progetto e organizzazione configurazione - Passaggio 3: crea un gruppo di ambienti.echo $DOMAIN
-
Trova l'indirizzo IP esterno e la porta del gateway Apigee in entrata 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
- Esporta l'IP esterno e la porta nelle variabili:
export INGRESS_IP_ADDRESS=EXTERNAL_IP_ADDRESS
export INGRESS_PORT=PORT_NUMBER
- 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, consulta Creazione della panoramica del proxy.