Pierwsze kroki z Node.js w Apigee Edge

Przeglądasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. Informacje

W tym temacie opisujemy najprostszy sposób pakowania aplikacji Node.js w serwer proxy interfejsu API za pomocą interfejsu zarządzania.

Wstęp

Bardzo możliwe, że pierwszą aplikacją Node.js, którą kiedykolwiek stworzyliśmy, był serwer HTTP, który odpowiada na żądania komunikatem „Hello World!”. Najprostszym sposobem wypróbowania Node.js w Apigee Edge jest wykonanie czegoś bardzo podobnego. Wystarczy kilka kliknięć myszą, by utworzyć działający serwer HTTP Node.js działający na serwerach brzegowych. Następnie możesz zmodyfikować aplikację Node.js, dodać kolejne pliki Node.js, dodać zasady lub użyć edytora kodu w interfejsie użytkownika.

Tworzę przykładową wersję Hello World! proxy interfejsu API

W tej sekcji dowiesz się, jak utworzyć serwer proxy interfejsu Edge API, który współpracuje z serwerem HTTP Node.js. Kod serwera HTTP Node.js jest już napisany i automatycznie wdrażany w Edge po wykonaniu tych prostych czynności.
  1. W kreatorze Budowanie serwera proxy wybierz Aplikacja Node.js.
  2. Kliknij Dalej.
  3. Postępuj zgodnie z instrukcjami kreatora tworzenia serwera proxy i wybierz poniższe opcje.
    Pole Zaznaczenie
    Szczegóły
    Nazwa serwera proxy Wpisz Nodejs-Hello. Wyświetlana nazwa interfejsu API.
    Ścieżka podstawowa serwera proxy Wpisz Nodejs-hello
    Źródło Wybierz Próbka „Hello World”. Pozostałe opcje omówimy w dalszej części tego tematu.
    Opis Podaj opis interfejsu API.
    Security
    Przebieg (brak) Wybierz Przekazywany (brak). Tworzy prosty przekazywanie przez serwer proxy.
    Hosty wirtualne
    domyślne, bezpieczne Nie zmieniaj wartości domyślnych. Więcej informacji o hostach wirtualnych znajdziesz w artykule Informacje o hostach wirtualnych (beta).
    Tworzenie
    Wdrażanie środowisk Wybierz test.
  4. Kliknij Skompiluj i wdróż.
    W odpowiedzi powinno pojawić się potwierdzenie, że nowy serwer proxy interfejsu API został utworzony i wdrożony w środowisku testowym.
  5. Kliknij Wyświetl serwer proxy <nazwa serwera proxy w edytorze, aby wyświetlić stronę z informacjami o serwerze proxy interfejsu API.

Wywołuję serwer proxy Hello

Gdy wywołujesz serwer proxy hello, aplikacja Node.js uruchamia się automatycznie i odpowiada komunikatowi „Hello, World”. Pamiętaj, że jeśli nie określisz inaczej, aplikacja Node.js jest wdrożona w środowisku o nazwie test. Oto podstawowe wywołanie wykorzystujące Curl (zamiast myorg zastąp nazwę organizacji). 
$ curl http://myorg-test.apigee.net/nodejs-hello
Hello, World!

Wyświetlanie i edytowanie kodu Node.js

Spójrzmy na kod w środowisku Node.js dodany do serwera proxy interfejsu API. Otwórz stronę podsumowania serwera proxy Hello World i kliknij Develop.



Otworzy się widok Programowanie z edytorem kodu. Kod możesz edytować bezpośrednio na tej stronie.

Na przykład zmień odpowiedź z Hello, World! na coś innego, np. Hello, Node!, a następnie kliknij Zapisz. Serwer proxy został zapisany i wdrożony ponownie.

Na koniec ponownie wywołaj serwer proxy, aby sprawdzić zmianę:

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

Więcej informacji o uruchamianiu aplikacji Node.js w Apigee Edge

Podobnie jak wszystkie aplikacje Node.js, aplikacje Node.js działające w Apigee Edge działają w jednym wątku kontroli. Nie ma potrzeby tworzenia nowego wątku (a wręcz przeciwnie – synchronizowania zmiennych między wątkami). Node.js wymusza programowanie nieblokujące, dlatego pojedynczy skrypt może obsługiwać tysiące równoczesnych żądań, ponieważ skrypt odciąża procesor za każdym razem, gdy na coś czeka. Gdy to nastąpi, otrzymuje on powiadomienie.

Aby używać Node.js w Apigee Edge, musisz określić główny plik skryptu Node.js. Ten skrypt musi być skonfigurowany do obsługi żądań przychodzących. Zwykle wykonuje się to za pomocą modułów http lub https, tworzenia klienta itd. (Jeśli główny skrypt nie jest skonfigurowany w ten sposób, zostanie uruchomiony, a po wdrożeniu zostanie zamknięty). W Apigee Edge każdy skrypt aplikacji Node.js jest uruchamiany od początku, gdy serwer proxy jest wdrożony, i zatrzymywany po wycofaniu serwera proxy. W tym czasie będzie czekać na nowe żądania i je przetworzyć. Więcej informacji znajdziesz w sekcji „Wywoływanie zaimportowanego pliku Node.js” artykułu o wdrażaniu samodzielnej aplikacji Node.js.

Dalsze kroki

Możesz też tworzyć i wdrażać samodzielne aplikacje Node.js bezpośrednio z systemu plików. W następnym temacie Wdrażanie samodzielnej aplikacji Node.js wyjaśniamy, jak przy użyciu polecenia apigeetool wdrożyć aplikację Node.js z poziomu wiersza poleceń.