Visão geral dos destinos hospedados

Você está vendo a documentação do Apigee Edge.
Acesse a documentação da Apigee X.
informações

Os destinos hospedados permitem executar aplicativos Node.js em um ambiente de execução nativo hospedado pela Apigee. O objetivo dos Destinos hospedados é simples: permitir que você implante aplicativos em um ambiente nativo, seguro, escalonável e isolado em que os proxies da API Edge possam chamá-los como serviços de destino.

Conforme ilustrado na figura a seguir, um proxy da API Edge chama um aplicativo Node.js implantado no ambiente de destinos hospedados. Observe que o ambiente de destinos hospedados é delimitado em um ambiente da organização da Apigee.

Para conseguir que um proxy da API Edge se comunique com um aplicativo de destinos hospedados corretamente criado e implantado requer uma configuração simples no endpoint de destino do proxy. Para começar, acesse os tutoriais de destinos hospedados.

Quais ambientes de execução de aplicativo são compatíveis com os Destinos hospedados?

No momento, só é possível implantar apps Node.js nos destinos hospedados.

Como instalar destinos hospedados

Os destinos hospedados estão disponíveis em todas as organizações de nuvem pública de borda. Não é necessário instalar nada para usar os destinos hospedados.

Como verificar se os destinos hospedados está ativado

Se você quiser verificar se sua organização está com os destinos hospedados ativados, acesse os detalhes dela e verifique se a propriedade features.isEdgeFunctionsEnabled está definida como verdadeira. A propriedade é somente leitura.

Exemplo:

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"
  }
  

O que você precisa saber sobre os destinos hospedados

Os destinos hospedados permitem que aplicativos Node.js sejam executados em um ambiente nativo que não dependa de nenhuma tecnologia de tempo de execução específica da Apigee. Depure e teste seu aplicativo localmente antes de implantá-lo e tenha certeza de que a versão implantada funcionará exatamente como funciona localmente. No momento da implantação, escolha qualquer versão de ambiente de execução do aplicativo para executá-lo em destinos hospedados. Por exemplo, é possível escolher executar um app Node.js em um ambiente v8.10.0.

Limites

Para limites de uso em destinos hospedados, consulte Limites de produtos da Apigee.

Etapas básicas a serem seguidas

Se você estiver familiarizado com o desenvolvimento de proxy de borda, basta aprender algumas etapas simples para usar os destinos hospedados com sucesso. Essencialmente, você cria, implanta e gerencia proxies de borda para destinos hospedados da mesma forma que qualquer outro proxy do Apigee Edge.

Para usar os destinos hospedados, você precisa realizar as tarefas a seguir. Os tutoriais mostram cada uma dessas tarefas em detalhes.

  • Desenvolva e teste o aplicativo Node.js localmente.
  • Crie um arquivo de manifesto no diretório raiz do projeto do seu aplicativo. O manifesto é um arquivo YAML que especifica as informações necessárias para criar e implantar o aplicativo.
  • Adicione seu aplicativo ao proxy de borda como um tipo de recurso hospedado.
  • No endpoint de destino do proxy, adicione uma tag <HostedTarget/> vazia. Essa tag instrui o Edge a implantar o aplicativo Node.js no ambiente de destinos hospedados. Por exemplo:
  • <?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>

Escopo dos aplicativos de destinos hospedados

Os aplicativos de Destinos hospedados têm um escopo definido para um ambiente da organização de Edge. Esse escopo é igual a qualquer proxy do Edge.

Os aplicativos de Destinos hospedados podem acessar dados do proxy?

No momento, os apps de Destinos hospedados não têm acesso ao ambiente de execução do proxy. Isso significa que não é possível acessar variáveis de fluxo, caches e outras entidades diretamente dos aplicativos de Destinos hospedados.

Com o Node.js incorporado (o suporte tradicional para Node.js baseado no Trireme no Edge), é possível usar o apigee-access para acessar variáveis de fluxo e outras entidades no Edge. No entanto, os destinos hospedados não são compatíveis com o módulo apigee-access para implantações do Node.js. Consulte também É possível contornar a falta de acesso à Apigee?

Como migrar o código do aplicativo atual para destinos hospedados

No momento, não há um caminho de migração automatizada de um aplicativo Node.js incorporado tradicional baseado no Trireme para os destinos hospedados. No entanto, é possível converter o código do aplicativo em destinos hospedados manualmente. Por exemplo, consulte Como migrar um proxy Node.js para um proxy de destinos hospedados.