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.

Ver este documento AEM sobre cómo configurar la ejecución de un 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.

Versión 16 de NodeJS es necesario 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 más información sobre cómo acceder a él.

Guarde el universal-editor-service.cjs desde Distribución de software a su 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 key.pem y una certificate.pem archivo. Guarde estos archivos en la misma ruta que su universal-editor-service.cjs archivo.

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 que su universal-editor-service.cjs, key.pem y certificate.pem archivos, crear un .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 cada llamada de actualización de contenido y dirigirse a https://localhost:8000 en lugar del servicio de editor universal predeterminado.

NOTE
Intento de acceso directo https://localhost:8000 resultados en una 404 error. Este es el comportamiento esperado.
Para probar el acceso al servicio de editor universal local, utilice https://localhost:8000/corslib/LATEST. Consulte la sección siguiente para obtener más información.
TIP
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 AEM Introducción al editor universal en el entorno de trabajo de la aplicación de

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

Con el Servicio de editor universal que se ejecuta localmente y su página de contenido instrumentada para utilizar el servicio local, ahora puede iniciar el editor.

  1. Abra el explorador para https://localhost:8000/corslib/LATEST.
  2. Dirija su navegador para que acepte su certificado autofirmado.
  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