Omówienie hostowanych celów

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

Hostowane obiekty docelowe umożliwiają uruchamianie aplikacji Node.js w natywnym środowisku wykonawczym hostowanym przez Apigee. Cel hostowanych obiektów docelowych jest prosty: umożliwia wdrażanie aplikacji w natywnym, bezpiecznym, skalowalnym i izolowanym środowisku, gdzie serwery proxy Edge API mogą je wywoływać jako usługi docelowe.

Jak widać na ilustracji poniżej, serwer proxy interfejsu Edge API wywołuje aplikację Node.js, która jest wdrożona w środowisku hostowanych obiektów docelowych. Pamiętaj, że środowisko hostowanych celów jest ograniczone do organizacji:środowisko Apigee.

Uzyskanie serwera proxy Edge API do komunikacji z prawidłowo skompilowaną i wdrożoną aplikacją hostowanych celów wymaga prostej konfiguracji w docelowym punkcie końcowym serwera proxy. Na początek zapoznaj się z samouczkami dotyczącymi hostowanych celów.

Jakie środowiska wykonawcze aplikacji obsługują hostowane elementy docelowe?

Obecnie w hostowanych miejscach docelowych możesz wdrażać tylko aplikacje Node.js.

Instalowanie hostowanych celów

Hostowane cele są dostępne we wszystkich organizacjach publicznych Edge w chmurze. Aby używać hostowanych celów, 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 sprawdź, czy właściwość features.isEdgeFunctionsEnabled ma wartość Prawda. Usługa 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 kampaniach docelowych

Hostowane cele umożliwiają uruchamianie aplikacji Node.js w środowisku natywnym, które nie zależy od żadnej technologii środowiska wykonawczego specyficznego dla Apigee. Przed wdrożeniem aplikacji możesz ją debugować i przetestować lokalnie. Masz pewność, że wdrożona wersja będzie działać dokładnie tak samo jak lokalnie. W momencie wdrażania możesz wybrać dowolną wersję środowiska wykonawczego aplikacji, w której będzie ona uruchamiana w hostowanych obiektach docelowych. Możesz na przykład wybrać uruchamianie aplikacji Node.js w środowisku w wersji 8.10.0.

Ograniczenia

Informacje o limitach wykorzystania hostowanych celów znajdziesz w artykule Limity korzystania z usługi Apigee.

Podstawowe czynności do wykonania

Jeśli znasz programowanie serwerów proxy na serwerach brzegowych, musisz tylko wykonać kilka prostych czynności, aby prawidłowo korzystać z hostowanych celów. Zasadniczo tworzysz i wdrażasz serwery proxy Edge dla hostowanych celów, tak jak w przypadku każdego innego serwera proxy Apigee Edge, oraz zarządzasz nimi.

Aby używać hostowanych celów, wykonaj podane niżej czynności. W samouczkach szczegółowo omówiono każdy z tych zadań.

• Programuj i testuj aplikację 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 Edge serwera proxy jako hostowany typ zasobu.
• W docelowym punkcie końcowym serwera proxy dodaj pusty tag <HostedTarget/>. Ten tag informuje Edge, że ma wdrożyć aplikację Node.js w środowisku hostowanych obiektów docelowych. Na 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 hostowanych elementów docelowych

Aplikacje hostowanego elementu docelowego są ograniczone do środowiska organizacji Edge. Ten zakres jest taki sam jak w przypadku dowolnego serwera proxy Edge.

Czy aplikacje hostowanego obiektu docelowego mają dostęp do danych serwera proxy?

Aplikacje hostowanego elementu docelowego nie mają obecnie dostępu do środowiska wykonawczego serwera proxy. Oznacza to, że nie można uzyskać dostępu do zmiennych przepływu, pamięci podręcznych ani innych encji bezpośrednio z aplikacji hostowanych celów.

Gdy masz osadzony Node.js (tradycyjną obsługę Node.js opartą na Trireme w Edge), możesz używać elementu apigee-access do uzyskiwania dostępu do zmiennych przepływu i innych elementów w Edge. Jednak hostowane cele nie obsługują modułu apigee-access w przypadku wdrożeń Node.js. Zobacz też Czy można obejść brak dostępu do Apigee?

Migracja istniejącego kodu aplikacji do hostowanych celów

Obecnie nie ma ścieżki automatycznej migracji z tradycyjnej osadzonej aplikacji Node.js opartej na Trireme do hostowanych celów. Możesz jednak ręcznie przekonwertować istniejący kod aplikacji na hostowane elementy docelowe. Przykład znajdziesz w sekcji Migracja istniejącego serwera proxy Node.js do serwera proxy hostowanych celów.