Sie lesen die Dokumentation zu Apigee Edge.
Rufen Sie die Dokumentation zu Apigee X auf. 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 können damit 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 mit gehosteten Zielen bereitgestellt wird. Beachten Sie, dass die Umgebung von gehosteten Zielen innerhalb einer Apigee-Umgebung unter der Organisation liegt.
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 die Anleitungen zu gehosteten Zielen an.
Welche Anwendungslaufzeiten werden von gehosteten Zielen unterstützt?
Derzeit können Sie Node.js-Anwendungen nur 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.
Aktivierung von gehosteten Zielen prüfen
Wenn Sie prüfen möchten, ob für Ihre Organisation gehostete Ziele aktiviert sind, rufen Sie die Details zu 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"
}
Wissenswertes 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ängt. Sie können Ihre App vor der Bereitstellung lokal debuggen und testen und sich darauf verlassen, dass die bereitgestellte Version genau wie lokal funktioniert. Zum Zeitpunkt der Bereitstellung können Sie eine beliebige Laufzeitversion auswählen, um Ihre Anwendung in gehosteten Zielen auszuführen. Sie können beispielsweise festlegen, dass eine Node.js-Anwendung in einer Umgebung der Version 8.10.0 ausgeführt werden soll.
Limits
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 erlernen, um gehostete Ziele erfolgreich zu verwenden. Edge-Proxys für gehostete Ziele werden genau wie jeder andere Apigee Edge-Proxy erstellt, bereitgestellt und verwaltet.
Führen Sie die folgenden Aufgaben aus, um gehostete Ziele zu verwenden. In den Anleitungen werden diese Aufgaben ausführlich erläutert.
- Node.js-Anwendung lokal entwickeln und testen
- Erstellen Sie eine Manifestdatei im Stammverzeichnis Ihres Anwendungsprojekts. Das Manifest ist eine YAML-Datei, die Informationen enthält, die zum Erstellen und Bereitstellen der Anwendung erforderlich sind.
- 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 Hosted Targets-Umgebung 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>
Bereich von gehosteten Zielanwendungen
Anwendungen für gehostete Ziele sind auf eine Edge-Organisationsumgebung beschränkt. Diese Einschränkung gilt für jeden Edge-Proxy.
Können Anwendungen mit gehosteten Zielen auf Proxy-Daten zugreifen?
Gehostete Ziele-Anwendungen haben derzeit keinen Zugriff auf die Proxy-Laufzeitumgebung. Das bedeutet, dass Sie nicht direkt über Hosted Targets-Anwendungen auf Flussvariablen, Caches und andere Entitäten zugreifen können.
Mit eingebettetem Node.js (der traditionellen, Trireme-basierten 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 Ist es möglich, das Fehlen von Apigee-Zugriff zu umgehen?
Vorhandenen Anwendungscode zu gehosteten Zielen migrieren
Es gibt derzeit 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 konvertieren. Ein Beispiel finden Sie unter Vorhandenen Node.js-Proxy zu einem Hosted Targets-Proxy migrieren.