Funções do AEM Edge

IMPORTANT
O AEM Edge Functions está atualmente na versão beta. Os recursos e a documentação podem mudar. Para receber comentários, contate aemcs-edgecompute-feedback@adobe.com.

As funções do AEM Edge permitem executar o JavaScript no Adobe CDN na borda, próximo aos visitantes e sem uma viagem de ida e volta para a origem. Eles funcionam em sites do AEM as a Cloud Service e do Edge Delivery Services com o CDN gerenciado pela Adobe.

O que são as funções do AEM Edge

As Funções do AEM Edge são módulos do JavaScript implantados e executados no Adobe CDN (viabilizados pelo Fastly Compute). Quando uma solicitação corresponde a uma regra de roteamento CDN em cdn.yaml, a Função Edge do AEM a intercepta, lê cabeçalhos, chama back-ends, transforma respostas e retorna o resultado da borda.

Padrões comuns incluem personalização renderizada pelo servidor, proxy seguro da API e agregação de resposta.

Quando usar as funções do AEM Edge

Use o guia a seguir ao escolher entre as Funções do AEM Edge e outras opções de extensibilidade do AEM.

Cenário
Método recomendado
Executar lógica personalizada, chamar APIs externas, personalizar respostas na borda
Funções do AEM Edge
Lógica de negócios complexa com contexto completo do AEM (para pilha Java do AEM as a Cloud Service) na origem
Serviço OSGi ou servlet Sling

Prefira as Funções Edge do AEM para conteúdo dinâmico ou dados que precisem de velocidade, segurança e escalabilidade sem precisar de uma viagem de ida e volta até a origem.

Por que usar as funções do AEM Edge

As funções do AEM Edge abordam quatro desafios comuns ao criar experiências dinâmicas fornecidas por CDN.

Benefício
Descrição
Desempenho
Menor tempo para o primeiro byte com execução de borda e sem viagem de ida e volta de origem para padrões comuns
SEO
HTML renderizado pelo servidor no primeiro rastreo, amigável para mecanismos de pesquisa e rastreadores de IA
Segurança
As credenciais e os segredos da API permanecem no lado do servidor e nunca são expostos no JavaScript do cliente
Personalização
Personalize o conteúdo por localização geográfica, dispositivo ou público-alvo antes que a página seja carregada

Como funciona

Uma Função Edge do AEM fica entre o cache da CDN e seus backends. Ele processa solicitações correspondentes antes que elas atinjam a origem.

Fluxo de solicitação de Funções do AEM Edge {align="center"}

Existem duas camadas de cache independentes: o cache da CDN (o que o navegador vê) e o cache de busca (o que a Função do AEM Edge vê ao chamar back-ends). Invalidar cada camada separadamente quando os dados subjacentes forem alterados.

Para obter mais informações, consulte Armazenamento em cache em funções do AEM Edge.

Como começar

Escolha se você está usando o site do AEM as a Cloud Service ou Edge Delivery Services e siga o tutorial de configuração. Você implanta uma JavaScript AEM Edge Function com /hello-world e /weather rotas, configura o roteamento CDN, envia o código para o Adobe CDN e verifica as respostas da borda.

Configurar no AEM as a Cloud Service

Configurar no AEM as a Cloud Service

Instale a CLI, implante o WKND (ou seu site), configure o roteamento CDN e verifique os endpoints do AEM Edge Function no AEM as a Cloud Service.

Configurar

Configurar no Edge Delivery Services

Configurar no Edge Delivery Services

Integre seu site do Edge Delivery no Cloud Manager, vincule seu repositório e implante os endpoints do AEM Edge Function no Edge Delivery Services.

Configurar

Como

Guias focados em código para padrões comuns de funções do AEM Edge.

Tópico
Descrição
Criar um ponto de extremidade de API
Expor pontos de extremidade HTTP com o manipulador de eventos de busca, seletores de origem CDN e chamadas de API de terceiros ou de busca de saída opcionais
Atender a vários pontos de extremidade
Uma função pode expor muitos endpoints; organize a lógica do manipulador conforme a API cresce
Filtros de solicitação HTTP
Ajustar solicitações ou respostas HTTP na CDN com regras do seletor de origem e um manipulador de busca

Limites da plataforma

Lembre-se dos seguintes limites ao projetar a lógica da função AEM Edge.

Limite
Valor
Máximo de chamadas de busca de saída por invocação
32
Máximo de funções do AEM Edge (AEM as a Cloud Service)
1 por ambiente
Máximo de funções do AEM Edge (Edge Delivery Services)
3 por programa (para ramificação principal, de preparo e de desenvolvimento do seu projeto do Edge Delivery Services mapeadas para sites de produção, de preparo e de desenvolvimento, respectivamente)
Armazenamentos de configuração, secretos e KV (programas de sandbox)
Não disponível

Para obter a lista completa de limitações, consulte Limitações na documentação do produto AEM Edge Functions.

Recursos adicionais

recommendation-more-help
experience-manager-learn-help-cloud-service