Erste Schritte mit Node.js in Apigee Edge

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

In diesem Thema wird die einfachste Möglichkeit erläutert, eine Node.js-Anwendung mithilfe der Verwaltungs-UI in einem API-Proxy zu verpacken.

Einführung

Vermutlich war die erste Node.js-Anwendung, die Sie erstellt haben, ein HTTP-Server, der auf Anfragen mit „Hello World!“ Die einfachste Möglichkeit, Node.js auf Apigee Edge zu testen, besteht darin, etwas Ähnliches zu tun. Mit nur wenigen Mausklicks können Sie einen funktionierenden Node.js-HTTP-Server über einen Proxy in Edge einrichten. Danach können Sie den Code-Editor in der UI verwenden, um die Node.js-Anwendung zu ändern, zusätzliche Node.js-Dateien hinzuzufügen, Richtlinien hinzuzufügen usw.

„Hello World!“-Beispiel wird erstellt API-Proxy

In diesem Abschnitt wird erläutert, wie Sie einen Edge API-Proxy erstellen, der mit einem Node.js-HTTP-Server interagiert. Der Node.js-HTTP-Servercode wurde bereits für Sie geschrieben und automatisch in Edge bereitgestellt, wenn Sie diese einfachen Schritte ausführen.
  1. Wählen Sie im Assistenten zum Erstellen eines Proxys die Option Node.js-App aus.
  2. Klicken Sie auf Weiter.
  3. Folgen Sie dem Assistenten zum Erstellen eines Proxys und treffen Sie die folgende Auswahl.
    Feld Auswahl
    Details
    Proxy-Name Geben Sie Nodejs-Hello ein. Der für die API angezeigte Name.
    Proxy-Basispfad Geben Sie "node-hello" ein
    Quelle Wählen Sie "Hello World"-Beispiel aus. Die anderen Optionen werden später in diesem Thema erläutert.
    Beschreibung Geben Sie eine Beschreibung der API ein.
    Sicherheit
    Passthrough (keine) Wählen Sie Pass through (none) (Keine) aus. Erstellt einen einfachen Pass-Through-Proxy.
    Virtuelle Hosts
    Standard, sicher Ändern Sie nicht die Standardeinstellungen. Weitere Informationen zu virtuellen Hosts finden Sie unter Informationen zu virtuellen Hosts (Beta).
    Erstellen
    Umgebungen bereitstellen Wählen Sie Testen aus.
  4. Klicken Sie auf Erstellen und bereitstellen.
    Sie sollten eine Bestätigung sehen, dass der neue API-Proxy erfolgreich erstellt und in der Testumgebung bereitgestellt wurde.
  5. Klicken Sie auf Proxy <Proxyname> im Editor anzeigen, um die Detailseite für den API-Proxy aufzurufen.

Hello-Proxy aufrufen

Wenn Sie den hello-Proxy aufrufen, wird die Node.js-Anwendung automatisch ausgeführt und gibt „Hello, World!“ zurück. Sofern nicht anders angegeben, wird die Node.js-Anwendung in der Umgebung namens test bereitgestellt. Hier ist der einfache Aufruf mit Curl. Ersetzen Sie myorg durch Ihren Organisationsnamen. 
$ curl http://myorg-test.apigee.net/nodejs-hello
Hello, World!

Node.js-Code ansehen und bearbeiten

Sehen wir uns den Node.js-Code an, der dem API-Proxy hinzugefügt wurde. Rufen Sie die Zusammenfassungsseite für den Hello World-Proxy auf und klicken Sie auf Entwickeln.



Dadurch wird die Ansicht „Develop“ mit einem Codeeditor geöffnet. Sie können den Code dort direkt bearbeiten.

Ändern Sie beispielsweise die Antwort von Hello, World! in einen anderen Wert wie Hello, Node! und klicken Sie dann auf Speichern. Der Proxy wird gespeichert und noch einmal bereitgestellt.

Rufen Sie schließlich den Proxy noch einmal auf, um die Änderung zu bestätigen:

$ curl http://myorg-test.apigee.net/nodejs-hello
Hello, Node!

Weitere Informationen zum Ausführen von Node.js-Anwendungen in Apigee Edge

Wie alle Node.js-Anwendungen werden auch Node.js-Anwendungen, die auf Apigee Edge ausgeführt werden, in einem einzigen Kontrollthread ausgeführt. Es ist nicht nötig und auch nicht in der Lage, einen weiteren Thread zu starten oder Variablen zwischen Threads zu synchronisieren. Da Node.js eine nicht blockierende Programmierung erzwingt, kann ein einzelnes Skript Tausende gleichzeitige Anfragen unterstützen, da das Skript die CPU aufgibt, sobald es auf etwas warten muss, und es später benachrichtigt wird.

Wenn Sie Node.js in Apigee Edge verwenden möchten, müssen Sie eine Node.js-Hauptskriptdatei angeben. Dieses Skript muss für die Verarbeitung eingehender Anfragen konfiguriert sein. Dazu verwenden Sie in der Regel die Module http oder https, erstellen einen Client usw. Wenn das Hauptskript nicht auf diese Weise konfiguriert ist, wird es nach der Bereitstellung einfach ausgeführt und beendet. In Apigee Edge wird jedes Node.js-Anwendungsskript von Anfang an gestartet, wenn der Proxy bereitgestellt wird, und beendet, wenn die Bereitstellung des Proxys aufgehoben wird. Dazwischen wird auf neue Anfragen gewartet und diese verarbeitet. Weitere Informationen finden Sie unter „Importierte Node.js-Datei aufrufen“ unter Eigenständige Node.js-Anwendung bereitstellen.

Nächste Schritte

Sie können auch eigenständige Node.js-Anwendungen direkt über Ihr Dateisystem erstellen und bereitstellen. Im nächsten Thema Eigenständige Node.js-Anwendung bereitstellen wird erläutert, wie Sie mit dem Befehl apigeetool eine Node.js-Anwendung über die Befehlszeile bereitstellen.