Habilitar o pipeline de front-end enable-front-end-pipeline
Saiba como você pode ativar o pipeline de front-end para sites existentes a fim de usar temas de site para personalizar seu site mais rapidamente.
Visão geral overview
O pipeline de front-end é um mecanismo que pode implantar rapidamente apenas o código front-end de seus sites, com base em temas de site e modelos de site.
Esse pipeline lida somente com o código front-end, tornando o processo de implantação mais rápido do que as implantações de pilha completa. Ele permite que desenvolvedores de front-end personalizem seu site facilmente, sem precisar de conhecimento sobre o AEM.
Sites baseados em modelos de site podem usar o pipeline de front-end por padrão. Este documento descreve como você pode adaptar seus sites existentes para aproveitar o pipeline de front-end.
O AEM pode configurar seu site para carregar temas implantados com o pipeline de front-end, mesmo que ele não tenha sido criado usando modelos de site e temas, criando camadas sobre as bibliotecas de clientes existentes.
Detalhes técnicos technical-details
Quando você ativa o pipeline de front-end para um site, o AEM faz as seguintes alterações na estrutura do site.
- Todas as páginas do site incluem um arquivo CSS e JS adicional, que pode ser modificado ao implantar atualizações por meio de um pipeline de front-end dedicado do Cloud Manager.
- Os arquivos CSS e JS adicionados estão inicialmente vazios. No entanto, você pode baixar uma pasta de "fontes de tema" para configurar a estrutura de pastas necessária para implantar atualizações de código CSS e JS por meio do pipeline.
- Somente um desenvolvedor pode desfazer a alteração, excluindo os nós
SiteConfig
eHtmlPageItemsConfig
que esta operação cria abaixo de/conf/<site-name>/sling:configs
.
Requisitos requirements
O AEM pode adaptar automaticamente seu site existente para usar o pipeline de front-end. Para fazer esse fluxo de trabalho, seu site deve usar v2 ou mais recente do Componente de Página dos Componentes Principais.
Ativação do pipeline de front-end enabling
Consulte Uso da Lista de permissões IP do Cloud Manager com o pipeline de front-end.
A habilitação do site é feita pelo console de Sites, usando o painel Site.
-
Faça logon no AEM e navegue até o site através de Navegação global > Sites.
-
Selecione seu site no console. Selecione a raiz do site e não qualquer página secundária.
-
Com seu site selecionado, abra o seletor de painéis à esquerda e escolha Site.
-
No painel Site, clique no botão Ativar pipeline de front-end.
-
A AEM solicita sua confirmação com uma visão geral das alterações feitas. Confirme e o site estará adaptado.
Agora, seu site está pronto para usar o pipeline de front-end. Para saber mais sobre o pipeline de front-end e gerenciar o tema do site, consulte:
- Usar o painel Site para gerenciar o tema do site
- Jornada de criação rápida de sites - esta jornada de documentação fornece a você uma visão geral do processo de implantação rápida de um site usando o pipeline de front-end e a ferramenta Criação rápida de site.
- Pipelines de CI/CD - este documento descreve o pipeline de front-end no contexto dos pipelines de nível de pilha completa e Web.
Pipeline de front-end e domínios personalizados custom-domains
O pipeline de front-end pode ser usado com o recurso de domínios personalizados do Cloud Manager, mas esteja ciente dos seguintes requisitos ao usar os dois recursos juntos.
Arquivos de front-end estáticos static-files
Os ativos estáticos de front-end implantados por meio do pipeline de front-end serão, por padrão, atendidos a partir do domínio estático predefinido da Adobe.
Se você precisar de um domínio personalizado para ativos front-end, poderá instalar um domínio personalizado no nível de publicação e configurar o Dispatcher para rotear caminhos específicos (como /static/
) para o local de hospedagem estática do Adobe. Este método requer a atualização das regras do Dispatcher para encaminhar e armazenar em cache corretamente as solicitações de ativos estáticos.
Depois de configurar o domínio e o dispatcher personalizados, você pode configurar o AEM para distribuir os ativos de front-end a partir do domínio estático.
Configuração configuration
Conforme descrito na seção Detalhes Técnicos, ativar o recurso de Pipeline de Front-End para um site cria um SiteConfig
e HtmlPageItemsConfig
nós abaixo de /conf/<site-name>/sling:configs
.
Se você quiser usar o recurso de domínios personalizados do Cloud Manager para seu site junto com o pipeline de front-end para ativos de status, propriedades adicionais deverão ser adicionadas a esses nós.
-
Defina a propriedade
customFrontendPrefix
emSiteConfig
para o site.- Vá até
/conf/<site-name>/sling:configs/com.adobe.aem.wcm.site.manager.config.SiteConfig
. - Adicionar ou atualizar a propriedade
customFrontendPrefix = "https://your-custom-domain.com/static/"
.
- Vá até
-
Isso atualiza o valor
prefixPath
deHtmlPageItemsConfig
com o domínio personalizado.-
Vá até
/conf/<site-name>/sling:configs/com.adobe.cq.wcm.core.components.config.HtmlPageItemsConfig
. -
Verifique se
prefixPath
reflete seu domínio personalizado, comoprefixPath = "https://your-custom-domain.com/static/<hash>/..."
.
- Esse valor também pode ser substituído manualmente, conforme necessário.
-
-
Verifique sua configuração.
- Após a implantação, verifique se as páginas estão referenciando corretamente artefatos de tema do domínio personalizado.
- Abra as ferramentas de desenvolvedor do seu navegador e inspecione os caminhos de arquivo
theme.css
etheme.js
para confirmar se eles foram carregados do domínio correto.
As páginas para o site fazem referência a artefatos de tema desse URL atualizado. O dispatcher encaminha solicitações desses recursos para o domínio estático.
Práticas recomendadas para desenvolvedores de front-end best-practices
Se você precisar desenvolver e testar os ativos de front-end localmente antes de implantar por meio do pipeline de front-end, considere as seguintes abordagens:
- Use o Modo Proxy do Construtor de Temas do Site para substituir artefatos de tema localmente para teste.
- Exiba manualmente seus arquivos de tema de um servidor de desenvolvimento local e atualize o
prefixPath
noHtmlPageItemsConfig
para corresponder ao endereço do servidor local. - Verifique se o cache do navegador está desativado durante o teste para ver as atualizações em tempo real.
Para obter mais detalhes sobre o desenvolvimento de front-end local, consulte a documentação do Criador de temas do site.