Creazione e deployment di un nuovo proxy API

Ora che hai configurato Google Cloud e la UI ibrida, nonché installato e configurato runtime, puoi vedere come funziona.

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 la UI

1. Crea un nuovo proxy API utilizzando la UI ibrida

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

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

  1. Apri la UI di Apigee in un browser.
  2. Seleziona Sviluppo > Proxy API nella vista principale.
  3. Dall'elenco a discesa Ambiente, seleziona l'ambiente in cui vuoi per creare un nuovo proxy API. In questa sezione si presume che il nome dell'ambiente sia "test". Tu ha 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 ne hai ancora creata i proxy, l'elenco è vuoto.

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

    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 tuo proxy.
    • Percorso base del proxy: impostato automaticamente su "/myproxy". La base del proxy Il percorso fa parte dell'URL utilizzato per effettuare richieste all'API. Edge utilizza l'URL per per abbinare le richieste in entrata 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". Questo definisce il parametro URL di destinazione che Apigee richiama su una richiesta al proxy API. Il servizio mocktarget ospitati su Apigee e restituisce dati semplici. Non richiede una chiave API o un token di accesso.

    I dettagli del proxy API dovrebbero essere simili ai seguenti:

  7. Fai clic su Avanti.
  8. Nella schermata Norme, seleziona Passthrough (nessuna autorizzazione) come l'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 Vai all'elenco di proxy.

    Ibrido mostra la vista 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 eseguirne il deployment in modo da 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. Nella UI 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 pulsante "myproxy". proxy.

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

    Nota 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 è visualizzato solo "1" e "Annulla deployment".

  4. Seleziona "1" (la revisione di cui vuoi eseguire il deployment) 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 dell'API

Segui i passaggi di seguito, a seconda che tu possa aggiornare o meno il record DNS del nome host utilizzato per creare il gruppo di ambienti.

Se non riesci ad aggiornare il DNS del tuo nome host

Segui questi passaggi se il nome host del gruppo di ambienti non è registrato o se non riesci ad aggiornare il relativo record DNS. In questi passaggi, ottieni l'IP in entrata e lo utilizzi direttamente in una chiamata cURL con il flag --resolve:

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

Se riesci ad aggiornare il DNS del tuo nome host

Segui questi passaggi se il nome host che hai utilizzato durante la creazione del gruppo di ambienti è registrato e puoi aggiornare il relativo record DNS in modo che punti all'IP in entrata esterno:

  1. Esporta l'IP esterno del traffico in entrata in una variabile:
    export INGRESS_IP=$(kubectl -n istio-system get service \
      istio-ingressgateway -o jsonpath='{.status.loadBalancer.ingress[0].ip}')
  2. Verifica che la variabile contenga l'indirizzo IP. Ad esempio:
    echo $INGRESS_IP
    34.118.196.202
  3. Utilizza questo indirizzo IP per aggiornare il record DNS (di solito un record A o CNAME) presso il tuo registrar o provider DNS. Tu potrebbe essere necessario attendere fino a un'ora prima che la modifica del record DNS si propaghi.
  4. Esporta l'alias host del tuo gruppo di ambienti in una variabile:
    export HOSTALIAS=your_host_alias
  5. Chiama il proxy API:
    curl -k https://$HOSTALIAS/myproxy

    Ad esempio:

    curl -v -k https://apitest.acme.com/myproxy

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

    Hello, Guest!