Erweiterungen hinzufügen und konfigurieren

Sie lesen gerade die Dokumentation zu Apigee Edge.
Zur Dokumentation zu Apigee X. info

Apigee Edge enthält mehrere installierte Erweiterungspakete. Bevor Sie eine Erweiterung in einem API-Proxy mit einer Extension Callout-Richtlinie verwenden können, müssen Sie die Erweiterung hinzufügen und konfigurieren. Wenn Sie eine Erweiterung hinzufügen, suchen Sie das Erweiterungspaket, das die externe Ressource darstellt, in die Sie Ihren API-Proxy einbinden möchten. Fügen Sie dann eine Erweiterung aus diesem Paket hinzu, konfigurieren Sie sie und stellen Sie sie in einer Edge-Umgebung bereit.

Wenn Sie eine Erweiterung aus einem Erweiterungspaket konfigurieren, geben Sie Werte an, die die Interaktion der Erweiterung mit der externen Ressource steuern. Wenn Sie beispielsweise eine Google Cloud Firestore-Erweiterung konfigurieren, geben Sie an, welche Datenbank die Erweiterung beim Erstellen, Abrufen und Löschen von Dokumenten verwenden soll. Jede Erweiterung hat eigene Konfigurationseigenschaften, die Aspekten der Ressource entsprechen, mit der sie interagiert. Eine Liste der enthaltenen Erweiterungen finden Sie unter Übersicht über die Referenz zu Erweiterungen.

Normalerweise enthält die Konfiguration jeder Erweiterung die Anmeldedaten, die die Erweiterung verwenden soll, um sich in Ihrem Namen bei der Ressource zu authentifizieren.

Die Bereitstellungsumgebung für Erweiterungen ist flexibel und unterstützt das Autoscaling basierend auf der Last. Daher ist standardmäßig bei einer Erweiterungsbereitstellung ohne Traffic möglicherweise keine Instanz verfügbar, um auf Anfragen zu reagieren. Die erste Anfrage an eine Erweiterung kann daher länger dauern, da die Umgebung eine Instanz der Erweiterung erstellt.

Eine Anleitung für den Einstieg finden Sie unter Anleitung: Erweiterung hinzufügen und verwenden.

Erweiterung hinzufügen und konfigurieren

  1. Melden Sie sich in Edge an, klicken Sie auf das Menü Administrator und dann auf Erweiterungen.

    Auf der Seite Erweiterungen werden alle Erweiterungen aufgeführt, die aus Erweiterungspaketen konfiguriert wurden, die im System verfügbar sind. Wenn Sie eine vorhandene konfigurierte Erweiterung ansehen möchten, können Sie die Liste filtern, indem Sie oben auf der Seite Filterbegriffe eingeben.

    In den nächsten Schritten fügen Sie Ihre eigene Erweiterung hinzu.

  2. Klicken Sie auf der Seite Erweiterung auf Erweiterung hinzufügen.

    Auf der Seite „Erweiterung auswählen“ werden die Erweiterungen in von Google entwickelte und von anderen Unternehmen entwickelte Erweiterungen unterteilt.

  3. Klicken Sie unter Erweiterung auswählen auf den gewünschten Tab und suchen Sie dann die Erweiterung, die der externen Ressource entspricht, auf die Sie zugreifen.

    Im Feld für das Erweiterungspaket können Sie auf „Details ansehen“ klicken, um Informationen zur Version, zum Autor usw. der Erweiterung aufzurufen.

  4. Klicken Sie auf das Feld für das Erweiterungspaket, um mit der Konfiguration einer Erweiterung aus dem Paket zu beginnen.

  5. Geben Sie im Dialogfeld Erweiterungseigenschaften einen Namen und eine Beschreibung für die Erweiterung ein und klicken Sie dann auf Erstellen.

  6. Suchen Sie auf der Seite Erweiterung > Name-meiner-Erweiterung für die Erweiterung, die Sie erstellen, eine Apigee Edge-Umgebung, für die Sie die Erweiterung konfigurieren möchten.

    Eine Erweiterung muss in derselben Umgebung bereitgestellt werden wie der API-Proxy, der sie verwendet.

  7. Klicken Sie in der Liste auf die Zeile der Umgebung.

  8. Wählen Sie im Dialogfeld Konfiguration Werte aus oder geben Sie sie ein, um diese Erweiterung zu konfigurieren.

    Jede Erweiterung hat eigene Konfigurationseigenschaften. Beschreibungen der Eigenschaften finden Sie in der Referenz der Erweiterung. Erweiterungsreferenzen sind unter Übersicht über die Referenz zu Erweiterungen aufgeführt.

  9. Klicken Sie auf Speichern.

Erweiterung bereitstellen

  1. Klicken Sie auf der Seite Erweiterung > Name-meiner-Erweiterung für die Erweiterung auf Bereitstellen, um die Erweiterung für die Verwendung in einem API-Proxy bereitzustellen.

Nachdem Sie eine Erweiterung bereitgestellt haben, haben Sie folgende Möglichkeiten: