Erweiterungen hinzufügen und konfigurieren

Sie sehen die Dokumentation zu Apigee Edge.
Zur Apigee X-Dokumentation weitere Informationen

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, die Sie in Ihren API-Proxy einbinden möchten, fügen eine Erweiterung aus diesem Paket hinzu und konfigurieren sie und stellen die Erweiterung in einer Edge-Umgebung bereit.

Wenn Sie eine Erweiterung aus einem Erweiterungspaket konfigurieren, geben Sie Werte an, durch die die Interaktion der Erweiterung mit ihrer externen Ressource fokussiert wird. 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 den Aspekten der Ressource entsprechen, mit der sie interagiert. Eine Liste der enthaltenen Erweiterungen finden Sie in der Übersicht zu Erweiterungen – Übersicht.

Normalerweise enthält die Konfiguration jeder Erweiterung die Anmeldedaten, die die Erweiterung für die Authentifizierung bei der Ressource in Ihrem Namen verwenden soll.

Die Umgebung für die Bereitstellung von Erweiterungen unterstützt das Autoscaling je nach Last. Daher verfügt eine Erweiterungsbereitstellung ohne Traffic standardmäßig über keine Instanz, um auf Anfragen zu antworten. Daher kann die erste Anfrage an eine Erweiterung länger dauern, während die Umgebung eine Instanz der Erweiterung zur Verwendung 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 bei Edge an, klicken Sie auf das Menü Admin und dann auf Erweiterungen.

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

    Im nächsten Schritt 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 angezeigt, die von Google oder von anderen Unternehmen entwickelt wurden.

  3. Klicken Sie unter Erweiterung auswählen auf den gewünschten Tab und suchen Sie die Erweiterung für die externe Ressource, auf die Sie zugreifen.

    Im Feld für das Erweiterungspaket können Sie auf Details anzeigen klicken, um Informationen über die Version, den Autor usw. der Erweiterung anzuzeigen.

  4. Klicke das Kästchen für das Erweiterungspaket an, um mit der Konfiguration einer Erweiterung aus dem Paket zu beginnen.

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

  6. Suchen Sie auf der Seite Erweiterung > Mein-Erweiterung-Name für die zu erstellende Erweiterung 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 zur Konfiguration der Erweiterung aus oder geben Sie sie ein.

    Jede Erweiterung hat ihre eigenen Konfigurationseigenschaften. Für Beschreibungen der Eigenschaften verwenden Sie die Referenz der Erweiterung. Erweiterungsreferenzen sind in der Übersicht über die Erweiterungsreferenz aufgeführt.

  9. Klicken Sie auf Speichern.

Erweiterung bereitstellen

  1. Klicken Sie auf der Seite Erweiterung > Mein-Erweiterungsname für die Erweiterung auf Bereitstellen, um die Erweiterung zur Verwendung über einen API-Proxy bereitzustellen.

Nachdem Sie eine Erweiterung bereitgestellt haben: