Ejecución de su propio servicio de editor universal local-ue-service

Descubra cómo puede ejecutar su propio servicio de editor universal para el desarrollo local o como parte de su propia infraestructura.

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:

Casos de uso use-cases

Su propia copia del servicio de editor universal resulta útil si desea:

Se admiten ambos casos de uso. AEM En este documento se explica cómo ejecutar en HTTPS junto con una copia local del servicio de editor universal (Universal Editor Service).

Si desea ejecutar su propio servicio de editor universal como parte de su propia infraestructura, debe seguir los mismos pasos que en el ejemplo de desarrollo local.

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 20🔗 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.

UES_PORT=8000
UES_PRIVATE_KEY=./key.pem
UES_CERT=./certificate.pem
UES_TLS_REJECT_UNAUTHORIZED=false
UES_CORS_PRIVATE_NETWORK=true

Estos son los valores mínimos requeridos para el desarrollo local en nuestro ejemplo.

La siguiente tabla detalla estos y los valores adicionales disponibles.

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.

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.