執行您自己的Universal Editor服務 local-ue-service

瞭解如何執行您自己的Universal Editor服務，以供本機開發或作為您自己基礎結構的一部分。

概觀 overview

Universal Editor 服務綁定 Universal Editor 和後端系統。若要能夠在本機開發Universal Editor，您必須執行Universal Editor服務的本機復本。 原因如下：

使用案例 use-cases

如果您想要：

支援這兩個使用案例。 本檔案說明如何在HTTPS中搭配Universal Editor服務的本機復本執行AEM。

如果您想要將自己的通用編輯器服務當做自己基礎結構的一部分來執行，您將遵循與本機開發範例相同的步驟。

將 AEM 設定為在 HTTPS 上執行 aem-https

在使用HTTPS固定的外部框架中，無法載入不安全的HTTP框架。 Universal Editor 服務會在 HTTPS 上執行，因此 AEM 或任何其他遠端頁面也必須在 HTTPS 上執行。

為此，您需要將 AEM 設定為在 HTTPS 上執行。出於開發目的，您可以使用自我簽署憑證。

請參閱此檔案，瞭解如何設定在HTTPS上執行的AEM，包括您可以使用的自我簽署憑證。

安裝 Universal Editor 服務 install-ue-service

Universal Editor服務並非Universal Editor的完整復本，而是其功能的子集，以確保不會透過網際網路路由來自您本機AEM環境的呼叫，而是從您控制的已定義端點路由呼叫。

需要NodeJS版本20才能執行通用編輯器服務的本機復本。

Universal Editor服務可透過Software Distribution取得。 如需如何存取軟體的詳細資訊，請參閱軟體發佈檔案。

將universal-editor-service.cjs檔案從Software Distribution儲存至您的本機開發環境。

建立憑證以透過 HTTPS 執行 Universal Editor 服務 ue-https

Universal Editor 服務還需要憑證才能在開發環境中在 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 服務。

在與您 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 服務 running-ue

若要啟動 Universal Editor 服務，請執行下列命令：

$ node ./universal-editor-service.cjs

此命令應該會將以下內容輸出到您的終端：

Universal Editor Service listening on port 8000 as HTTPS Server

確保服務啟動 HTTPS 伺服器而不是 HTTP 伺服器。

使用本機 Universal Editor 服務而不是全域服務 using-local-ue

Universal Editor 會根據頁面的偵測方式，知道要使用哪個 Universal Editor 服務來編輯頁面。這是透過載入 Universal Editor 頁面的中繼標記來完成。

對於要使用您本機 Universal Editor 服務所編輯的頁面，您必須設定以下中繼標記：

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

設定完成後，您應該會看到每個內容更新呼叫都會前往 https://localhost:8000，而不是預設的 Universal Editor 服務。

使用本機 Universal Editor 服務編輯頁面 editing

有了本機執行的 Universal Editor 服務和經檢測可使用本機服務的內容頁面，現在您可以啟動編輯器。