Creazione e deployment di un nuovo proxy API

Ora che hai configurato Google Cloud e l'interfaccia utente ibrida e hai installato e configurato il runtime, puoi scoprire come funzionano insieme.

Questa sezione illustra quanto segue:

  1. Crea un nuovo proxy API nell'interfaccia utente di Apigee utilizzando la procedura guidata Proxy API
  2. Esegui il deployment del nuovo proxy nel cluster con l'interfaccia utente

1. Creare 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 Proxy API.

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

  1. Apri UI Apigee in un browser.
  2. Seleziona Sviluppa > Proxy API nella visualizzazione principale.
  3. Nell'elenco a discesa Ambiente, seleziona l'ambiente in cui vuoi creare un nuovo proxy API. In questa sezione si presume che il nome dell'ambiente sia "test". Hai creato almeno un ambiente nel passaggio 5: Aggiungi un ambiente.

    L'interfaccia utente ibrida mostra un elenco di proxy API per l'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 del proxy: inserisci "myproxy". I passaggi rimanenti di questa sezione presuppongono che questo sia l'ID del tuo proxy.
    • Percorso base del proxy: impostato automaticamente su "/myproxy". Il percorso base del proxy fa parte dell'URL utilizzato per inviare 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 invocato da Apigee su una richiesta al proxy API. Il servizio mocktarget è ospitato su Apigee e restituisce dati semplici. Non richiede una chiave API o un token di accesso.

    I dettagli del proxy API dovrebbero avere il seguente aspetto:

  7. Fai clic su Avanti.
  8. Nella schermata Norme, seleziona Passa tutto (nessuno) come opzione di sicurezza.
  9. Fai clic su Avanti.
  10. Nella schermata Riepilogo, fai clic su Crea.

    Hybrid genera il proxy (a volte chiamato bundle del proxy):

  11. Fai clic su Esci.

    Hybrid mostra la visualizzazione Proxy, che mostra un elenco di proxy API. Il nuovo proxy dovrebbe trovarsi nella parte superiore dell'elenco, con un indicatore di stato grigio, a indicare che non è stato ancora disegnato.

2. Esegui il deployment del proxy nel cluster utilizzando l'interfaccia utente ibrida

Dopo aver creato un nuovo proxy, devi eseguirlo per poterlo provare. Questa sezione descrive come eseguire il deployment del nuovo proxy utilizzando l'interfaccia utente ibrida.

Per eseguire il deployment di un proxy API nell'interfaccia utente ibrida:

  1. Nell'interfaccia utente ibrida, seleziona Sviluppa > Proxy API.

    Assicurati che sia selezionato l'ambiente "test".

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

  2. Fai clic sul proxy "myproxy".

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

    Tieni presente che in Deployment, la colonna Revisione mostra "Non implementato".

  3. Nella colonna Revisione, espandi il selettore del menu a discesa per scegliere la revisione da implementare.

    L'elenco a discesa mostra solo "1" e "Esegui il ritiro".

  4. Seleziona "1", la revisione che vuoi implementare, dall'elenco a discesa.

    L'interfaccia utente ti chiede di confermare il deployment:

  5. Fai clic su Esegui il deployment.

    L'interfaccia utente 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 "eventualmente coerente" di Hybrid indica che un nuovo deployment verrà implementato nel cluster in un breve periodo di tempo e non immediatamente.

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

3. Chiama il proxy API

Quando l'interfaccia utente indica che il proxy è dipiegato, puoi provare a chiamarlo:

  1. Se hai utilizzato il carattere jolly "*" per la proprietà envs.hostAlias come indicato in Configurare il cluster, segui questi passaggi prima di continuare:
    1. Ottieni l'IP esterno per il servizio istio-ingressgateway. Ad esempio: 
      kubectl get services -n istio-system

      L'output sarà simile al seguente, dove 34.68.41.240 è l'indirizzo IP di ingresso esterno:

      NAME                       TYPE           CLUSTER-IP      EXTERNAL-IP      PORT(S)
istio-ingressgateway       LoadBalancer   10.43.255.19    34.68.41.240      80:31381/TCP,443:31391
    2. Copia il valore di EXTERNAL-IP da utilizzare nel passaggio successivo. In questo esempio, dovresti copiare 34.68.41.240.
  2. Chiama il proxy utilizzando cURL o il client REST che preferisci: 
    curl -v -k https://34.68.41.240/myproxy

    Se la chiamata va a buon fine, viene visualizzato il seguente output:

    Hello, Guest!