Cómo configurar un entorno de desarrollo de AEM local

style

border-bottom-glow

Cómo configurar un entorno de desarrollo de AEM local

Bienvenido al comienzo de tu viaje con Adobe Experience Manager, estamos encantados de tenerte a bordo. AEM es una herramienta potente y valiosa para el desarrollo web y la administración de contenido utilizada por las principales corporaciones y organizaciones de todo el mundo. Hoy comenzaremos poco a poco guiándole a través de cómo instalar una instancia local de AEM 6.5 en su equipo para que pueda comenzar a jugar con AEM y sus herramientas.

Tenga en cuenta que las imágenes y los comandos a los que se hace referencia en esta publicación se utilizan y capturan desde una Macbook Pro con macOS Venture 13.2.1. Si está en una máquina con Windows o una versión mucho más reciente de macOS, y nota que algunas cosas se ven o se comportan de manera ligeramente diferente en su máquina, ¡no se asuste! Es probable que esto se deba solo a ligeras diferencias en la interfaz de usuario. Todos los comandos enumerados deberían funcionar tan bien en Windows como en Mac.

Para comenzar, querrá asegurarse de tener la última versión de Java instalada en su máquina. Java es una parte importante de la arquitectura de AEM y utilizaremos algunos comandos de Java durante la instalación de AEM. Puede encontrar el enlace para descargar Java aquí.

Si bien no es necesario, quería mencionar que si está trabajando en una computadora Mac, también recomendaría instalar Iterm2. Es una versión más robusta y rica en funciones de la aplicación de terminal predeterminada de Mac y hace que trabajar en la terminal sea mucho más fácil. Los desarrolladores de AEM viven en el terminal, por lo que cualquier cosa que pueda hacer ahora para mejorar su comodidad con él le beneficiará en los próximos años. Puede encontrar el enlace para instalarlo aquí.

Una vez instalado Java, deberá obtener acceso al archivo jar de inicio rápido de AEM y una licencia de AEM. Si es un socio de soluciones de Adobe, puede obtener acceso a un entorno de desarrollo de AEM local. En primer lugar, asegúrese de haber iniciado sesión en su cuenta de Adobe Solution Partner. Luego, puede usar este enlace para encontrar el formulario necesario para solicitar una cuenta de desarrollo.

Rellene el formulario de solicitud de descarga de Adobe Experience Manager y Adobe se pondrá en contacto con un correo electrónico con una descarga y una clave de licencia.

Si está trabajando en AEM como individuo, las licencias y los archivos se pueden comprar en el sitio web de licencias de Adobe.

Ahora que tiene Java instalado y acceso al archivo jar de inicio rápido de AEM, querrá crear un directorio general de AEM para ayudar a mantener el equipo organizado, así como dos subdirectorios, autor y editor. La instancia de autor de AEM es donde creará e insertará contenido nuevo para sus sitios web, mientras que la instancia de publicación es donde residirá el contenido publicado y donde escribirá código al que los usuarios que se enfrenten al sitio web necesitarán acceso. Abra una terminal y ejecute los siguientes comandos:

mkdir -p ~/aem/ 
mkdir -p ~/aem/author
mkdir -p ~/aem/publisher

A continuación, querrá copiar el archivo jar de inicio rápido de AEM y los archivos de licencia en ambos directorios.
A continuación, en la terminal, querrá descomprimir los archivos jar. Primero, navegue hasta su directorio de autor y ejecute el siguiente comando en su terminal:
java -jar AEM_6.5_Quickstart.jar -unpack -r author
Una vez que el archivo haya terminado de desempaquetarse, vaya al directorio del editor y ejecute la siguiente línea:
java -jar AEM_6.5_Quickstart.jar -unpack -r publish
Una vez que los archivos jar hayan terminado de desempaquetarse, debería ver una carpeta crx-quickstart en ambos directorios. Navega a tu directorio de autor, luego navega a crx-quickstart/bin, y abre el archivo de inicio con el editor de texto de tu elección.

En el archivo de inicio, desplácese hacia abajo hasta la sección que comienza con la línea # default JVM options. Debería ver una opción etiquetada -Xmx1024m. Cambie esa opción a -Xmx2048m como en la imagen de arriba. Esta opción determina a cuánta RAM puede acceder AEM mientras se ejecuta en la máquina, por lo que aumentar este número debería permitir que AEM se ejecute con mucha más fluidez.
Ahora navegue hasta el directorio de su editor y, dentro de él, navegue hasta el crx-qucikstart/biny, nuevamente, abra el archivo de inicio con el editor de texto de su elección. Tenemos algunas líneas más que querremos editar en estos archivos.

Primero, navegue a la sección etiquetada TCP port used for stop and status scripts. Debajo de allí, debería ver una línea que dice CQ_PORT=4502. Cambie ese puerto a CQ_HOST=4503. Esta línea determina el puerto local en el que se ejecutará la instancia de AEM al iniciar esta versión de AEM. Dado que nuestra instancia de autor ya se ejecuta en 4502, queremos asegurarnos de que nuestra instancia de editor se ejecute en otro lugar para que los dos no interfieran entre sí.
A continuación, desplácese hacia abajo hasta la sección etiquetada # runmode(s). Debería ver una línea que dice CQ_RUNMODE='author'. Cambie esa línea a CQ_RUNMODE='publisher'. Esta línea determina en qué "modo" se ejecutará la instancia de AEM. Dado que esta es nuestra instancia de publicación, queremos que se ejecute en modo de publicación.
Finalmente, navegue a la sección # default JVM options y cambie -Xmx1024m a –Xmx2048m. Al igual que en la instancia de autor, esto aumenta la cantidad de RAM a la que AEM puede acceder mientras se ejecuta.
¡Enhorabuena, ha instalado AEM en su máquina local! Para probar esto, continúe e inicie cada instancia y asegúrese de que todo se cargue correctamente. Para hacerlo, navegue hasta el directorio de su elección y navegue hacia abajo hasta crx-qucikstart/bin. En ese directorio, escriba el comando ./start. AEM tardará unos minutos en iniciarse, especialmente la primera vez que lo ejecute, por lo que para asegurarse de que todo se inicia correctamente, ejecute el comando tail -f para ver los procesos que se están ejecutando.
Abra el explorador de su elección y vaya a localhost:4502 si está ejecutando la instancia de autor o localhost:4503 si está ejecutando la instancia de editor. Una vez que todo se cargue correctamente, debería ver la siguiente pantalla de inicio de sesión. El nombre de usuario y la contraseña predeterminados son admin.

Si no ve esa pantalla inicialmente al iniciarse, espere unos minutos más para permitir que AEM termine de configurarse. Si sigue sin verlo o recibe un mensaje de error, elimine la instancia actual y vuelva a instalar AEM desde el principio.
Una vez más, ¡felicidades por comenzar con AEM! Para detener la instancia, navegue hasta el directorio crx-quickstart/bin respectivo en su terminal y ejecute el comando ./stop. ¡Feliz codificación!