Configurar o SDK do AEM local set-up-local-aem-sdk
O Adobe Experience Manager (AEM) pode ser executado localmente usando o Quickstart Jar do SDK do AEM as a Cloud Service. Isso permite que desenvolvedores implantem e testem códigos, configurações e conteúdo personalizados antes de enviá-los ao controle de origem e implantá-los em um ambiente do AEM as a Cloud Service.
Observe que ~
é usado como abreviação para o Diretório do usuário. No Windows, é equivalente a %HOMEPATH%
.
Instalar o Java™
O Experience Manager é um aplicativo Java™ e, portanto, requer o SDK Java™ do Oracle para oferecer suporte às ferramentas de desenvolvimento.
- Baixe e instale o Java™ SDK 11 mais recente
- Verifique se o SDK do Java™ 11 do Oracle está instalado executando o comando:
code language-shell |
---|
|
code language-shell |
---|
|
code language-shell |
---|
|
Baixar o SDK as a Cloud Service do AEM
O SDK as a Cloud Service do AEM, ou AEM AEM SDK, contém o Quickstart Jar usado para executar o Author e o Publish localmente para desenvolvimento, bem como a versão compatível das Ferramentas do Dispatcher.
- Efetue logon no https://experience.adobe.com/#/downloads com o seu Adobe ID
- Observe que sua organização Adobe deve ser provisionado para o AEM as a Cloud Service baixar o SDK do AEM as a Cloud Service.
- Navegue até a AEM as a Cloud Service guia
- Classificar por Data de publicação in Decrescente pedido
- Clique no último SDK do AEM linha de resultado
- Revise e aceite o EULA e toque no Baixar botão
Extraia o Quickstart Jar do zip do SDK do AEM
- Descompacte o baixado
aem-sdk-XXX.zip
arquivo
Configurar o serviço de autor local do AEM set-up-local-aem-author-service
O serviço de autor local do AEM fornece aos desenvolvedores uma experiência local que os profissionais de marketing digital/autores de conteúdo compartilharão para criar e gerenciar conteúdo. O serviço de autoria do AEM foi projetado como um ambiente de autoria e visualização, permitindo que a maioria das validações do desenvolvimento de recursos possa ser realizada em relação a ele, tornando-o um elemento vital do processo de desenvolvimento local.
-
Criar a pasta
~/aem-sdk/author
-
Copie o JAR de início rápido arquivo para
~/aem-sdk/author
e renomeie-o paraaem-author-p4502.jar
-
Inicie o serviço de autor local do AEM 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, é recomendável usar o padrão para desenvolvimento local para reduzir a necessidade de reconfigurar.
- Forneça a senha do administrador como
Você não é possível inicie o AEM como Cloud Service Quickstart Jar clicando duas vezes em.
-
Acesse o serviço de autor local do AEM em http://localhost:4502 em um navegador da Web
code language-shell |
---|
|
code language-shell |
---|
|
code language-shell |
---|
|
Configurar o serviço de publicação local do AEM
O Serviço de publicação local do AEM fornece aos desenvolvedores a experiência local que os usuários finais do AEM terão, como navegar pelo site hospedado no AEM. Um serviço de publicação local do AEM é importante, pois se integra ao AEM SDK Ferramentas do Dispatcher e permite que os desenvolvedores testem e ajustem a experiência final voltada para o usuário final.
-
Criar a pasta
~/aem-sdk/publish
-
Copie o JAR de início rápido arquivo para
~/aem-sdk/publish
e renomeie-o paraaem-publish-p4503.jar
-
Inicie o serviço de publicação local do AEM 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, é recomendável usar o padrão para desenvolvimento local para reduzir a necessidade de reconfigurar.
- Forneça a senha do administrador como
Você não é possível inicie o AEM como Cloud Service Quickstart Jar clicando duas vezes em.
-
Acesse o serviço de publicação local do AEM em http://localhost:4503 em um navegador da Web
code language-shell |
---|
|
code language-shell |
---|
|
code language-shell |
---|
|
Configurar serviços locais do AEM no modo de pré-lançamento
O tempo de execução local do AEM pode ser iniciado em modo de pré-lançamento permitindo que um desenvolvedor compile em relação aos recursos da próxima versão do AEM as a Cloud Service. O pré-lançamento é ativado ao passar o -r prerelease
argumento na primeira inicialização do tempo de execução local do AEM. Isso pode ser usado com os serviços locais de publicação de AEM Author e AEM.
code language-shell |
---|
|
code language-shell |
---|
|
code language-shell |
---|
|
Simular distribuição de conteúdo content-distribution
Em um ambiente de Cloud Service verdadeiro, o conteúdo é distribuído do Serviço do autor para o Serviço de publicação usando Distribuição de conteúdo do Sling e o pipeline de Adobe. A variável Pipeline de Adobe O é 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 de Autor e Publicação. Isso pode ser feito ativando os agentes de replicação herdados.
-
Faça logon na Autor e navegue até http://localhost:4502/etc/replication/agents.author.html.
-
Clique em Agente padrão (publicação) para abrir o Agente de replicação padrão.
-
Clique em Editar para abrir a configuração do agente.
-
No Configurações , atualize os seguintes campos:
- Ativado - marque como verdadeiro
- ID de usuário agente - Deixe este campo vazio
-
No Transporte , atualize os seguintes campos:
- URI -
http://localhost:4503/bin/receive?sling:authRequestLogin=1
- Usuário -
admin
- Senha -
admin
- URI -
-
Clique em Ok para salvar a configuração e ativar o Padrão Agente de replicação.
-
Agora é possível fazer alterações no conteúdo no serviço do Autor e publicá-las no serviço de Publicação.
Modos de inicialização do Quickstart Jar
O nome do Quickstart Jar, aem-<tier>_<environment>-p<port number>.jar
especifica como ele será inicializado. Depois que o AEM é iniciado em um nível, criação ou publicação específica, ele não pode ser alterado para o nível alternativo. Para fazer isso, a variável crx-Quickstart
a pasta gerada durante a primeira execução deve ser excluída e o Quickstart Jar deve ser executado novamente. O ambiente e as portas podem ser alterados, mas exigem a interrupção/início da instância local do AEM.
Alteração de ambientes, dev
, stage
e prod
, podem ser úteis para os desenvolvedores garantirem 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 padrão dev
modo de execução do ambiente.
As permutações disponíveis são as seguintes:
aem-author-p4502.jar
aem-author_dev-p4502.jar
aem-author-p4502.jar
)aem-author_stage-p4502.jar
aem-author_prod-p4502.jar
aem-publish-p4503.jar
aem-publish_dev-p4503.jar
aem-publish-p4503.jar
)aem-publish_stage-p4503.jar
aem-publish_prod-p4503.jar
Observe que o número da porta pode ser qualquer porta disponível na máquina de desenvolvimento local, no entanto, por convenção:
- Porta 4502 é usado para o serviço de autor local do AEM
- Porta 4503 é usado para o serviço de publicação local do AEM
Alterar esses parâmetros pode exigir ajustes nas configurações do SDK do AEM
Interrupção de um tempo de execução local do AEM
Para interromper um tempo de execução de AEM local, AEM Author ou Publish service, abra a janela da linha de comando usada para iniciar o AEM Runtime e toque em Ctrl-C
. Aguarde o desligamento do AEM. Quando o processo de desligamento estiver concluído, o prompt da linha de comando estará disponível.
Tarefas opcionais de configuração do tempo de execução do AEM
- Variáveis de ambiente de configuração OSGi e variáveis secretas são especialmente definido para o tempo de execução local do AEM, em vez de gerenciá-los usando a interface de linha de comando aio.
Quando atualizar o Quickstart Jar
Atualize o SDK do AEM pelo menos mensalmente na última quinta-feira de cada mês, ou logo após, que é a cadência de lançamento para "lançamentos de recursos" as a Cloud Service do AEM.
Como evitar perda de conteúdo ao atualizar o SDK do AEM
A atualização do SDK do AEM está criando efetivamente 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 do AEM anterior são perdidas. As estratégias a seguir são viáveis para ajudar a criar conteúdo persistente entre as atualizações do SDK do AEM e podem ser usadas de forma discreta ou em conjunto:
- Crie um pacote de conteúdo dedicado a conter conteúdo de "amostra" para auxiliar no desenvolvimento e mantenha-o no Git. Qualquer conteúdo que deve ser mantido por meio de atualizações do SDK do AEM será mantido nesse pacote e reimplantado após a atualização do SDK do AEM.
- Uso oak-upgrade com o
includepaths
diretiva, para copiar o conteúdo do repositório anterior do SDK do AEM para o novo repositório do SDK do AEM. - Faça backup de qualquer conteúdo usando o Gerenciador de pacotes AEM e pacotes de conteúdo no SDK AEM anterior e reinstale-os no novo SDK do AEM.
Lembre-se de que usar as abordagens acima para manter o código entre as atualizações do SDK do AEM indica um antipadrão de desenvolvimento. O código não descartável deve se originar no IDE de desenvolvimento e fluir para o SDK do AEM por meio de implantações.
Resolução de problemas
Clicar duas vezes no arquivo Jar de início rápido resulta em um erro troubleshooting-double-click
Ao clicar duas vezes no Quickstart Jar para iniciar, um modal de erro é exibido, impedindo que o AEM seja iniciado localmente.
Isso ocorre porque o AEM as a Cloud Service Quickstart Jar não oferece suporte ao clique duplo do Quickstart Jar para iniciar o AEM localmente. Em vez disso, você deve executar o arquivo Jar a partir dessa linha de comando.
Para iniciar o serviço de Autor do AEM, cd
no diretório que contém o Quickstart Jar e execute o comando:
code language-shell |
---|
|
code language-shell |
---|
|
code language-shell |
---|
|
ou, para iniciar o serviço de publicação do AEM, cd
no diretório que contém o Quickstart Jar e execute o comando:
code language-shell |
---|
|
code language-shell |
---|
|
code language-shell |
---|
|
Iniciar o Quickstart Jar a partir da linha de comando interrompe imediatamente troubleshooting-java-8
Ao iniciar o Quickstart Jar na linha de comando, o processo é interrompido imediatamente e o serviço 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 SDK 11 do Java™ 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 SDK do Java™ 11 do Oracle estiver instalado, verifique se essa é a versão ativa executando o comando na linha de comando:
code language-shell |
---|
|
code language-shell |
---|
|
code language-shell |
---|
|