Adobe Experience Manager as a Cloud Service 發行前通道 prerelease-channel

了解如何使用發行前通道來取得即將推出的 AEM as a Cloud Service 功能預覽。

簡介 introduction

Adobe Experience Manager as a Cloud Service 定期提供新功能。特定功能發行中新增和即將推出的功能清單會發佈在發行說明中。

通常會透過以下兩種方式之一發行即將推出的功能:

  • 作為 Alpha、Beta 或限量開放計畫的一部分
  • 透過預發行通道使用

本文件說明如何啟用預發行通道。使用者可以透過預發行通道存取早期功能,而這些功能將成為 AEM 未來的功能版本。您可以藉此驗證新功能,並在未來發行前做好採用該功能的規劃。請參閱文件 Adobe Experience Manager (AEM) as a Cloud Service 發行說明,了解 AEM 發行排程的詳細資訊。

啟用預發行通道來存取及試用即將推出的功能 enable-prerelease

在任何開發或沙箱環境中皆可啟用預發行通道。在中繼環境或生產環境中無法啟用預發行通道。

有兩種不同的方式可以存取預發行通道:

雲端環境 cloud-environments

若要更新雲端環境以利使用預發行通道,您必須增加一個新的環境變數。您可以使用 Cloud Manager UI 或透過 CLI 執行此操作。

使用 UI 新增環境變數 add-with-ui

  1. my.cloudmanager.adobe.com 登入 Cloud Manager 並選取適當的組織。

  2. 導覽至您要啟用預發行通道的計劃。

  3. 選取您要啟用預發行通道的環境,並透過「計劃 > 環境 > 環境設定」存取其設定。

  4. 新增一個新的環境變數

    table 0-row-4 1-row-4
    名稱 套用的服務 類型
    AEM_RELEASE_CHANNEL prerelease 全部 變數
  5. 儲存變更後,環境將重新整理並啟用預發行通道。

    新環境變數

使用 CLI 新增環境變數 add-with-cli

您也可以使用 Cloud Manager API 和 CLI 來更新環境變數。

  • 使用 Cloud Manager API 的環境變數端點,將 AEM_RELEASE_CHANNEL 環境變數設定為值 prerelease

    code language-text
    PATCH /program/{programId}/environment/{environmentId}/variables
    [
            {
                    "name" : "AEM_RELEASE_CHANNEL",
                    "value" : "prerelease",
                    "type" : "string"
            }
    ]
    
  • 也可以使用 Cloud Manager CLI

    code language-shell
    aio cloudmanager:environment:set-variables <ENVIRONMENT_ID> --programId=<PROGRAM_ID> --variable AEM_RELEASE_CHANNEL "prerelease
    

若要將環境還原成標準行為 (非預發行通道),可刪除該變數。

本機 SDK local-sdk

您可以在本機快速入門 SDK 的預發行通道中存取即將推出的功能,並將您的 Maven 專案設定為參照位於 Maven Central 中的預發行通道 API Jar,以便針對新 API 編寫程式碼。只要使用預發行模式啟動一般快速入門 SDK,您也可以在本機開發環境中查看和存取這些預發行通道。

使用預發行模式啟動快速入門 SDK prerelease-mode

  1. 從軟體分發入口網站下載 SDK 並按照存取 AEM as a Cloud Service SDK 中所述進行安裝。
  2. 啟動 SDK 快速入門時,請包含引數 -r prerelease

值為 sticky,因此只能在第一次啟動時選取它。重新安裝 SDK 以變更命令列選項。

由於每月功能發行之間可能會有多個 AEM 維護版本,因此您可以下載這些新的 SDK 並在 maven 專案中參照新的 SDK API Jar 版本。維護版本不會新增其他發行前功能,但可能包括其他較小幅的變更,例如錯誤修正、安全性修正和效能增強。
Javadoc 會發佈到 Maven Central。

針對發行前 SDK 進行建置 build-sdk

  1. 修改您的 Maven 專案的 pom.xml 以參照獨特的發行前 SDK API jar,這個檔案已發佈到 Maven Central。它包含用於發行前功能的任何新 Java API,並且相依於 SDK API jar。它使用相同的版本。

    例如,這裡是參照一般 API jar 的父系 pom 的相依性管理區段中的片段:

    code language-none
    <dependencyManagement>
     <dependencies>
         <dependency>
             <groupId>com.adobe.aem</groupId>
             <artifactId>aem-sdk-api</artifactId>
             <version>${aem.sdk.api}</version>
             <scope>provided</scope>
         </dependency>
    

    然後是模組中的用法:

    code language-none
     <dependencies>
      <dependency>
          <groupId>com.adobe.aem</groupId>
          <artifactId>aem-sdk-api</artifactId>
      </dependency>
    

    若要變更為發行前 SDK,只需將相依性從 com.adobe.aem:aem-sdk-api 變更為 com.adobe.aem:aem-prerelease-sdk-api,如下所述:

    code language-none
    <dependencyManagement>
     <dependencies>
       <dependency>
             <groupId>com.adobe.aem</groupId>
             <artifactId>aem-prerelease-sdk-api</artifactId>
             <version>${aem.sdk.api}</version>
             <scope>provided</scope>
       </dependency>
    <dependencies>
       <dependency>
          <groupId>com.adobe.aem</groupId>
          <artifactId>aem-prerelease-sdk-api</artifactId>
       </dependency>
    

    如同往常,個別專案可以使用相依性。

  2. 部署到您的本機伺服器。

  3. 如果其本機運作符合預期且您感到滿意,請將程式碼提交到開發分支,並使用 Cloud Manager 非生產管道部署到啟用預發行通道的環境。

CAUTION
部署到中繼或生產環境時,絕不能使用 aem-prerelease-sdk-api artifactId。透過生產管道部署時,請一律使用 aem-sdk-api。同樣地,參照發行前 API 的程式碼不應該透過生產管道進行部署。

AEM CS SDK Build Analyzer Maven 外掛程式 v1.0 及更高版本將透過檢查相依性來偵測專案中是否使用了發行前 API。如果該分析器有找到,它將使用發行前 SDK API 來分析專案。

考量事項 considerations

使用發行前通道時,需要注意幾個事項。

  • 發行前通道不一定包含所有將在下一版中推出的新功能。
  • 發行前版本中的功能經過嚴格的品質保證,旨在提供完整的功能而不是測試版品質。如果您發現任何問題,請提報,就像您在懷疑一般 AEM 版本中的功能存在錯誤時所做的。
  • 若要判斷環境是否已經設定預發行通道,請前往 AEM 主控台的​ 關於 ​頁面,並檢查 AEM 版本號碼是否包含 PRERELEASE 字尾,例如 Adobe Experience Manager 2021.4.5226.20210427T070726Z-210429-PRERELEASE

關於

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab