Você está vendo a documentação do Apigee Edge.
Acesse a
documentação da Apigee X. informações
É possível hospedar suas APIs do Node.js na Apigee Edge, onde os proxies da API podem chamá-las como serviços de destino.
Com o suporte do Node.js no Apigee Edge, você pode criar serviços de back-end personalizados para seus proxies no Node.js. Essencialmente, o Apigee Edge hospeda o código Node.js em um ambiente de execução com escopo para uma organização e um ambiente Apigee. Os proxies de API implantados na mesma organização e ambiente podem chamar APIs baseadas em HTTP expostas pelo aplicativo Node.js.
Opções de implantação do Node.js
A Apigee oferece duas opções para hospedar o código Node.js: Destinos hospedados e o ambiente de implantação tradicional do Node.js Edge.
Implantar em 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. Ele fornece um ambiente de execução de nó nativo para que você possa usar seus pacotes de nós favoritos.
É possível depurar e testar seu app localmente antes de implantá-lo e ter 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 executar especificamente um app Node.js em um ambiente v8.10.0 ou qualquer outra versão.
A figura abaixo ilustra a arquitetura básica:
O ambiente de execução de destinos hospedados tem um escopo definido para uma organização e um ambiente da Apigee e pode servir como o destino para qualquer proxy de API implantado nessa mesma organização e ambiente.
Implante no ambiente integrado tradicional do Node.js
A abordagem tradicional para implantar o Node.js no Edge depende internamente de um aplicativo de ponte de código aberto chamado Trireme e de um intérprete de JavaScript chamado Rhino. Esses componentes permitem que o código Node.js seja executado diretamente no ambiente de execução do Edge Java.
O ambiente de execução tradicional e incorporado do Node.js tem como escopo uma organização e ambiente da Apigee e pode servir como destino para todos os proxies de API implantados nessa organização e ambiente.
Com essa abordagem, é possível usar um módulo de suporte chamado apigee-access que permite acessar variáveis de fluxo de proxy de API, caches, mapas de chave-valor e cotas de dentro do código do aplicativo Node.js.
Como escolher uma abordagem com Node.js
A Apigee recomenda o uso de destinos hospedados. Os aplicativos Node.js implantados em destinos hospedados não dependem de nenhuma tecnologia de tempo de execução Node.js específica da Apigee. O aplicativo Node.js será executado nos destinos hospedados exatamente como é executado no ambiente de desenvolvimento local.
Além disso, o suporte da Apigee para a implantação tradicional do Node.js Edge tem limitações:
- Apenas uma versão mais antiga do Node.js (0.10.32) é compatível.
- Há diferenças sutis de comportamento entre os ambientes padrão do Node.js e do Trireme/Rhino.
- Depurar apps Node.js após a implantação no Edge é difícil.
Atualmente, os destinos hospedados não são compatíveis com o uso de apigee-access para acessar recursos no contexto de fluxo de proxy, como variáveis de fluxo.
Para saber mais sobre a implantação tradicional do Node.js no Edge, consulte Implantação tradicional do Node.js no Edge.
Casos de uso
Casos de uso comuns para Node.js no Edge incluem:
Criar APIs e serviços de back-end baseados em HTTP autônomos altamente personalizados.
Resolver problemas complexos e de otimização de dispositivos móveis com a vantagem de um endpoint de destino programável.
Criação de serviços compostos e mashups.
Desenvolver protótipos rapidamente de novas APIs usando frameworks como o Express.
Próxima etapa
Para decidir qual é a melhor abordagem de implantação do Node.js para você, leia as visões gerais: