Sie sehen sich die Apigee Edge-Dokumentation an.
Sehen Sie sich die Apigee X-Dokumentation an.
Mit gehosteten Zielen können Sie Node.js-Anwendungen in einer nativen Laufzeitumgebung ausführen, die von Apigee gehostet wird. Das Ziel von gehosteten Zielen ist einfach: Sie können Anwendungen in einer nativen, sicheren, skalierbaren und isolierten Umgebung bereitstellen, in der Edge-API-Proxys sie als Zieldienste aufrufen können.
Wie die folgende Abbildung zeigt, ruft ein Edge API-Proxy eine Node.js-Anwendung auf, die in der Umgebung für gehostete Ziele bereitgestellt wird. Die Umgebung für gehostete Ziele befindet sich in einer Apigee-Organisation:Umgebung.
Wenn Sie einen Edge API-Proxy benötigen, um mit einer ordnungsgemäß erstellten und bereitgestellten gehosteten Zielanwendung zu kommunizieren, ist eine einfache Konfiguration im Zielendpunkt des Proxys erforderlich. Rufen Sie als Erstes die Anleitungen zu gehosteten Zielen auf.
Welche Laufzeiten für Anwendungen werden von gehosteten Zielen unterstützt?
Derzeit können Sie nur Node.js-Anwendungen auf gehosteten Zielen bereitstellen.
Gehostete Ziele installieren
Gehostete Ziele sind in allen Edge Public Cloud-Organisationen verfügbar. Sie müssen nichts installieren, um gehostete Ziele zu verwenden.
Überprüfen, ob gehostete Ziele aktiviert sind
Wenn Sie prüfen möchten, ob für Ihre Organisation gehostete Ziele aktiviert sind, rufen Sie die Organisationsdetails ab und achten Sie darauf, dass die Property features.isEdgeFunctionsEnabled
auf „true“ festgelegt ist. Die Property ist schreibgeschützt.
Beispiel:
https://api.enterprise.apigee.com/v1/organizations/myorg
{ "createdAt":1507572884047, "createdBy":"jdoe@apigee.com", "displayName":"myorg", "environments":[ "prod", "dev", "test", "portal" ], "lastModifiedAt":1507578673194, "lastModifiedBy":"jdoe@apigee.com", "name":"jdoe", "properties":{ "property":[ { "name":"features.isSmbOrganization", "value":"false" }, { "name":"self.service.virtual.host.enabled", "value":"true" }, { "name":"features.isCpsEnabled", "value":"true" }, { "name":"features.isEdgeFunctionsEnabled", "value":"true" } ] }, "type":"paid" }
Informationen zu gehosteten Zielen
Mit gehosteten Zielen können Node.js-Anwendungen in einer nativen Umgebung ausgeführt werden, die nicht von einer Apigee-spezifischen Laufzeittechnologie abhängig ist. Sie können die Anwendung lokal debuggen und testen, bevor Sie sie bereitstellen. Sie können sich aber darauf verlassen, dass die bereitgestellte Version genau wie lokal funktioniert. Zum Zeitpunkt der Bereitstellung können Sie eine beliebige Laufzeitversion der Anwendung zum Ausführen der Anwendung in gehosteten Zielen auswählen. Sie können beispielsweise speziell eine Node.js-Anwendung in einer v8.10.0-Umgebung ausführen.
Einschränkungen
Informationen zu Nutzungslimits für gehostete Ziele finden Sie unter Apigee-Produktlimits.
Grundlegende Schritte
Wenn Sie mit der Edge-Proxy-Entwicklung vertraut sind, müssen Sie nur ein paar einfache Schritte ausführen, um gehostete Ziele erfolgreich zu verwenden. Damit werden Edge-Proxys für gehostete Ziele genau wie jeder andere Apigee Edge-Proxy erstellt, bereitgestellt und verwaltet.
Wenn Sie gehostete Ziele verwenden möchten, müssen Sie die folgenden Schritte ausführen. In den Anleitungen werden diese Aufgaben ausführlich beschrieben.
- Node.js-Anwendung lokal entwickeln und testen
- Erstellen Sie im Stammverzeichnis Ihres Anwendungsprojekts eine Manifestdatei. Das Manifest ist eine YAML-Datei, die Informationen zum Erstellen und Bereitstellen der Anwendung enthält.
- Fügen Sie Ihre Anwendung dem Edge-Proxy als gehosteten Ressourcentyp hinzu.
- Fügen Sie im Ziel-Endpunkt des Proxys ein leeres
<HostedTarget/>
-Tag hinzu. Dieses Tag weist Edge an, die Node.js-Anwendung in der Umgebung für gehostete Ziele bereitzustellen. Beispiel:
<?xml version="1.0" encoding="UTF-8"?> <TargetEndpoint name="default"> <PreFlow name="PreFlow"> <Request /> <Response /> </PreFlow> <PostFlow name="PostFlow"> <Request /> <Response /> </PostFlow> <Flows /> <HostedTarget /> </TargetEndpoint>
Umfang der Anwendungen in gehosteten Zielen
Gehostete Ziele werden auf eine Edge-Organisationsumgebung beschränkt. Dieser Geltungsbereich ist derselbe wie bei jedem Edge-Proxy.
Können Anwendungen von gehosteten Zielen auf Proxy-Daten zugreifen?
Anwendungen mit gehosteten Zielen haben derzeit keinen Zugriff auf die Proxy-Laufzeitumgebung. Das bedeutet, dass Sie nicht direkt über Anwendungen von gehosteten Zielen auf Flussvariablen, Caches und andere Entitäten zugreifen können.
Mit dem eingebetteten Node.js (der traditionellen, auf Trireme basierenden Node.js-Unterstützung in Edge) können Sie apigee-access verwenden, um auf Flussvariablen und andere Entitäten in Edge zuzugreifen. Gehostete Ziele unterstützen das Modul apigee-access
für Node.js-Bereitstellungen jedoch nicht.
Siehe auch Kann man den Mangel an Apigee-Zugriff umgehen?
Vorhandenen Anwendungscode zu gehosteten Zielen migrieren
Derzeit gibt es keinen automatisierten Migrationspfad von einer traditionellen auf Trireme basierenden eingebetteten Node.js-Anwendung zu gehosteten Zielen. Sie können jedoch vorhandenen Anwendungscode manuell in gehostete Ziele umwandeln. Ein Beispiel finden Sie unter Vorhandenen Node.js-Proxy zu einem gehosteten Ziel-Proxy migrieren.