移轉生產網站 production-migration
使用此工作流程將同意的頁面清單移動至Edge Delivery Services (提供網站的Adobe Experience Manager服務)。 從每個範本的範例頁面開始,解決其內容和設計對應到新網站的方式,並僅在範例在作者將使用的編輯器中運作時匯入更多頁面。 如果區塊、預設內容或預覽等字詞是您第一次使用,請參閱如何建置和更新您的網站和塑造內容結構。
對於一些示範頁面或第一次評估,請使用較小的示範和試用工作流程。 它們不需要檢查生產網站在發行前是否需要。
同意範圍和目的地 scope
移轉主管和架構師同意範圍和目的地。 您需要授權才能讀取來源、修改目標存放庫,以及將內容和資產寫入目的地。 同意哪些人簽署結果以及哪些人授權發佈。 如果某些頁面需要登入,請以專用的唯讀帳戶設定受保護的網站驗證。 如果來源封鎖自動訪客,請在編目前安排其管理員的存取權。 請參閱具有機器人保護的Source網站。
記錄:
頁面匯入會複製每個頁面的內容和設計。 整合和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
- 請依照共用主控台設定或Experience Manager製作設定操作(如果內容進入Experience Manager製作)。 重複使用現有專案的設定,而非重新建立專案。
- 要求代理程式將授權網站編目:
Scope site https://www.example.com。 網站目錄會探索頁面,並將其分組為範本(共用版面的頁面)和區塊變體。 - 檢閱Planning檢視中的目錄。 更正範本和區塊群組,並調查失敗的URL。
- 將探索到的URL與您同意的頁面清單進行比較。 新增探索遺漏的頁面,並明確決定失敗、已略過、重複或排除的URL。
- 為每個範本和重要變體挑選範例頁面。 涵蓋長內容、不尋常的影像、地區設定,以及需要大量互動的頁面。
編目會讀取來源,但不會匯入任何內容。 狀態為 complete 的執行仍可以有失敗的頁面;請參閱結果和狀態。 在繼續之前,請為每個範圍URL指定範本或核准的排除專案。
代理程式如何大規模移轉 migration-at-scale
代理程式不會透過AI模型傳送每個頁面。 分別解譯每個頁面不會擴展至數千頁,而模型每次處理類似頁面的方式可能略有不同。 相反地,AI模型會在每個範本的一個範例頁面上執行對應,而代理程式會將該對應轉換為在範本其他頁面上執行的程式碼:
- 將頁面群組至範本。 網站目錄會將來源網站的頁面分組為範本,這些範本是共用版面的頁面。 如果您移轉沒有目錄的頁面,您命名的每個頁面都會啟動自己的範本。
- 移轉範例頁面。 對於每個範本,代理程式會先移轉一個顯示範本典型配置的實際頁面,理想情況下還會移轉其大多數區塊和變體。 網站目錄會為每個範本建議一個範本。 如果範本的其他頁面顯示其更多區塊,請改為選擇該頁面:範例頁面缺少的區塊只會稍後在匯入頁面需要時新增。 AI模型會將範例頁面的內容對應至預設內容和區塊,並建立其所需的區塊或重複使用現有區塊。
- 產生匯入指令碼。 代理程式會為範本撰寫匯入指令碼:剖析器這個部分,會從來源HTML擷取每個區塊的內容,而轉換器這個部分,會清理整個頁面。 指令碼是專案的
tools/importer/資料夾中的JavaScript檔案,其版本設定於Git中,且包含其餘的程式碼。 - 調整模式,而非頁面。 當您要求更正時,代理程式會變更產生結果的區塊或匯入指令碼,而非編輯一個頁面的輸出。 更正接著會套用至範本的每個頁面,之後範本會重複使用已存在的區塊。
- 大量匯入其餘頁面。 大量匯入會在範本的其他頁面上執行匯入指令碼,而不用AI模型解譯每個頁面。 接著,代理程式會將匯入的頁面與其來源頁面進行比較,修正差異過大的頁面的匯入指令碼,然後再次匯入這些頁面。
在匯入所有範本之前,請先驗證每個範本的幾個頁面。 請參閱以批次匯入。
這同樣適用於內容結構的變更,例如哪些內容會成為區塊,或頁面分割為多個區段:變更匯入指令碼。 它是程式碼、檢閱及合併,就像其餘的程式碼一樣,下次匯入時會將其套用至範本的每個頁面。 對一個匯入頁面的編輯會保留在本機,而再次匯入範本時會將其覆寫。
若要變更範本和區塊本身,例如將頁面移動到另一個範本,或使一個區塊成為另一個範本的變體,請使用Planning檢視或在聊天中詢問。 代理程式在下次產生區塊或匯入頁面時就會追蹤這些變更,而您已經匯入的頁面不會變更。 若要合併設計,請參閱重新樣式化網站。 若要合併區塊程式碼,請參閱重新調整而不變更結果。
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中。
-
檢閱內容結構:區段、預設內容、區塊、變體以及代理程式選擇的區段樣式。 作者將編輯此結構中每個已移轉的頁面,以便在範例頁面上處理。 請參閱設定內容結構形狀。
-
將匯入的文字、連結、影像、中繼資料和區段順序與來源進行比較。 當模式錯誤時,請修正匯入指令碼,而非頁面。 檢視代理程式如何依比例移轉。
-
套用來源樣式或遵循重新設計工作流程。 請先檢查全域樣式,然後再修訂個別區塊。
-
與頁面匯入分開完成共用的頁首、導覽和頁尾。 代理程式會針對整個網站移轉一次(包括頁尾影像),讓每個頁面共用一個頁首和一個頁尾。
-
將範例頁面上傳至內容目的地,然後編輯、儲存、重新開啟及預覽:
- 檔案式上載和預覽。
- 轉換、封裝上傳和簽入通用編輯器以進行Experience Manager編寫。
-
在您匯入更多頁面之前,請先記錄從來源到輸出的議定對應、區塊模型、設計決定和已知例外。
如果作者無法編輯頁面,看起來正確的頁面仍會失敗。 若為Experience Manager製作,請在匯入更多內容之前,同時檢查區塊模型、產生的元件組態、轉換錯誤以及影像的儲存位置。
塑造內容結構 content-structure
作者會以代理程式在匯入時所選擇的結構編輯每個已移轉的頁面,而大量匯入會在範本的每個頁面上重複該結構。 Edge Delivery Services頁面是由包含預設內容和區塊的區段所組成;請參閱標籤、區段、區塊和自動封鎖。 代理程式會遵循David的模型,並保持結構如設計允許的那樣簡單,因為每個區塊和變體都是作者要學習的額外內容。
cards-compact。 包含不同欄位或不同工作的內容會取得自己的區塊。 選用內容和不同數量的專案不會產生變體。dark、light-grey或centered。 區段中的文字和按鈕會從樣式中取得其顏色,因此單靠顏色絕不會建立區塊或變體。若要調整結構:
保留作者所做的選擇。 設計系統應該做出作者不應該做的決定:當區塊需要多個變體或選項時,請詢問其中某些變體或選項是否屬於設計。
確認前預估 estimate
目錄和第一個範例頁面會根據網站所需的工作提供估計值,而非其頁面計數:
針對每個URL🔗的第一個批次的記錄,檢查預估值。
團隊工作 collaboration
有幾個人員可以使用該代理程式處理相同的專案,每個人員都在自己的主控台工作區中。 他們會透過Git共用程式碼,也會透過內容目的地共用內容。 主控台不會顯示誰正在處理什麼工作,也不會將兩個人的變更合併到相同頁面,因此會同意誰正在處理什麼工作並繼續互相交談。
有代理程式的範圍比沒有代理程式的範圍更重要。 單一請求可以變更許多檔案,因此當兩個人同時變更相同的區塊或樣式時,必須手動解決許多檔案之間的衝突。
領導移轉 phases
移轉會分階段執行。 代理程式會逐一執行大部分的重複工作,而您的團隊會做出決定並簽署結果。 讓某個人(例如移轉銷售機會)執行第一個階段;其他人在區塊和匯入指令碼結算後即可加入。 檢視團隊工作。
視覺貢獻者可從範例頁面階段開始處理樣式設定。 請參閱進行視覺化變更。
從一個人開始,然後劃分工作 divide-work
第一個步驟是建立其他所有建置專案的基礎:全域樣式、第一個區塊,以及第一個範本的匯入指令碼。 讓一個人設定它們。 在劃分工作之前,請檢查區塊是否符合實際內容,以及作者是否易於使用。 請參閱設定內容結構形狀。
一旦團隊同意這些區塊,就劃分工作,讓人員變更不同的檔案:
- 依區塊:某人精簡卡片區塊,而另一個人建立輪播。
- 依範本:每個人都會精簡不同範本的匯入指令碼。 檢視代理程式如何依比例移轉。
- 專業技術:開發人員建置整合時,設計師會精簡現有區塊的樣式。
不要同時給予兩個人相同的區塊、全域樣式或相同的匯入指令碼,除非他們同意如何協調。
以小步驟共用程式碼 share-code
- 同意共用分支,例如
main或開發分支。 每個人員在程式碼檢視中透過 切換分支 將其工作區切換至該工作區。 - 讓代理程式的每個請求都集中在單一區塊、範本或任務上。 使用建立新PR,在運作後立即推送結果:主控台會將您的變更推送至新分支、開啟提取請求至共用分支,並將您的工作區留在新分支上。
- 經常檢閱及合併提取請求。 小型變更衝突較少,且檢閱速度較快,而持續開啟數天的提取請求則會收集衝突。
- 開始新工作之前,請先切換回具有 切換分支 的共用分支,並使用同步 > 提取 > 程式碼提取它,以便在每個人的合併工作上建置。
如果提取無法使用或報告衝突,請參閱如果其他人變更了分支。
小規模、頻繁的推播也會讓團隊瞭解代理程式變更內容及原因。 若要取得每個要求一個認可,請參閱留下每個要求的記錄。
協調內容變更 share-content
內容沒有合併。 您的工作區會保留頁面的復本,而上傳會將內容目的地中的頁面替換為您的復本。 如果兩個人變更了同一個頁面,則表示最後上傳會成功,而另一個人的變更會遺失。 將每個頁面或一組頁面一次提供給一個人。
若要讓其他人上傳的頁面進入您的工作區:
- 開啟在內容檢視中顯示雲端圖示的頁面。 主控台會將其下載至您的工作區。
- 在檔案式專案中,選取「同步 > 提取 > 內容」以從Experience Workspace下載每個頁面。 它會取代您的本機復本,包括您尚未上傳的編輯,因此請上傳您要先保留的編輯。
批次匯入 batches
驗證範例頁面之後,請使用目錄大量匯入工作流程和大量匯入提示。
- 使用範本的匯入指令碼匯入小型批次。
- 檢查一般頁面和邊緣案例。 如果匯入指令碼錯誤,請先更正並再次匯入受影響的頁面,然後再繼續。
- 為每個來源URL保留記錄:目的地、匯入狀態、錯誤、登出以及任何已核准的排除。
- 依範本繼續範本。 個別發現、分析、匯入、失敗、略過和簽出的頁面計數。
- 當您變更共用樣式、匯入指令碼、區塊模型或區塊程式碼時,重新檢查先前的範例頁面。
一旦作者開始編輯內容目的地中的移轉頁面,其頁面就會成為真相的來源。 再次匯入或上傳這些頁面會覆寫作者的工作,且修正的匯入指令碼不會合併這些頁面,因此請先與作者同意。
完成網站 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
同意網站擁有者在發行前必須執行的動作,並在預覽和即時網站上測試。 網站擁有者會與測試者和作者一起將結果登出。
每個自動訊號會檢查一件事:指令碼已執行的匯入工具狀態、已轉換內容的產生套件、頁面看起來像其來源的視覺相似度分數,以及Lighthouse分數實驗室測試中一個頁面載入的方式。 生產整備需要表格的每個區域。
釋放、復原和移交 handoff
發行版本擁有者會協調程式碼合併、內容發佈和網域切換,然後確認網站的持續擁有者已將其接管。
- 推送簽核代碼,並根據存放庫原則的要求進行稽核。 合併至
main會立即更新已上線的網站程式碼,因此請規劃與內容發行的合併。 檢視變更如何上線。 - 只上傳已簽章的內容和影像至已確認的目的地。 檢閱每個頁面和影像的錯誤。
- 在預覽網站
*.aem.page上驗證具有預期代碼修訂版本的已儲存內容。 - 取得網站的發行核准,並遵循設定的發佈和網域轉換流程。 發佈功能可讓頁面在
*.aem.live上使用;直接轉換功能是透過Adobe管理的CDN或您自己的CDN,在您自己的網域上提供這些頁面。 在切換前完成上線檢查清單。 - 檢查即時URL、重新導向、關鍵歷程和發行後的監視。 作業遙測顯示真實訪客體驗網站效能的方式。
- 提供專案交接、每個URL的記錄、作者範例、簽核結果、例外狀況以及復原連絡人。
發生錯誤時,請保留確切的URL或路徑、操作及錯誤記錄。 請在更正原因後,重試影響最小的範圍。 請勿重新啟動成功的批次,因為有一頁失敗。
推送程式碼、上傳檔案、將內容套件匯入至Experience Manager以及發佈作業,都是不同系統上的獨立作業。 部分失敗只會套用部分變更,而且單一復原無法復原所有變更。 透過Git復原程式碼,並透過內容目的地的版本記錄或您同意的流程復原內容和影像。