Creazione e deployment di un nuovo proxy API

Ora che hai configurato Google Cloud e la UI ibrida e hai installato e configurato il runtime, puoi vedere come funzionano insieme.

Questa sezione illustra i seguenti argomenti:

  1. Crea un nuovo proxy API nella UI di Apigee utilizzando la procedura guidata per il proxy API
  2. Esegui il deployment del nuovo proxy nel cluster con la UI

1. Crea 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 API proxy.

Per creare un proxy API semplice utilizzando la procedura guidata per il proxy API:

  1. Apri l'UI di Apigee in un browser.
  2. Seleziona Sviluppo > Proxy API nella visualizzazione principale.
  3. 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.

    La UI ibrida mostra un elenco di proxy API per quell'ambiente. Se non hai ancora creato proxy, l'elenco è vuoto.

  4. Fai clic su +Proxy in alto a destra. Viene avviata la procedura guidata proxy API.
  5. Seleziona proxy inverso (il più comune) e fai clic su Avanti.

    Viene visualizzata la visualizzazione Dettagli proxy.

  6. Configura il proxy con le seguenti impostazioni:
    • Nome proxy:inserisci "myproxy". I passaggi rimanenti in 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 associare e instradare le richieste in entrata al proxy API appropriato.
    • (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". Questo definisce l'URL di destinazione che Apigee richiama su una richiesta al proxy API. Il servizio fittizio è ospitato su Apigee e restituisce dati semplici. Non richiede chiavi API o token di accesso.

    I dettagli del proxy API dovrebbero avere il seguente aspetto:

  7. Tocca Avanti.
  8. Nella schermata Criteri, seleziona Passthrough (nessuna autorizzazione) come opzione di sicurezza.
  9. Tocca Avanti.
  10. Nella schermata Riepilogo, fai clic su Crea.

    Hybrid genera il proxy (a volte indicato come pacchetto proxy):

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

    Ambiente ibrido mostra la vista proxy, con un elenco di 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 proxy nel cluster utilizzando l'interfaccia utente ibrida

Dopo aver creato un nuovo proxy, devi eseguirne il deployment in modo da poterlo provare. Questa sezione descrive come eseguire il deployment del nuovo proxy utilizzando la UI ibrida.

Per eseguire il deployment di un proxy API nella UI ibrida:

  1. Nella UI ibrida, seleziona Sviluppo > Proxy API.

    Assicurati che l'ambiente "test" sia selezionato.

    La UI mostra il nuovo proxy nell'elenco dei proxy:

  2. Fai clic sul proxy "myproxy".

    L'interfaccia utente mostra la scheda Panoramica proxy API per il proxy in questione.

    Tieni presente che in Deployment, la colonna Revisione mostra "Deployment non eseguito".

  3. Nella colonna Revisione, espandi il selettore a discesa per scegliere la revisione di cui eseguire il deployment.

    Nell'elenco a discesa sono visualizzati solo "1" e "Annulla deployment".

  4. Seleziona "1" dall'elenco a discesa, ovvero la revisione di cui vuoi eseguire il deployment.

    La UI richiede di confermare il deployment:

  5. Fai clic su Esegui il deployment.

    La UI avvia 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 "a coerenza finale " di ibrido prevede l'implementazione di un nuovo deployment nel cluster in un breve periodo di tempo, non immediatamente.

Sebbene esistano diversi modi per controllare lo stato di deployment di un proxy nell'interfaccia utente, i due passaggi successivi spiegano come chiamare il proxy API di cui hai appena eseguito il deployment e come controllare lo stato del deployment con una chiamata alle API Apigee.

3. Chiamare il proxy API

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

  1. Esporta l'alias host del gruppo di ambienti in una variabile: 
    $HOSTALIAS=your_host_alias
  2. 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, verrà visualizzato il seguente output:

    Hello, Guest!

Se hai utilizzato un certificato autofirmato e ricevi un errore TLS/SSL, prova a seguire questi passaggi:

  1. Esporta l'alias host del gruppo di ambienti in una variabile: 
    $HOSTALIAS=your_host_alias
  2. Esporta l'host in entrata: 
    export INGRESS_HOST=$(kubectl -n istio-system get service \
  istio-ingressgateway -o jsonpath='{.status.loadBalancer.ingress[0].ip}')
  3. Esporta il numero di porta in entrata sicura: 
    export SECURE_INGRESS_PORT=$(kubectl -n istio-system get \
  service istio-ingressgateway -o jsonpath='{.spec.ports[?(@.name=="https")].port}')
  4. Chiama il proxy API: 
    curl  -H Host:$HOSTALIAS --resolve \
  $HOSTALIAS:$SECURE_INGRESS_PORT:$INGRESS_HOST  \
  https://$HOSTALIAS:$SECURE_INGRESS_PORT/myproxy -k