Você está lendo a documentação do Apigee Edge.
Acesse a
documentação da Apigee X. info
É possível hospedar suas APIs Node.js no Apigee Edge, em que os proxies de API podem chamá-las como serviços de destino.
O suporte do Node.js no Apigee Edge permite criar serviços de back-end personalizados para seus proxies no Node.js. Essencialmente, o Apigee Edge hospeda seu código Node.js em um ambiente de execução com escopo para uma organização e ambiente da 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 os aplicativos Node.js sejam executados em um ambiente nativo que não depende de nenhuma tecnologia de execução específica da Apigee. Ele oferece um ambiente de execução de nó nativo para que você possa usar seus pacotes de nó favoritos.
É possível depurar e testar seu app localmente antes de implantá-lo e garantir que a versão implantada funcione exatamente como a local. No momento da implantação, você pode escolher qualquer versão do ambiente de execução do aplicativo para executá-lo em destinos hospedados. Por exemplo, você pode escolher especificamente executar um app Node.js em um ambiente v8.10.0 ou qualquer outra versão.
A figura a seguir ilustra a arquitetura básica:
O ambiente de execução de destinos hospedados tem escopo para uma organização e ambiente da Apigee e pode servir como destino para qualquer proxy de API implantado nessa mesma organização e ambiente.
Implantar no ambiente tradicional incorporado 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 interpretador JavaScript chamado (Rhino). Esses componentes permitem que o código Node.js seja executado diretamente no ambiente de execução Java do Edge.
O ambiente de execução tradicional incorporado do Node.js tem escopo para uma organização e ambiente da Apigee e pode servir como destino para qualquer proxy de API implantado em essa mesma 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 no código do aplicativo Node.js.
Como escolher uma abordagem do Node.js
A Apigee recomenda o uso de destinos hospedados. Os apps Node.js implantados em destinos hospedados não dependem de nenhuma tecnologia de execução do Node.js específica da Apigee. Seu app Node.js será executado em 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:
- Somente uma versão mais antiga do Node.js (0.10.32) é compatível.
- Há diferenças sutis no comportamento entre o ambiente padrão do Node.js e o ambiente Trireme/Rhino.
- É difícil depurar apps Node.js depois que eles são implantados no Edge.
No momento, os destinos hospedados não oferecem suporte ao uso de apigee-access para acessar recursos no contexto do fluxo de proxy, como variáveis de fluxo.
Para saber mais sobre a implantação tradicional do Node.js Edge, consulte Implantação tradicional do Node.js no Edge.
Casos de uso
Os casos de uso comuns do Node.js no Edge incluem:
Criação de APIs e serviços de back-end HTTP autônomos altamente personalizados.
Resolução de problemas complexos e de otimização para dispositivos móveis com a vantagem de um endpoint de destino programável.
Criação de serviços compostos e mashups.
Desenvolvimento rápido de protótipos de novas APIs usando frameworks como o Express.
Próxima etapa
Para decidir qual abordagem de implantação do Node.js é a melhor para você, leia as visões gerais: