Configuración del tiempo de ejecución de AEM local

Adobe Experience Manager (AEM) se puede ejecutar localmente mediante el Jar de inicio rápido del SDK de AEM as a Cloud Service. Esto permite a los desarrolladores implementar y probar el código, la configuración y el contenido personalizados antes de comprometerlo con el control de código fuente e implementarlo en un entorno de AEM como Cloud Service.

Tenga en cuenta que ~ se utiliza como método abreviado para el Directorio del usuario. En Windows, este es el equivalente de %HOMEPATH%.

Instalación de Java

Experience Manager es una aplicación Java y, por lo tanto, requiere el SDK de Java para admitir las herramientas de desarrollo.

  1. Descargar e instalar el último SDK de Java 11
  2. Compruebe que el SDK de Java 11 esté instalado ejecutando el comando :
    • Windows:java -version
    • macOS / Linux: java --version

Java

Descargar el SDK de AEM as a Cloud Service

El SDK de AEM as a Cloud Service, o SDK de AEM, contiene el Jar de inicio rápido utilizado para ejecutar AEM Author y Publish localmente para el desarrollo, así como la versión compatible de las herramientas de Dispatcher.

  1. Inicie sesión en https://experience.adobe.com/#/downloads con su Adobe ID
    • Tenga en cuenta que la organización de Adobe debe aprovisionarse para AEM como Cloud Service para descargar el SDK de AEM as a Cloud Service.
  2. Vaya a la pestaña AEM as a Cloud Service
  3. Ordenar por Fecha de publicación en orden Descendente
  4. Haga clic en la última fila de resultados de AEM SDK
  5. Revise y acepte el EULA y pulse el botón Download

Extraer el Jar de inicio rápido del zip del SDK de AEM

  1. Descomprima el archivo aem-sdk-XXX.zip descargado

Configurar el servicio local de AEM Author

El servicio de creación de AEM local proporciona a los desarrolladores una experiencia local que los especialistas en marketing digital/autores de contenido compartirán para crear y administrar contenido. El servicio de creación de AEM está diseñado como entorno de creación y previsualización, lo que permite realizar la mayoría de las validaciones del desarrollo de funciones en su contra, lo que lo convierte en un elemento vital del proceso de desarrollo local.

  1. Crear la carpeta ~/aem-sdk/author

  2. Copie el archivo Quickstart JAR en ~/aem-sdk/author y cámbielo por aem-author-p4502.jar

  3. Inicie el servicio local de AEM Author ejecutando lo siguiente desde la línea de comandos:

    • java -jar aem-author-p4502.jar
      • Proporcione la contraseña de administrador como admin. Cualquier contraseña de administrador es aceptable, pero se recomienda utilizar el valor predeterminado para el desarrollo local para reducir la necesidad de volver a configurarla.

    no puede iniciar el AEM como Cloud Service Jar de inicio rápido haciendo doble clic en.

  4. Acceda al servicio local de AEM Author en http://localhost:4502 en un navegador 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

Configuración del servicio local de publicación de AEM

El servicio de publicación de AEM local proporciona a los desarrolladores la experiencia local que los usuarios finales del AEM tendrán, como navegar por el sitio web alojado en AEM. Un servicio de publicación de AEM local es importante, ya que se integra con las herramientas de Dispatcher del SDK de AEM y permite a los desarrolladores realizar pruebas de humo y ajustar la experiencia de cara al usuario final final.

  1. Crear la carpeta ~/aem-sdk/publish

  2. Copie el archivo Quickstart JAR en ~/aem-sdk/publish y cámbielo por aem-publish-p4503.jar

  3. Inicie el servicio de publicación de AEM local ejecutando lo siguiente desde la línea de comandos:

    • java -jar aem-publish-p4503.jar
      • Proporcione la contraseña de administrador como admin. Cualquier contraseña de administrador es aceptable, pero se recomienda utilizar el valor predeterminado para el desarrollo local para reducir la necesidad de volver a configurarla.

    no puede iniciar el AEM como Cloud Service Jar de inicio rápido haciendo doble clic en.

  4. Acceda al servicio de publicación local de AEM en http://localhost:4503 en un navegador 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 la distribución de contenido

En un entorno de Cloud Service verdadero, el contenido se distribuye desde el servicio de creación al servicio de publicación mediante Sling Content Distribution y la canalización de Adobe. La Canalización de Adobe es un microservicio aislado disponible solo en el entorno de la nube.

Durante el desarrollo, puede ser deseable simular la distribución de contenido mediante el servicio Autor y Publicación local. Esto se puede lograr habilitando los agentes de replicación heredados.

NOTA

Los agentes de replicación solo están disponibles para su uso en el JAR de inicio rápido local y proporcionan solo una simulación de distribución de contenido.

  1. Inicie sesión en el servicio Author y vaya a http://localhost:4502/etc/replication/agents.author.html.

  2. Haga clic en Agente predeterminado (publicar) para abrir el agente de replicación predeterminado.

  3. Haga clic en Editar para abrir la configuración del agente.

  4. En la pestaña Settings, actualice los campos siguientes:

    • Enabled - check true
    • ID de usuario del agente : deje este campo vacío

    Configuración del agente de replicación: configuración

  5. En la pestaña Transport , actualice los campos siguientes:

    • URI - http://localhost:4503/bin/receive?sling:authRequestLogin=1
    • Usuario - admin
    • Contraseña - admin

    Configuración del agente de replicación: transporte

  6. Haga clic en Ok para guardar la configuración y habilitar el Default Agente de replicación.

  7. Ahora puede realizar cambios en el contenido del servicio Autor y publicarlo en el servicio Publicar .

Publicar página

Modos de inicio de Jar de inicio rápido

El nombre del Jar de inicio rápido, aem-<tier>_<environment>-p<port number>.jar especifica cómo se iniciará. Una vez AEM se ha iniciado en un nivel específico, se puede crear o publicar, no se puede cambiar al nivel alternativo. Para ello, la carpeta crx-Quickstart generada durante la primera ejecución debe eliminarse y el Jar de inicio rápido debe volver a ejecutarse. El entorno y los puertos se pueden cambiar, aunque requieren la detención/inicio de la instancia de AEM local.

Cambiar entornos, dev, stage y prod, puede resultar útil para los desarrolladores para garantizar que las configuraciones específicas del entorno se definan y resuelvan correctamente por AEM. Se recomienda que el desarrollo local se realice principalmente en el modo predeterminado de ejecución del entorno dev.

Las permutaciones disponibles son las siguientes:

  • aem-author-p4502.jar
    • Como autor en el modo de ejecución de desarrollo en el puerto 4502
  • aem-author_dev-p4502.jar
    • Como Autor en el modo de ejecución Dev en el puerto 4502 (igual que aem-author-p4502.jar)
  • aem-author_stage-p4502.jar
    • Como autor en modo de ejecución de ensayo en el puerto 4502
  • aem-author_prod-p4502.jar
    • Como Autor en modo de ejecución de producción en el puerto 4502
  • aem-publish-p4503.jar
    • Como autor en el modo de ejecución de desarrollo en el puerto 4503
  • aem-publish_dev-p4503.jar
    • Como Autor en el modo de ejecución Dev en el puerto 4503 (igual que aem-publish-p4503.jar)
  • aem-publish_stage-p4503.jar
    • Como autor en modo de ejecución de ensayo en el puerto 4503
  • aem-publish_prod-p4503.jar
    • Como autor en modo de ejecución de producción en el puerto 4503

Tenga en cuenta que el número de puerto puede ser cualquier puerto disponible en la máquina de desarrollo local, aunque por convención:

  • El puerto 4502 se utiliza para el servicio Autor de AEM local
  • El puerto 4503 se utiliza para el servicio AEM Publish local

Para cambiar estas opciones es posible que sea necesario realizar ajustes en AEM configuraciones del SDK

Detención de un tiempo de ejecución de AEM local

Para detener un tiempo de ejecución de AEM local, ya sea AEM Author o Publish, abra la ventana de línea de comandos que se utilizó para iniciar el tiempo de ejecución de AEM y pulse Ctrl-C. Espere a que AEM cierre. Cuando se complete el proceso de apagado, el símbolo del sistema de la línea de comandos estará disponible.

Tareas opcionales de configuración de tiempo de ejecución de AEM local

Cuándo actualizar el Jar de inicio rápido

Actualice el SDK de AEM al menos mensualmente el último jueves de cada mes o poco después, que es la cadencia de lanzamiento de AEM como "versiones de funciones" Cloud Service.

ADVERTENCIA

Actualizar el Jar de inicio rápido a una nueva versión requiere reemplazar el entorno de desarrollo local completo, lo que resulta en una pérdida de todo el código, la configuración y el contenido en los repositorios de AEM locales. Asegúrese de que cualquier código, configuración o contenido que no se deba destruir se comprometa de forma segura con Git o se exporta desde la instancia de AEM local como Paquetes AEM.

Cómo evitar la pérdida de contenido al actualizar el SDK de AEM

La actualización del SDK de AEM está creando de forma efectiva un nuevo tiempo de ejecución de AEM, incluido un nuevo repositorio, lo que significa que se pierden los cambios realizados en un repositorio anterior del SDK de AEM. Las siguientes son estrategias viables para ayudar a mantener el contenido entre AEM actualizaciones del SDK y se pueden utilizar de forma discreta o concertada:

  1. Cree un paquete de contenido dedicado a contener contenido de "muestra" para ayudar en el desarrollo y mantenerlo en Git. Cualquier contenido que se deba mantener mediante AEM actualizaciones del SDK se mantendría en este paquete y se volvería a implementar después de actualizar el SDK de AEM.
  2. Utilice oak-upgrade con la directiva includepaths para copiar contenido del repositorio AEM SDK anterior al nuevo repositorio AEM SDK.
  3. Haga una copia de seguridad de cualquier contenido mediante AEM Administrador de paquetes y paquetes de contenido en el SDK de AEM anterior y vuelva a instalarlos en el nuevo SDK de AEM.

Recuerde que, con los enfoques anteriores para mantener el código entre AEM actualizaciones del SDK, indica un anti-patrón de desarrollo. El código no desechable debe originarse en el IDE de desarrollo y fluir a AEM SDK mediante implementaciones.

Solución de problemas

Al hacer doble clic en el archivo Jar de inicio rápido se produce un error

Al hacer doble clic en el Jar de inicio rápido para iniciar, se muestra un modo de error que impide que el AEM se inicie localmente.

Solución de problemas: haga doble clic en el archivo Jar de inicio rápido

Esto se debe a que AEM como Cloud Service Jar de inicio rápido no admite hacer doble clic en el Jar de inicio rápido para comenzar AEM localmente. En su lugar, debe ejecutar el archivo Jar desde esa línea de comandos.

Para iniciar el servicio AEM Author, cd en el directorio que contiene el Jar de inicio rápido y ejecute el comando:

$ java -jar aem-author-p4502.jar

o bien, para iniciar el servicio AEM Publish, cd en el directorio que contiene el Jar de inicio rápido y ejecute el comando:

$ java -jar aem-publish-p4503.jar

Iniciar el Jar de inicio rápido desde la línea de comandos anula inmediatamente

Al iniciar el Jar de inicio rápido desde la línea de comandos, el proceso se interrumpe inmediatamente y el servicio de AEM no se inicia, con el siguiente error:

➜  ~/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

Esto se debe a que AEM como Cloud Service requiere Java SDK 11 y está ejecutando una versión diferente, muy probablemente Java 8. Para resolver este problema, descargue e instale Oracle Java SDK 11.
Una vez instalado el SDK 11 de Java, compruebe que sea la versión activa ejecutando lo siguiente desde la línea de comandos.

Una vez instalado el SDK de Java 11, compruebe que es la versión activa ejecutando el comando desde la línea de comandos:

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

Recursos adicionales

En esta página