Empfehlungen

Diese Seite gilt für Apigee und Apigee Hybrid.

Apigee Edge-Dokumentation aufrufen

Was Sie in diesem Schritt tun

Führen Sie die folgenden Schritte aus, um einen Test-API-Proxy zu erstellen und bereitzustellen. Testen Sie schließlich den API-Proxy, indem Sie eine HTTP-Anfrage an ihn senden.

API-Proxy erstellen und bereitstellen

Beim Bereitstellungsprozess für Apigee wird nicht automatisch ein API-Proxy für Sie erstellt und bereitgestellt. Sie müssen einen Proxy manuell erstellen und bereitstellen.

Apigee-UI in der Cloud Console

So erstellen Sie Ihren ersten Proxy und stellen ihn bereit:

  1. Öffnen Sie die Apigee-UI in der Cloud Console in einem Browser.
  2. Achten Sie darauf, dass der Name Ihrer Organisation im Drop-down-Menü links oben in der Benutzeroberfläche ausgewählt ist. Der Name der Organisation entspricht dem Namen Ihres Google Cloud-Projekts.
  3. Klicken Sie im linken Navigationsbereich auf Proxy-Entwicklung > API-Proxys.
  4. Klicken Sie auf + Erstellen.

    Die Seite Proxy erstellen wird geöffnet.

  5. Wählen Sie im Feld Proxyvorlage die Option Reverse-Proxy (am häufigsten) aus.
  6. Konfigurieren Sie den Proxy in Schritt 1: Proxydetails mit den folgenden Werten:
    Parametername Wert
    Proxy-Name hello-world
    Basispfad /hello-world
    Ziel (vorhandene API) mocktarget.apigee.net
  7. Klicken Sie auf Weiter.
  8. In Schritt 2: Bereitstellen (optional):
    • Bereitstellungsumgebungen: Optional. Wählen Sie durch die Kästchen eine oder mehrere Umgebungen aus, in denen Sie Ihren Proxy bereitstellen möchten. 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.
    • Dienstkonto: (optional) Hängen Sie ein Dienstkonto an Ihre Bereitstellung an, damit der Proxy auf Google Cloud-Dienste zugreifen kann, wie in der Rolle und den Berechtigungen des Dienstkontos angegeben.
  9. Klicken Sie auf Erstellen.

    Der neue API-Proxy wird erstellt und in der ausgewählten Umgebung bereitgestellt.

  10. Die Seite Proxy-Zusammenfassung für den neu erstellten Proxy wird geöffnet. Mit einem grünen Häkchen unter Status wird angezeigt, dass der Proxy erfolgreich bereitgestellt wurde. Wenn der Proxy nicht bereitgestellt wird, finden Sie weitere Informationen unter API-Proxy bereitstellen. Folgen Sie den Schritten, um ihn manuell bereitzustellen.
  11. Wählen Sie im linken Navigationsbereich Verwaltung > Umgebungen > Umgebungsgruppen aus.
  12. Kopieren Sie den Hostnamen für Ihre Umgebungsgruppe. Mit diesem Hostnamen rufen Sie in den nächsten Schritten den API-Proxy auf.

Apigee-Benutzeroberfläche

So erstellen Sie Ihren ersten Proxy und stellen ihn bereit:

  1. Melden Sie sich bei der Apigee-UI an.
  2. Achten Sie darauf, dass der Name Ihrer Organisation im Drop-down-Menü links oben in der Benutzeroberfläche ausgewählt ist. Der Name der Organisation entspricht dem Namen Ihres Google Cloud-Projekts.
  3. Klicken Sie in der Hauptansicht auf API-Proxys.
  4. Wählen Sie in der Drop-down-Liste Umgebung auswählen eine Umgebung aus.
  5. Klicken Sie auf Neu erstellen.
  6. Klicken Sie auf Proxy umkehren (am häufigsten).
  7. Konfigurieren Sie den Proxy auf der Seite Proxydetails mit den folgenden Einstellungen:
    Parametername Wert
    Name hello-world
    Basispfad /hello-world
    Ziel (vorhandene API) https://mocktarget.apigee.net
  8. Klicken Sie auf Weiter.
  9. Wählen Sie auf der Seite Allgemeine Richtlinien unter Sicherheit: Autorisierung die Option Passthrough (keine Autorisierung) aus.
  10. Klicken Sie auf Weiter.
  11. Wählen Sie auf der Seite Zusammenfassung unter Optionale Bereitstellung die Umgebung aus, in der der Proxy bereitgestellt werden soll.
  12. Klicken Sie auf Erstellen und bereitstellen.

    Der neue API-Proxy wird erstellt und in der ausgewählten Umgebung bereitgestellt.

  13. Klicken Sie auf Zur Proxyliste. Mit einem grünen Häkchen unter Status wird angezeigt, dass der Proxy erfolgreich bereitgestellt wurde. Wenn der Proxy nicht bereitgestellt wird, finden Sie weitere Informationen unter API-Proxy bereitstellen. Folgen Sie den Schritten, um ihn manuell bereitzustellen.
  14. Wählen Sie im linken Navigationsbereich Admin > Umgebungen > Gruppen aus.
  15. Klicken Sie auf In der Google Cloud Console ansehen.
  16. Kopieren Sie den Hostnamen für Ihre Umgebungsgruppe. Mit diesem Hostnamen rufen Sie in den nächsten Schritten den API-Proxy auf.
  17. Schließen Sie die Google Cloud Console.

Proxy mit internem Zugriff aufrufen

Wenn Sie den internen Zugriff in Schritt 4: Zugriffsrouting anpassen zugelassen haben, folgen Sie der Anleitung unter API-Proxy nur mit internem Zugriff aufrufen

Proxy mit externem Zugriff aufrufen

Wenn Sie externen Zugriff in Schritt 4: Zugriffsrouting anpassen zugelassen haben, gehen Sie so vor:

  1. Richten Sie einen DNS-Eintrag für Ihren Host ein. Es gibt zwei Möglichkeiten, um diese Aufgabe auszuführen:
    • Erstellen Sie bei Ihrem Registrator einen A-Eintrag, der den Hostnamen Ihrer Umgebungsgruppe auf die IP-Adresse verweist, die auf der Seite des Assistenten unter DNS konfigurieren angezeigt wird. Wenn Ihr Hostname beispielsweise sales.example.com und die IP-Adresse 10.23.0.2 lautet, verweisen Sie den Eintrag für sales.example.com auf die Adresse 10.23.0.2.
    • Verwenden Sie Google Cloud DNS, um einer IP-Adresse eine URL zuzuordnen.
  2. Testen Sie den API-Proxy, indem Sie die folgende Anfrage in einem Terminalfenster senden: 
    curl -v -H "Host:YOUR_ENV_GROUP_HOSTNAME" \
  https://YOUR_INSTANCE_IP_OR_DNS/hello-world

    Dabei gilt:

    • Der Wert des Host-Headers (YOUR_ENV_GROUP_HOSTNAME) ist der Hostname auf der Seite Umgebungen > Umgebungsgruppen.

    Eine erfolgreiche Anfrage gibt den String Hello, Guest! zurück. Wenn Ihre Anfrage nicht erfolgreich ist, lesen Sie die Fehlerbehebung.

Nächste Schritte