Questa pagina si applica a Apigee e Apigee ibridi.
Visualizza la documentazione di Apigee Edge.
Cosa stai facendo in questo passaggio
Per creare ed eseguire il deployment di un proxy API di test, segui i passaggi riportati di seguito. Infine, testa il proxy API inviando una richiesta HTTP.
Crea ed esegui il deployment di un proxy API
La procedura di provisioning per Apigee non crea automaticamente un proxy API e non ne esegue il deployment. Devi creare e implementare un proxy manualmente.
UI di Apigee nella console Cloud
Per creare ed eseguire il deployment del primo proxy:
- Apri l'UI di Apigee nella console Cloud in un browser.
- Assicurati che il nome della tua organizzazione sia selezionato nel menu a discesa. nell'angolo in alto a sinistra dell'interfaccia utente. Il nome dell'organizzazione è uguale al nome del progetto Google Cloud.
- Nel riquadro di navigazione a sinistra, fai clic su Sviluppo proxy > Proxy API.
- Fai clic su + Crea.
Viene visualizzata la pagina Crea un proxy.
- Nella casella Modello di proxy, seleziona Proxy inverso (più comune).
- Nel passaggio 1: dettagli del proxy, configura il proxy con i seguenti valori:
Nome parametro Valore Nome proxy hello-world
Percorso di base /hello-world
Target (API esistente) mocktarget.apigee.net
- Fai clic su Avanti.
- Nel Passaggio 2: esegui il deployment (facoltativo):
- Ambienti di deployment: facoltativo. Utilizza le caselle di controllo per selezionare uno o più ambienti in cui implementare il proxy. Se preferisci non eseguire il deployment del proxy a questo punto, lascia la Il campo Ambienti di deployment è vuoto. Puoi sempre eseguire il deployment il proxy in un secondo momento.
- Service account: facoltativo. Collega un account di servizio al tuo deployment per consentire al proxy di accedere ai servizi Google Cloud, come specificato nel ruolo e nelle autorizzazioni dell'account di servizio.
- Fai clic su Crea.
Il nuovo proxy API viene creato e implementato nell'ambiente selezionato.
- Si apre la pagina Riepilogo proxy per il proxy appena creato. Un segno di spunta verde in Stato indica che il proxy è stato disegnato correttamente. Se il deployment del proxy non è stato eseguito, consulta Esegui il deployment di un proxy API e segui i passaggi per eseguirne manualmente il deployment.
- Nel riquadro di navigazione a sinistra, seleziona Gestione > Ambienti > Gruppi di ambienti.
- Copia il nome host del gruppo di ambienti. Utilizzerai questo per chiamare il proxy API nei passaggi successivi.
Interfaccia utente di Apigee
Per creare ed eseguire il deployment del tuo primo proxy:
- Accedi all'interfaccia utente di Apigee.
- Assicurati che il nome della tua organizzazione sia selezionato nel menu a discesa nell'angolo in alto a sinistra dell'interfaccia utente. Il nome dell'organizzazione è uguale al nome del tuo progetto Google Cloud.
- Fai clic su Proxy API nella vista principale.
- Nell'elenco a discesa Seleziona ambiente, seleziona un ambiente.
- Fai clic su Crea nuova.
- Fai clic su Inverti proxy (più comune).
- Nella pagina Dettagli proxy, configura il proxy con
i seguenti valori:
Nome parametro Valore Nome hello-world
Percorso di base /hello-world
Target (API esistente) https://mocktarget.apigee.net
- Fai clic su Avanti.
- Nella pagina Criteri comuni, in Sicurezza: Autorizzazione seleziona Passthrough (nessuna autorizzazione).
- Fai clic su Avanti.
- Nella pagina Riepilogo, in Deployment facoltativo, seleziona l'ambiente in cui eseguire il deployment del proxy.
- Fai clic su Crea ed esegui il deployment.
Il nuovo proxy API è stato creato e il cui deployment viene eseguito nell'ambiente selezionato.
- Fai clic su Vai all'elenco di proxy. Un segno di spunta verde sotto Lo stato indica che il deployment del proxy è stato eseguito correttamente. Se il proxy non è di cui non è stato eseguito il deployment, consulta Esecuzione del deployment di un proxy API e segui i passaggi per eseguirlo manualmente.
- Nel riquadro di navigazione a sinistra, seleziona Amministrazione > Ambienti > Gruppi.
- Fai clic su Visualizza nella console Google Cloud.
- Copia il nome host per il gruppo di ambienti. Utilizzerai questo nome host per chiamare il proxy API nei passaggi successivi.
- Chiudi la console Google Cloud.
Chiama il proxy con accesso interno
Se hai consentito l'accesso interno in Passaggio 4: personalizza il routing dell'accesso, segui le istruzioni riportate in: Chiamata a un proxy API con accesso solo interno.
Chiama il proxy con accesso esterno
Se hai consentito l'accesso esterno in Passaggio 4: personalizza il routing degli accessi, segui questi passaggi:
- Configura una voce DNS per l'host. Ecco due modi per ottenere
questa attività:
- Nel tuo registrar, crea un record A che rimandi al nome host del tuo gruppo di ambienti
l'IP mostrato nella pagina della procedura guidata in Configura DNS. Ad esempio, se
il nome host è
sales.example.com
e l'IP è 10.23.0.2, quindi punta la record persales.example.com
all'indirizzo10.23.0.2
. - Utilizza Google Cloud DNS per mappare un URL a un indirizzo IP.
- Nel tuo registrar, crea un record A che rimandi al nome host del tuo gruppo di ambienti
l'IP mostrato nella pagina della procedura guidata in Configura DNS. Ad esempio, se
il nome host è
- Testa il proxy API inviando la seguente richiesta in una finestra del terminale:
curl -v -H "Host:YOUR_ENV_GROUP_HOSTNAME" \ https://YOUR_INSTANCE_IP_OR_DNS/hello-world
Dove:
- Il valore dell'intestazione
Host
(YOUR_ENV_GROUP_HOSTNAME) è il nome host in Ambienti > Pagina Gruppi di ambienti.
Una richiesta riuscita restituisce la stringa
Hello, Guest!
. Se la richiesta non ha esito positivo, consulta la sezione Risoluzione dei problemi. - Il valore dell'intestazione
Passaggi successivi
- Fai un tour di Apigee tutorial, tra cui: