Ora che hai configurato Google Cloud e la UI ibrida, nonché installato e configurato runtime, puoi vedere come funziona.
Questa sezione illustra quanto segue:
- Crea un nuovo proxy API nella UI di Apigee utilizzando Procedura guidata proxy API
- Esegui il deployment del nuovo proxy nel cluster con la UI
1. Creare un nuovo proxy API utilizzando l'interfaccia utente ibrida
Questa sezione descrive come creare un nuovo proxy API nell'interfaccia utente utilizzando la procedura guidata API Proxy.
Per creare un proxy API semplice utilizzando la procedura guidata Proxy API:
- Apri la UI di Apigee in un browser.
- Seleziona Sviluppo > Proxy API nella vista principale.
- Nell'elenco a discesa Ambiente, seleziona l'ambiente in cui vuoi creare un nuovo proxy API. In questa sezione si presume che il nome dell'ambiente sia "test". Tu
ha creato almeno un ambiente nel Passaggio 5: aggiungi un ambiente.
La UI ibrida mostra un elenco di proxy API per l'ambiente. Se non hai ancora creato proxy, l'elenco è vuoto.
- Fai clic su +Proxy in alto a destra. Viene avviata la procedura guidata del proxy API.
- Seleziona Proxy inverso (il più comune) e fai clic su Avanti.
Viene visualizzata la visualizzazione Dettagli 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 tuo proxy.
- Percorso di base del proxy: viene impostato automaticamente su "/myproxy". Il percorso base del proxy fa parte dell'URL utilizzato per inviare 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 come "Testing Apigee hybrid con un proxy semplice".
- Target (API esistente): inserisci "https://mocktarget.apigee.net". Questo definisce l'URL di destinazione invocato da Apigee su una richiesta al proxy API. Il servizio mocktarget ospitati su Apigee e restituisce dati semplici. Non richiede una chiave API o un token di accesso.
I dettagli del proxy API dovrebbero avere il seguente aspetto:
- Fai clic su Avanti.
- Nella schermata Norme, seleziona Passthrough (senza autorizzazione) come opzione di sicurezza.
- Fai clic su Avanti.
- Nella schermata Riepilogo, fai clic su Crea.
Il proxy ibrido genera il proxy (a volte indicato come pacchetto di proxy):
- Fai clic su Vai all'elenco di proxy.
In Hybrid viene visualizzata la visualizzazione Proxy, che mostra un elenco di proxy API. La nuovo proxy dovrebbe essere in cima all'elenco, con un indicatore di stato grigio, a indicare che non è stato ancora eseguito il deployment.
2. Esegui il deployment del proxy nel cluster utilizzando l'interfaccia utente ibrida
Dopo aver creato un nuovo proxy, devi eseguirlo per poterlo provare. Questa sezione descrive come eseguire il deployment del nuovo proxy utilizzando la UI ibrida.
Per eseguire il deployment di un proxy API nella UI ibrida:
- Nella UI ibrida, seleziona Sviluppa > Proxy API.
Assicurati che sia selezionato l'ambiente "test".
La UI mostra il nuovo proxy nell'elenco dei proxy:
Fai clic sul proxy "myproxy".
L'interfaccia utente mostra la scheda Panoramica dei proxy API per il proxy in questione.
Nota che in Deployment, la colonna Revisione mostra "Deployment non eseguito".
- Nella colonna Revisione, espandi il selettore a discesa per scegliere la revisione
di cui eseguire il deployment.
L'elenco a discesa mostra solo "1" e "Esegui il ritiro".
Seleziona "1" (la revisione di cui vuoi eseguire il deployment) dall'elenco a discesa.
La UI ti chiede di confermare il deployment:
- Fai clic su Esegui il deployment.
La UI avvia il processo di deployment della revisione 1 del nuovo proxy nel cluster.
Tieni presente che il deployment non è un processo istantaneo. Il livello "conforme alla coerenza" di Hybrid consente di eseguire l'implementazione di un nuovo deployment nel cluster in un breve di tempo e non immediatamente.
Sebbene esistano diversi modi per controllare lo stato di implementazione di un proxy nell'interfaccia utente, i due passaggi successivi spiegano come chiamare il proxy API appena implementato e come controllare lo stato di implementazione con una chiamata alle API Apigee.
3. Chiama il proxy dell'API
Quando l'interfaccia utente indica del tuo proxy, puoi provare a chiamarlo utilizzando cURL o il client REST che preferisci. Ad esempio:
- Esporta l'alias host del gruppo di ambienti in una variabile:
$HOSTALIAS=your_host_alias
- Chiama il proxy API:
curl -k https://$HOSTALIAS/myproxy
Ad esempio:
curl -v -k https://apitest.acme.com/myproxy
Se la chiamata va a buon fine, viene visualizzato il seguente output:
Hello, Guest!
Se hai utilizzato un certificato autofirmato e ricevi un errore TLS/SSL, prova a seguire questi passaggi:
- Esporta l'alias host del gruppo di ambienti in una variabile:
$HOSTALIAS=your_host_alias
- Esporta l'host in entrata:
export INGRESS_HOST=$(kubectl -n istio-system get service \ istio-ingressgateway -o jsonpath='{.status.loadBalancer.ingress[0].ip}')
- Esporta il numero di porta di ingresso sicura:
export SECURE_INGRESS_PORT=$(kubectl -n istio-system get \ service istio-ingressgateway -o jsonpath='{.spec.ports[?(@.name=="https")].port}')
- Chiama il proxy API:
curl -H Host:$HOSTALIAS --resolve \ $HOSTALIAS:$SECURE_INGRESS_PORT:$INGRESS_HOST \ https://$HOSTALIAS:$SECURE_INGRESS_PORT/myproxy -k