Você está vendo 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 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 ser chamados como serviços de destino.
Conforme ilustrado na figura a seguir, um proxy da API Edge chama um aplicativo Node.js que é implantado no ambiente de destinos hospedados. O ambiente de destinos hospedados tem o escopo definido dentro de uma organização organization:environment da Apigee.
Para fazer com que um proxy da API do Edge se comunique com um aplicativo de destino hospedado 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 apps Node.js em destinos hospedados.
Como instalar destinos hospedados
O Hosted Targets está disponível em todas as organizações da 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 sua organização tem
os destinos hospedados ativados, confira
os detalhes da organização 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 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. É possível depurar e testar o app localmente antes da implantação e ter a certeza de que a versão implantada vai funcionar 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 nos destinos hospedados. Por exemplo, você pode escolher especificamente executar um app Node.js em um ambiente v8.10.0.
Limites
Para saber os limites de uso em destinos hospedados, consulte Limites de produtos da Apigee.
Etapas básicas
Se você já conhece o desenvolvimento de proxy da Edge, basta aprender algumas etapas simples para usar as metas hospedadas. Basicamente, você cria, implanta e gerencia proxies do Edge para destinos hospedados assim como faz com qualquer outro proxy do Apigee Edge.
Para usar destinos hospedados, você precisa realizar as tarefas a seguir. Nos tutoriais, explicamos 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 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 destino hospedados têm escopo para um ambiente de organização do Edge. Esse escopo é o mesmo para qualquer proxy do Edge.
Os aplicativos de Destinos Hospedados podem acessar dados do proxy?
No momento, os apps de destino hospedados não têm acesso ao ambiente de execução do proxy. Isso significa que não é possível acessar variáveis, caches e outras entidades do fluxo diretamente dos aplicativos do Target hospedado.
Com o Node.js incorporado (o suporte tradicional do Node.js baseado em Trireme no Edge), é possível usar o
apigee-access para
acessar variáveis de fluxo e outras entidades no Edge. No entanto, o destino hospedado não oferece 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
No momento, não há um caminho de migração automatizado de um aplicativo Node.js incorporado baseado em Trireme tradicional para destinos hospedados. No entanto, é possível converter o código do aplicativo atual em destinos hospedados manualmente. Para conferir um exemplo, consulte Como migrar um proxy do Node.js para um proxy de destino hospedado.