Passaggi successivi consigliati

Questa pagina si applica ad Apigee e Apigee hybrid.

Visualizza la documentazione di Apigee Edge.

Attività di 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 e 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.

Interfaccia utente di Apigee nella console Cloud

Per creare ed eseguire il deployment del tuo primo proxy:

  1. Apri la UI di Apigee nella console Cloud in un browser.
  2. 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.
  3. Nel riquadro di navigazione a sinistra, fai clic su Sviluppo proxy > Proxy API.
  4. Fai clic su + Crea.

    Viene visualizzata la pagina Crea un proxy.

  5. Nella casella Modello proxy, seleziona Proxy inverso (il più comune).
  6. Nel passaggio 1: dettagli del proxy, configura il proxy con i seguenti valori:
    Nome parametro Valore
    Nome del proxy hello-world
    Percorso di base /hello-world
    Target (API esistente) mocktarget.apigee.net
  7. Fai clic su Avanti.
  8. In 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 in questo momento, lascia vuoto il campo Ambienti di deployment. Puoi sempre eseguire il deployment del 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.
  9. Fai clic su Crea.

    Il nuovo proxy API viene creato e implementato nell'ambiente selezionato.

  10. Viene visualizzata la pagina Riepilogo del proxy del proxy appena creato. Un segno di spunta verde in Stato indica che il proxy è stato disegnato correttamente. Se il proxy non è di cui non è stato eseguito il deployment, consulta Eseguire il deployment di un proxy API e segui i passaggi per eseguirlo manualmente.
  11. Nel riquadro di navigazione a sinistra, seleziona Gestione > Ambienti > Gruppi di ambienti.
  12. Copia il nome host per il gruppo di ambienti. Utilizzerai questo hostname per chiamare il proxy API nei passaggi successivi.

Interfaccia utente di Apigee

Per creare ed eseguire il deployment del tuo primo proxy:

  1. Accedi all'interfaccia utente di Apigee.
  2. 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.
  3. Fai clic su Proxy API nella visualizzazione principale.
  4. Nell'elenco a discesa Seleziona ambiente, seleziona un ambiente.
  5. Fai clic su Crea nuova.
  6. Fai clic su Proxy inverso (il più comune).
  7. Nella pagina Dettagli del 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
  8. Fai clic su Avanti.
  9. Nella pagina Criteri comuni, in Sicurezza: Autorizzazione, seleziona Passa (nessuna autorizzazione).
  10. Fai clic su Avanti.
  11. Nella pagina Riepilogo, in Deployment facoltativo, seleziona l'ambiente in cui eseguire il deployment del proxy.
  12. Fai clic su Crea ed esegui il deployment.

    Il nuovo proxy API viene creato e implementato nell'ambiente selezionato.

  13. Fai clic su Vai all'elenco di proxy. Un segno di spunta verde in Stato indica che il proxy è stato disegnato 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.
  14. Nel riquadro di navigazione a sinistra, seleziona Amministrazione > Ambienti > Gruppi.
  15. Fai clic su Visualizza nella console Google Cloud.
  16. Copia il nome host per il gruppo di ambienti. Utilizzerai questo nome host per chiamare il proxy API nei passaggi successivi.
  17. 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:

  1. Configura una voce DNS per l'host. Ecco due modi per svolgere questa operazione:
    • Nel tuo registrar, crea un record A che indichi il nome host del gruppo di ambienti all'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, indirizza il record per sales.example.com all'indirizzo 10.23.0.2.
    • Utilizza Cloud DNS di Google per mappare un URL a un indirizzo IP.
  2. 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 della pagina Ambienti > Gruppi di ambienti.

    Una richiesta riuscita restituisce la stringa Hello, Guest!. Se la richiesta non va a buon fine, consulta la sezione Risoluzione dei problemi.

Passaggi successivi