Ora che hai configurato Google Cloud e la UI ibrida, nonché installato e configurato il tempo di esecuzione, puoi verificare che tutto funzioni insieme.
Questa sezione illustra i seguenti passaggi:
- Crea un nuovo proxy API nella UI di Apigee utilizzando la procedura guidata del proxy API
- Esegui il deployment del nuovo proxy nel cluster con l'interfaccia utente
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 proxy API.
Per creare un semplice proxy API utilizzando la procedura guidata del proxy API:
- Apri l'UI di Apigee in un browser.
- Seleziona Sviluppo > proxy API nella visualizzazione principale.
- Dall'elenco a discesa Ambiente, seleziona l'ambiente in cui vuoi creare un nuovo proxy API. Questa sezione presuppone che il nome dell'ambiente sia "test". Hai
creato almeno un ambiente nel Passaggio 5: aggiungi un ambiente.
L'interfaccia utente ibrida mostra un elenco di proxy API per l'ambiente. Se non hai ancora creato alcun proxy, l'elenco è vuoto.
- Fai clic su +Proxy in alto a destra. Viene avviata la procedura guidata del proxy API.
- Seleziona Proxy inverso (la più comune) e fai clic su Avanti.
Viene visualizzata la visualizzazione Dettagli proxy.
- Configura il proxy con le seguenti impostazioni:
- Proxy Name (Nome proxy): inserisci "myproxy". I passaggi rimanenti di questa sezione presuppongono che questo sia l'ID del tuo proxy.
- Proxy Base Path (Percorso base 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 abbinare e instradare le richieste in entrata al proxy API appropriato.
- (Facoltativo) Descrizione: inserisci una descrizione per il nuovo proxy API, ad esempio "Testing Apigee Apigee with a Simple proxy".
- 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 fittarget è ospitato 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:
- Tocca Avanti.
- Nella schermata Criteri, seleziona Passthrough (nessuna autorizzazione) come opzione di sicurezza.
- Tocca Avanti.
- Nella schermata Riepilogo, fai clic su Crea.
Il modello ibrido genera il proxy (a volte denominato il bundle proxy):
- Fai clic su Vai all'elenco dei proxy.
La pagina ibrida mostra la vista Proxy, che mostra un elenco dei proxy API. Il nuovo proxy dovrebbe essere in cima all'elenco, con un indicatore di stato grigio, che indica che il deployment non è stato ancora eseguito.
2. Esegui il deployment del tuo proxy nel cluster utilizzando l'interfaccia utente ibrida
Dopo aver creato un nuovo proxy, devi eseguirne il deployment per poterlo provare. Questa sezione descrive come eseguire il deployment del nuovo proxy utilizzando l'interfaccia utente ibrida.
Per eseguire il deployment di un proxy API nell'interfaccia utente ibrida:
- Nell'interfaccia utente ibrida, seleziona Sviluppo > proxy API.
Assicurati che l'ambiente "test" sia selezionato.
L'interfaccia utente mostra il nuovo proxy nell'elenco dei proxy:
Fai clic sul proxy "myproxy".
La UI mostra la scheda Proxy Proxy per il proxy in questione.
Nota che nella sezione Deployment, la colonna Revisione mostra "Non implementato".
- 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 "undeploy".
Seleziona "1" (la revisione da implementare) nell'elenco a discesa.
La UI richiede di confermare il deployment:
- Fai clic su Esegui il deployment.
L'interfaccia utente inizia il processo di deployment della revisione 1 del nuovo proxy nel cluster.
Tieni presente che il deployment non è un processo istantaneo. Il modello di deployment "ibrido" a coerenza finale significa che verrà implementato nel cluster un nuovo deployment in un breve periodo di tempo e non immediatamente.
Anche se esistono diversi modi per controllare lo stato del deployment di un proxy nell'interfaccia utente, i prossimi due passaggi spiegano come chiamare il proxy API che hai appena sottoposto a deployment e come controllare lo stato del deployment con una chiamata alle API Apigee.
3. Chiama il proxy API
Quando l'UI indica che è stato eseguito il deployment del tuo proxy, puoi provare a chiamarlo utilizzando il client cURL o REST. 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 ha esito positivo, viene visualizzato il seguente output:
Hello, Guest!
Se hai utilizzato un certificato autofirmato e viene visualizzato 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 della porta in entrata 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