DocumentaçãoAEMTutoriais do AEM as a Cloud Service

Estratégia de implantação do AEM Edge Function no Edge Delivery Services

Última atualização: 29 de julho de 2026
  • Aplica-se a:
  • Experience Manager as a Cloud Service

Criado para:

  • Intermediate
  • Developer
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.

No Edge Delivery Services, uma AEM Edge Function está associada a um site, e cada site é mapeado para uma ramificação Git. Um programa recebe exatamente 3 instâncias do AEM Edge Function, um orçamento fixo, independentemente de quantas ramificações seu repositório tem. Planeje sua estratégia de ramificação em torno desse orçamento antes de criá-lo em seu processo de lançamento.

Como as funções do AEM Edge são definidas no escopo

Função do AEM Edge vinculada a
Limite de implantação
Programa Edge Delivery Services
3 por programa (ramificação principal, de preparo e de desenvolvimento, mapeada para os sites de produção, de preparo e de desenvolvimento)

Cada site, Produção, Preparo e Desenvolvimento mapeia para uma ramificação fixa (main, stage e dev respectivamente) e obtém sua própria instância de Função AEM Edge.

Modelo de implantação do AEM Edge Function no Edge Delivery Services

Promover código pelos seus sites

No Edge Delivery Services, sua configuração de CDN (edgeFunctions.yaml e cdn.yaml) e seu código de Função do AEM Edge ficam no mesmo repositório do projeto do AEM Edge Functions. As etapas de alto nível para promover o código para o próximo site são:

  1. Mescle sua configuração e as alterações de código da Função Edge do AEM na ramificação mapeada para o site de destino (por exemplo, dev em stage).

  2. No Cloud Manager, verifique se o pipeline de configuração do Edge Delivery Services usa a ramificação mesclada.

  3. Execute o pipeline de configuração do Edge Delivery para implantar os arquivos edgeFunctions.yaml e cdn.yaml.

  4. Verifique se o contexto da CLI (ou sistema de CI/CD) usa a ramificação mesclada e direciona o site desejado usando o comando aio aem edge-functions info.

  5. Execute o aio aem edge-functions deploy <name> (por meio da CLI ou do sistema CI/CD) para implantar o código de função no site de destino.

Gerenciar segredos entre sites

O Edge Delivery Services tem um pipeline de configuração por programa, não um por site. Os sites Desenvolvimento, Preparo e Produção compartilham tudo, de modo que não é possível adicionar o mesmo nome de variável três vezes com três valores diferentes.

No Cloud Manager, abra o pipeline de configuração do Edge Delivery do programa e selecione Exibir/Editar variáveis. Adicione um segredo por site, com o prefixo para que os três sites nunca colidam, por exemplo DEV_TRIPS_API_TOKEN, STAGE_TRIPS_API_TOKEN e MAIN_TRIPS_API_TOKEN. Para obter as etapas exatas, consulte Usar configurações e segredos.

As configurações não secretas funcionam da mesma forma independentemente do site: você as declara diretamente em edgeFunctions.yaml, confirmadas no Git. Para obter as etapas exatas, consulte Usar configurações e segredos.

Planejar o SDLC em torno do escopo do site

  • Testar lógica de função na ramificação dev antes de mesclar para stage ou main.
  • Prefixe cada segredo e nome de variável com seu site (DEV_, STAGE_, MAIN_), já que um pipeline de configuração serve todos os três sites.
  • Rastrear a configuração e o desvio secreto entre sites como parte de sua lista de verificação de lançamento, não como uma reflexão posterior.

Recursos adicionais

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