Baixar e instalar modelos do AEM Sites (serviços em nuvem)
Este guia fornece instruções passo a passo para configurar o modelo mais recente do AEM Guides para gerar páginas do AEM Sites em um ambiente de nuvem. Siga estas etapas para instalar os pacotes necessários, criar e configurar predefinições e gerar o AEM Sites.
Pré-requisitos
Antes de continuar com a configuração, verifique se os seguintes pré-requisitos foram atendidos:
-
Nuvem do Adobe Experience Manager (AEM): uma instância em execução do AEM as a Cloud Service com o AEM Guides 2502 ou versões posteriores.
-
Permissões necessárias: você deve ter as seguintes permissões:
- Acesso ao Cloud Manager para implantar pacotes.
- Acesso ao Repositório Git associado ao seu ambiente.
- Permissões para criar e modificar predefinições no AEM Guides.
-
Baixar Pacotes: baixe os seguintes pacotes do Portal de Distribuição de Software:
- Pacote de componentes: guides-components.all-1.x.0.zip
- Modelo de sites: aemg-docs-1.x.0.zip
Instalação de pacote por meio da implantação na nuvem
Instale o Pacote de Componentes (guides-components.all-1.x.x.zip) e execute as seguintes etapas
-
Clonar repositório Git:
-
Navegue até Repositórios no painel esquerdo do Cloud Manager.
-
Selecione Acessar informações do repositório e copie o comando git clone.
-
Clonar o repositório no sistema local usando o nome de usuário e a senha fornecidos (gerar senha, se necessário).
-
-
Adicionar Pacote ao Pacote Maven:
-
No repositório clonado localmente, crie um novo pacote Maven ou adicione a um existente.
-
Verifique se a estrutura /jcr_root/apps/fmdita/install existe no projeto Maven.
-
Coloque o arquivo guides-components.all-1.x.x.zip baixado na pasta de instalação.
-
-
Atualizar filters.xml:
-
Abra o arquivo filters.xml localizado na pasta META-INF do diretório de conteúdo principal.
-
Adicione o seguinte filtro: filter root="/apps/fmdita" mode="merge"/
-
-
Configurar pom.xml: Atualize o arquivo pom.xml de acordo com os requisitos de ambiente.
-
Enviar alterações e executar o pipeline:
- Envie as alterações para o repositório Git principal.
- Navegue até Pipelines no Cloud Manager e execute o pipeline para o ambiente desejado.
-
Verificar instalação: depois que a implantação for concluída, o pacote de componentes será instalado no ambiente da AEM Cloud.
Criar site usando modelos instalados
-
Importar Modelo de Sites:
- Acesse a página do AEM Sites (servername/sites.html/content).
- Selecione Criar > Site do Modelo.
- Importe o modelo de sites aemg-docs-1.x.x.zip usando a opção Importar.
-
Selecionar Modelo: Selecione AEMG Docs 1.x.x e Avançar.
-
Inserir Detalhes do Site: Insira o Título do Site e o Nome do Site.
-
Selecione Criar.
Criar predefinição de site do AEM
-
Criar uma nova predefinição:
-
Abra um mapa DITA no AEM Guides e navegue até o painel Saída.
-
Selecione Criar Predefinição.
-
Selecione o tipo como AEM Sites.
-
Insira um nome para a predefinição.
-
Desmarque a configuração Usar mapeamento de componente herdado.
-
Selecione Adicionar para criar a predefinição.
-
-
Configurar predefinição do site AEM: Há duas opções para configurar o site pronto para uso (OOTB):
Opção 1: Usar a Lista Suspensa de Sites
-
Selecione Site como o criado acima (por exemplo, Site AEMG Docs).
-
Verifique se o Caminho de publicação e o modelo de Página de tópico estão definidos automaticamente como:
- Caminho de publicação: /content/AEMG-Docs-Site/en/docs/product
- Modelo da página de tópico: Página de tópico
Opção 2: Usar o Caminho do Site
-
Defina o Caminho do site manualmente como /content/AEMG-Docs-Site/en/docs/product.
-
Verifique se o modelo de Página de Tópico está automaticamente definido como Página de Tópico.
-
-
Salvar a predefinição: Salve as alterações feitas na predefinição.
Gerar AEM Sites
-
Gerar Site:
- Com a predefinição configurada, gere o site do AEM para o mapa DITA correspondente.
- O site gerado estará disponível no caminho: /content/AEMG-Docs-Site/en/docs/product.
-
Alterar o Caminho de Geração Padrão (Opcional): Se desejar alterar o caminho padrão para geração de site, execute as seguintes etapas:
-
Navegue até AEM Sites.
-
Crie uma nova página de produto na estrutura do site OOTB.
-
Navegue até Documentação do AEMG > Inglês > Documentação.
-
Selecione o bloco Página inicial e selecione Avançar.
-
Insira o Título e o Nome da página.
-
Selecione Criar.
-
Consulte a documentação oficial de Implantação do AEM as a Cloud Service para obter mais detalhes.