Você está lendo a documentação do Apigee Edge.
Acesse a
documentação da Apigee X. info
Os destinos hospedados permitem executar aplicativos Node.js em um ambiente de execução nativo ambiente 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 de API do Edge possam chamá-los como serviços de destino.
Como ilustrado na figura a seguir, um proxy de API do Edge chama um aplicativo Node.js que é implantado no ambiente de destinos hospedados. O ambiente de destinos hospedados tem escopo em uma organização:ambiente da Apigee.
Para que um proxy de API do Edge se comunique com um aplicativo de destinos hospedados criado e implantado corretamente é necessária 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 aplicativos 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. Não é necessário instalar nada para usar os destinos hospedados.
Como verificar se os destinos hospedados estão ativados
Se você quiser verificar se a organização tem
destinos hospedados ativados, acesse
os detalhes da organização e verifique se a features.isEdgeFunctionsEnabled
propriedade está definida como "true". 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 execução específica da Apigee. É possível depurar e testar o app localmente antes de implantá-lo e garantir que a versão implantada funcione exatamente como a local. No momento da implantação, é possível 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 aplicativo Node.js em um ambiente v8.10.0.
Limites
Para limites de uso em destinos hospedados, consulte Limites de produto da Apigee.
Etapas básicas a seguir
Se você estiver familiarizado com o desenvolvimento de proxy do Edge, só precisará aprender algumas etapas simples para usar os destinos hospedados. Basicamente, você cria, implanta e gerencia proxies do Edge para destinos hospedados da mesma forma que faz para qualquer outro proxy do Apigee Edge.
Para usar destinos hospedados, é necessário realizar as tarefas a seguir. Os tutoriais explicam 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 as informações necessárias para criar e implantar o aplicativo.
- Adicione o aplicativo ao proxy do Edge como um recurso hospedado tipo.
- No endpoint de destino do proxy, adicione uma tag
<HostedTarget/>vazia. Essa tag informa ao Edge para implantar o aplicativo Node.js no ambiente de destinos hospedados. 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 de aplicativos de destinos hospedados
Os aplicativos de destinos hospedados têm escopo em uma organização:ambiente do Edge. Esse escopo é o mesmo de qualquer proxy do Edge.
Os aplicativos de destinos hospedados podem acessar dados de proxy?
No momento, os aplicativos 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 de aplicativos de destinos hospedados.
Com o Node.js incorporado (o suporte tradicional do Node.js baseado em Trireme no Edge), é possível usar
apigee-access para
acessar 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 apigee-access?
Como migrar o código do aplicativo atual para destinos hospedados
No momento, não há um caminho de migração automatizado de um aplicativo Node.js incorporado tradicional baseado em Trireme para destinos hospedados. No entanto, é possível converter o código do aplicativo atual para destinos hospedados manualmente. Para conferir um exemplo, consulte Como migrar um proxy Node.js atual para um proxy de destinos hospedados.