Wyświetlasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. info
Hostowane cele pozwalają uruchamiać aplikacje Node.js w natywnym środowisku wykonawczym hostowanym przez Apigee. Cel hostowanych celów jest prosty: pozwalają wdrażać aplikacje w natywnym, bezpiecznym, skalowalnym i odizolowanym środowisku, w którym serwery proxy Edge API mogą wywoływać je jako usługi docelowe.
Jak widać na ilustracji poniżej, serwer proxy interfejsu Edge API wywołuje aplikację Node.js wdrożoną w środowisku hostowanych celów. Pamiętaj, że zakres środowiska hostowanych celów jest w zakresie organizacji:środowisko Apigee.
Uzyskanie serwera proxy interfejsu Edge API na potrzeby komunikacji z poprawnie skompilowaną i wdrożoną aplikacją hostowanych celów wymaga prostej konfiguracji w docelowym punkcie końcowym serwera proxy. Aby rozpocząć, otwórz samouczki dotyczące hostowanych celów.
Jakie środowisko uruchomieniowe aplikacji obsługuje usługa Hosted Targets?
Obecnie aplikacje Node.js możesz wdrażać tylko w miejscach docelowych hostowanych.
Instalowanie hostowanych celów
Hostowane cele są dostępne we wszystkich organizacjach Edge Public Cloud. Aby korzystać z celów hostowanych, nie musisz niczego instalować.
Sprawdzanie, czy hostowane cele są włączone
Jeśli chcesz sprawdzić, czy Twoja organizacja ma włączone hostowane cele, pobierz informacje o organizacji i upewnij się, że właściwość features.isEdgeFunctionsEnabled ma wartość Prawda. Właściwość jest tylko do odczytu.
Na przykład:
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"
}
Co musisz wiedzieć o celach hostowanych
Hostowane cele pozwalają aplikacjom Node.js uruchamiać się w środowisku natywnym, które nie zależy od żadnej technologii środowiska wykonawczego specyficznego dla Apigee. Przed wdrożeniem aplikacji możesz debugować i przetestować ją lokalnie. Masz pewność, że wdrożona wersja będzie działać dokładnie tak samo jak lokalnie. Podczas wdrażania możesz wybrać dowolną wersję środowiska uruchomieniowego aplikacji do uruchamiania aplikacji w hostowanych celach. Możesz na przykład uruchomić aplikację Node.js w środowisku v8.10.0.
Limity
Informacje o limitach wykorzystania w przypadku hostowanych celów znajdziesz w artykule Limity usług Apigee.
Podstawowe kroki do wykonania
Jeśli wiesz, jak programować serwer proxy Edge, wystarczy wykonać kilka prostych czynności, aby prawidłowo korzystać z hostowanych celów. W zasadzie tworzysz i wdrażasz Edge proxy oraz zarządzasz nimi w przypadku hostowanych celów tak samo jak w przypadku każdego innego Edge proxy Apigee.
Aby używać hostowanych celów, musisz wykonać poniższe zadania. Samouczki szczegółowo omawiają każde z tych zadań.
- Tworzenie i testowanie aplikacji Node.js lokalnie.
- Utwórz plik manifestu w katalogu głównym projektu aplikacji. Plik manifestu to plik YAML, który określa informacje potrzebne do skompilowania i wdrożenia aplikacji.
- Dodaj aplikację do serwera proxy Edge jako typ zasobu hostowanego.
- W sekcji Punkt końcowy docelowy serwera proxy dodaj pusty tag
<HostedTarget/>. Ten tag informuje Edge o konieczności wdrożenia aplikacji Node.js do środowiska hostowanych celów. Przykład:
<?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>
Zakres aplikacji docelowych hostowanych
Aplikacje z hostowanymi elementami docelowymi mają zakres ograniczony do środowiska organizacji Edge. Zakres ten jest taki sam jak w przypadku dowolnego serwera proxy Edge.
Czy aplikacje w hostowanych celach mogą uzyskiwać dostęp do danych serwera proxy?
Aplikacje z hostowanymi celami nie mają obecnie dostępu do środowiska czasu wykonywania proxy. Oznacza to, że nie można uzyskać dostępu do zmiennych przepływu, pamięci podręcznej ani innych encji bezpośrednio z aplikacji hostowanych celów.
W przypadku osadzonej biblioteki Node.js (tradycyjnej obsługi Node.js opartej na Trireme w Edge) możesz używać interfejsu apigee-access do uzyskiwania dostępu do zmiennych przepływu i innych encji w Edge. Jednak hostowane cele nie obsługują modułu apigee-access dla wdrożeń Node.js.
Zobacz też:
Czy można obejść brak dostępu do apigee?
Migracja istniejącego kodu aplikacji do hostowanych miejsc docelowych
Obecnie nie istnieje automatyczna ścieżka migracji z tradycyjnej umieszczonej na platformie Trireme aplikacji Node.js do hostowanych celów. Możesz jednak ręcznie przekonwertować istniejący kod aplikacji na docelowe aplikacje hostowane. Przykład znajdziesz w sekcji Migracja istniejącego serwera proxy Node.js do serwera proxy hostowanych celów.