ドキュメントAEM as a Cloud Serviceユーザーガイド

Edge Delivery Services 向けコンテンツソースをワンクリックで設定

最終更新日： 2025年6月9日
  • 適用対象：
  • Experience Manager as a Cloud Service
  • トピック：
  • Cloud Manager
  • 開発

作成対象：

  • 管理者
  • 開発者
重要
Helix は、ドキュメントベースのオーサリングを用いた AEM Sites を動作させる、基盤となるアーキテクチャの内部名です。機能名や製品名ではありません。この記事では、Helix とは、Edge Delivery Sites で使用されるアーキテクチャバージョンを指します。Helix 5 は基盤となるアーキテクチャの現在のバージョンです。Helix 4 は以前のバージョンです。

Adobe Experience Manager（AEM）Edge Delivery Services を使用すると、高速でグローバルに分散した Edge Network を使用して、Google Drive、SharePoint、AEM 自体などの複数のソースからコンテンツを配信できます。

コンテンツソースの設定は、次のように 2 つのバージョン間で異なります。

バージョンコンテンツソースの設定方法
Helix 4YAML ファイル（fstab.yaml）
Helix 5設定サービス API（fstab.yaml は使用しない）

この記事では、両方のバージョンに対する包括的な設定手順、例および検証手順を説明します。

事前準備

Cloud Manager でワンクリック Edge Delivery を使用する場合、サイトは 1 つのリポジトリを持つ Helix 5 になります。Helix 5 の手順に従い、提供された Helix 4 YAML バージョンの手順をフォールバックとして使用します。

Helix のバージョンの確認

  • Helix 4 - プロジェクトに fstab.yaml ファイルが含まれます。
  • Helix 5 - プロジェクトは fstab.yaml を使用して​ おらず、ガイド付きウィザードまたは API を使用してCloud Manager で設定されています。

まだ不明な場合は、リポジトリメタデータを確認するか、管理者に問い合わせてください。

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 を更新します。

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

    5. 変更をコミットして GitHub にプッシュします。

  • SharePoint

    1. SharePoint フォルダーまたはドキュメントライブラリを作成します。

    2. helix@adobe.com とアクセスを共有します。

    3. フォルダーの URL を取得します。

    4. 次に示すように、fstab.yaml を更新します。

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

    5. 変更をコミットして GitHub にプッシュします。

  • AEM

    1. AEM コンテンツパスを特定します。

    2. 次に示すように、AEM コンテンツの書き出し URL を使用します。

      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 のコンテンツソースの設定

Helix 5 はリポジトリ構造に依存しない（「repoless」と呼ばれる）ため、fstab.yaml を使用せず、複数のサイトで同じディレクトリを共有します。設定は、設定サービス API または Edge Delivery Services のユーザーインターフェイスを通じて管理されます。設定は、リポジトリレベルではなく、サイトレベルで行います。

概念的な違いは次のとおりです。

項目
Helix 4
Helix 5
設定
fstab.yaml で実行します。
YAML の代わりに API または UI を通じて実行します。
マウントポイント
fstab.yaml で定義されます。
必須ではありません。ルートは暗黙的に理解されます。

Helix 5 のコンテンツソースを設定するには

  1. Configuration Service API を使用し、API キーまたはアクセストークンによって認証します。

  2. 次の PUT API 呼び出しを行います。

    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 呼び出しを使用して、現在の設定を調べます。

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