运行您自己的通用编辑器服务 local-ue-service

了解如何运行您自己的通用编辑器服务，以供本地开发或作为您自己的基础架构的一部分。

概述 overview

Universal Editor Service 是一项用于将 Universal Editor 与后端系统绑定的服务。要能够在本地开发通用编辑器，必须运行通用编辑器服务的本地副本。 这是因为：

用例 use-cases

如果您希望：

这两个用例都受支持。 本文档介绍如何在HTTPS中运行AEM以及Universal Editor服务的本地副本。

如果您希望将自己的通用编辑器服务作为您自己的基础架构的一部分运行，则遵循与本地开发示例相同的步骤。

将 AEM 设置为在 HTTPS 上运行 aem-https

在使用HTTPS固定的外部帧中，无法加载不安全的HTTP帧。 Universal Editor Service 在 HTTPS 上运行，因此，AEM 或任何其他远程页面也必须在 HTTPS 上运行。

为此，您需要将 AEM 设置为在 HTTPS 上运行。出于开发目的，您可以使用自签名证书。

请参阅此文档，了解如何设置在HTTPS上运行的AEM，包括您可以使用的自签名证书。

安装 Universal Editor Service install-ue-service

Universal Editor服务不是Universal Editor的完整副本，而只是其功能的子集，以确保来自本地AEM环境的调用不会通过Internet进行路由，而是从您控制的已定义端点进行路由。

需要NodeJS版本20才能运行通用编辑器服务的本地副本。

Universal Editor服务可通过Software Distribution使用。 有关如何访问它的详细信息，请参阅软件分发文档。

将universal-editor-service.cjs文件从Software Distribution保存到本地开发环境。

创建证书以通过 HTTPS 运行 Universal Editor Service ue-https

Universal Editor Service 还需要证书才能在开发环境中的 HTTPS 上运行。

运行以下命令。

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

该命令生成一个 key.pem 文件和一个 certificate.pem 文件。将这两个文件保存到与 universal-editor-service.cjs 文件相同的路径。

设置Universal Editor服务配置 setting-up-service

必须在 NodeJS 中设置大量环境变量才能在本地运行 Universal Editor Service。

在与 universal-editor-service.cjs、key.pem 和 certificate.pem 文件相同的路径上，创建具有以下内容的 .env 文件。

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

在本例中，这些是本地开发所需的最小值。

下表详细说明这些值和可用的其他值。

运行 Universal Editor Service running-ue

要启动 Universal Editor Service，请执行以下命令：

$ node ./universal-editor-service.cjs

它应将以下内容输出到终端：

Universal Editor Service listening on port 8000 as HTTPS Server

确保该服务启动 HTTPS 服务器而不是 HTTP 服务器。

使用本地 Universal Editor Service 而不是全局服务 using-local-ue

Universal Editor 根据页面的检测方式了解使用哪个 Universal Editor Service 编辑页面。通过在 Universal Editor 中加载的页面中的元标记完成这一点。

对于要使用本地 Universal Editor Service 编辑的页面，必须设置以下元标记：

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

设置完成后，您应看到每个内容更新调用都转到 https://localhost:8000 而不是默认的 Universal Editor Service。

使用本地 Universal Editor Service 编辑页面 editing

在本地运行 Universal Editor Service 并且您的内容页面经过检测可使用本地服务后，您现在可以启动编辑器。