Quando o AEM como serviço em nuvem foi lançado pela primeira vez, o comportamento da CDN só podia ser controlado (de forma muito limitada) por meio de configurações do Apache para controle de cache. Caso precisasse de mais personalização, sua única opção era trazer sua própria CDN: ou seja, adicionar uma CDN adicional como Cloudflare, Akamai ou uma Fastly configurada por você, além da CDN Fastly integrada e gerenciada pela Adobe.
Introdução ao CDN gerenciado da Adobe para AEM como um serviço em nuvem
No entanto, no ano passado, a Adobe lançou um novo recurso de CDN gerenciado para o AEM Cloud Service, simplificando bastante as configurações híbridas com o Edge Delivery Services (também conhecido como Helix) ou com o AEM baseado em JCR. Temos alguns diagramas de arquitetura e outros exemplos de configuração para isso aqui.
A configuração é feita criando um arquivo /config/cdn.yaml em seu projeto AEM e implantando-o por meio de um pipeline de configuração dedicado para gerenciar configurações específicas do ambiente (por exemplo, DEV, STG, PROD). Esses pipelines leves normalmente são executados em apenas 1 a 2 minutos, permitindo iterações eficientes e testes seguros de novas lógicas de CDN antes da implantação em produção.
No entanto, as implantações em um ambiente de desenvolvimento do AEM como um serviço em nuvem exigem a execução de um pipeline do Cloud Manager, e a execução de um pipeline do Cloud Manager requer um commit no Git. Você não vai querer ficar depurando sua sintaxe E testando sua lógica de configuração com repetidos pushes do Git para o seu branch de desenvolvimento, isso é simplesmente confuso (sem falar no tempo absurdo que consome). Felizmente, existe uma maneira de testar isso localmente com uma configuração mínima, para que você possa se divertir ainda mais testando a mesma coisa quarenta vezes até, com sorte, acertar a sintaxe.
O segredo disso está nos Ambientes de Desenvolvimento Rápido (RDEs) da Adobe.
Configurando e testando configurações de CDN em um AEM RDE
A principal diferença entre os RDEs e os ambientes de Desenvolvimento, Teste e Produção em um ambiente AEM como Serviço em Nuvem é que o RDE deve ser implantado diretamente da estação de trabalho de um desenvolvedor individual usando a interface de linha de comando aio , em vez de por meio de um pipeline do Cloud Manager controlado pelo Git. Esses ambientes são projetados para iteração e depuração rápidas, mas são compartilhados – assim, as alterações podem ser validadas e passar pelos processos de revisão adequados antes de entrarem no ciclo de lançamento Desenvolvimento -> Teste -> Produção.
Configure um ambiente RDE com uma CDN
Para testar suas configurações de CDN em um RDE, primeiro você precisará garantir que tenha um nome de host e um certificado SSL configurados na frente do ambiente RDE em questão, para que você tenha um ambiente de CDN para configurar. Observe também que a maioria dos ambientes AEMaaCS possui apenas um único ambiente RDE provisionado, mas que vários ambientes podem ser provisionados por um custo adicional, e isso pode ter sido incluído no contrato do AEM Cloud Service da sua empresa.
Para configurar isso para um domínio do Edge Delivery Services, faça o seguinte:
(1) Criar domínio no Cloud Manager: Na interface do usuário do Adobe Cloud Manager, acesse Configurações de domínio na barra de navegação à esquerda e clique em Adicionar domínio .
Você precisará configurar isso com um certificado gerenciado pela Adobe, que gerará um código de verificação que você deverá inserir como um registro CNAME em seu provedor de DNS para verificar o certificado. Até que essa etapa de verificação seja concluída, seu certificado aparecerá como "NÃO VERIFICADO".
Após a verificação, você poderá prosseguir para a próxima etapa.
(2) Adicionar o certificado SSL: Depois de verificar a propriedade de um domínio, você pode adicionar um certificado SSL para esse domínio. Você pode usar um certificado gerenciado pela Adobe ou seu próprio certificado, se preferir. Observe que o Cloud Manager só exibirá os domínios que você verificou.
(3) Mapeie o domínio para o seu ambiente RDE no Cloud Manager: Em seguida, você precisará mapear seu domínio para o ambiente RDE no Cloud Manager. Na barra de navegação à esquerda, clique em MAPEAMENTOS DE DOMÍNIO e selecione "CDN Gerenciado pela Adobe" como o tipo de CDN. Escolha o nome do seu ambiente RDE como origem, publish como camada e selecione o domínio e o certificado SSL que você criou para este ambiente RDE.
(4) Mapeie o domínio para a Adobe no DNS: No seu DNS, crie um registro CNAME para mapear seu domínio RDE para cdn.adobeaemcloud.com. Isso permitirá que a Adobe identifique e direcione esse domínio adequadamente.
(5) Certifique-se de que seu arquivo config.yml gerencie ambientes RDE: Por fim, se você seguiu este guia sobre como configurar o Adobe Managed CDN, ao configurar seu cdn.yml, certifique-se de que o RDE esteja listado como um dos ambientes aos quais a configuração se refere:
kind: "CDN"
version: "1"
metadata:
envTypes: ["rde", "dev", "stage", "prod"]
data:
Utilizando a CLI do AIO para enviar configurações para a CDN do RDE.
Depois de configurar um ambiente de desktop remoto (RDE) e prepará-lo para aceitar sua configuração de CDN, você estará pronto para configurar sua estação de trabalho para enviar configurações de CDN para o RDE.
1. Instale o NPM, o Node e o NVM na sua máquina. Você vai querer usar o Node.js 20.
2. Instale o ambiente de execução do Adobe I/O com npm install -g @adobe/aio-cli
3. Instale e atualize seus plugins AIO:aio plugins:install @adobe/aio-cli-plugin-cloudmanager
aio plugins:install @adobe/aio-cli-plugin-aem-rde aio plugins:update
4. Autentique-se com o login aio, que abrirá uma janela do navegador - certifique-se de usar seu perfil IMS para a conta AEMaaCS com a qual você está trabalhando, caso contrário, você pode precisar aio logout e selecionar novamente.
- Organize sua empresa com
aio cloudmanager:org:select
5. Defina o ID do seu programa para o ID da sua organização com aio config:set cloudmanager_programid {YOUR PROGRAM ID GOES HERE}
- Se você quiser ver os ambientes aos quais tem acesso, use
aio cloudmanager:list-environments. Isso mostrará em qual ambiente o RDE está localizado. - Use isso para definir o EnvironmentID do CloudManager. Isso pode ser feito usando
aio config:set cloudmanager_environmentID {YOUR ENVIRONMENT ID GOES HERE}
6. Inicie a configuração do seu ambiente de disco rígido (RDE) com aio aem:rde:setup - ele perguntará se você deseja armazenar localmente; responda que sim, por favor.
7. Tente aio aem:rde:status e veja se ele permite que você use o RDE. Deverá responder da seguinte forma:
PS C:\Users\Noah\Desktop\my-aemaacs> aio aem:rde:status
Running aem:rde:status on cm-p104400-e1291792
Info for cm-p104400-e1291743
Environment: Ready
Após configurar tudo isso, você estará pronto para começar a testar sua configuração. Se ainda não o fez, agora seria um bom momento para criar uma nova ramificação que reflita as suas alterações. Em seguida, você precisará garantir que está no diretório correto da configuração que deseja testar. Depois disso, você pode usar aio aem:rde:install -t env-config ./config para instalar sua configuração de CDN no diretório. Isso listará quaisquer erros de sintaxe que você possa ter.
PS C:\Users\Noah\Desktop\my-aemaacs> aio aem:rde:install -t env-config ./config
Running aem:rde:status on cm-p104400-e1291743
Zipped file /tmp/aio-rde-RF1WAb/config.zip of 2584 total bytes
Uploading ████████████████████████████████████████ 100% | ETA: 0s | 3/3 KB
#42: deploy completed for env-config config.zip on author,publish - done by [email protected] at 2025-10-24T21:15:59.387Z
Logs:
> State: complete
Testar algo como uma configuração de CDN pode ser complicado às vezes, mas existem maneiras de fazer isso localmente. Embora os testes sejam feitos localmente, ainda precisamos utilizar a lógica de backend que será usada pela CDN. Se feito corretamente, isso nos permitirá ver como a configuração da CDN está interagindo com os URLs de teste sem a necessidade de enviá-la para uma ramificação de desenvolvimento.
Seu próximo passo provavelmente será criar uma solicitação de pull request para obter aprovação para enviar suas alterações para o ambiente de desenvolvimento, com base na estratégia de ramificação em uso em sua organização. Após a aprovação da sua solicitação de pull request (PR), as configurações podem ser enviadas para o repositório configurado para seus pipelines do Cloud Manager, de onde poderão ser enviadas para o ambiente de desenvolvimento para testes adicionais e, posteriormente, para o ambiente de produção!
Com essa abordagem, os desenvolvedores individuais podem ser totalmente produtivos no desenvolvimento e teste de configurações de CDN com confiança, sabendo que têm uma ótima chance de funcionar em produção!
Sobre o autor
Noah Mattison
Gerente de Entrega Técnica na Arbory Digital
Noah é formado em Ciência da Computação pela UNC Wilmington, originalmente era um estudante de pré-medicina com paixão por detecção de câncer e IA. Na Arbory, ele ajuda a planejar a execução de projetos, delega tarefas entre equipes, mantém uma comunicação eficaz e apoia as operações internas. Ele acredita na comunidade e na visão da Arbory. Ele tem uma forte consciência ambiental e gosta de se manter ativo ao ar livre, acampando, escalando e passando tempo com os amigos.
Gostou do que ouviu? Tem dúvidas sobre o que é certo para você? Adoraríamos conversar! Entre em contato conosco.