Passaggio 10: esegui il deployment di un proxy API

Ora che hai configurato Google Cloud e la UI di Apigee e installato e configurato il runtime, puoi iniziare a vedere come funziona insieme.

1. Crea un nuovo proxy API utilizzando la UI di Apigee

Questa sezione descrive come creare un nuovo proxy API nell'interfaccia utente utilizzando la procedura guidata API Proxy.

Per creare un semplice proxy API con la procedura guidata API Proxy:

  1. Apri la UI di Apigee in un browser.
  2. Seleziona la tua organizzazione dal menu a discesa nell'angolo in alto a sinistra.
  3. Seleziona Develop > API Proxy nella vista principale.
  4. Fai clic su Crea nuovo.Viene avviata la procedura guidata del proxy API.
  5. Seleziona Inverti proxy (più comune).

    Viene visualizzata la visualizzazione Dettagli del proxy.

  6. 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 proxy.
    • Percorso di base del 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 trovare corrispondenze e instradare le richieste in entrata al proxy API corretto.
    • (Facoltativo) Descrizione:inserisci una descrizione per il nuovo proxy API, ad esempio "Test di Apigee hybrid con un proxy semplice".
    • Target (API esistente): inserisci "https://mocktarget.apigee.net". Definisce l'URL di destinazione che Apigee richiama su una richiesta al proxy API. Il servizio mocktarget è ospitato su Apigee e restituisce dati semplici. Non richiede chiavi API o token di accesso.

    I dettagli del proxy API dovrebbero essere simili ai seguenti:

  7. Fai clic su Avanti.
  8. Nella schermata Criteri, seleziona Passthrough (nessuna autorizzazione) come opzione di sicurezza.
  9. Fai clic su Avanti.
  10. Nella schermata Riepilogo, seleziona un ambiente in cui eseguire il deployment del proxy e fai clic su Crea ed esegui il deployment.

    Il proxy ibrido genera il proxy (a volte indicato come pacchetto di proxy):

  11. Fai clic su Vai all'elenco dei proxy.

    Apigee mostra la vista Proxy, che mostra un elenco di proxy API. Il nuovo proxy dovrebbe essere visualizzato con un indicatore di stato verde che indica che il deployment è stato eseguito.

2. Chiama il proxy API

Quando la UI indica che il deployment del proxy è stato eseguito, puoi provare a chiamarlo utilizzando cURL o il client REST che preferisci. Ad esempio:

  1. Assicurati che la variabile di ambiente DOMAIN sia impostata sul nome di dominio utilizzato per il nome host del gruppo di ambiente in Configurazione di progetto e organizzazione - Passaggio 3: crea un gruppo di ambienti.
    echo $DOMAIN
  2. Trova l'indirizzo IP esterno e la porta del gateway Apigee in entrata con il seguente comando:

    kubectl get svc -n apigee -l app=apigee-ingressgateway

    L'output dovrebbe essere simile al seguente:

    NAME                                        TYPE           CLUSTER-IP    EXTERNAL-IP     PORT(S)                                      AGE
    apigee-ingressgateway-prod-hybrid-37a39bd   LoadBalancer   192.0.2.123   233.252.0.123   15021:32049/TCP,80:31624/TCP,443:30723/TCP   16h
  3. Esporta l'IP esterno e la porta nelle variabili:
    export INGRESS_IP_ADDRESS=EXTERNAL_IP_ADDRESS
    export INGRESS_PORT=PORT_NUMBER
  4. Chiama il proxy API:
    curl  -H Host:$DOMAIN --resolve \
      $DOMAIN:$INGRESS_PORT:$INGRESS_IP_ADDRESS  \
      https://$DOMAIN:$INGRESS_PORT/myproxy -k

    Ad esempio:

    curl  -H Host:example.com --resolve example.com:443:233.252.0.123 https://example.com:443/myproxy -k

Per scoprire di più sulla creazione e sul deployment dei proxy API, consulta Creazione della panoramica del proxy.