Esta é a documentação do Apigee Edge.
Acesse
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 em um ambiente nativo, seguro, escalonável e isolado que pode ser chamado pelos proxies da API Edge como serviços de destino.
Como ilustrado na figura a seguir, um proxy da API Edge chama um aplicativo Node.js que é implantados no ambiente de destinos hospedados. O ambiente de destinos hospedados tem escopo em uma organização do ambiente da Apigee.
Como conseguir um proxy da API Edge para se comunicar com um aplicativo de destinos hospedados criado e implantado corretamente 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 aplicativos são compatíveis com os destinos hospedados?
No momento, só é possível implantar apps Node.js em destinos hospedados.
Como instalar destinos hospedados
Os destinos hospedados estão disponíveis em todas as organizações do Edge Public Cloud. Você não precisa instalar nada para usar os destinos hospedados.
Como verificar se os destinos hospedados estão ativados
Se você quiser verificar se sua organização
Destinos hospedados ativados, get
os detalhes da organização e verifique se os features.isEdgeFunctionsEnabled
é 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 destinos hospedados
Os destinos hospedados permitem que aplicativos Node.js sejam executados em um ambiente nativo que não depende de nenhuma tecnologia de ambiente de execução específica da Apigee. É possível depurar e testar aplicativo localmente antes de implantá-lo e ter a certeza de que a versão implantada funcionará exatamente como acontece localmente. No momento da implantação, escolha qualquer versão do ambiente de execução do aplicativo executando seu aplicativo nos destinos hospedados. Por exemplo, é possível escolher especificamente executar um app Node.js em um ambiente v8.10.0.
Limites
Para saber os limites de uso em destinos hospedados, consulte a página Produto da Apigee limites de desempenho.
Etapas básicas
Se estiver familiarizado com o desenvolvimento do Edge Proxy, você só precisa aprender algumas etapas simples para usar os Destinos hospedados. Basicamente, você cria, implanta e gerencia proxies do Edge para destinos hospedados assim como para qualquer outro proxy do Apigee Edge.
Para usar destinos hospedados, você precisa realizar as tarefas a seguir. Os tutoriais cada uma dessas tarefas em detalhes.
- Desenvolva e teste seu aplicativo Node.js localmente.
- Crie um arquivo de manifesto. no diretório raiz do projeto do aplicativo. O manifesto é um arquivo YAML que especifica informações necessárias para criar e implantar o aplicativo.
- Adicione o aplicativo ao proxy de borda como um recurso hospedado não é válido.
- No endpoint de destino do proxy, adicione uma tag
<HostedTarget/>vazia. Esta 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 escopo de um ambiente de organização de borda. Esse escopo é igual a qualquer proxy de borda.
Os aplicativos nos Destinos Hospedados podem acessar dados do proxy?
Os apps de destino hospedados não têm acesso ao ambiente de tempo de execução do proxy. Ou seja, não é possível acessar o fluxo variáveis, caches e outras entidades diretamente dos aplicativos de Destinos Hospedados.
Com o Node.js incorporado (o suporte tradicional a Node.js baseado em Trireme no Edge), você pode usar
apigee-access a
de acesso a variáveis de fluxo e outras entidades no Edge. No entanto, os Destinos hospedados não
oferecem suporte ao 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
Não há atualmente um caminho de migração automatizado de uma Aplicativo Node.js incorporado com base em Trireme para destinos hospedados. No entanto, é possível converter o código do aplicativo atual em destinos hospedados manualmente. Por exemplo, consulte Migração um proxy Node.js para um proxy de destinos hospedados.