Passaggi successivi consigliati

Questa pagina si applica ad Apigee e Apigee hybrid.

Visualizza la documentazione di Apigee Edge.

Cosa fai in questo passaggio

Per creare e implementare un proxy API di test, segui i passaggi riportati di seguito. Infine, testa il proxy API inviandogli una richiesta HTTP.

Creazione e deployment di un proxy API

Il processo di provisioning per Apigee non crea e non esegue automaticamente il deployment di un proxy API. Devi creare e implementare un proxy manualmente.

UI Apigee nella console Cloud

Per creare ed eseguire il deployment del tuo primo proxy:

  1. Nella console Google Cloud , vai alla pagina Sviluppo proxy > Proxy API.

    Vai ai proxy API

  2. Assicurati che il nome della tua organizzazione sia selezionato dal selettore di progetti nel riquadro Google Cloud. Il nome dell'organizzazione è lo stesso del nome del tuo Google Cloud progetto.
  3. Fai clic su + Crea.

    Viene visualizzata la pagina Crea un proxy.

  4. Nella casella Modello proxy, seleziona Reverse proxy (il più comune).
  5. In Passaggio 1: dettagli del proxy, configura il proxy con i seguenti valori:
    Nome parametro Valore
    Nome proxy hello-world
    Percorso base /hello-world
    Target (API esistente) mocktarget.apigee.net
  6. Fai clic su Avanti.
  7. Nel passaggio 2: implementa (facoltativo):
    • Deployment environments (ambienti di deployment): facoltativo. Utilizza le caselle di controllo per selezionare uno o più ambienti in cui eseguire il deployment del 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 del account di servizio.
  8. Fai clic su Crea.

    Il nuovo proxy API viene creato e sottoposto a deployment nell'ambiente selezionato.

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

Apigee classico

Per creare ed eseguire il deployment del tuo primo proxy:

  1. Accedi alla UI Apigee.
  2. Assicurati che il nome della tua organizzazione sia selezionato dal menu a discesa nell'angolo in alto a sinistra dell'interfaccia utente. Il nome dell'organizzazione è lo stesso del nome del tuo progetto Google Cloud.
  3. Fai clic su Proxy API nella visualizzazione principale.
  4. Dall'elenco a discesa Seleziona ambiente, seleziona un ambiente.
  5. Fai clic su Crea nuova.
  6. Fai clic su Reverse proxy (il più comune).
  7. Nella pagina Dettagli proxy, configura il proxy con i seguenti valori:
    Nome parametro Valore
    Nome hello-world
    Percorso base /hello-world
    Target (API esistente) https://mocktarget.apigee.net
  8. Fai clic su Avanti.
  9. Nella pagina Norme comuni, in Sicurezza: Autorizzazione, seleziona Pass-through (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 sottoposto a deployment nell'ambiente selezionato.

  13. Fai clic su Vai all'elenco dei proxy. Un segno di spunta verde in Stato indica che il proxy è stato implementato correttamente. Se il proxy non è stato eseguito il deployment, consulta 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 Google Cloud console.

Chiama il proxy con accesso interno

Se hai consentito l'accesso interno nel 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 nel passaggio 4: personalizza il routing degli accessi, segui questi passaggi:

  1. Configura una voce DNS per l'host. Ecco due modi per svolgere questa attività:
    • Nel registrar, crea un record A che indirizzi il nome host del gruppo di ambienti all'IP mostrato nella pagina della procedura guidata in Configura DNS. Ad esempio, se il tuo nome host è sales.example.com e l'IP è 10.23.0.2, punta il record per sales.example.com all'indirizzo 10.23.0.2.
    • Utilizza Google Cloud DNS 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