升級程式碼和自訂 upgrading-code-and-customizations

規劃升級時,必須調查並處理下列實作領域。

概觀 overview

  1. 圖樣偵測器 — 依照升級規劃中的說明執行模式偵測器,並詳述於 此頁面. 除了AEM的Target版本中無法使用的API/套件組合,您還會收到模式偵測器報告,其中包含必須解決之區域的詳細資訊。 「模式偵測」報表可指出程式碼中的任何不相容專案。 如果不存在任何專案,表示您的部署已經與6.5相容。 您仍然可以選擇使用6.5功能執行新的開發,但並非只是為了維護相容性。 如果回報不相容,您可以選擇在相容模式中執行,並延遲開發新的6.5功能或相容性。 或者,您可以在升級後決定進行開發,並移至步驟2。 另請參閱 AEM 6.5的回溯相容性 以取得更多詳細資料。

  2. 開發6.5的程式碼基底 — 為Target版本的程式碼基底建立專屬的分支或存放庫。 使用升級前相容性的資訊,規劃要更新的程式碼區域。

  3. 使用6.5 Uber jar編譯 — 更新程式碼基底POM以指向6.5 uber jar並編譯對它適用的程式碼。

  4. 更新AEM自訂* - *AEM的任何自訂專案或擴充功能應進行更新/驗證,以在6.5中運作,並新增至6.5程式碼基底。 包括UI搜尋Forms、資產自訂、使用/mnt/overlay的任何內容

  5. 部署至6.5環境 - AEM 6.5的乾淨例項(製作+發佈)應在Dev/QA環境中站立。 應部署更新的程式碼庫和代表性內容範例(來自目前生產環境)。

  6. QA驗證和錯誤修正 - QA應在6.5的製作和發佈執行個體上驗證應用程式。找到的任何錯誤都應修正並認可至6.5程式碼基底。 視需要重複開發週期,直到修復所有錯誤為止。

在繼續升級之前,您應該要有已針對AEM目標版本完整測試的穩定應用程式程式碼基底。 根據測試中所做的觀察,可能有方法來最佳化自訂程式碼。 例如,其中可能包括重構程式碼以避免周遊存放庫、自訂索引以最佳化搜尋,或在JCR中使用無序節點等。

除了選擇性地升級您的程式碼基底和自訂以與新的AEM版本搭配使用外,6.5還可協助您使用回溯相容性功能(如所述)更有效率地管理自訂 此頁面.

如上所述及下圖所示,執行 圖樣偵測器 在第一個步驟中,可以協助您評估升級的整體複雜性。 它也可以協助您決定是否要以相容性模式執行,或更新自訂以使用所有新的AEM 6.5功能。 請參閱 AEM 6.5的回溯相容性 頁面以取得更多詳細資料。
opt_cropped

升級程式碼基底 upgrade-code-base

在版本控制中為6.5程式碼建立專用分支 create-a-dedicated-branch-for-6.5-code-in-version-control

AEM實作所需的所有程式碼和設定,都應使用某種形式的版本控制加以管理。 應建立版本控制中的專用分支,以管理目標AEM版本中程式碼庫所需的任何變更。 此分支管理針對AEM目標版本的反複程式碼庫測試和後續錯誤修正。

更新AEM Uber Jar版本 update-the-aem-uber-jar-version

AEM Uber jar包含所有AEM API,作為您Maven專案的 pom.xml. 納入Uber Jar作為單一相依性永遠是最佳實務,而不是納入個別AEM API相依性。 升級程式碼基底時,請變更Uber Jar的版本以指向目標AEM版本。 如果您的專案是在Uber Jar存在之前使用AEM版本開發的,請移除所有個別AEM API相依性。 以目標版本的AEM的Uber Jar的單一包含來取代它們。 針對新版本的Uber Jar重新編譯程式碼基底。 更新任何已棄用的API或方法,使其與AEM的目標版本相容。

<dependency>
    <groupId>com.adobe.aem</groupId>
    <artifactId>uber-jar</artifactId>
    <version>6.5.0</version>
    <classifier>apis</classifier>
    <scope>provided</scope>
</dependency>

逐步停止使用管理資源解析程式 phase-out-use-of-administrative-resource-resolver

透過使用管理工作階段 SlingRepository.loginAdministrative()ResourceResolverFactory.getAdministrativeResourceResolver() 在AEM 6.0之前的程式碼基底中非常普遍。基於安全考量,這些方法已過時,因為它們提供太寬的存取層級。 在未來Sling版本中,將移除這些方法. 強烈建議您重構任何程式碼,以改用服務使用者。 有關服務使用者與的詳細資訊 如何逐步淘汰管理工作階段可在此處找到.

查詢和Oak索引 queries-and-oak-indexes

升級程式碼庫時,必須徹底測試程式碼庫中任何查詢的使用。 對於從Jackrabbit 2 (AEM 6.0之前的版本)升級的客戶,這項測試尤其重要,因為Oak不會自動為內容編制索引,且應建立自訂索引。 如果從AEM 6.x版本升級,現成的Oak索引定義可能已變更,並且可能影響現有查詢。

下列工具可用來分析和檢查查詢效能:

傳統UI編寫 classic-ui-authoring

傳統UI編寫仍可在AEM 6.5中使用,但已過時。 可以找到更多資訊 此處. 如果您的應用程式在傳統UI作者環境中執行,建議升級至AEM 6.5並繼續使用傳統UI。 移轉至Touch UI可計畫為單獨的專案,以便透過數個開發週期完成。 若要在AEM 6.5中使用傳統UI,必須將數個OSGi設定認可至程式碼基底。 如需如何進行設定的詳細資訊,請參閱 此處.

與6.5存放庫結構一致 align-repository-structure

為了更輕鬆升級並確保在升級期間不會覆寫設定,存放庫在6.4中進行了重組,以將內容與設定分開。

因此,必須移動數個設定,使其不再位於下 /etc 一如既往。 若要檢閱更新至AEM 6.4中必須檢閱和解決的整套存放庫重組問題,請參閱 AEM 6.4中的存放庫重組.

AEM自訂 aem-customizations

必須識別AEM來源版本中AEM製作環境的所有自訂。 在識別之後,建議將每個自訂內容儲存在版本控制中,或至少作為內容封裝的一部分進行備份。 在生產升級之前,所有自訂都應在執行目標AEM版本的QA或中繼環境中部署及驗證。

一般覆蓋 overlays-in-general

延伸AEM現成可用功能的常見作法是,在/apps底下以其他節點覆蓋/libs底下的節點和/或檔案。 您應在版本控制中追蹤這些覆蓋圖,並針對AEM的目標版本進行測試。 如果檔案(例如JS、JSP、HTL)重疊,Adobe建議您留下已增強哪些功能的註解,以便在AEM目標版本上更輕鬆地進行回歸測試。 一般覆蓋圖的更多資訊可以找到 此處. 您可以在下方找到特定AEM覆蓋圖的指示。

升級自訂搜尋Forms upgrading-custom-search-forms

自訂搜尋Facet在升級後必須進行一些手動調整,才能正常運作。 如需詳細資訊,請參閱 升級自訂搜尋Forms.

Assets UI自訂 assets-ui-customizations

NOTE
只有從AEM 6.2之前的版本升級時才需要此程式。

已自訂Assets部署的執行個體必須準備好進行升級。 此動作是必要的,可確保所有自訂內容與新的6.4節點結構相容。

您可以執行下列操作,為Assets UI準備自訂:

  1. 在要升級的執行個體上,前往以下位置開啟CRXDE Lite: https://server:port/crx/de/index.jsp

  2. 前往下列節點:

    • /apps/dam/content
  3. 將內容節點重新命名為 content_backup 在視窗左側的瀏覽器窗格上按一下滑鼠右鍵,然後選擇 重新命名.

  4. 重新命名節點後,在下方建立名為內容的節點 /apps/dam 已命名 內容 並將其節點型別設為 sling:Folder.

  5. 移動的所有子節點 content_backup 在新建立的內容節點中,以滑鼠右鍵按一下總管窗格中的每個子項節點,然後選取 移動.

  6. 刪除 content_backup 節點。

  7. 下方更新的節點 /apps/dam 具有正確節點型別的 sling:Folder 理想情況下,應儲存至版本控制中,並以程式碼庫部署,或至少以內容封裝形式備份。

產生現有資產的資產ID generating-asset-ids-for-existing-assets

若要產生現有資產的資產ID,請在升級AEM執行個體以執行AEM 6.5時升級資產。若要啟用 Assets分析功能. 如需詳細資訊,請參閱 新增內嵌程式碼.

若要升級資產,請在JMX主控台中設定「關聯資產ID」套件。 根據存放庫中的資產數量, migrateAllAssets 可能需要很長的時間。 Adobe的內部測試估計,TarMK上的125000資產大約需要1小時。

1487758945977

如果您需要整個資產的子集有資產ID,請使用 migrateAssetsAtPath API。

若為所有其他用途,請使用 migrateAllAssets() API。

InDesign指令碼自訂 indesign-script-customizations

Adobe建議您將自訂指令碼放在 /apps/settings/dam/indesign/scripts 位置。 有關InDesign指令碼自訂的更多資訊可以找到 此處.

復原ContextHub設定 recovering-contexthub-configurations

ContextHub設定會受升級影響。 您可以找到有關如何復原現有ContextHub設定的說明 此處.

工作流程自訂 workflow-customizations

通常會直接編輯工作流程,以新增或移除不需要的功能。 自訂的常見工作流程為 DAM更新資產 工作流程。 自訂實施所需的所有工作流程都應進行備份,並儲存在版本控制中,因為升級期間可能會覆寫這些工作流程。

可編輯的範本 editable-templates

NOTE
只有在使用AEM 6.2的可編輯範本進行Sites升級時,才需要此程式

可編輯範本的結構在AEM 6.2和6.3之間變更。如果您要從6.2或更舊版本升級,而且您的網站內容是使用可編輯的範本所建置,則必須使用 回應式節點清理工具. 此工具旨在執行 晚於 清理內容的升級。 在製作和發佈層級上執行。

CUG實作變更 cug-implementation-changes

封閉使用者群組的實作已大幅變更,以解決舊版AEM的效能和擴充性限制。 先前版本的CUG已在6.3中淘汰,新的實施僅支援觸控式UI。 如果您是從6.2版或更舊版本升級,您將會找到移轉至新CUG實作的指示 此處.

測試程式 testing-procedure

應準備完整的測試計畫以進行測試升級。 測試升級的程式碼基底和應用程式必須先在較低的環境中完成。 找到的任何錯誤都應透過反複的方式進行修正,直到程式碼庫穩定為止,只有那時才應該升級較高層級的環境。

測試升級程式 testing-the-upgrade-procedure

這裡所述的升級程式應在開發和QA環境中進行測試,如您的自訂執行手冊中所述(請參閱 規劃升級)。 升級程式應重複執行,直到所有步驟都記錄在升級執行手冊中且升級過程順利進行。

實作測試區域 implementation-test-areas-

以下是任何AEM實作的重要區域,在環境升級且部署升級後的程式碼庫後,這些區域應包含在測試計畫中。

功能測試區域
說明
已發佈的網站
在發佈層上測試AEM實作和相關程式碼
透過Dispatcher。 應包含頁面更新的條件和
快取失效。
製作
在製作層級上測試AEM實作和相關程式碼。 應包括頁面、元件製作和對話方塊。
與Experience Cloud解決方案整合
驗證與Analytics、DTM和Target等產品的整合。
與協力廠商系統整合
驗證「作者」和「發佈」階層上的任何協力廠商整合。
驗證、安全性和許可權
任何驗證機制(如LDAP/SAML)都應經過驗證。
應在Author和Publish上測試許可權和群組
階層。
查詢
自訂索引和查詢應該與查詢效能一起測試。
UI自訂
製作環境中AEM UI的任何擴充功能或自訂專案。
工作流程
自訂和/或現成的工作流程及功能。
效能測試
載入測試應在模擬真實世界情境的製作和發佈層級上執行。

記錄測試計畫和結果 document-test-plan-and-results

應建立涵蓋上述實作測試區域的測試計畫。 通常,依作者和發佈工作清單來區隔測試計畫是可行的做法。 此測試計畫應在升級生產環境之前於開發、QA和中繼環境上執行。 測試結果和效能量度應在較低層級環境中擷取,以便在升級中繼和生產環境時提供比較。

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2