Desarrollo local de AEM con el Editor universal local-dev-ue

AEM Descubra cómo el Editor universal admite la edición en instancias de locales con fines de desarrollo.

Información general overview

El servicio de editor universal es lo que une al editor universal y al sistema backend. Para poder desarrollar localmente para el editor universal, debe ejecutar una copia local del servicio de editor universal. Esto se debe a que:

  • El servicio de edición universal oficial de Adobe AEM está alojado a nivel global, y su instancia de local tendría que estar expuesta a Internet.
  • AEM Al desarrollar con un SDK de local, no se puede acceder al servicio de editor universal de Adobe desde Internet.
  • AEM Si la instancia de la tiene restricciones de IP y el servicio de editor universal de Adobe no está en un intervalo de IP definido, puede alojarlo usted mismo.

AEM AEM En este documento se explica cómo ejecutar en HTTPS junto con una copia local del servicio de editor universal para poder desarrollar localmente en para su uso con el editor universal (Universal Editor). Se puede ejecutar en HTTPS de manera que se pueda ejecutar de forma local en el editor universal (Universal Editor).

AEM Configuración de la ejecución de la en HTTPS aem-https

Dentro de un marco externo protegido con HTTPS no se puede cargar un marco HTTP no seguro. AEM El servicio de editor universal se ejecuta en HTTPS y, por lo tanto, el servicio de editor universal o cualquier otra página remota también deben ejecutarse en HTTPS.

AEM Para ello, debe configurar la ejecución de la en HTTPS. Para fines de desarrollo, puede utilizar un certificado autofirmado.

AEM Consulte este documento sobre cómo configurar la ejecución de la aplicación en HTTPS, incluido un certificado firmado automáticamente que pueda utilizar.

Instalación del servicio de editor universal install-ue-service

AEM El servicio de editor universal no es una copia completa del editor universal, sino solo un subconjunto de sus funciones para garantizar que las llamadas desde su entorno de trabajo local no se enruten a través de Internet, sino desde un punto final definido que usted controle.

Se requiere la versión 16 de NodeJS para ejecutar una copia local del servicio de editor universal.

El servicio de editor universal está disponible a través de la distribución de software. Consulte la documentación de distribución de software para obtener detalles sobre cómo acceder a ella.

Guarde el archivo universal-editor-service.cjs de Distribución de software en el entorno de desarrollo local.

Crear un certificado para ejecutar el servicio de editor universal con HTTPS ue-https

El servicio de editor universal también requiere un certificado para ejecutarse en HTTPS en el entorno de desarrollo.

Ejecute el siguiente comando.

$ openssl req -newkey rsa:2048 -nodes -keyout key.pem -x509 -days 365 -out certificate.pem

El comando genera un archivo key.pem y un archivo certificate.pem. Guarde estos archivos en la misma ruta que el archivo universal-editor-service.cjs.

Configuración del servicio de editor universal setting-up-service

Se deben configurar varias variables de entorno en NodeJS para ejecutar el servicio de editor universal localmente.

En la misma ruta de acceso que los archivos de universal-editor-service.cjs, key.pem y certificate.pem, cree un archivo de .env con el siguiente contenido.

EXPRESS_PORT=8000
EXPRESS_PRIVATE_KEY=./key.pem
EXPRESS_CERT=./certificate.pem
NODE_TLS_REJECT_UNAUTHORIZED=0

La variable tiene los siguientes significados:

Ejecución del servicio de editor universal running-ue

Para iniciar el servicio de editor universal, ejecute el siguiente comando:

$ node ./universal-editor-service.cjs

Debe enviar lo siguiente al terminal:

Universal Editor Service listening on port 8000 as HTTPS Server

Asegúrese de que el servicio inicia HTTPS Server y no HTTP Server.

Uso del servicio de editor universal local en lugar del servicio global using-local-ue

El editor universal sabe qué servicio de editor universal utilizar para editar una página en función de cómo se instrumenta la página. Esto se realiza mediante metaetiquetas en la página cargada en el editor universal.

Para editar una página con el servicio de editor universal local, se debe configurar la siguiente etiqueta meta:

<meta name="urn:adobe:aue:config:service" content="https://localhost:8000">

Una vez configurado, debería ver que cada llamada de actualización de contenido se dirige a https://localhost:8000 en lugar del servicio de editor universal predeterminado.

NOTE
Si se intenta obtener acceso directamente a https://localhost:8000, se producirá un error de 404. Este es el comportamiento esperado.
Para probar el acceso al servicio de editor universal local, use https://localhost:8000/corslib/LATEST. Consulte la siguiente sección para obtener más información.
TIP
AEM Para obtener más información sobre cómo se instrumentan las páginas para utilizar el servicio de editor universal global, consulte el documento Introducción al editor universal en la documentación de {100000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000000000000000000000

Edición de una página con el servicio de editor universal local editing

Con el servicio de editor universal ejecutándose localmente y la página de contenido instrumentada para usar el servicio local, ahora puede iniciar el editor.

  1. Abra el explorador a https://localhost:8000/corslib/LATEST.
  2. Indique a su explorador que acepte su certificado firmado automáticamente.
  3. Una vez que el certificado autofirmado sea de confianza, puede editar la página mediante el servicio de editor universal local.
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab