Schritt 10: API-Proxy bereitstellen

Nachdem Sie Google Cloud und die Apigee-Benutzeroberfläche konfiguriert und die Laufzeit installiert und konfiguriert haben, können Sie sehen, wie sie zusammenwirken.

1. Einen neuen API-Proxy mithilfe der Apigee-Benutzeroberfläche erstellen

In diesem Abschnitt wird beschrieben, wie Sie einen neuen API-Proxy in der Benutzeroberfläche mithilfe des API-Proxy-Assistenten erstellen.

So erstellen Sie einen einfachen API-Proxy mit dem API-Proxy-Assistenten:

  1. Öffnen Sie die Apigee-UI in einem Browser.
  2. Wählen Sie Ihre Organisation links oben im Drop-down-Menü aus.
  3. Wählen Sie in der Hauptansicht Develop > API Proxies aus.
  4. Klicken Sie auf Neu erstellen. Der API-Proxy-Assistent wird gestartet.
  5. Wählen Sie Reverse-Proxy (wird am häufigsten verwendet) aus.

    Die Ansicht Proxy-Details wird angezeigt.

  6. Konfigurieren Sie den Proxy mit den folgenden Einstellungen:
    • Proxy Name: Geben Sie "myproxy" ein. In den verbleibenden Schritten in diesem Abschnitt wird davon ausgegangen, dass dies Ihre Proxy-ID ist.
    • Proxy-Basispfad: Wird automatisch auf "/myproxy" festgelegt. Der Proxy-Basispfad ist Teil der URL, die zum Senden von Anfragen an Ihre API verwendet wird. Edge verwendet die URL, um eingehende Anfragen zuzuordnen und an den richtigen API-Proxy weiterzuleiten.
    • (Optional) Beschreibung: Geben Sie eine Beschreibung für den neuen API-Proxy ein, z. B. "Apigee Hybrid mit einem einfachen Proxy testen".
    • Ziel (vorhandene API): Geben Sie "https://mocktarget.apigee.net" ein. Dies definiert die Ziel-URL, die Apigee für eine Anfrage an den API-Proxy aufruft. Der simulierte Zieldienst wird bei Apigee gehostet und gibt einfache Daten zurück. Ein API-Schlüssel oder ein Zugriffstoken sind nicht erforderlich.

    Die Details Ihres API-Proxys sollten so aussehen:

  7. Klicken Sie auf Weiter.
  8. Wählen Sie auf dem Bildschirm Richtlinien die Sicherheitsoption Passthrough (keine Autorisierung) aus.
  9. Klicken Sie auf Weiter.
  10. Wählen Sie auf dem Bildschirm Zusammenfassung eine Umgebung aus, in der Sie den Proxy bereitstellen möchten, und klicken Sie auf Erstellen und bereitstellen.

    Hybrid generiert den Proxy (manchmal auch als Proxy-Bundle bezeichnet):

  11. Klicken Sie auf Zur Proxyliste.

    Apigee zeigt die Ansicht Proxys an, in der eine Liste der API-Proxys angezeigt wird. Ihr neuer Proxy sollte mit einer grünen Statusanzeige angezeigt werden, was bedeutet, dass er bereitgestellt wurde.

2. Den API-Proxy aufrufen

Wenn die Benutzeroberfläche angibt, dass Ihr Proxy bereitgestellt ist, können Sie versuchen, diesen mit cURL oder dem REST-Client Ihrer Wahl aufzurufen: Beispiel:

  1. Prüfen Sie, ob die Umgebungsvariable DOMAIN auf den Domainnamen festgelegt ist, den Sie für den Hostnamen für Ihre Umgebungsgruppe in Projekt- und Organisationseinrichtung – Schritt 3: Umgebungsgruppe erstellen verwendet haben. 
    echo $DOMAIN

  2. Suchen Sie mit dem folgenden Befehl die externe IP-Adresse und den Port des Apigee Ingress-Gateways:

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

    Die Ausgabe sollte in etwa so aussehen: 

    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. Exportieren Sie Ihre externe IP-Adresse und Ihren Port in Variablen: 
    export INGRESS_IP_ADDRESS=EXTERNAL_IP_ADDRESS
export INGRESS_PORT=PORT_NUMBER
  4. Den API-Proxy aufrufen 
    curl  -H Host:$DOMAIN --resolve \
  $DOMAIN:$INGRESS_PORT:$INGRESS_IP_ADDRESS  \
  https://$DOMAIN:$INGRESS_PORT/myproxy -k

    Beispiel:

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

Weitere Informationen zum Erstellen und Bereitstellen von API-Proxys finden Sie unter Ersten Proxy erstellen.