將內容引入雲端服務 ingesting-content
Cloud Acceleration Manager 中的摘取程序 ingestion-process
請依照下列步驟，使用Cloud Acceleration Manager擷取您的移轉集：
-
前往Cloud Acceleration Manager。 按一下您的專案卡，然後按一下「內容轉移」卡。 導覽至 擷取工作，然後按一下 新增擷取
-
檢閱擷取檢查清單，並確保完成所有步驟。 若要確保成功擷取，這些步驟是必要的。 只有在檢查清單完成時，才繼續進行 下一步 步驟。
-
提供建立內嵌所需的資訊。
- 移轉集： 選取包含擷取資料的移轉集作為Source。
- 移轉集將在長時間不活動後過期，因此預期擷取會在執行擷取後不久進行。 檢閱移轉集到期日以取得詳細資料。
note tip TIP 如果擷取正在執行，對話方塊將會指出它。 擷取一旦成功完成，就會自動開始內嵌。 如果擷取失敗或停止，擷取工作將會撤銷。 -
目的地： 選取目的地環境。 此環境是擷取移轉集內容的地方。
- 內嵌不支援快速開發環境(RDE)或預覽型別的目的地，並且即使使用者有權存取，也不會顯示為可能的目的地選擇。
- 雖然移轉集可同時內嵌至多個目的地，但目的地一次只能是一個執行或等待內嵌的目標。
-
層： 選取層。 (作者/Publish)。
- 如果來源是
Author，建議將其擷取到目標上的Author層。 同樣地，如果來源為Publish，目標也應為Publish。
- 如果來源是
note note NOTE 如果目標層是 Author，則作者執行個體會在擷取期間關閉，且無法供使用者（例如，作者或執行維護的任何人）使用。 原因是為了保護系統，並防止任何可能遺失或導致擷取衝突的變更。 確保您的團隊知道這個事實。 另請注意，環境在作者擷取期間似乎處於休眠狀態。-
擦除： 選擇
Wipe值- 擦去 選項會設定目的地的擷取起點。 如果啟用 擦去，包含其所有內容的目的地會重設為Cloud Manager中指定的AEM版本。 如果未啟用，目的地會維持目前內容為起點。
- 此選項 不 會影響內容擷取的執行方式。 擷取一律使用內容取代策略，而 不是 內容合併策略，因此在 擦除 和 非擦除 的情況下，擷取移轉集將會覆寫目的地上相同路徑中的內容。 例如，如果移轉集包含
/content/page1，而目的地已包含/content/page1/product1，則內嵌會移除整個page1路徑及其子頁面，包括product1，並將其取代為移轉集中的內容。 這表示在執行 非擦去 擷取至包含任何應維護之內容的目的地時，必須仔細規劃。 - 非擦去擷取是專為追加擷取使用案例而設計。 這些內嵌專案旨在遞增數量的新內容，這些內容自現有移轉集中最後一次內嵌以來已變更。 若在此使用案例之外執行非擦去擷取，可能會導致擷取時間非常長。
note important IMPORTANT 如果已為內嵌啟用設定 擦去，它會重設整個現有的存放庫，包括目標Cloud Service執行個體的使用者許可權。 此重設對於新增到 管理員 群組的管理員使用者也是true，必須將該使用者再次新增到管理員群組才能開始內嵌。 -
預先複製： 選擇
Pre-copy值- 您可以執行選用的預先複製步驟，大幅加快內嵌速度。 如需詳細資訊，請參閱使用AzCopy擷取。
- 如果使用預先複製擷取（用於S3或Azure資料存放區），建議先單獨執行
Author擷取。 如此可加快Publish擷取稍後執行的速度。
note important IMPORTANT 您必須屬於目的地Cloud Service作者服務上的本機 AEM管理員 群組，才能起始內嵌至目的地。 如果您無法開始內嵌，請參閱無法開始內嵌以取得詳細資料。 - 移轉集： 選取包含擷取資料的移轉集作為Source。
-
選取擷取選擇後，將會顯示預估的持續時間。 這是根據類似擷取之歷史資料盡力估計的結果。
- 只有在擷取的「檢查大小」值已收集到並且可供使用時，才會計算並顯示此預估值。
- 此值是預估值，雖然計算方式很聰明，但不應視為精確。 不同的因素可能會改變實際持續時間。
- 在執行內嵌期間，此值也會在期間對話方塊中提供，該對話方塊可透過內嵌的"檢視期間"動作存取。
-
按一下 擷取。
-
然後，您可以從「內嵌工作」清單檢視中監視內嵌，並使用內嵌的動作功能表來檢視持續時間並記錄內嵌進度。
-
按一下列中的 (i) 按鈕，以取得擷取工作的詳細資訊。 您可以按一下 …，然後按一下 檢視期間，以檢視擷取每個步驟的執行或完成期間。 擷取的資訊也會顯示出來，以瞭解正在擷取的內容。
填滿攝入 top-up-ingestion-process
「內容轉移工具」具備可透過執行移轉集的 追加 來擷取差異內容的功能。 如此可修改移轉集，使其僅包含自上次擷取以來已變更的內容，而無須再次擷取所有內容。
若要在部分擷取完成後擷取差異內容，您必須執行追加擷取，然後使用具有 擦去 選項 停用的擷取方法。 請務必閱讀上述 擦去 說明，以避免遺失目的地上的內容。
從建立內嵌工作開始，並確定在內嵌期間已停用 擦去，如下所示：
疑難排解 troubleshooting
CAM無法擷取移轉權杖 cam-unable-to-retrieve-the-migration-token
自動擷取移轉權杖可能會因為其他原因而失敗，包括您在目標Cloud Service環境中透過Cloud Manager設定IP允許清單。 在這種情況下，當您嘗試開始內嵌時，會看到下列對話方塊：
按一下對話方塊上的「取得權杖」連結，手動擷取移轉權杖。 另一個標籤會開啟，顯示Token。 然後，您可以複製權杖並將其貼到 移轉權杖輸入 欄位。 現在，您應該能夠開始內嵌。
無法開始內嵌 unable-to-start-ingestion
您必須屬於目的地Cloud Service作者服務上的本機 AEM管理員 群組，才能起始內嵌至目的地。 如果您不屬於AEM管理員群組，當您嘗試開始內嵌時，會看到如下所示的錯誤。 您可以要求您的系統管理員將您新增至本機 AEM系統管理員，或要求您取得權杖本身，然後您可以將權杖貼到 移轉權杖輸入 欄位中。
無法連線至移轉服務 unable-to-reach-migration-service
請求內嵌後，可能會向使用者顯示類似以下訊息：「無法聯絡目標環境上的移轉服務。 如果是這樣的話，請稍後再試或聯絡Adobe支援。」
此訊息指出Cloud Acceleration Manager無法連線到目標環境的移轉服務來開始內嵌。 發生此狀況可能有各種原因。
- AEM as a Cloud Service會維護環境狀態，而且偶爾會因為各種正常原因而重新啟動移轉服務。 如果服務正在重新啟動，則無法連線到該服務，但最終會提供該服務。
- 執行個體上可能正在執行另一個處理序。 例如，如果AEM版本更新正在套用更新，則系統可能忙碌中，且移轉服務定期無法使用。 完成該程式後，可以再次嘗試開始內嵌。
- 如果已透過Cloud Manager套用IP允許清單，它會封鎖Cloud Acceleration Manager以停止連線至移轉服務。 無法新增用於內嵌的IP位址，因為其位址是動態的。 目前，唯一的解決方案是在擷取和索引過程中停用IP允許清單。
- 可能有其他原因需要調查。 如果內嵌或索引繼續失敗，請聯絡Adobe客戶服務。
AEM版本更新與擷取 aem-version-updates-and-ingestions
AEM版本更新會自動套用至環境，以使其與最新的AEM as a Cloud Service版本保持一致。 如果在執行內嵌時觸發更新，可能會導致無法預測的結果，包括環境損毀。
如果「AEM版本更新」已上線到目的地程式，則擷取程式會嘗試在開始前停用其佇列。 擷取完成時，版本更新程式狀態會傳回至擷取開始前的狀態。
如果「AEM版本更新」作用中（即更新正在執行或排入佇列等待執行），則擷取不會開始，且使用者介面會顯示下列訊息。 更新完成後，即可開始內嵌。 Cloud Manager可用來檢視方案管道的目前狀態。
由於違反唯一條件限制而導致填滿擷取失敗 top-up-ingestion-failure-due-to-uniqueness-constraint-violation
追加擷取失敗的常見原因是節點ID發生衝突。 若要識別此錯誤，請使用Cloud Acceleration Manager UI下載擷取記錄，並尋找類似以下的專案：
java.lang.RuntimeException： org.apache.jackrabbit.oak.api.CommitFailedException： OakConstraint0030：唯一性條件約束違反了屬性[jcr：uuid]，其值為a1a1a1a1-b2b2-c3c3-d4d4-e5e5e5e5e5： /some/path/jcr：content， /some/other/path/jcr：content
AEM中的每個節點都必須有唯一的uuid。 此錯誤指出正在擷取的節點與目的地執行個體上不同路徑中存在的節點具有相同的uuid。 發生此狀況有兩個原因：
- 節點在來源上從擷取到後續追加擷取之間移動
- 記住：對於追加擷取，即使節點不再存在於來源上，仍會存在於移轉集中。
- 目的地上的節點會在擷取與後續追加擷取之間移動。
此衝突必須手動解決。 熟悉內容的人必須決定必須刪除兩個節點中的哪一個，同時留意參考該內容的其他內容。 解決方案可能要求再次執行追加擷取，而不需要違反規定的節點。
無法刪除引用節點而導致填滿擷取失敗 top-up-ingestion-failure-due-to-unable-to-delete-referenced-node
追加擷取失敗的另一個常見原因是目的地執行個體上特定節點的版本衝突。 若要識別此錯誤，請使用Cloud Acceleration Manager UI下載擷取記錄，並尋找類似以下的專案：
java.lang.RuntimeException： org.apache.jackrabbit.oak.api.CommitFailedException： OakIntegrity0001：無法刪除參照的節點： 8a2289f4-b904-4bd0-8410-15e41e0976a8
如果目的地的節點在內嵌與後續 非擦去 內嵌之間被修改，以致已建立新版本，就可能發生這種情況。 如果在啟用「包含版本」的情況下擷取移轉集，則可能會發生衝突，因為目的地現在具有由版本記錄和其他內容參考的更新版本。 由於違規版本節點被引用，擷取程式無法刪除該節點。
解決方案可能要求再次執行追加擷取，而不需要違反規定的節點。 或者，建立違規節點的小型移轉集，但停用「包含版本」。
最佳實務指出，如果必須使用包含版本的移轉集來執行 非擦去 內嵌，請務必儘可能減少修改目的地上的內容，直到移轉歷程完成為止。 否則，這些衝突可能會發生。
由於節點屬性值過大而導致擷取失敗 ingestion-failure-due-to-large-node-property-values
儲存在MongoDB中的節點屬性值不能超過16 MB。 如果節點值超過支援的大小，擷取會失敗，且記錄會包含：
BSONObjectTooLarge錯誤並指定哪個節點超過最大值，或BsonMaximumSizeExceededException錯誤，表示節點可能包含超過大小上限**的unicode字元
這是MongoDB限制。
請參閱內容轉移工具必備條件中的Node property value in MongoDB附註，以取得詳細資訊以及可協助尋找所有大型節點的Oak工具連結。 修正所有大型節點後，請再次執行擷取和擷取。
若要避免此限制，請在來源AEM執行個體上執行Best Practices Analyzer，並檢閱它提供的發現，特別是「不支援的存放庫結構」(URS)模式。
因預期外的間歇性錯誤導致擷取失敗 ingestion-failure-due-to-unexpected-intermittent-errors
有時，非預期的間歇性問題可能會導致擷取失敗，很遺憾，唯一的補救方法就是重試擷取。 調查擷取記錄以找出失敗的原因，並檢視它是否符合下面列出的任何錯誤，其中應嘗試重試。
MongoDB問題 mongo-db-issues
Atlas prescale timeout error— 擷取階段會嘗試預先縮放目標雲端資料庫，使其大小與正在擷取的移轉集內容大小相符。 少數情況下，此作業未在預期時間範圍內完成。Exhausted mongo restore retries— 嘗試將擷取的移轉集內容還原到雲端資料庫的本機傾印已經用盡。 這表示MongoDB的整體健康情況/網路問題，通常會在幾分鐘後自行解決。
擷取已撤銷 ingestion-rescinded
使用執行中的擷取作為來源移轉集而建立的擷取會耐心等待，直到擷取成功，而且在那一刻會正常開始。 如果擷取失敗或停止，則擷取及其索引工作將不會開始，但會取消。 在這種情況下，請檢查擷取以確定失敗的原因，修正問題並重新開始擷取。 執行固定擷取後，即可排程新的內嵌。
重新執行內嵌後已刪除的資產不存在
一般而言，不建議在內嵌之間修改雲端環境資料。
使用Assets觸控式UI從Cloud Service目的地刪除資產時，會刪除節點資料，但不會立即刪除包含影像的資產blob。 它會標示為刪除，因此不再出現在UI中；但是，它會保留在資料存放區中，直到發生記憶體回收並移除blob為止。
在先前移轉的資產被刪除，且下次內嵌是在記憶體回收行程完成刪除資產之前執行的情境中，內嵌相同的移轉集將不會還原已刪除的資產。 當內嵌檢查雲端環境上的資產時，沒有節點資料；因此，內嵌會將節點資料複製到雲端環境。 不過，在檢查blob存放區時，它會看到blob存在，並略過複製blob。 這就是為什麼中繼資料會在您從觸控式UI檢視資產時出現在擷取後，但影像卻沒有。 請記住，移轉集和內容擷取並非設計用於處理這種情況。 他們的目標是將新內容新增到雲端環境，而不是還原先前移轉的內容。
下一步 whats-next
擷取成功後，AEM索引會自動開始。 如需詳細資訊，請參閱移轉內容後的索引。
完成將內容擷取到Cloud Service中後，您可以檢視每個步驟的記錄（擷取和擷取）並尋找錯誤。 請參閱檢視移轉集記錄以瞭解更多資訊。