文件AEM as a Cloud Service使用手冊

AEM as a Cloud Service 中的維護任務 maintenance-tasks-in-aem-as-a-cloud-service

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主題：

建立對象：

  • undefined

維護任務是依據排程執行以將存放庫最佳化的程序。使用 AEM as a Cloud Service，客戶設定維護任務的操作屬性的需求會降至最低。客戶可以將他們的資源集中在應用程式層級的問題上，將基礎結構的操作交由 Adobe 進行。

設定維護任務 maintenance-tasks-configuring

在舊版AEM中，您可以使用維護卡（「工具>作業>維護」）來設定維護任務。 AEM as a Cloud Service的維護卡已無法使用，因此設定應認可至原始檔控制，並使用Cloud Manager進行部署。 Adobe會管理具有客戶無法設定之設定（例如資料存放區記憶體回收）的維護任務。 其他維護任務可由客戶設定，如下表所述。

CAUTION
Adobe保留覆寫客戶維護任務組態設定的權利，以緩解效能降級等問題。

下表說明可用的維護任務。

維護任務
擁有設定者
如何設定（選擇性）
資料存放區記憶體回收
Adobe
不適用 — 完全Adobe擁有
版本清除
客戶
目前預設會停用版本清除，但可以設定原則，如版本清除和稽核記錄清除維護工作區段中所述。

預設即將啟用清除，這些值可覆寫。
稽核記錄清除
客戶
稽核記錄清除目前預設為停用，但可以設定原則，如版本清除和稽核記錄清除維護任務一節中所述。

預設即將啟用清除，這些值可覆寫。
Lucene 二進位清理
Adobe
未使用，因此被Adobe停用。
臨時任務清除
客戶

必須在Git中完成。 覆寫/libs下的現成維護視窗設定節點，方法是在資料夾/apps/settings/granite/operations/maintenance/granite_weekly、granite_daily或granite_monthly下建立屬性。

如需其他組態詳細資訊，請參閱下方的維護期間表格。 在上述節點底下新增另一個節點，以啟用維護任務。 將其命名為granite_TaskPurgeTask，屬性sling:resourceType設為granite/operations/components/maintenance/task，屬性granite.maintenance.name設為TaskPurge。 設定OSGI屬性，請參閱com.adobe.granite.taskmanagement.impl.purge.TaskPurgeMaintenanceTask以取得屬性清單。

工作流程清除
客戶

必須在Git中完成。 覆寫/libs下的現成維護視窗設定節點，方法是在資料夾/apps/settings/granite/operations/maintenance/granite_weekly、granite_daily或granite_monthly下建立屬性。 如需其他組態詳細資訊，請參閱下方的維護期間表格。

透過在上面的節點底下新增另一個具有適當屬性的節點（將其命名為granite_WorkflowPurgeTask）來啟用維護任務。 設定OSGI屬性，請參閱AEM 6.5維護工作檔案。

專案清除
客戶

必須在Git中完成。 覆寫/libs下的現成維護視窗設定節點，方法是在資料夾/apps/settings/granite/operations/maintenance/granite_weekly、granite_daily或granite_monthly下建立屬性。 如需其他組態詳細資訊，請參閱下方的維護期間表格。

透過在上面的節點底下新增另一個具有適當屬性的節點（將其命名為granite_ProjectPurgeTask）來啟用維護任務。 請參閱「Adobe專案清除設定」底下的OSGI屬性清單。

維護時段設定
擁有設定者
設定型別
參數
每日
客戶
jcr節點定義

windowSchedule=daily （此值不應變更）

windowStartTime=HH：MM 用作24小時時鐘。 定義與每日維護期間相關的維護任務何時開始執行。

windowEndTime=HH：MM 用作24小時時鐘。 定義與每日維護視窗關聯的維護任務在尚未完成時應何時停止執行。

在此時間範圍內，維護任務不能執行超過一次。

每週
客戶
jcr節點定義

windowSchedule=weekly （此值不應變更）

windowStartTime=HH：MM 用作24小時時鐘。 定義與每週維護期間關聯的維護任務應何時開始執行。

windowEndTime=HH：MM 用作24小時時鐘。 定義與每週維護視窗關聯的維護任務在尚未完成時應何時停止執行。

在此時間範圍內，維護任務不能執行超過一次。

windowScheduleWeekdays =由1-7 （例如[5,5]）的兩個值組成的陣列 陣列的第一個值是排程工作的開始日期，第二個值是停止工作的結束日期。 開始和結束的確切時間分別由windowStartTime和windowEndTime控制。

每月
客戶
jcr節點定義

windowSchedule=monthly （此值不應變更）

windowStartTime=HH：MM 用作24小時時鐘。 定義與每月維護視窗關聯的維護任務應何時開始執行。

windowEndTime=HH：MM 用作24小時時鐘。 定義與每月維護視窗關聯的維護任務在尚未完成時應何時停止執行。

在此時間範圍內，維護任務不能執行超過一次。

windowScheduleWeekdays=由1-7 （例如[5,5]）的兩個值組成的陣列 陣列的第一個值是排程工作的開始日期，第二個值是停止工作的結束日期。 開始和結束的確切時間分別由windowStartTime和windowEndTime控制。

windowFirstLastStartDay= 0/1 0表示排程在每月的第一週，或1表示排程在每月最後一週。 若沒有值，則會有效地在受windowScheduleWeekdays （每月）控制的當天排程工作。

位置：

  • 每日 — /apps/settings/granite/operations/maintenance/granite_daily
  • 每週 — /apps/settings/granite/operations/maintenance/granite_weekly
  • 每月 — /apps/settings/granite/operations/maintenance/granite_monthly

程式碼範例：

程式碼範例1 （每日）

<?xml version="1.0" encoding="UTF-8"?>
<jcr:root xmlns:sling="http://sling.apache.org/jcr/sling/1.0"
  xmlns:jcr="http://www.jcp.org/jcr/1.0"
  jcr:primaryType="sling:Folder"
  sling:configCollectionInherit="true"
  sling:configPropertyInherit="true"
  windowSchedule="daily"
  windowStartTime="03:00"
  windowEndTime="05:00"
 />

程式碼範例2 （每週）

<?xml version="1.0" encoding="UTF-8"?>
<jcr:root xmlns:sling="http://sling.apache.org/jcr/sling/1.0"
   xmlns:jcr="http://www.jcp.org/jcr/1.0"
   jcr:primaryType="sling:Folder"
   sling:configCollectionInherit="true"
   sling:configPropertyInherit="true"
   windowEndTime="15:30"
   windowSchedule="weekly"
   windowScheduleWeekdays="[5,5]"
   windowStartTime="14:30"/>

程式碼範例3 （每月）

<?xml version="1.0" encoding="UTF-8"?>
<jcr:root xmlns:sling="http://sling.apache.org/jcr/sling/1.0"
   xmlns:jcr="http://www.jcp.org/jcr/1.0"
   jcr:primaryType="sling:Folder"
   sling:configCollectionInherit="true"
   sling:configPropertyInherit="true"
   windowEndTime="15:30"
   windowSchedule="monthly"
   windowFirstLastStartDay=0
   windowScheduleWeekdays="[5,5]"
   windowStartTime="14:30"/>

版本永久刪除與稽核日誌永久刪除維護作業 purge-tasks

永久刪除版本和稽核記錄會減少存放庫的大小，在某些情況下，可以改善效能。

NOTE
AEM Guides客戶不應設定「版本清除」。

預設值 defaults

目前預設不會啟用清除，但未來將會變更。 在啟用預設清除之前建立的環境會有較保守的臨界值，因此清除不會意外發生。 如需有關預設永久刪除原則的詳細資訊，請參閱下方的「版本永久刪除」和「稽核日誌永久刪除」段落。

您可以宣告組態檔並將其部署（如下所述），來覆寫預設的清除值。

套用設定 configure-purge

宣告組態檔並部署，如下列步驟所述。

NOTE
在組態檔案中部署版本清除節點後，您必須將其保持宣告狀態，且不得將其移除。 如果您嘗試這麼做，設定管道將會失敗。
同樣地，在組態檔中部署稽核記錄清除節點後，必須將其保持宣告狀態，不得將其移除。

1 — 在Git中專案的頂層資料夾中建立下列資料夾和檔案結構：

config/
     mt.yaml

2 — 在組態檔中宣告屬性，包括：

  • 值為「MaintenanceTasks」的「kind」屬性。
  • 「版本」屬性（目前我們為版本1）。
  • 具有屬性envTypes的可選「metadata」物件，其環境型別(dev、stage、prod)的清單以逗號分隔，此設定對其有效。 如果未宣告任何中繼資料物件，則該設定對所有環境型別都有效。
  • 同時具有versionPurge和auditLogPurge物件的資料物件。

請參閱下列versionPurge與auditLogPurge物件的定義與語法。

您應建構類似於以下範例的設定：

kind: "MaintenanceTasks"
version: "1"
metadata:
  envTypes: ["dev"]
data:
  versionPurge:
    maximumVersions: 15
    maximumAgeDays: 20
    paths: ["/content"]
    minimumVersions: 1
    retainLabelledVersions: false
  auditLogPurge:
    rules:
      - replication:
          maximumAgeDays: 15
          contentPath: "/content"
          types: ["Activate", "Deactivate", "Delete", "Test", "Reverse", "Internal Poll"]
      - pages:
          maximumAgeDays: 15
          contentPath: "/content"
          types: ["PageCreated", "PageModified", "PageMoved", "PageDeleted", "VersionCreated", "PageRestored", "PageValid", "PageInvalid"]
      - dam:
          maximumAgeDays: 15
          contentPath: "/content"
          types: ["ASSET_EXPIRING", "METADATA_UPDATED", "ASSET_EXPIRED", "ASSET_REMOVED", "RESTORED", "ASSET_MOVED", "ASSET_VIEWED", "PROJECT_VIEWED", "PUBLISHED_EXTERNAL", "COLLECTION_VIEWED", "VERSIONED", "ADDED_COMMENT", "RENDITION_UPDATED", "ACCEPTED", "DOWNLOADED", "SUBASSET_UPDATED", "SUBASSET_REMOVED", "ASSET_CREATED", "ASSET_SHARED", "RENDITION_REMOVED", "ASSET_PUBLISHED", "ORIGINAL_UPDATED", "RENDITION_DOWNLOADED", "REJECTED"]

請記住，為了讓設定有效：

  • 必須定義所有屬性。 沒有繼承的預設值。
  • 下方屬性表格中的型別（整數、字串、布林值等）必須遵守。
NOTE
您可以使用yq在本機驗證組態檔（例如，yq mt.yaml）的YAML格式。

3 — 設定非生產和生產組態管道。

快速開發環境(RDE)不支援清除。 對於生產（非沙箱）計畫中的其他環境型別，在Cloud Manager中建立目標部署設定管道。

如需詳細資訊，請參閱設定生產管道和設定非生產管道。

版本清除 version-purge

NOTE
AEM Guides客戶不應設定「版本清除」。

版本清除預設值 version-purge-defaults

目前預設不會啟用清除，但未來將會變更。

啟用預設清除後建立的環境會有以下預設值：

  • 超過30天的版本會被移除。
  • 會保留過去30天內最近的五個版本。
  • 無論上述規則為何，都會保留最新版本（以及目前的檔案）。

在啟用預設清除之前建立的環境，其預設值會列於下方，但建議您降低這些值，以最佳化效能。

  • 超過7年的版本會被移除。
  • 會保留過去7年的所有版本。
  • 7年後，最新版本以外的版本（除了目前的檔案）會被移除。

版本清除屬性 version-purge-properties

允許的屬性列於下方。

指示​ 預設 ​的資料行指示未來套用預設時的預設值；待定 ​反映尚未確定的環境ID。

屬性
環境>待定的未來預設值
環境<=TBD的未來預設值
必要
類型
值
路徑
["/content"]
["/content"]
是
字串陣列
指定建立新版本時要在哪一個路徑下清除版本。 客戶必須宣告此屬性，但唯一允許值為「/content」。
maximumAgeDays
30
2557 （7年以上2個閏日）
是
整數
系統會移除設定值之前的任何版本。 如果值為0，則不會根據版本的存留期執行永久刪除。
maximumVersions
5
0 （無限制）
是
整數
第n個最新版本之前的任何版本都會被移除。 如果值為0，則不會根據版本數執行永久刪除。
minimumVersions
1
1
是
整數
無論年齡為何，保留的最低版本數量。 請注意，一律會保留至少1個版本；其值必須為1或更高。
retainLabelledVersioned
false
false
是
布林值
決定是否從清除中排除明確標籤的版本。 為求較佳的存放庫最佳化，建議將此值設為false。

屬性互動

下列範例說明屬性在結合時如何互動。

範例：

maximumAgeDays = 30
maximumVersions = 10
minimumVersions = 2

如果第23天有11個版本，則會在下次清除維護工作執行時清除最舊的版本，因為maximumVersions屬性設定為10。

如果第31天有5個版本，則只會清除3個，因為minimumVersions屬性設定為2。

範例：

maximumAgeDays = 30
maximumVersions = 0
minimumVersions = 1

由於maximumVersions屬性設為0，因此不會清除任何超過30天的版本。

將保留一個超過30天的版本。

稽核記錄清除 audit-purge

稽核記錄清除預設值 audit-purge-defaults

目前預設不會啟用清除，但未來將會變更。

啟用預設清除後建立的環境會有以下預設值：

  • 會移除超過7天的復寫、DAM和頁面稽核記錄。
  • 所有可能的事件都會記錄下來。

在啟用預設清除之前建立的環境，其預設值會列於下方，但建議您降低這些值，以最佳化效能。

  • 系統會移除超過7年的復寫、DAM和頁面稽核記錄。
  • 所有可能的事件都會記錄下來。
NOTE
建議符合法規要求，必須產生無法編輯之稽核記錄的客戶整合專門的外部服務。

稽核記錄清除屬性 audit-purge-properties

允許的屬性列於下方。

指示​ 預設 ​的資料行指示未來套用預設時的預設值；待定 ​反映尚未確定的環境ID。

屬性
環境>待定的未來預設值
環境<=TBD的未來預設值
必要
類型
值
多項規則
-
-
是
物件
下列一或多個節點：復寫、頁面、dam。 這些節點中的每一個都會定義規則，其屬性如下。 所有屬性都必須宣告。
maximumAgeDays
7 天
2557年（7年以上2個閏日）
是
整數
對於復寫、頁面或dam：稽核記錄的保留天數。 系統會清除早於設定值的稽核記錄。
內容路徑
「/content」
「/content」
是
字串
相關型別稽核記錄清除的路徑。 必須設定為「/content」。
型別
所有值
所有值
是
列舉陣列
針對​ 復寫，列舉值為：啟用、停用、刪除、測試、反向、內部輪詢。 對於​ 頁面，列舉值為： PageCreated、PageModified、PageMoved、PageDeleted、VersionCreated、PageRestored、PageRolled、PageValid、PageInvalid。 對於​ dam，列舉值為：ASSET_EXPIRING、METADATA_UPDATED、ASSET_EXPIRED、ASSET_REMOVED、RESTORED、ASSET_MOVED、ASSET_VIEWED、PROJECT_VIEWED、PUBLISHED_EXTERNAL、COLLECTION_VIEWED、VERSIONED、ADDED_COMMENT、RENDITION_UPDATED、ACCEPTED、DOWNATED、DOWNATED、DOWNATED、DOWNATED、SUBONED、SUBASSET、SUBASSET_UPDATED、RATED、RATED_RATED、ASSET_RATED、RATED、ASSET_REMOVED、ASSET_RATED、ASSET_ASSET已共用、RENDITION_REMOVED、ASSET_PUBLISHED、ORIGINAL_UPDATED、RENDITION_DOWNLOADED、REJECTED。
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab