Sie sehen die Dokumentation zu Apigee Edge.
Zur Apigee X-Dokumentation weitere Informationen
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 ermöglichen die Bereitstellung von Anwendungen in einer nativen, sicheren, skalierbaren und isolierten Umgebung, 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. Beachten Sie, dass die gehostete Zielumgebung innerhalb einer Apigee-Organisationsumgebung beschränkt ist.
Damit ein Edge API-Proxy mit einer ordnungsgemäß erstellten und bereitgestellten Anwendung für gehostete Ziele kommunizieren kann, ist eine einfache Konfiguration im Zielendpunkt des Proxys erforderlich. Sehen Sie sich zum Einstieg die Anleitungen für gehostete Ziele an.
Welche Anwendungslaufzeiten unterstützen gehostete Ziele?
Derzeit können Sie Node.js-Anwendungen nur für gehostete Ziele 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.
Prüfen, ob gehostete Ziele aktiviert sind
Wenn Sie überprüfen möchten, ob gehostete Ziele in Ihrer Organisation aktiviert sind, rufen Sie die Details Ihrer Organisation ab und achten Sie darauf, dass das Attribut features.isEdgeFunctionsEnabled auf „true“ gesetzt ist. Die Eigenschaft 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 Apigee-spezifischer Laufzeittechnologie abhängig ist. Sie können Ihre Anwendung vor der Bereitstellung lokal debuggen und testen. Die bereitgestellte Version funktioniert dann genauso wie lokal. Bei der Bereitstellung können Sie eine beliebige Anwendungslaufzeitversion zum Ausführen Ihrer Anwendung in gehosteten Zielen auswählen. Sie können beispielsweise eine Node.js-Anwendung in einer Umgebung mit Version 8.10.0 ausführen.
Einschränkungen
Informationen zu Nutzungslimits für gehostete Ziele finden Sie unter Apigee-Produktlimits.
Grundlegende Schritte
Wenn Sie mit der Entwicklung von Edge-Proxys vertraut sind, müssen Sie nur ein paar einfache Schritte erlernen, um gehostete Ziele erfolgreich zu verwenden. Im Wesentlichen erstellen, bereitstellen und verwalten Sie Edge-Proxys für gehostete Ziele wie für jeden anderen Apigee Edge-Proxy.
Führen Sie die folgenden Aufgaben aus, um gehostete Ziele zu verwenden. In den Anleitungen werden diese Aufgaben im Detail beschrieben.
- Node.js-Anwendung lokal entwickeln und testen
- Erstellen Sie eine Manifestdatei im Stammverzeichnis Ihres Anwendungsprojekts. 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 Zielendpunkt 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 für gehostete Ziele
Gehostete Zielanwendungen sind auf eine Edge-Organisationsumgebung beschränkt. Dieser Umfang ist der gleiche wie für jeden Edge-Proxy.
Können gehostete Zielanwendungen auf Proxydaten zugreifen?
Gehostete Zielanwendungen haben derzeit keinen Zugriff auf die Proxylaufzeitumgebung. Das bedeutet, dass Sie nicht direkt über Hosted Targets-Anwendungen auf Ablaufvariablen, Caches und andere Entitäten zugreifen können.
Mit eingebettetem Node.js (die herkömmliche, Trireme-basierte Node.js-Unterstützung in Edge) können Sie apigee-access nutzen, um auf Flussvariablen und andere Entitäten in Edge zuzugreifen. Gehostete Ziele unterstützen jedoch nicht das Modul apigee-access für Node.js-Bereitstellungen.
Siehe auch Ist es möglich, den fehlenden Apigee-Zugriff zu umgehen?
Vorhandenen Anwendungscode zu gehosteten Zielen migrieren
Derzeit gibt es keinen automatisierten Migrationspfad von einer herkömmlichen Trireme-basierten eingebetteten Node.js-Anwendung zu gehosteten Zielen. Sie können vorhandenen Anwendungscode jedoch manuell in gehostete Ziele umwandeln. Ein Beispiel finden Sie unter Vorhandenen Node.js-Proxy zu einem gehosteten Ziel-Proxy migrieren.