文件AEM as a Cloud Service使用手冊

一鍵設定 Edge Delivery Services 的內容來源 config-content-source

Last update: Thu May 29 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 適用對象：
  • Experience Manager as a Cloud Service

建立對象：

  • 管理員
  • 開發人員
IMPORTANT
Helix 是支援 AEM Sites 文件型製作之基礎架構的內部名稱。其並非一項功能或產品名稱。在本文中，Helix 指的是您 Edge Delivery Sites 所使用的架構版本。Helix 5 是目前版本的基礎架構；Helix 4 是先前的版本。

Adobe Experience Manager (AEM) Edge Delivery Services 透過快速、遍布全球的 Edge Network，允許透過多個來源 (例如 Google Drive、SharePoint 或 AEM 本身) 進行內容傳遞。

兩個架構版本的內容來源設定有以下不同：

版本
內容來源設定方法
Helix 4
YAML 檔案 (fstab.yaml)
Helix 5
設定服務 API (無fstab.yaml)

此文章提供兩個版本的完整設定步驟、範例和驗證指示。

開始之前

如果您使用 Cloud Manager 的一鍵式 Edge Delivery，您的網站便是使用單一存放庫的 Helix 5。請按照 Helix 5 指示進行，並使用所提供的 Helix 4 YAML 版本指示做為後備方案。

確定您的 Helix 版本

  • Helix 4 - 您的專案包括一個 fstab.yaml 檔案。
  • Helix 5：您的專案​ 未 ​使用fstab.yaml，並且是透過 Cloud Manager 使用引導精靈或 API 所設定的。

如果您仍然不確定，請透過存放庫中繼資料確認或諮詢您的管理員。

設定 Helix 4 的內容來源

在 Helix 4 中，fstab.yaml 檔案會定義您網站的內容來源。此檔案位於 GitHub 存放庫的根目錄，將 URL 路徑前置詞 (稱為掛接點) 對應至外部內容來源。典型範例如下圖所示：

mountpoints:
  /: https://drive.google.com/drive/folders/your-folder-id

上述範例僅供說明使用。實際 URL 應該指向您的內容來源，例如 Google Drive 資料夾、SharePoint 目錄或 AEM 路徑。

若要設定 Helix 4 的內容來源：

根據您使用的來源系統而定，步驟會有所不同。

  • Google Drive

    1. 建立 Google Drive 資料夾。

    2. 與 helix@adobe.com 共用資料夾。

    3. 取得此共用資料夾的連結。

    4. 更新您的 fstab.yaml，如下所示：

      code language-yaml 
      mountpoints:
    /: https://drive.google.com/drive/folders/<folder-id>

    5. 提交並推送變更至 GitHub。

  • SharePoint

    1. 建立 SharePoint 資料夾或文件庫。

    2. 與 helix@adobe.com 共用存取權限。

    3. 取得資料夾 URL。

    4. 更新您的 fstab.yaml，如下所示：

      code language-yaml 
      mountpoints:
  /: https://<tenant>.sharepoint.com/sites/<site>/Shared%20Documents/<folder>

    5. 提交並推送變更至 GitHub。

  • AEM

    1. 確認您的 AEM 內容路徑。

    2. 使用 AEM 內容匯出 URL，如下所示：

      code language-yaml 
      mountpoints:
  /: https://author.<your-aem-instance>.com/bin/franklin.delivery/<org>/<repo>/main

    3. 提交並推送變更至 GitHub。

驗證

  • 使用 AEM Sidekick Chrome 擴充功能，按一下「預覽」>「發佈」>「測試即時網站」。
  • 驗證 URL：https://main--<repo>--<org>.hlx.page/

設定 Helix 5 的內容來源 config-helix5

Helix 5 無存放庫、不使用 fstab.yaml，並且支援多個網站共用同一個目錄。透過設定服務 API 或 Edge Delivery Sites 使用者介面來管理設定。設定為網站層級 (非存放庫層級)。

概念性差異如下：

層面
Helix 4
Helix 5
設定
透過 fstab.yaml 完成
透過 API 或 UI (而非 YAML) 完成。
掛接點
如 fstab.yaml 所定義。
不需要。此根目錄不需明言即可理解。

若要設定 Helix 5 的內容來源：

  1. 使用設定服務 API，透過 API 金鑰或存取權杖進行驗證。

  2. 進行以下 PUT API 呼叫：

    code language-bash 
    PUT /api/{program}/{programId}/site/{siteId}
Content-Type: application/json

{
  "sitename": "my-site",
  "branchName": "main",
  "version": "v5",
  "repo": "my-content-repo-link"
}

  3. 驗證回應 (預期是 HTTP 200 OK)。

驗證

  • 使用 AEM Sidekick Chrome 擴充功能，按一下「預覽」>「發佈」>「測試即時網站」。

  • 驗證 URL：https://main--<repo>--<org>.aem.page/

  • (選用) 透過以下 GET API 呼叫檢查目前設定：

    code language-bash 
    GET /api/{program}/{programId}/site/{siteId}
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab