Managed Runtime 管理

Managed Runtime 讓您能輕鬆管理與 PWA Kit 網店相關的組織、專案、環境和套件。這份指南將說明網頁式 Runtime Admin 工具中的可行管理任務清單,此清單會持續增加。(本指南中描述的所有管理任務及更多任務也可以使用 Managed Runtime API 來完成。)

在繼續之前,請確認您擁有 Managed Runtime 和 Runtime Admin 的存取權限。若要佈建 Managed Runtime,請聯絡您的 Success Manager。在 Runtime Admin 方面,請聯絡您的 Commerce Cloud 管理員,請他們使用 Account Manager 將以下任一角色加到您的帳戶:Managed Runtime UserManaged Runtime Admin

專案能協助您管理同一組織下的多個環境。每項 PWA Kit 專案都需要 Managed Runtime 中相應的專案,以在 Salesforce 的公有雲端基礎架構上部署和代管網店程式碼。

若要在 Runtime Admin 中建立專案:

  1. 登入 Runtime Admin
  2. 按一下 [New Project] (新專案)。
  3. 為專案輸入名稱。
  4. 按一下 [Create Project] (建立專案)。

首次建立專案時,在部署必要的雲端基礎架構之前,無法在網路上存取您的網站。此部署流程最多可能需要 40 分鐘。

這份指南中針對其他管理任務的說明均假設您從 Runtime Admin 的專案 Overview (概觀) 頁面開始。

若要尋找現有專案並開啟其 Overview (概觀) 頁面:

  1. 登入 Runtime Admin
  2. 如有必要,請從組織選單 (左上角) 中選擇組織。
  3. 按一下專案名稱。(若要檢視專案,您必須獲得指派先前說明過的任一專案角色。)

相關螢幕截圖

若要快速切換專案,請使用頁面頂端的專案選單。

Project Settings (專案設定) 頁面讓您能進行以下任務:

  • 查詢專案 ID,並確保與 PWA Kit 設定相符。
  • 編輯專案 ID。
  • 檢視並編輯專案的名稱及 URL。
  • 刪除專案。
  • 管理部署通知。(請見下一章節。)

若要存取 Project Settings (專案設定) 頁面:

  1. 前往專案的 [Overview] (概觀) 頁面。
  2. 在左側選單按一下 [Project Settings] (專案設定)。

若要編輯設定,請按一下 [Edit] (編輯) 來進行編輯,接著按一下 [Update] (更新)。若要取消編輯,請按一下 [Cancel] (取消)。

若要刪除專案,請按一下 [Delete] (刪除),輸入專案名稱來確認,接著按一下 [Yes, Delete] (是,刪除)。若要保留專案,請按一下 [No, Keep] (不,保留)。

您可以選擇在發生任何下列部署事件時,接收電子郵件通知:

  • 開始部署
  • 部署成功
  • 部署失敗

若要新增通知:

  1. 前往專案的 [Overview] (概觀) 頁面。
  2. 在左側選單按一下 [Project Settings] (專案設定)。
  3. 按一下 [Add Notification] (新增通知)。
  4. 選擇一或多個要通知的環境。
  5. 選擇一或多個部署事件。
  6. 輸入所有通知接收人的電子郵件地址。
  7. 按一下 [Add Notification] (新增通知)。

相關螢幕截圖

若要編輯通知:

  1. 前往專案的 [Overview] (概觀) 頁面。
  2. 在左側選單按一下 [Project Settings] (專案設定)。
  3. 按一下通知旁的 […] 按鈕。
  4. 按一下 [Edit] (編輯)。
  5. 變更任何通知設定。
  6. 按一下 [Update Notification] (更新通知)。

相關螢幕截圖

若要移除通知:

  1. 前往專案的 [Overview] (概觀) 頁面。
  2. 在左側選單按一下 [Project Settings] (專案設定)。
  3. 按一下通知旁的 […] 按鈕。
  4. 按一下 [Remove] (移除)。
  5. 按一下 [Yes, Remove] (是,移除)。

相關螢幕截圖

環境可將您的正式網店與專為其他目的 (例如開發或測試) 而部署的其他網店區分開來。若要進一步瞭解環境及相關概念,請參閱 Managed Runtime 概觀

若要在 Runtime Admin 中建立環境:

  1. 前往專案的 [Overview] (概觀) 頁面。
  2. 按一下 [New Environment] (新環境)。
  3. 為環境輸入名稱。
  4. 選擇區域來部署至 Salesforce 的公有雲端基礎架構。
  5. 如果環境是生產環境,則請將其標示為 Production。如果您已達到 Production 環境的數量上限,請聯絡支援人員。
  6. 按一下 [Create Environment] (建立環境)。

新環境的預設區域是美國東部 (北維吉尼亞),因為位置距離通常與開發及測試環境相關的 On-Demand Sandbox 最近。

對於使用 PWA Kit 和 Managed Runtime 的網站,您為每個環境部署時只能一次指派一個套件

  1. 前往專案的 [Overview] (概觀) 頁面。
  2. 按一下您想部署至的環境名稱。例如:[production]
  3. 在標題 Bundles (套件) 下,按一下您想部署的套件旁的 [Deploy] (部署) 按鈕。
  4. 按一下 [Confirm Deploy] (確認部署)。
  5. 等待部署完成。

當部署完成後,套件將會在標題 Deployed Bundle (已部署套件) 下出現。(第一次部署至新的環境時,流程最多可能需要一小時來完成。)

Environment Settings (環境設定) 頁面讓您能在同一頁面上進行許多管理任務,包括:

  • 重新命名環境或環境 ID。
  • 變更部署區域。
  • 允許特定 IP 位址存取環境。
  • 為環境設定 Proxy。請參閱 Proxy 要求來瞭解更多資訊。
  • 將環境標示為 Production。
  • 刪除環境。

若要存取 Environment Settings (環境設定) 頁面:

  1. 前往專案的 [Overview] (概觀) 頁面。
  2. 按一下您想編輯設定的環境名稱。
  3. 在左側選單按一下 [Environment Settings] (環境設定)。

若要進行編輯,請按一下 General (一般) 設定或 Advanced (進階) 設定旁的 [Edit] (編輯) 按鈕。在進行編輯後,請按一下 [Update] (更新) 來儲存變更,或 [Cancel] (取消) 來取消變更。

重新導向可讓您將要求從所要求的 URL 轉送至不同的 URL。重新導向可協助避免因變更網店而對使用者體驗造成的干擾。例如,請考慮為春季使用季節性的宣傳活動頁面。當春季宣傳活動結束並替換為夏季宣傳活動時,您可以從春季的 URL 重新導向至夏季的 URL。

在 Production 環境中建立重新導向前,我們建議您先在 Staging 環境中建立。

若要建立重新導向:

  1. 前往專案的 [Overview] (概觀) 頁面。
  2. 按一下您想建立重新導向的環境名稱。
  3. 在左側選單按一下 [URL Redirects] (URL 重新導向)。
  4. 按一下 [Create Redirect] (建立重新導向)。
  5. [Redirect From] (重新導向自) 欄位中,輸入相對 URL 路徑。舉例來說,若要將訪客從 URL www.example.com/winter 重新導向,請輸入 /winter
  6. [Redirect To] (重新導向至) 欄位中,輸入相對 URL 路徑。
  7. 如有需要,可啟用轉送查詢參數和萬用字元路徑。(稍後將會提供轉送設定的更多資訊。)
  8. [Redirect Type] (重新導向類型) 下拉選單中,根據 HTTP 狀態代碼選擇重新導向類型。(稍後將會提供狀態代碼的更多資訊。)
  9. 按一下 [Create Redirect] (建立重新導向)。

讓我們更詳細地看看建立重新導向的選項。

您在 [Redirect From] (重新導向自) 欄位輸入的值必須永遠為 相對 路徑。[Redirect To] (重新導向至) 欄位則可為相對路徑或完整 URL。舉例來說,想像一下我們要將訪客從 www.example.com/spring 重新導向至 www.example.com/summer[Redirect From] (重新導向自) 欄位必須為 /spring[Redirect To] (重新導向至) 欄位可為 /summerwww.example.com/summer

您可以新增星號字元 (*) 至 [Redirect From] (重新導向自) URL 的結尾,以表示萬用字元。萬用字元符合 URL 中任何 (0 個或多個) 字元。舉例來說,重新導向自 /a/* 會符合 /a//a/b/a/b/c

萬用字元只能用在 [Redirect From] (重新導向自) URL 的末尾。

Managed Runtime 會先處理標準的重新導向,接著才是含有萬用字元的重新導向。

大部分重新導向使用永久的 301 狀態代碼,但您也可以選擇暫時的 302。若您不確定要使用哪一個 HTTP 狀態代碼,請參考 MOZ.com 的狀態代碼說明工具

有些要求會包含查詢字串參數,也建議您將這些參數包含在已重新導向的要求中。舉例來說,相對路徑 /spring-landing-page 可附加查詢字串來進行分析追蹤,像是 /spring-landing-page?gclid=123

若要啟用查詢參數轉送,請前往表單的 [Forward] (轉送) 部分,並選擇 [Query Parameters] (查詢參數)。否則,來源 URL 的查詢字串參數將不會包含在重新導向 URL 內。

要是 [Redirect From] (重新導向自) 和 [Redirect To] (重新導向至) URL 兩者都有查詢字串、也啟用了轉送,會怎麼樣?在這種情況下,重新導向 URL 會包含兩個查詢字串的組合。[Redirect To] (重新導向至) URL 的查詢參數將附加至要求中的查詢字串。舉例來說,想像一下您的應用程式收到相對路徑 /spring?year=2019 的要求。若您選擇將 /spring 重新導向到 /summer?year=2020,則啟用轉送時,重新導向 URL 會是 /summer?year=2019&year=2020

您可以在 [Redirect To] (重新導向至) URL 中,自動包含 [Redirect From] (重新導向自) URL 萬用字元部分之後的任何路徑。例如:若 /a/*[Redirect From] (重新導向自) URL 中的 /a/b/c 相符,且 [Redirect To] (重新導向至) URL 為 /z/,則重新導向 URL 會是 /z/b/c

若要啟用萬用字元路徑轉送,請前往表單的 [Forward] (轉送) 部分,並選擇 [Wildcard Path] (萬用字元路徑)。

我們建議您永遠在 Staging 環境中建立重新導向,並在測試後複製到 Production 環境。

您可以使用複製重新導向功能,將所有重新導向從一個環境複製到另一個環境。

若要複製重新導向:

  1. 前往專案的 [Overview] (概觀) 頁面。
  2. 按一下包含您想複製之重新導向的環境名稱。
  3. 在左側選單按一下 [URL Redirects] (URL 重新導向)。
  4. 按一下 [Clone Redirects] (複製重新導向)。[Clone Redirects] (複製重新導向) 的表單出現。目前環境列於 From Environment (來自環境) (來源) 之下。
  5. To Environment (目的地環境) 下,選擇要將重新導向複製到的環境 (目的地)。
  6. 按一下 [Clone n Redirects] (複製 n 個重新導向)。(n 代表要複製的重新導向數目。)

複製重新導向時,您會將目的地環境的「所有」重新導向替換為來源環境的「所有」重新導向。

若要編輯現有重新導向的設定:

  1. 前往專案的 [Overview] (概觀) 頁面。
  2. 按一下包含您想編輯之重新導向的環境名稱。
  3. 在左側選單按一下 [URL Redirects] (URL 重新導向)。
  4. 按一下重新導向旁的刪節號 (…) 按鈕。
  5. 按一下 [Edit] (編輯)。
  6. 更新設定。
  7. 按一下 [Update Redirect] (更新重新導向)。

若要刪除重新導向:

  1. 前往專案的 [Overview] (概觀) 頁面。
  2. 按一下包含您想刪除之重新導向的環境名稱。
  3. 在左側選單按一下 [URL Redirects] (URL 重新導向)。
  4. 按一下重新導向旁的刪節號 (…) 按鈕。
  5. 按一下 [Delete] (刪除)。
  6. 按一下 [Yes, Delete Redirect] (是,刪除重新導向)。

若重新導向運作不如預期,請嘗試以下疑難排解步驟:

  • 清除瀏覽器快取,因為重新導向均已快取。
  • 確認您查看的是正確環境的設定。
  • 編輯重新導向,確認 [Redirect From] (重新導向自) 和 [Redirect To] (重新導向至) 欄位中已輸入正確的值。

重新導向有以下技術限制:

  • 每個環境最多可以有 10,000 個重新導向。
  • 每個環境都有自己的一套重新導向,您有責任使用複製功能來讓它們保持同步。
  • 重新導向功能支援從一條路徑到另一條路徑的簡單重新導向。針對含有條件的複雜重新導向,請使用 Express.js 在 ssr.js 中的重新導向支援
  • 以 Runtime Admin 工具或 Managed Runtime API 建立的重新導向不會在本機開發環境中執行。
  • 重新導向不會由 PWA Kit 應用程式中的頁面轉換觸發,只能由 HTTP 要求觸發。

若要新增使用者至專案:

  1. 前往專案的 [Overview] (概觀) 頁面。
  2. 在左側選單按一下 [Users & Permissions] (使用者和權限)。
  3. 按一下 [New User] (新使用者])。
  4. 輸入使用者的電子郵件地址。(請確認使用者是您組織的一員,且在 Account Manager 中擁有下列任一角色:Managed Runtime UserManaged Runtime Admin。)
  5. 選擇一個角色。
  6. 按一下 [Add User] (新增使用者)。

相關螢幕截圖

若要變更使用者的角色:

  1. 前往專案的 [Overview] (概觀) 頁面。
  2. 在左側選單按一下 [Users & Permissions] (使用者和權限)。
  3. 按一下使用者名稱旁的 […] 按鈕。
  4. 按一下 [Edit] (編輯)。
  5. 選擇一個角色。
  6. 按一下出現的彈出選單。
  7. 選擇新的角色。
  8. 按一下 [Save] (儲存)。

相關螢幕截圖

想完整查看與每個角色相關的使用者能力,請參閱 Managed Runtime 概觀

若要從專案移除使用者:

  1. 前往專案的 [Overview] (概觀) 頁面。
  2. 在左側選單按一下 [Users & Permissions] (使用者和權限)。
  3. 按一下使用者名稱旁的 […] 按鈕。
  4. 按一下 [Remove] (移除)。
  5. 按一下 [Yes, Remove User] (是,移除使用者)。

相關螢幕截圖