DocumentationAEM as a Cloud ServiceGuide de l’utilisateur

Configurer la source de contenu en un seul clic pour Edge Delivery Services config-content-source

Last update: Mon Jun 09 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • S'applique à :
  • Experience Manager as a Cloud Service

Créé pour :

  • Administration
  • Développeur
IMPORTANT
Helix est le nom interne de l’architecture sous-jacente qui alimente AEM Sites avec la création basée sur des documents. Il ne s’agit pas d’un nom de fonctionnalité ou de produit. Dans cet article, Helix fait référence à la version de l’architecture utilisée par vos sites Edge Delivery. Helix 5 est la version actuelle de l’architecture sous-jacente. Helix 4 est la version précédente.

Adobe Experience Manager (AEM) Edge Delivery Services permet la diffusion de contenu à partir de plusieurs sources telles que Google Drive, SharePoint ou AEM lui-même, à l’aide d’un réseau Edge Network rapide distribué dans le monde entier.

La configuration de la source de contenu est différente entre les deux versions de l’architecture sur les points suivants :

Version
Méthode de configuration de la source de contenu
Helix 4
Fichier YAML (fstab.yaml)
Helix 5
API Configuration Service (sansfstab.yaml)

Cet article fournit des étapes de configuration complètes, des exemples et des instructions de validation pour les deux versions.

Avant de commencer

Si vous utilisez Edge Delivery en un seul clic dans Cloud Manager, votre site utilise Helix 5 avec un seul référentiel. Suivez les instructions pour Helix 5 et utilisez la version YAML Helix 4 fournie comme solution de secours.

Déterminer votre version Helix

Confirmez via les métadonnées du référentiel ou consultez votre administrateur ou administratrice si vous avez toujours un doute.

Configurer la source de contenu pour Helix 4

Dans Helix 4, le fichier fstab.yaml définit la source de contenu de votre site. Situé à la racine de votre référentiel GitHub, ce fichier mappe les préfixes de chemin d’URL (appelés points de montage) à des sources de contenu externes. Voici un exemple typique :

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

L’exemple ci-dessus est fourni à titre illustratif uniquement. L’URL réelle doit pointer vers votre source de contenu, par exemple un dossier Google Drive, un répertoire SharePoint ou un chemin d’accès AEM.

Pour configurer la source de contenu pour Helix 4, procédez comme suit :

Les étapes varient en fonction du système source que vous utilisez.

  • Google Drive

    1. Créez un dossier Google Drive.

    2. Partagez le dossier avec helix@adobe.com.

    3. Obtenez le lien du dossier partageable.

    4. Mettez à jour votre fstab.yaml comme illustré ci-dessous :

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

    5. Validez et envoyez les modifications à GitHub.

  • SharePoint

    1. Créez un dossier ou une bibliothèque de documents SharePoint.

    2. Partagez l’accès avec helix@adobe.com.

    3. Obtenez l’URL du dossier.

    4. Mettez à jour votre fstab.yaml comme illustré ci-dessous :

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

    5. Validez et envoyez les modifications à GitHub.

  • AEM

    1. Identifiez le chemin d’accès au contenu AEM.

    2. Utilisez l’URL d’export de contenu AEM comme illustré ci-dessous :

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

    3. Validez et envoyez les modifications à GitHub.

Validation

  • À l’aide de l’extension Chrome AEM Sidekick, cliquez sur Prévisualisation > Publier > Tester le site actif.
  • Valider l’URL : https://main--<repo>--<org>.hlx.page/

Configurer la source de contenu pour Helix 5 config-helix5

Helix 5 n’utilise pas de référentiels ni le fichier fstab.yaml et prend en charge plusieurs sites partageant le même répertoire. La configuration est gérée via l’API Configuration Service ou l’interface d’utilisation des sites Edge Delivery. La configuration s’effectue au niveau du site (et non du référentiel).

Les différences conceptuelles sont les suivantes :

Aspect
Helix 4
Helix 5
Configuration
Effectuée via fstab.yaml
Effectuée via l’API ou l’interface d’utilisation au lieu de YAML.
Points de montage
Définis dans fstab.yaml.
Non requis. La racine est implicitement comprise.

Pour configurer la source de contenu pour Helix 5, procédez comme suit :

  1. À l’aide de l’API Configuration Service, authentifiez-vous par le biais d’une clé API ou d’un jeton d’accès.

  2. Effectuez l’appel API PUT suivant :

    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. Validez la réponse (attendue : HTTP 200 OK).

Validation

  • À l’aide de l’extension Chrome AEM Sidekick, cliquez sur Prévisualisation > Publier > Tester le site actif.

  • Valider l’URL : https://main--<repo>--<org>.aem.page/

  • (Facultatif) Inspectez la configuration actuelle par le biais de l’appel API GET suivant :

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