Schritt 2: API-Proxy bereitstellen

Aktuell lesen Sie die Version 1.11 der Apigee Hybrid-Dokumentation. Weitere Informationen finden Sie unter Unterstützte Versionen.

Version 1.11 

Unterstützte Versionen:

• V1.12 (aktuellste Version)                        
• v1.11                         
• v1.10                                        
• Liste der unterstützten Versionen

Nicht unterstützte Versionen:

• v1.9                                         
• v1.8                                         
• v1.7                                         
• v1.6                                         
• v1.5                                         
• v1.4                                         
• v1.3                                         
• v1.2                                         
• v1.1                                         

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.

Hinweis: Es gibt eine neue Version der Apigee-UI, die in die Google Cloud Console eingebunden ist. Die neue Benutzeroberfläche heißt Apigee in der Cloud Console. In den Anleitungen auf den ersten beiden Tabs unten wird erläutert, wie Sie Apigee in der Cloud Console oder das klassische Apigee verwenden.

Apigee in der Cloud Console

So erstellen Sie einen neuen API-Proxy mit Apigee in der Cloud Console:

1. Öffnen Sie die Apigee-UI in der Cloud Console in einem Browser.
2. Wählen Sie Ihre Organisation links oben im Drop-down-Menü aus.
3. Wählen Sie in der Hauptansicht Proxy-Entwicklung > API-Proxys aus.
4. Klicken Sie auf 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:
   • Proxyname: Geben Sie myproxy ein. In den verbleibenden Schritten in diesem Abschnitt wird davon ausgegangen, dass dies Ihre Proxy-ID ist.
   • Basispfad: Wird automatisch auf / festgelegt, gefolgt vom Proxynamen, der in diesem Beispiel /myproxy lautet. Der 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 Next (Weiter).
8. Wählen Sie auf dem Bildschirm Richtlinien die Sicherheitsoption Passthrough (keine Autorisierung) aus.
9. Klicken Sie auf Next (Weiter).
10. Unter Bereitstellen (optional) haben Sie die Möglichkeit, im Feld Bereitstellungsumgebungen eine oder mehrere Umgebungen auszuwählen, in denen Sie Ihren Proxy bereitstellen können. Wenn Sie den Proxy zu diesem Zeitpunkt nicht bereitstellen möchten, lassen Sie das Feld Bereitstellungsumgebungen leer. Sie können den Proxy später jederzeit bereitstellen.
11. Klicken Sie auf Erstellen. Apigee generiert den Proxy (manchmal auch als Proxy-Bundle bezeichnet).

Apigee zeigt die Ansicht Proxy-Zusammenfassung an. Wenn Sie den Proxy bereitstellen, wird im Abschnitt Bereitstellungen die Nummer der Überarbeitung angezeigt, die 1 ist, wenn Sie das erste Mal bereitstellen. In der Spalte Status werden mit einer grünen Statusanzeige die Umgebungen angezeigt, in denen der Proxy bereitgestellt wird.

Darunter wird im Abschnitt Endpunkte Folgendes angezeigt:

• Proxy-Endpunkte: Der Basispfad, den Sie für den Proxy festgelegt haben. In diesem Beispiel ist das /myproxy.
• Zielendpunkte: Der Basispfad, den Sie für das Ziel festlegen. In diesem Beispiel ist das https://mocktarget.apigee.net.

Klassisches Apigee

So erstellen Sie einen neuen API-Proxy mit dem klassischen Apigee:

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 Next (Weiter).
8. Wählen Sie auf dem Bildschirm Richtlinien die Sicherheitsoption Passthrough (keine Autorisierung) aus.
9. Klicken Sie auf Next (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.

Glückwunsch!

Sie haben Apigee Hybrid erfolgreich installiert. Weitere Informationen zum Erstellen und Bereitstellen von API-Proxys finden Sie unter Einführung in die API-Proxy-Erstellung.