封裝管理員 working-with-packages
套件可讓您匯入和匯出存放庫內容。 您可以使用套件來安裝新內容、安裝新功能、在執行個體之間傳輸內容以及備份存放庫內容。
使用封裝管理員,您可以在AEM執行個體和本機檔案系統之間傳輸封裝,以進行開發。
什麼是套件? what-are-packages
套件是一個zip檔案,以檔案系統序列化形式存放庫內容,稱為儲存庫序列化,提供易於使用和編輯的檔案和資料夾表示法。 套件中包含的內容是使用篩選器來定義。
套件也包含儲存庫中繼資訊,包括篩選器定義和匯入組態資訊。 套件中可包含不用於套件提取的其他內容屬性,例如說明、視覺影像或圖示。 這些額外的內容屬性僅供內容套件取用者參考。
封裝管理員 package-manager
封裝管理員會管理AEM安裝上的封裝。 在您擁有 已指派必要的許可權 您可以將封裝管理員用於各種動作,包括設定、建置、下載和安裝封裝。
必要許可權 required-permissions
若要建立、修改、上傳和安裝套件,使用者必須在以下節點上擁有適當的許可權:
- 完整權利(排除刪除於)
/etc/packages
- 包含套件內容的節點
存取封裝管理員 accessing
您可以透過三種方式存取「封裝管理員」:
- 從AEM主功能表> 工具 > 部署 > 封裝
- 從 CRXDE Lite 使用頂端切換列
- 直接存取
http://<host>:<port>/crx/packmgr/
封裝管理員UI ui
封裝管理員分為四個主要功能區域:
-
左側導覽面板 — 此面板可讓您篩選及排序套件清單。
-
封裝清單 — 這是您執行個體上的套件清單,按照左側導覽面板中的選取專案進行篩選和排序。
-
活動記錄 — 此面板一開始會最小化,並展開以詳細說明「封裝管理員」的活動,例如建置或安裝封裝時。 「活動記錄」標籤中還有額外的按鈕可執行下列動作:
- 清除記錄
- 顯示/隱藏
-
工具列 — 工具列包含[左側導覽面板]和[封裝]清單的重新整理按鈕,以及用於搜尋、建立和上傳封裝的按鈕。
按一下左側導覽面板中的選項,會立即篩選封裝清單。
按一下封裝名稱會展開「封裝清單」中的專案,以顯示有關封裝的詳細資訊。
展開封裝詳細資訊時,可以透過工具列按鈕對封裝執行許多動作。
下有進一步的動作 更多 按鈕。
封裝狀態 package-status
封裝清單中的每個專案都有一個狀態指示器,讓您一眼就知道封裝的狀態。 將游標暫留在狀態上會顯示工具提示,其中包含狀態的詳細資訊。
如果封裝已變更或從未建置,則狀態會以連結的形式顯示,以採取快速動作來重建或安裝封裝。
封裝設定 package-settings
套件基本上是一組篩選器,以及根據這些篩選器的存放庫資料。 使用封裝管理員UI,您可以按一下封裝,然後按一下 編輯 按鈕以檢視套件的詳細資訊,包括下列設定。
一般設定 general-settings
您可以編輯各種封裝設定來定義資訊,例如封裝說明、相依性和提供者詳細資訊。
此 封裝設定 對話方塊可透過 編輯 按鈕時間 建立 或 編輯 套件。 完成任何變更後,按一下 儲存.
封裝縮圖 thumbnails
縮圖提供封裝所包含內容的快速參考視覺表示。 然後這會顯示在封裝清單中,並且有助於輕鬆識別封裝或封裝類別。
以下是用於正式套件的慣例範例:
官方Hotfix
擴充功能的正式AEM安裝
Official Service Pack
對您的套件使用唯一的圖示。 請勿重複使用Adobe使用的圖示。
封裝篩選器 package-filters
篩選器會識別要包含在封裝中的存放庫節點。 A 篩選器定義 指定下列資訊:
- 此 根路徑 要包含的內容的
- 規則 在根路徑底下包含或排除特定節點
使用新增規則 + 按鈕。 使用移除規則 - 按鈕。
規則會根據其順序套用,因此請使用 上 和 向下 箭頭按鈕。
篩選器可包含零個或多個規則。 未定義規則時,套件會包含根路徑下的所有內容。
您可以為封裝定義一或多個篩選定義。 使用多個篩選器以包含來自多個根路徑的內容。
建立篩選時,您可以定義路徑或使用規則運算式來指定您要包含或排除的所有節點。
套件篩選器最常在您初次使用時定義 建立套件。 不過,它們也可在稍後進行編輯,之後應重新建置套件,以根據新的篩選定義更新其內容。
相依性 dependencies
6.5
groupId:name:version
groupId:name:version
進階設定 advanced-settings
WKND Media Group
https://wknd.site
https://wknd.site/package/
重新啟動 — 安裝套件後,必須重新啟動AEM
覆寫 — 覆寫存放庫中的ACL
合併 — 合併兩組ACL
MergePreserve — 將內容中的存取控制項與封裝隨附的控制項合併,方法是新增內容中未出現之主體的存取控制項
清除 — 清除ACL
套件熒幕擷取畫面 package-screenshots
您可以將多個熒幕擷取畫面附加至封裝,以提供內容顯示方式的視覺化表示。
封裝動作 package-actions
可以對套件執行許多動作。
建立封裝 creating-a-new-package
-
按一下 建立封裝.
note tip TIP 如果您的執行個體有許多套件,可能會有資料夾結構。 在這種情況下,在建立新封裝之前可以更輕鬆地導覽到所需的目標資料夾。 -
在 新封裝 對話方塊中,輸入下列欄位:
-
封裝名稱 — 選取描述性名稱,以協助您(和其他人)輕鬆識別封裝內容。
-
版本 — 這是文字欄位,可供您指出版本。 這會附加至封裝名稱,以形成zip檔案的名稱。
-
群組 — 這是目標群組(或資料夾)名稱。 群組可協助您組織套件。 如果群組尚不存在,則會建立該群組的資料夾。 如果您將群組名稱保留為空白,它會在主封裝清單中建立封裝。
-
-
按一下 確定 以建立封裝。
-
AEM會在套裝程式清單頂端列出新套裝程式。
-
按一下 編輯 以定義 封裝內容。 按一下 儲存 完成編輯設定後。
-
您現在可以 建置 您的封裝。
不一定要在建立套件後立即建置套件。 未建置的套件不包含任何內容,且僅由套件的篩選資料和其他中繼資料組成。
建置套件 building-a-package
通常會在您建立套件的同時建立套裝 建立套件,但您稍後可以返回建置或重建套件。 如果存放庫中的內容已變更或封裝篩選器已變更,此功能會很有用。
-
按一下封裝名稱,從封裝清單開啟封裝詳細資訊。
-
按一下 建置. 對話方塊會要求您確認是否要建置封裝,因為任何現有的封裝內容都會被覆寫。
-
按一下 確定. AEM會建置套件,在活動清單中列出新增到套件的所有內容。 完成時,AEM會顯示已建置封裝的確認,並且(當您關閉對話方塊時)會更新封裝清單資訊。
編輯封裝 edit-package
將套件上傳到AEM後,您可以修改其設定。
-
按一下封裝名稱,從封裝清單開啟封裝詳細資訊。
-
按一下 編輯 並更新 封裝設定 視需要。
-
按一下 儲存 以儲存。
您可能需要 重新建置封裝 以根據您所做的變更來更新其內容。
重新包裝封裝 rewrapping-a-package
建立套件後,即可重新包裝。 重新包裝會變更封裝資訊,而不使用縮圖、說明等,而不會變更封裝內容。
-
按一下封裝名稱,從封裝清單開啟封裝詳細資訊。
-
按一下 編輯 並更新 封裝設定 視需要。
-
按一下 儲存 以儲存。
-
按一下 更多 > 折行 而對話方塊會要求確認。
檢視其他封裝版本 other-versions
由於每個封裝版本都會以任何其他封裝的形式出現在清單中,因此「封裝管理員」可以找到所選封裝的其他版本。
-
按一下封裝名稱,從封裝清單開啟封裝詳細資訊。
-
按一下 更多 > 其他版本 且會開啟一個對話方塊,其中包含相同封裝的其他版本清單,其中包含狀態資訊。
檢視封裝內容和測試安裝 viewing-package-contents-and-testing-installation
建立套件後,您可以檢視內容。
-
按一下封裝名稱,從封裝清單開啟封裝詳細資訊。
-
若要檢視內容,請按一下 更多 > 內容,而「封裝管理員」會在活動記錄中列出封裝的整個內容。
-
若要執行試執行安裝,請按一下 更多 > 測試安裝 和「封裝管理員」在活動記錄中報告結果,就像已執行安裝一樣。
正在將封裝下載至您的檔案系統 downloading-packages-to-your-file-system
-
按一下封裝名稱,從封裝清單開啟封裝詳細資訊。
-
按一下 下載 按鈕或套件詳細資訊區域中套件的連結檔案名稱。
-
AEM會將套件下載到您的電腦。
共用封裝 share
Package Share是一項集中式公用服務,可分發內容套件。 封裝共用已取代為 Software Distribution 而且此按鈕已無法運作。
從您的檔案系統上傳套件 uploading-packages-from-your-file-system
-
選取要將封裝上傳到的群組資料夾。
-
按一下 上傳套裝 按鈕。
-
提供關於上傳之封裝的必要資訊。
- 封裝 — 使用 瀏覽…… 按鈕以從您的本機檔案系統選取所需的封裝。
- 強制上傳 — 如果已有同名的套件,此選項會強制上傳並覆寫現有的套件。
-
按一下 確定 則會上傳選取的封裝,並相應地更新封裝清單。
封裝內容現在存在於AEM上,但若要讓內容可供使用,請確定 安裝套件.
正在驗證封裝 validating-packages
由於套件可以修改現有內容,因此在安裝前驗證這些變更通常會有幫助。
驗證選項 validation-options
封裝管理員可以執行下列驗證:
驗證 OSGi 封裝匯入 osgi-package-imports
檢查內容
此驗證會檢查所有JAR檔案(OSGi套裝)的套件,擷取其 manifest.xml
(其中包含所述OSGi套件所依賴的已建立版本的相依性),並驗證AEM例項以正確的版本匯出所述相依性。
如何報告
任何無法由AEM執行個體滿足的版本化相依性都會列在「封裝管理員」的「活動記錄」中。
錯誤狀態
如果不滿足相依性,則具有這些相依性的套件中的OSGi套件組合將不會啟動。 這會導致中斷的應用程式部署,因為依賴未啟動OSGi套件組合的任何專案都將無法正常運作。
錯誤解決
若要解決因未滿足的OSGi套件組合所導致的錯誤,必須調整包含未滿足之匯入的套件組合中的相依性版本。
驗證覆蓋 overlays
檢查內容
此驗證會決定要安裝的套件是否包含已在目的地AEM執行個體中覆蓋的檔案。
例如,假設在已有覆蓋 /apps/sling/servlet/errorhandler/404.jsp
,此套件包含 /libs/sling/servlet/errorhandler/404.jsp
,如此一來,它就會變更現有的檔案 /libs/sling/servlet/errorhandler/404.jsp
.
如何彙報
任何此類覆蓋圖會在「封裝管理員」的「活動記錄」中說明。
錯誤狀態
錯誤狀態表示套件正嘗試部署已覆蓋的檔案,因此套件中的變更將會被覆蓋覆寫(因此「隱藏」)且不會生效。
錯誤解決
若要解決此問題,中的覆蓋檔案維護者 /apps
必須檢閱中覆蓋檔案的變更 /libs
並視需要將變更合併至覆蓋圖( /apps
),並重新部署覆蓋的檔案。
驗證 ACL acls
檢查內容
此驗證會檢查要新增哪些許可權、如何處理這些許可權(合併/取代),以及目前的許可權是否會受到影響。
如何報告
在「封裝管理員」的「活動記錄」中說明這些許可權。
錯誤狀態
無法提供明確的錯誤。 驗證只會指出安裝套件是否會新增或影響任何新的ACL許可權。
錯誤解決
使用驗證提供的資訊,可以在CRXDE中檢閱受影響的節點,並且可以根據需要在套件中調整ACL。
正在執行驗證 performing-validation
套件的驗證可以透過兩種不同的方式完成:
上傳套件後但安裝套件前應一律進行驗證。
透過封裝管理程式進行封裝驗證 via-package-manager
-
按一下封裝名稱,從封裝清單開啟封裝詳細資訊。
-
若要驗證套件,請按一下 更多 > 驗證,
-
在隨後出現的模型對話方塊中,使用核取方塊選取驗證型別,然後按一下開始驗證 驗證.
-
接著會執行選取的驗證,結果會顯示在「封裝管理員」的「活動記錄」中。
透過HTTPPOST要求進行套件驗證 via-post-request
POST請求會採用下列形式。
https://<host>:<port>/crx/packmgr/service.jsp?cmd=validate&type=osgiPackageImports,overlays,acls
此 type
引數可以是任何以逗號分隔的無序清單,包含:
osgiPackageImports
overlays
acls
的值 type
預設為 osgiPackageImports
(如果未明確傳遞)。
使用cURL時,執行類似下列的陳述式:
curl -v -X POST --user admin:admin -F file=@/Users/SomeGuy/Desktop/core.wcm.components.all-1.1.0.zip 'http://localhost:4502/crx/packmgr/service.jsp?cmd=validate&type=osgiPackageImports,overlays,acls'
透過POST要求驗證時,回應會以JSON物件的形式傳回。
檢視封裝涵蓋範圍 package-coverage
套件是由其篩選器所定義。 您可以讓「封裝管理員」將封裝的篩選器套用至您現有的存放庫內容,以顯示封裝的篩選器定義所涵蓋的存放庫內容。
-
按一下封裝名稱,從封裝清單開啟封裝詳細資訊。
-
按一下 更多 > 涵蓋範圍.
-
涵蓋範圍詳細資訊會列在活動記錄中。
安裝套件 installing-packages
上傳封裝只會將封裝內容新增到存放庫,但無法存取。 安裝上傳的套件以使用套件的內容。
在安裝套件之前,封裝管理員會自動建立包含將被覆寫內容的快照套件。 如果您解除安裝套裝軟體,將會重新安裝此快照。
- 如果您正在安裝數位資產,您必須:
首先,停用WorkflowLauncher。
使用OSGi控制檯的元件選單選項來停用com.day.cq.workflow.launcher.impl.WorkflowLauncherImpl.
- 接著,安裝完成後,重新啟用WorkflowLauncher。
-
按一下封裝名稱,從封裝清單開啟您要安裝的封裝詳細資訊。
-
按一下 安裝 專案詳細資訊中的按鈕,或 安裝 套件狀態中的連結。
-
對話方塊將會要求確認,並允許指定其他選項。
- 僅擷取 — 僅擷取套件,以免建立快照,因此無法解除安裝
- 儲存臨界值 — 直到觸發自動儲存為止的暫時節點數目(如果您遇到並行修改例外狀況會增加)
- 擷取子封裝 — 啟用自動擷取子封裝
- 存取控制處理 — 指定安裝封裝時,如何處理封裝中定義的存取控制資訊(選項與 進階封裝設定)
- 相依關係處理 — 指定在安裝期間處理相依性的方式
-
按一下 安裝.
-
活動記錄檔會詳細說明安裝進度。
安裝完成並成功後,封裝清單會更新,而且文字也會更新 已安裝 會顯示在封裝狀態。
重新安裝套件 reinstalling-packages
重新安裝套裝軟體時,會對已安裝的套裝軟體執行相同的步驟,這些套裝軟體會在 初始安裝套件。
以檔案系統為基礎的上傳與安裝 file-system-based-upload-and-installation
安裝套件時,您可以完全放棄套件管理員。 AEM可以偵測位於主機本機檔案系統特定位置的套件,並自動上傳及安裝這些套件。
-
在AEM安裝資料夾下有
crx-quicksart
jar旁邊的資料夾和license.properties
檔案。 建立名為的資料夾install
在crx-quickstart
產生路徑<aem-home>/crx-quickstart/install
. -
在此資料夾中,新增您的封裝。 它們會自動上傳並安裝在您的執行個體上。
-
上傳和安裝完成後,您可以在封裝管理員中檢視套件,就像您已使用封裝管理員UI進行安裝一樣。
如果執行個體正在執行,當您將其新增至的套件時,上傳和安裝會立即開始 install
資料夾
如果執行個體未執行,則會將套件置於 install
資料夾在啟動時依字母順序安裝。
解除安裝套件 uninstalling-packages
解除安裝套裝軟體會將儲存區域的內容還原成安裝前由「套裝軟體管理員」自動建立的快照。
-
按一下封裝名稱,開啟您要從封裝清單解除安裝的封裝詳細資料。
-
按一下 更多 > 解除安裝,即可從存放庫中移除此封裝的內容。
-
對話方塊將會要求確認並列出進行的所有變更。
-
套裝軟體會被移除並套用快照。 處理程式的進度會顯示在活動記錄檔中。
刪除封裝 deleting-packages
刪除封裝只會從「封裝管理員」刪除其詳細資料。 如果已經安裝此套件,則不會刪除安裝的內容。
-
按一下封裝名稱,開啟您要從封裝清單中刪除之封裝的封裝詳細資訊。
-
封裝管理員會要求您確認要刪除封裝。 按一下 確定 以確認刪除。
-
套件資訊會遭到刪除,而詳細資訊會回報於活動記錄中。
正在複製封裝 replicating-packages
複製套件的內容以將其安裝在發佈執行個體上。
-
按一下封裝名稱,開啟您要從封裝清單復寫之封裝的詳細資訊。
-
按一下 更多 > 復寫.
-
會複製套件,並在活動記錄中報告詳細資訊。
Software Distribution software-distribution
AEM套件可用於在AEM環境中建立和共用內容。
Software Distribution 是一項集中式服務,旨在簡化AEM套件的搜尋和下載。
如需詳細資訊,請參閱 Software Distribution檔案。