DocumentaciónAEM as a Cloud ServiceGuía del usuario

Configuración de la fuente de contenido con un solo clic para Edge Delivery Services config-content-source

Last update: Thu Nov 06 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Se aplica a:
  • Experience Manager as a Cloud Service

Creado para:

  • Administrador
  • Desarrollador
IMPORTANT
Helix es el nombre interno de la arquitectura subyacente que impulsa AEM Sites con la creación basada en documentos. No es una función o un nombre de producto. En este artículo, Helix hace referencia a la versión de arquitectura utilizada por Edge Delivery Sites. Helix 5 es la versión actual de la arquitectura subyacente; Helix 4 es la versión anterior.

Adobe Experience Manager (AEM) Edge Delivery Services permite enviar contenido desde varios orígenes, como Google Drive, SharePoint o el propio AEM, mediante una red perimetral rápida y distribuida globalmente.

La configuración de la fuente de contenido difiere entre las dos versiones de la arquitectura de la siguiente manera:

Versión
Método de configuración de la fuente de contenido
Helix 4
Archivo YAML (fstab.yaml)
Helix 5
API del servicio de configuración (nofstab.yaml)

En este artículo se proporcionan pasos de configuración completos, ejemplos e instrucciones de validación para ambas versiones.

Antes de comenzar

Si utiliza Edge Delivery en Cloud Manager con un solo clic, su sitio utilizará Helix 5 con un solo repositorio. Siga las instrucciones de Helix 5 y utilice la versión YAML de Helix 4 proporcionada como alternativa.

Determine su versión de Helix

Confirme a través de los metadatos del repositorio o consulte con su administrador si aún no está seguro.

Configuración del origen de contenido para Helix 4

En Helix 4, el archivo fstab.yaml define el origen de contenido del sitio. Ubicado en la raíz del repositorio de GitHub, este archivo asigna prefijos a la ruta URL (llamados puntos de montaje) a orígenes de contenido externos. Un ejemplo típico tiene el siguiente aspecto:

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

El ejemplo anterior es solo ilustrativo. La dirección URL real debe apuntar a la fuente de contenido, como una carpeta de Google Drive, un directorio de SharePoint o una ruta de acceso de AEM.

Para configurar la fuente de contenido para Helix 4, haga lo siguiente:

Los pasos varían según el sistema de origen que utilice.

  • Google Drive

    1. Cree una carpeta de Google Drive.

    2. Comparta la carpeta con helix@adobe.com.

    3. Obtenga el vínculo de la carpeta que se puede compartir.

    4. Actualice su fstab.yaml como se muestra a continuación:

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

    5. Confirme e inserte los cambios en GitHub.

  • SharePoint

    1. Cree una carpeta de SharePoint o una biblioteca de documentos.

    2. Comparta el acceso con helix@adobe.com.

    3. Obtenga la dirección URL de la carpeta.

    4. Actualice su fstab.yaml como se muestra a continuación:

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

    5. Confirme e inserte los cambios en GitHub.

  • AEM

    1. Identifique la ruta del contenido de AEM.

    2. Utilice la URL de exportación de contenido de AEM como se muestra a continuación:

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

    3. Confirme e inserte los cambios en GitHub.

Validación

  • Mediante la extensión de Chrome de AEM Sidekick, haga clic en Vista previa > Publicar > Probar el sitio activo.
  • Valide la URL: https://main--<repo>--<org>.hlx.page/

Configuración de la fuente de contenido para Helix 5 config-helix5

Helix 5 no requiere repositorio, no utiliza fstab.yaml y admite que varios sitios compartan el mismo directorio. La configuración se administra mediante la API del servicio de configuración o la interfaz de usuario de Edge Delivery Services. La configuración es a nivel de sitio (no de repositorio).

Las diferencias conceptuales son las siguientes:

Aspecto
Helix 4
Helix 5
Configuración
Realizado mediante fstab.yaml
Se realiza mediante la API o la IU en lugar de YAML.
Puntos de montaje
Definido en fstab.yaml.
No es necesario. La raíz se entiende implícitamente.

Para configurar la fuente de contenido para Helix 5, haga lo siguiente:

  1. Con la API del servicio de configuración, realice la autenticación mediante una clave de API o un token de acceso.

  2. Realice la siguiente llamada a la API PUT:

    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. Valide la respuesta (se esperaba: HTTP 200 OK).

Validación

  • Mediante la extensión de Chrome de AEM Sidekick, haga clic en Vista previa > Publicar > Probar el sitio activo.

  • Valide la URL: https://main--<repo>--<org>.aem.page/

  • (Opcional) Inspeccione la configuración actual a través de la siguiente llamada de la API GET:

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