Omówienie hostowanych celów

Wyświetlasz dokumentację Apigee Edge.
Przejdź do dokumentacji Apigee X.
info

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

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

Aby proxy interfejsu Edge API mogło komunikować się z prawidłowo utworzoną i wdrożoną aplikacją hostowanych miejsc docelowych wymaga prostej konfiguracji w docelowym punkcie końcowym proxy. Aby rozpocząć, zapoznaj się z samouczkami dotyczącymi hostowanych miejsc docelowych.

Jakie środowiska wykonawcze aplikacji są obsługiwane przez hostowane miejsca docelowe?

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

Instalowanie hostowanych miejsc docelowych

Hostowane miejsca docelowe są dostępne we wszystkich organizacjach Edge Public Cloud. Aby korzystać z hostowanych miejsc docelowych, nie musisz niczego instalować.

Sprawdzanie, czy hostowane miejsca docelowe są włączone

Jeśli chcesz sprawdzić, czy w Twojej organizacji są włączone hostowane miejsca docelowe, pobierz szczegóły organizacji i upewnij się, że features.isEdgeFunctionsEnabled właściwość ma wartość true. Ta 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 hostowanych miejscach docelowych

Hostowane miejsca docelowe umożliwiają uruchamianie aplikacji Node.js w środowisku natywnym które nie zależy od żadnej technologii środowiska wykonawczego specyficznej dla Apigee. Przed wdrożeniem możesz debugować i testować aplikację lokalnie, mając pewność, że wdrożona wersja będzie działać dokładnie tak samo jak lokalnie. Podczas wdrażania możesz wybrać dowolną wersję środowiska wykonawczego aplikacji, w której ma być uruchamiana aplikacja w hostowanych miejscach docelowych. Możesz na przykład wybrać uruchamianie aplikacji Node.js w środowisku v8.10.0.

Limity

Limity wykorzystania hostowanych miejsc docelowych znajdziesz w artykule Limity produktów Apigee.

Podstawowe kroki

Jeśli znasz się na tworzeniu proxy Edge, wystarczy, że nauczysz się kilku prostych kroków aby skutecznie korzystać z hostowanych miejsc docelowych. Zasadniczo tworzysz, wdrażasz i zarządzasz proxy Edge dla hostowanych miejsc docelowych tak samo jak w przypadku każdego innego proxy Apigee Edge.

Aby korzystać z hostowanych miejsc docelowych, musisz wykonać te czynności: Samouczki szczegółowo opisują każdą z tych czynności.

  • Opracuj i przetestuj aplikację Node.js lokalnie.
  • Utwórz plik manifestu w katalogu głównym projektu aplikacji. Manifest to plik YAML, który zawiera informacje potrzebne do utworzenia i wdrożenia aplikacji.
  • Dodaj aplikację do proxy Edge jako typ zasobu hostowanego.
  • W docelowym punkcie końcowym proxy dodaj pusty tag <HostedTarget/>. Ten tag informuje Edge, że aplikację Node.js należy wdrożyć w środowisku hostowanych miejsc 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 miejsc docelowych

Aplikacje hostowanych miejsc docelowych są ograniczone do organizacji Edge:środowiska. Ten zakres jest taki sam jak w przypadku każdego proxy Edge.

Czy aplikacje hostowanych miejsc docelowych mogą uzyskiwać dostęp do danych proxy?

Aplikacje hostowanych miejsc docelowych nie mają obecnie dostępu do środowiska wykonawczego proxy. Oznacza to, że nie możesz uzyskiwać dostępu do zmiennych przepływu pamięci podręcznych i innych encji bezpośrednio z aplikacji hostowanych miejsc docelowych.

W przypadku wbudowanego Node.js (tradycyjnej obsługi Node.js w Edge opartej na Trireme) możesz używać apigee-access do uzyskiwania dostępu do zmiennych przepływu i innych encji w Edge. Hostowane miejsca docelowe nie obsługują jednak modułu apigee-access w przypadku wdrożeń Node.js. Zobacz też Czy można obejść brak apigee-access?

Migracja istniejącego kodu aplikacji do hostowanych miejsc docelowych

Obecnie nie ma automatycznej ścieżki migracji z tradycyjnej wbudowanej aplikacji Node.js opartej na Trireme do hostowanych miejsc docelowych. Możesz jednak ręcznie przekonwertować istniejący kod aplikacji na hostowane miejsca docelowe. Przykład znajdziesz w artykule Migracja istniejącego proxy Node.js do proxy hostowanych miejsc docelowych.