Configurar tempo de execução de AEM local

O Adobe Experience Manager (AEM) pode ser executado localmente usando o AEM como um Jar de início rápido do SDK do Cloud Service. Isso permite que os desenvolvedores implantem e testem código, configuração e conteúdo personalizados antes de confirmá-los no controle de origem e implantá-los em um AEM como um ambiente Cloud Service.

Observe que ~ é usado como abreviado para o Diretório do usuário. No Windows, este é o equivalente a %HOMEPATH%.

Instalar Java

O Experience Manager é um aplicativo Java e, portanto, requer o SDK do Java para oferecer suporte às ferramentas de desenvolvimento.

  1. Baixe e instale o Java SDK 11 mais recente
  2. Verifique se o SDK do Java 11 está instalado executando o comando:
    • Windows:java -version
    • macOS / Linux: java --version

Java

Baixar o AEM como um SDK do Cloud Service

O AEM como Cloud Service SDK, ou AEM SDK, contém o Quickstart Jar usado para executar o AEM Author e Publicar localmente para desenvolvimento, bem como a versão compatível das Ferramentas do Dispatcher.

  1. Faça logon em https://experience.adobe.com/#/downloads com sua Adobe ID
    • Observe que sua organização do Adobe deve ser provisionada para AEM como Cloud Service para baixar o AEM como um SDK do Cloud Service.
  2. Navegue até a guia AEM como Cloud Service
  3. Classificar por Data de Publicação em Ordem Decrescente
  4. Clique na linha de resultado mais recente AEM SDK
  5. Revise e aceite o EULA e toque no botão Download

Extraia o Jar do Quickstart do zip AEM SDK

  1. Descompacte o arquivo aem-sdk-XXX.zip baixado

Configurar o serviço de autor do AEM local

O Serviço de criação do AEM local fornece aos desenvolvedores uma experiência local com os profissionais de marketing digital/autores de conteúdo compartilhados para criar e gerenciar conteúdo. O AEM Author Service foi projetado como um ambiente de criação e visualização, permitindo que a maioria das validações de desenvolvimento de recursos possa ser executada em relação a ele, tornando-o um elemento vital do processo de desenvolvimento local.

  1. Crie a pasta ~/aem-sdk/author

  2. Copie o arquivo Quickstart JAR para ~/aem-sdk/author e renomeie-o para aem-author-p4502.jar

  3. Inicie o Serviço de criação do AEM local executando o seguinte na linha de comando:

    • java -jar aem-author-p4502.jar
      • Forneça a senha do administrador como admin. Qualquer senha de administrador é aceitável, no entanto, sua recomendação é usar o padrão para desenvolvimento local para reduzir a necessidade de reconfigurar.

    Você não pode iniciar o AEM como Cloud Service Quickstart Jar clicando duas vezes em.

  4. Acesse o Serviço de Autor do AEM local em http://localhost:4502 em um navegador da Web

Windows:

$ mkdir -p c:\Users\<My User>\aem-sdk\author
$ copy aem-sdk-Quickstart-XXX.jar c:\Users\<My User>\aem-sdk\author\aem-author-p4502.jar
$ cd c:\Users\<My User>\aem-sdk\author
$ java -jar aem-author-p4502.jar

macOS / Linux:

$ mkdir -p ~/aem-sdk/author
$ cp aem-sdk-Quickstart-XXX.jar ~/aem-sdk/author/aem-author-p4502.jar
$ cd ~/aem-sdk/author
$ java -jar aem-author-p4502.jar

Configurar o serviço de publicação do AEM local

O Serviço de publicação do AEM local fornece aos desenvolvedores a experiência local que os usuários finais do AEM terão, como navegar no site hospedado no AEM. Um serviço de publicação do AEM local é importante, pois integra-se AEM Ferramentas do Dispatcher do SDK e permite que os desenvolvedores façam um teste de fumaça e ajustem a experiência voltada para o usuário final.

  1. Crie a pasta ~/aem-sdk/publish

  2. Copie o arquivo Quickstart JAR para ~/aem-sdk/publish e renomeie-o para aem-publish-p4503.jar

  3. Inicie o AEM Publish Service local executando o seguinte na linha de comando:

    • java -jar aem-publish-p4503.jar
      • Forneça a senha do administrador como admin. Qualquer senha de administrador é aceitável, no entanto, sua recomendação é usar o padrão para desenvolvimento local para reduzir a necessidade de reconfigurar.

    Você não pode iniciar o AEM como Cloud Service Quickstart Jar clicando duas vezes em.

  4. Acesse o Serviço de publicação do AEM local em http://localhost:4503 em um navegador da Web

Windows:

$ mkdir -p c:\Users\<My User>\aem-sdk\publish
$ copy aem-sdk-Quickstart-XXX.jar c:\Users\<My User>\aem-sdk\publish\aem-publish-p4503.jar
$ cd c:\Users\<My User>\aem-sdk\publish
$ java -jar aem-publish-p4503.jar

macOS / Linux:

$ mkdir -p ~/aem-sdk/publish
$ cp aem-sdk-Quickstart-XXX.jar ~/aem-sdk/publish/aem-publish-p4503.jar
$ cd ~/aem-sdk/publish
$ java -jar aem-publish-p4503.jar

Simular distribuição de conteúdo

Em um ambiente de Cloud Service verdadeiro, o conteúdo é distribuído do Serviço de criação para o Serviço de publicação usando Distribuição de conteúdo de sling e o Pipeline de Adobe. O Adobe Pipeline é um microsserviço isolado disponível somente no ambiente de nuvem.

Durante o desenvolvimento, pode ser desejável simular a distribuição de conteúdo usando o serviço local Autor e Publicação . Isso pode ser feito habilitando os agentes de Replicação herdados.

OBSERVAÇÃO

Os agentes de replicação só estão disponíveis para uso no Quickstart JAR local e fornecem apenas uma simulação da distribuição de conteúdo.

  1. Faça logon no serviço Author e navegue até http://localhost:4502/etc/replication/agents.author.html.

  2. Clique em Default Agent (publish) para abrir o agente de Replicação padrão.

  3. Clique em Editar para abrir a configuração do agente.

  4. Na guia Settings , atualize os seguintes campos:

    • Ativado - verificar verdadeiro
    • ID de usuário do agente - Deixe este campo vazio

    Configuração do Agente de Replicação - Configurações

  5. Na guia Transport , atualize os seguintes campos:

    • URI - http://localhost:4503/bin/receive?sling:authRequestLogin=1
    • Usuário - admin
    • Senha - admin

    Configuração do Agente de Replicação - Transporte

  6. Clique em Ok para salvar a configuração e ativar o Agente de Replicação Padrão.

  7. Agora é possível fazer alterações no conteúdo no serviço Autor e publicá-las no serviço de Publicação.

Publicar página

Modos de inicialização do Jar de início rápido

A nomenclatura do Jar do Início Rápido, aem-<tier>_<environment>-p<port number>.jar especifica como ele será iniciado. Depois de AEM iniciado em um nível, autor ou publicação específico, ele não pode ser alterado para o nível alternativo. Para fazer isso, a pasta crx-Quickstart gerada durante a primeira execução deve ser excluída e o Quickstart Jar deve ser executado novamente. Ambiente e portas podem ser alteradas, no entanto exigem a interrupção/inicialização da instância de AEM local.

Alterar ambientes, dev, stage e prod, pode ser útil para os desenvolvedores garantir que as configurações específicas do ambiente sejam definidas e resolvidas corretamente pelo AEM. Recomenda-se que o desenvolvimento local seja feito principalmente em relação ao modo de execução padrão dev do ambiente.

As permutas disponíveis são as seguintes:

  • aem-author-p4502.jar
    • Como Autor no modo de execução Dev na porta 4502
  • aem-author_dev-p4502.jar
    • Como Autor no modo de execução Dev na porta 4502 (mesma como aem-author-p4502.jar)
  • aem-author_stage-p4502.jar
    • Como autor no modo de execução de preparo na porta 4502
  • aem-author_prod-p4502.jar
    • Como Autor no modo de execução Produção na porta 4502
  • aem-publish-p4503.jar
    • Como Autor no modo de execução Dev na porta 4503
  • aem-publish_dev-p4503.jar
    • Como Autor no modo de execução Dev na porta 4503 (igual a aem-publish-p4503.jar)
  • aem-publish_stage-p4503.jar
    • Como autor no modo de execução de preparo na porta 4503
  • aem-publish_prod-p4503.jar
    • Como Autor no modo de execução Produção na porta 4503

Observe que o número da porta pode ser qualquer porta disponível na máquina de desenvolvimento local, no entanto, por convenção:

  • A porta 4502 é usada para o serviço AEM Author local
  • A porta 4503 é usada para o serviço de publicação do AEM local

Alterar esses itens pode exigir ajustes nas configurações AEM SDK

Interrompendo um tempo de execução de AEM local

Para interromper um tempo de execução de AEM local, seja o AEM Author ou Publish service, abra a janela da linha de comando que foi usada para iniciar o AEM Runtime e toque em Ctrl-C. Aguarde AEM desligamento. Quando o processo de desligamento estiver concluído, o prompt da linha de comando estará disponível.

Tarefas opcionais de configuração de tempo de execução de AEM local

Quando atualizar o Quickstart Jar

Atualize o SDK do AEM pelo menos mensalmente na última quinta-feira de cada mês, ou logo depois dela, que é o ritmo de lançamento do AEM como "lançamentos de recursos" do Cloud Service.

AVISO

Atualizar o Quickstart Jar para uma nova versão requer a substituição de todo o ambiente de desenvolvimento local, resultando na perda de todo o código, configuração e conteúdo nos repositórios de AEM locais. Certifique-se de que qualquer código, configuração ou conteúdo que não deve ser destruído esteja comprometido com o Git ou seja exportado da instância de AEM local como AEM Pacotes.

Como evitar perda de conteúdo ao atualizar o SDK do AEM

A atualização do SDK do AEM está criando um novo tempo de execução do AEM, incluindo um novo repositório, o que significa que todas as alterações feitas em um repositório do SDK anterior AEM são perdidas. A seguir estão estratégias viáveis para ajudar no conteúdo persistente entre atualizações AEM SDK e podem ser usadas discretamente ou em conjunto:

  1. Crie um pacote de conteúdo dedicado a conter conteúdo de "amostra" para auxiliar no desenvolvimento e o mantenha no Git. Qualquer conteúdo que deve ser mantido por meio de atualizações AEM SDK seria mantido neste pacote e reimplantado após a atualização do SDK AEM.
  2. Use oak-upgrade com a diretiva includepaths para copiar o conteúdo do repositório SDK AEM anterior para o novo repositório SDK AEM.
  3. Faça backup de qualquer conteúdo usando AEM Pacote Manager e pacotes de conteúdo no SDK AEM anterior e reinstale-os no novo SDK AEM.

Lembre-se de que usar as abordagens acima para manter o código entre AEM atualizações do SDK indica um antipadrão de desenvolvimento. O código não descartável deve se originar no IDE de desenvolvimento e fluir para AEM SDK por meio de implantações.

Resolução de problemas

Clicar duas vezes no arquivo Quickstart Jar resulta em um erro

Ao clicar duas vezes no Quickstart Jar para iniciar, é exibido um modal de erros que impede o AEM de iniciar localmente.

Solução de problemas - Clique duas vezes no arquivo Quickstart Jar

Isso ocorre porque o AEM como um Cloud Service Quickstart Jar não oferece suporte ao clique duplo do Quickstart Jar para iniciar AEM localmente. Em vez disso, você deve executar o arquivo Jar a partir dessa linha de comando.

Para iniciar o serviço AEM Author, cd no diretório que contém o Quickstart Jar e execute o comando:

$ java -jar aem-author-p4502.jar

ou, para iniciar o serviço AEM Publish, cd no diretório que contém o Quickstart Jar e execute o comando:

$ java -jar aem-publish-p4503.jar

Iniciar o Jar Quickstart a partir da linha de comando aborta imediatamente

Ao iniciar o Quickstart Jar a partir da linha de comando, o processo é interrompido imediatamente e o serviço de AEM não é iniciado, com o seguinte erro:

➜  ~/aem-sdk/author: java -jar aem-author-p4502.jar
Loading quickstart properties: default
Loading quickstart properties: instance
java.lang.Exception: Quickstart requires a Java Specification 11 VM, but your VM (Java HotSpot(TM) 64-Bit Server VM / Oracle Corporation) reports java.specification.version=1.8
  at com.adobe.granite.quickstart.base.impl.Main.checkEnvironment(Main.java:1046)
  at com.adobe.granite.quickstart.base.impl.Main.<init>(Main.java:646)
  at com.adobe.granite.quickstart.base.impl.Main.main(Main.java:981)
Quickstart: aborting

Isso ocorre porque o AEM as a Cloud Service requer o Java SDK 11 e você está executando uma versão diferente, provavelmente o Java 8. Para resolver esse problema, baixe e instale o Oracle Java SDK 11.
Depois que o Java SDK 11 tiver sido instalado, verifique se é a versão ativa executando o seguinte na linha de comando.

Depois que o Java 11 SDK estiver instalado, verifique se é a versão ativa executando o comando a partir da linha de comando:

  • Windows: java -version
  • macOS / Linux: java --version

Recursos adicionais

Nesta página