移轉生產網站 production-migration

使用此工作流程將同意的頁面清單移動至Edge Delivery Services (提供網站的Adobe Experience Manager服務)。 從每個範本的範例頁面開始,解決其內容和設計對應到新網站的方式,並僅在範例在作者將使用的編輯器中運作時匯入更多頁面。 如果區塊、預設內容或預覽等字詞是您第一次使用,請參閱如何建置和更新您的網站和塑造內容結構。

對於一些示範頁面或第一次評估,請使用較小的示範和試用工作流程。 它們不需要檢查生產網站在發行前是否需要。

同意範圍和目的地 scope

移轉主管和架構師同意範圍和目的地。 您需要授權才能讀取來源、修改目標存放庫,以及將內容和資產寫入目的地。 同意哪些人簽署結果以及哪些人授權發佈。 如果某些頁面需要登入,請以專用的唯讀帳戶設定受保護的網站驗證。 如果來源封鎖自動訪客,請在編目前安排其管理員的存取權。 請參閱具有機器人保護的Source網站。

記錄:

輸入
要保留的決定
Source詳細目錄
網域、頁面URL、地區設定、檔案、資產,以及排除或淘汰的內容。
代碼
存放庫、工作分支、稽核原則和版本所有者。
內容目的地
專案使用的兩個儲存體選項中的哪一個。
設計
保留來源外觀或套用新設計。 為核准的參照和版本命名。
行為
導覽、表單、搜尋、商務、同意、分析、個人化和其他必須有效的整合。 識別其擁有者。
URL原則
要保留的目的地路徑、重新導向、標準URL、語言關係和連結。
復原
程式碼基準、內容備份與復原程式,以及覆寫或發佈的許可權。

頁面匯入會複製每個頁面的內容和設計。 整合和CMS功能會在來源的伺服器上執行(例如搜尋、表單處理、個人化規則和內容繼承),因此匯入時只會在每個頁面上複製其輸出。 將它們列在​ 行為 ​下,並決定每個專案在新網站上如何運作。 請參閱限制。

主控台工作區一次只能在一個網站上運作。 在有數個網站的程式中,同意其訂單,並推播及上傳每個網站的工作,然後再使用​ 切換網站 ​開啟下一個網站。

重新啟動在Experience Manager上執行的網站 relaunch-aem-site

您的團隊決定重新啟動後,工作流程將與任何其他來源相同。 以下幾點專屬於Experience Manager來源:

  • 您的其他網站:​代理程式會讀取來源網站的頁面,而不會變更來源。 它只會寫入新網站的Git存放庫以及您選擇的內容目的地,因此您組織的其他Experience Manager網站會維持原樣運作,而來源網站也會如此,直到您在版本切換其網域為止。 透過Experience Manager編寫,上傳會將頁面寫入/content/{site-name}下,並將影像寫入網站的Assets資料夾下,並取代該路徑已存在的任何頁面,因此請與製作執行個體的管理員一致。 檢視上傳內容。
  • 代理程式如何讀取來源:​代理程式讀取每個頁面時,瀏覽器會轉譯它,而非來源的元件、範本或存放庫。 因此,元件、體驗片段和內容繼承不會因此延續:它們的輸出會顯示在每個頁面上。 決定要將哪些共用內容保留在新網站上一次。 檢視專案剩餘工作。
  • 內容去向:​目的地是您的選擇,如同任何來源一樣;請參閱內容的儲存位置以及作者如何編輯內容。 Experience Manager製作需要Experience Manager as a Cloud Service製作例項,因此執行於其他位置的製作例項不能是目的地。
  • 存放庫:​如果您的程式碼位於透過Cloud Manager連線的存放庫中,主控台也可搭配使用。 請參閱使用其他Git主機。
  • 您團隊的決定:​語言、市場之間的繼承以及核准工作流程,都是您團隊的決定。 匯入會提供您位於其來源路徑的頁面,而非這些結構。 在編目之前,將其與其他範圍決定一起記錄。

準備和編目 prepare

  1. 請依照共用主控台設定或Experience Manager製作設定操作(如果內容進入Experience Manager製作)。 重複使用現有專案的設定,而非重新建立專案。
  2. 要求代理程式將授權網站編目: Scope site https://www.example.com。 網站目錄會探索頁面,並將其分組為範本(共用版面的頁面)和區塊變體。
  3. 檢閱Planning檢視中的目錄。 更正範本和區塊群組,並調查失敗的URL。
  4. 將探索到的URL與您同意的頁面清單進行比較。 新增探索遺漏的頁面,並明確決定失敗、已略過、重複或排除的URL。
  5. 為每個範本和重要變體挑選範例頁面。 涵蓋長內容、不尋常的影像、地區設定,以及需要大量互動的頁面。

編目會讀取來源,但不會匯入任何內容。 狀態為​ complete ​的執行仍可以有失敗的頁面;請參閱結果和狀態。 在繼續之前,請為每個範圍URL指定範本或核准的排除專案。

代理程式如何大規模移轉 migration-at-scale

代理程式不會透過AI模型傳送每個頁面。 分別解譯每個頁面不會擴展至數千頁,而模型每次處理類似頁面的方式可能略有不同。 相反地,AI模型會在每個範本的一個範例頁面上執行對應,而代理程式會將該對應轉換為在範本其他頁面上執行的程式碼:

  1. 將頁面群組至範本。 網站目錄會將來源網站的頁面分組為範本,這些範本是共用版面的頁面。 如果您移轉沒有目錄的頁面,您命名的每個頁面都會啟動自己的範本。
  2. 移轉範例頁面。 對於每個範本,代理程式會先移轉一個顯示範本典型配置的實際頁面,理想情況下還會移轉其大多數區塊和變體。 網站目錄會為每個範本建議一個範本。 如果範本的其他頁面顯示其更多區塊,請改為選擇該頁面:範例頁面缺少的區塊只會稍後在匯入頁面需要時新增。 AI模型會將範例頁面的內容對應至預設內容和區塊,並建立其所需的區塊或重複使用現有區塊。
  3. 產生匯入指令碼。 代理程式會為範本撰寫匯入指令碼:剖析器這個部分,會從來源HTML擷取每個區塊的內容,而轉換器這個部分,會清理整個頁面。 指令碼是專案的tools/importer/資料夾中的JavaScript檔案,其版本設定於Git中,且包含其餘的程式碼。
  4. 調整模式,而非頁面。 當您要求更正時,代理程式會變更產生結果的區塊或匯入指令碼,而非編輯一個頁面的輸出。 更正接著會套用至範本的每個頁面,之後範本會重複使用已存在的區塊。
  5. 大量匯入其餘頁面。 大量匯入會在範本的其他頁面上執行匯入指令碼,而不用AI模型解譯每個頁面。 接著,代理程式會將匯入的頁面與其來源頁面進行比較,修正差異過大的頁面的匯入指令碼,然後再次匯入這些頁面。

在匯入所有範本之前,請先驗證每個範本的幾個頁面。 請參閱以批次匯入。

這同樣適用於內容結構的變更,例如哪些內容會成為區塊,或頁面分割為多個區段:變更匯入指令碼。 它是程式碼、檢閱及合併,就像其餘的程式碼一樣,下次匯入時會將其套用至範本的每個頁面。 對一個匯入頁面的編輯會保留在本機,而再次匯入範本時會將其覆寫。

若要變更範本和區塊本身,例如將頁面移動到另一個範本,或使一個區塊成為另一個範本的變體,請使用Planning檢視或在聊天中詢問。 代理程式在下次產生區塊或匯入頁面時就會追蹤這些變更,而您已經匯入的頁面不會變更。 若要合併設計,請參閱重新樣式化網站。 若要合併區塊程式碼,請參閱重新調整而不變更結果。

NOTE
主控台中的範本是具有相同版面配置的一組來源頁面,代理程式會使用這些來源頁面來規劃和匯入它們。 它不是template頁面中繼資料,會將類別新增至頁面的body元素,讓專案的程式碼可以不同地設定這些頁面的樣式。 若要對齊兩者,請要求代理程式在匯入指令碼中設定中繼資料,讓範本的每個頁面在匯入時都能取得該中繼資料,例如:「若是文章範本,請在匯入指令碼中將頁面中繼資料template設定為article,並縮小文章頁面的主欄。」

驗證範例頁面 representatives

移轉負責人、設計人員和作者一起處理第一個範本。 從它的一些頁面開始。 例如:

僅移轉這些產品頁面: https://www.example.com/products/tents、https://www.example.com/products/backpacks和https://www.example.com/products/boots。 將內容儲存為/products下的檔案型內容。 保留核准的文字、連結、中繼資料和影像含義。 重複使用專案的區塊和內容慣例。 報告匯入無法重現的遺失內容和互動。 請勿上傳、推送或發佈。

將範例URL和路徑替換為您自己的,並且對於Experience Manager編寫,表示內容儲存在JCR中。

  1. 檢閱內容結構:區段、預設內容、區塊、變體以及代理程式選擇的區段樣式。 作者將編輯此結構中每個已移轉的頁面,以便在範例頁面上處理。 請參閱設定內容結構形狀。

  2. 將匯入的文字、連結、影像、中繼資料和區段順序與來源進行比較。 當模式錯誤時,請修正匯入指令碼,而非頁面。 檢視代理程式如何依比例移轉。

  3. 套用來源樣式或遵循重新設計工作流程。 請先檢查全域樣式,然後再修訂個別區塊。

  4. 與頁面匯入分開完成共用的頁首、導覽和頁尾。 代理程式會針對整個網站移轉一次(包括頁尾影像),讓每個頁面共用一個頁首和一個頁尾。

  5. 將範例頁面上傳至內容目的地,然後編輯、儲存、重新開啟及預覽:

  6. 在您匯入更多頁面之前,請先記錄從來源到輸出的議定對應、區塊模型、設計決定和已知例外。

如果作者無法編輯頁面,看起來正確的頁面仍會失敗。 若為Experience Manager製作,請在匯入更多內容之前,同時檢查區塊模型、產生的元件組態、轉換錯誤以及影像的儲存位置。

塑造內容結構 content-structure

作者會以代理程式在匯入時所選擇的結構編輯每個已移轉的頁面,而大量匯入會在範本的每個頁面上重複該結構。 Edge Delivery Services頁面是由包含預設內容和區塊的區段所組成;請參閱標籤、區段、區塊和自動封鎖。 代理程式會遵循David的模型,並保持結構如設計允許的那樣簡單,因為每個區塊和變體都是作者要學習的額外內容。

結構
代理程式在匯入時會做什麼
如何加以導向
節
分割背景或版面配置變更的頁面。 頁面各部分之間的空白是間距,而非區段。
要求它合併作者視為頁面一部分的區段,或分割執行兩項工作的區段。
預設內容
保留作者在檔案中可輸入作為預設內容的所有內容:標題、段落、清單、連結和內嵌影像。 CSS會依設計需求將其排列。
在其中建立了這類內容的區塊,請要求它使用預設內容,並以CSS設定其樣式。
區塊
將區塊用於重複專案、互動元件和並排固定的版面。 流動及包裝的類似專案會成為卡片;欄會並排儲存一組固定的不同內容。 像片背景屬於其區塊,例如主圖。 它會先重複使用專案的區塊,然後再建立區塊。
命名圖樣應使用的區塊,或要求它重複使用現有的區塊。 請參閱在建立區塊前撰寫。
封鎖變體
為作者選擇的外觀微小差異建立變體,例如cards-compact。 包含不同欄位或不同工作的內容會取得自己的區塊。 選用內容和不同數量的專案不會產生變體。
要求它合併僅稍微不同的變體,或將欄位不同的變體轉換為自己的區塊。
節樣式
當區段的背景與頁面不同、對齊方式並非預設值,或其預設內容位於區塊旁邊時,會在區段中繼資料中給予區段樣式。 它會在外觀之後命名樣式,例如dark、light-grey或centered。 區段中的文字和按鈕會從樣式中取得其顏色,因此單靠顏色絕不會建立區塊或變體。
同意區段樣式及其名稱的清單,方便作者在每個頁面上從這些樣式中選擇。

若要調整結構:

  1. 移轉之前,請檢閱​ Planning ​檢視中的目錄,並修正其中的區塊名稱和群組。 請參閱精簡目錄。
  2. 將專案的區塊、變體和區段樣式記錄在AGENTS.md中,以便代理程式在之後的頁面和之後的工作階段中重複使用這些區塊、變體和區段樣式。 請參閱檔案內容慣例。
  3. 在預覽面板的​ 檔案檢視 ​中檢查每個範例頁面,該檢視會顯示其區段、區塊和預設內容。 檢視內容檢視。
  4. 修正匯入指令碼中的錯誤模式,讓大量匯入在每個頁面上重複進行修正。 檢視代理程式如何依比例移轉。
  5. 要求作者編輯範例頁面。 如果他們猶豫要使用哪個區塊、變體或樣式,會有太多選擇。

保留作者所做的選擇。 設計系統應該做出作者不應該做的決定:當區塊需要多個變體或選項時,請詢問其中某些變體或選項是否屬於設計。

確認前預估 estimate

目錄和第一個範例頁面會根據網站所需的工作提供估計值,而非其頁面計數:

  1. 為網站編目。 目錄會列出範本、區塊變體和區域設定,以及失敗的URL。 請參閱準備和目錄。
  2. 驗證主要範本的範例頁面。 記錄每個專案所需的內容:新區塊、匯入指令碼的更正、樣式,以及內容結構的變更。
  3. 從範例頁面需要的內容中調整其餘範本的大小。 之後的範本會重複使用已存在的區塊,因此請計算每個區塊新增的區塊。 具有自身版面配置的頁面會計為自己的範本。
  4. 新增匯入不涵蓋的專案:您在範圍的​ 行為 ​下記錄的行為,以及您的團隊決定和建置的專案工作。

針對每個URL🔗的第一個批次的記錄,檢查預估值。

團隊工作 collaboration

有幾個人員可以使用該代理程式處理相同的專案,每個人員都在自己的主控台工作區中。 他們會透過Git共用程式碼,也會透過內容目的地共用內容。 主控台不會顯示誰正在處理什麼工作,也不會將兩個人的變更合併到相同頁面,因此會同意誰正在處理什麼工作並繼續互相交談。

有代理程式的範圍比沒有代理程式的範圍更重要。 單一請求可以變更許多檔案,因此當兩個人同時變更相同的區塊或樣式時,必須手動解決許多檔案之間的衝突。

領導移轉 phases

移轉會分階段執行。 代理程式會逐一執行大部分的重複工作,而您的團隊會做出決定並簽署結果。 讓某個人(例如移轉銷售機會)執行第一個階段;其他人在區塊和匯入指令碼結算後即可加入。 檢視團隊工作。

視覺貢獻者可從範例頁面階段開始處理樣式設定。 請參閱進行視覺化變更。

從一個人開始,然後劃分工作 divide-work

第一個步驟是建立其他所有建置專案的基礎:全域樣式、第一個區塊,以及第一個範本的匯入指令碼。 讓一個人設定它們。 在劃分工作之前,請檢查區塊是否符合實際內容,以及作者是否易於使用。 請參閱設定內容結構形狀。

一旦團隊同意這些區塊,就劃分工作,讓人員變更不同的檔案:

  • 依區塊:​某人精簡卡片區塊,而另一個人建立輪播。
  • 依範本:​每個人都會精簡不同範本的匯入指令碼。 檢視代理程式如何依比例移轉。
  • 專業技術:​開發人員建置整合時,設計師會精簡現有區塊的樣式。

不要同時給予兩個人相同的區塊、全域樣式或相同的匯入指令碼,除非他們同意如何協調。

以小步驟共用程式碼 share-code

  1. 同意共用分支,例如main或開發分支。 每個人員在程式碼檢視中透過​ 切換分支 ​將其工作區切換至該工作區。
  2. 讓代理程式的每個請求都集中在單一區塊、範本或任務上。 使用​建立新PR,在運作後立即推送結果:主控台會將您的變更推送至新分支、開啟提取請求至共用分支,並將您的工作區留在新分支上。
  3. 經常檢閱及合併提取請求。 小型變更衝突較少,且檢閱速度較快,而持續開啟數天的提取請求則會收集衝突。
  4. 開始新工作之前,請先切換回具有​ 切換分支 ​的共用分支,並使用​同步 > 提取 > 程式碼​提取它,以便在每個人的合併工作上建置。

如果提取無法使用或報告衝突,請參閱如果其他人變更了分支。

小規模、頻繁的推播也會讓團隊瞭解代理程式變更內容及原因。 若要取得每個要求一個認可,請參閱留下每個要求的記錄。

協調內容變更 share-content

內容沒有合併。 您的工作區會保留頁面的復本,而上傳會將內容目的地中的頁面替換為您的復本。 如果兩個人變更了同一個頁面,則表示最後上傳會成功,而另一個人的變更會遺失。 將每個頁面或一組頁面一次提供給一個人。

若要讓其他人上傳的頁面進入您的工作區:

  • 開啟在內容檢視中顯示雲端圖示的頁面。 主控台會將其下載至您的工作區。
  • 在檔案式專案中,選取「同步 > 提取 > 內容」以從Experience Workspace下載每個頁面。 它會取代您的本機復本,包括您尚未上傳的編輯,因此請上傳您要先保留的編輯。

批次匯入 batches

驗證範例頁面之後,請使用目錄大量匯入工作流程和大量匯入提示。

  1. 使用範本的匯入指令碼匯入小型批次。
  2. 檢查一般頁面和邊緣案例。 如果匯入指令碼錯誤,請先更正並再次匯入受影響的頁面,然後再繼續。
  3. 為每個來源URL保留記錄:目的地、匯入狀態、錯誤、登出以及任何已核准的排除。
  4. 依範本繼續範本。 個別發現、分析、匯入、失敗、略過和簽出的頁面計數。
  5. 當您變更共用樣式、匯入指令碼、區塊模型或區塊程式碼時,重新檢查先前的範例頁面。

一旦作者開始編輯內容目的地中的移轉頁面,其頁面就會成為真相的來源。 再次匯入或上傳這些頁面會覆寫作者的工作,且修正的匯入指令碼不會合併這些頁面,因此請先與作者同意。

完成網站 complete-site

自動匯入是傳遞的一部分。 實作及驗證議定的需求,包括:

  • 頁首、頁尾、導覽、內部連結和錯誤頁面。
  • 影像、下載、字型、資產許可權,以及任何保留的Dynamic Media參考。
  • 視需要提供標題、說明、標準URL、結構化資料、重新導向、網站地圖以及地區設定關係。
  • Forms、搜尋、商務、帳戶功能、分析、同意和其他整合。
  • 作者指引、操作所有權、存取權和部署設定。

代理程式會實作這些的程式碼端,例如呼叫搜尋或商務API、表單及載入分析和同意之程式碼的區塊。 它無法在您的存放庫和內容之外設定系統,例如搜尋服務、CDN或分析帳戶,而且不會決定您的需求。 提供API檔案和同意的行為,並為簽署結果的每個外部系統命名擁有者。 請參閱Connect Services and Applications,以取得表單表單提交,以及產品頁面Commerce頁面。

影像和檔案 assets

影像到達新網站的方式取決於內容目的地:

  • 體驗Workspace:​當您在主控台中工作時,匯入的頁面仍可參考來源網站上的影像。 當您上傳頁面時,主控台會將其影像(包括從來源下載的影像)上傳至以具有前導點的頁面命名的資料夾。 接著會將頁面指向已上傳的復本。 如果影像遺失、格式不受支援或模稜兩可,主控台會報告該影像,但不會上傳頁面。 上傳後,系統會檢查每個影像是否已送達。 檢視上傳內容。
  • Experience Manager製作:​上傳內容封裝時選取​上傳影像,並在/content/dam/下選擇資料夾。 預設為 /content/dam/site。 檢視上傳內容。
  • Adobe Dynamic Media:​來源從Dynamic Media (包括Scene7和具有OpenAPI URL的Dynamic Media)提供的影像請留在那裡。 匯入的頁面會參考它們,而專案的程式碼會轉譯它們。

Edge Delivery Services會以適合每個熒幕的大小和格式提供影像。 針對檔案型別和大小的限制,檢查大型檔案、視訊和SVG影像。

檢查範例頁面上檔案的連結,例如PDF。 每個連結都必須指向新網站上的復本,而不是您即將淘汰的來源網站。

URL、重新導向和搜尋中繼資料 urls-seo

代理程式會從其來源URL取得每個頁面的路徑。 它會將路徑變成小寫、移除.html、將結尾的/轉換為index,並以連字型大小取代其他字元,例如空格和底線。 /About_Us.html變成/about-us。 每個以此方式變更或您有意變更的URL都需要重新導向。

代理程式本身不會建立重新導向、網站地圖或語言替代專案。 詢問他們作為任務,並檢視結果:

  • 重新導向:​具有​ Source ​和​ 目的地 ​欄的redirects試算表,每個URL一列,不含萬用字元。 要求代理程式列出其路徑已變更的來源URL,作為工作表的列。 請參閱重新導向。
  • 頁面中繼資料:​匯入會將每個頁面的標題、說明和社交影像保留在其中繼資料區塊中。 若要一次設定多個頁面的中繼資料,請使用metadata試算表。 請參閱大量中繼資料。
  • Sitemap和語言:​存放庫中的helix-sitemap.yaml檔案,其中可包含每個頁面的語言替代項(hreflang)。 請參閱Sitemaps。
  • 搜尋引擎:​預覽和即時網站*.aem.page和*.aem.live對搜尋引擎是隱藏的;您的生產網域不是。 在切換前檢查robots.txt。 請參閱robots.txt。
  • 查詢索引:​從僅包含已發佈頁面的查詢索引讀取的頁面清單,例如文章清單和網站搜尋。 請參閱索引。

檢查並登出 acceptance

同意網站擁有者在發行前必須執行的動作,並在預覽和即時網站上測試。 網站擁有者會與測試者和作者一起將結果登出。

區域
簽核時間
適用範圍
每個範圍內URL都有目的地或已核准的例外。 已失敗和已略過的頁面會得到解析或記錄。
內容
文字、連結、資產、中繼資料和地區設定內容完整且正確。
製作
作者可以編輯一般欄位和區塊、儲存、重新開啟以及在編輯器中預覽結果。
設計
核准的案頭和行動版面配置適用於真實內容,包括長文字和區塊變體。
函數
導覽、鍵盤互動、表單、整合和認可的使用者歷程都可正常運作。
品質
協助工具、效能以及相關的SEO和安全性檢查符合專案商定的要求。 自動協助工具只會尋找規則可偵測的問題,因此也可以使用鍵盤和熒幕助讀程式來測試範例頁面。 使用PageSpeed Insights測試效能;在GitHub上,Edge Delivery Services會針對其說明中的測試URL對每個提取請求執行相同的檢查。
運作
存放庫檢閱、內容發佈、復原、監控和支援擁有權都已記錄下來,並視需要進行測試。

每個自動訊號會檢查一件事:指令碼已執行的匯入工具狀態、已轉換內容的產生套件、頁面看起來像其來源的視覺相似度分數,以及Lighthouse分數實驗室測試中一個頁面載入的方式。 生產整備需要表格的每個區域。

釋放、復原和移交 handoff

發行版本擁有者會協調程式碼合併、內容發佈和網域切換,然後確認網站的持續擁有者已將其接管。

  1. 推送簽核代碼,並根據存放庫原則的要求進行稽核。 合併至main會立即更新已上線的網站程式碼,因此請規劃與內容發行的合併。 檢視變更如何上線。
  2. 只上傳已簽章的內容和影像至已確認的目的地。 檢閱每個頁面和影像的錯誤。
  3. 在預覽網站*.aem.page上驗證具有預期代碼修訂版本的已儲存內容。
  4. 取得網站的發行核准,並遵循設定的發佈和網域轉換流程。 發佈功能可讓頁面在*.aem.live上使用;直接轉換功能是透過Adobe管理的CDN或您自己的CDN,在您自己的網域上提供這些頁面。 在切換前完成上線檢查清單。
  5. 檢查即時URL、重新導向、關鍵歷程和發行後的監視。 作業遙測顯示真實訪客體驗網站效能的方式。
  6. 提供專案交接、每個URL的記錄、作者範例、簽核結果、例外狀況以及復原連絡人。

發生錯誤時,請保留確切的URL或路徑、操作及錯誤記錄。 請在更正原因後,重試影響最小的範圍。 請勿重新啟動成功的批次,因為有一頁失敗。

推送程式碼、上傳檔案、將內容套件匯入至Experience Manager以及發佈作業,都是不同系統上的獨立作業。 部分失敗只會套用部分變更,而且單一復原無法復原所有變更。 透過Git復原程式碼,並透過內容目的地的版本記錄或您同意的流程復原內容和影像。

recommendation-more-help
experience-manager-cloud-service-help-main-toc