DocumentazioneAEM as a Cloud ServiceGuida utente

Configurare l’origine di contenuto con un clic per Edge Delivery Services config-content-source

Last update: Mon Jun 09 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Si applica a:
  • Experience Manager as a Cloud Service

Creato per:

  • Amministratore
  • Sviluppatore
IMPORTANT
Helix è il nome interno dell’architettura sottostante che alimenta AEM Sites con l’authoring basato su documenti. Non è una funzione o un nome di prodotto. In questo articolo, Helix fa riferimento alla versione dell’architettura utilizzata dai siti Edge Delivery. Helix 5 è la versione corrente dell’architettura sottostante; Helix 4 è la versione precedente.

Edge Delivery Services di Adobe Experience Manager (AEM) consente la distribuzione dei contenuti da più origini, come Google Drive, SharePoint o AEM stesso, utilizzando una rete Edge veloce e distribuita a livello globale.

La configurazione dell’origine del contenuto differisce tra la versione Helix 4 e Helix 5 nel modo seguente:

Versione
Metodo di configurazione dell’origine contenuto
Helix 4
File YAML (fstab.yaml)
Helix 5
API del servizio di configurazione (nofstab.yaml)

Questo articolo fornisce passaggi di configurazione completi, esempi e istruzioni di convalida per entrambe le versioni.

Prima di iniziare

Se utilizzi Edge Delivery con un solo clic in Cloud Manager, il tuo sito utilizzerà Helix 5 con un singolo archivio. Segui le istruzioni Helix 5 e utilizza la versione Helix 4 YAML fornita come fallback.

Determinare la versione Helix

  • Helix 4: il progetto include un file fstab.yaml.
  • Helix 5: il progetto non utilizza fstab.yaml ed è stato configurato tramite la procedura guidata di Cloud Manager o l’API.

Se non hai la certezza, conferma tramite i metadati dell’archivio o consulta l’amministratore.

Configurare l’origine di contenuto per Helix 4

In Helix 4, il file fstab.yaml definisce l’origine del contenuto per il sito. Situato nella directory principale dell’archivio GitHub, questo file mappa i prefissi del percorso URL (denominati punti di montaggio) alle origini di contenuto esterne. Un esempio tipico è simile al seguente:

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

L’esempio precedente è solo a scopo illustrativo. L’URL effettivo deve puntare all’origine del contenuto, ad esempio una cartella di Google Drive, una directory di SharePoint o un percorso AEM.

Per configurare l’origine di contenuto per Helix 4:

I passaggi variano a seconda del sistema di origine utilizzato.

  • Google Drive

    1. Crea una cartella di Google Drive.

    2. Condividi la cartella con helix@adobe.com.

    3. Ottieni il collegamento alla cartella condivisibile.

    4. Aggiorna fstab.yaml come mostrato di seguito:

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

    5. Conferma e invia le modifiche su GitHub.

  • SharePoint

    1. Crea una cartella SharePoint o una libreria documenti.

    2. Condividi l’accesso con helix@adobe.com.

    3. Ottieni l’URL della cartella.

    4. Aggiorna fstab.yaml come mostrato di seguito:

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

    5. Conferma e invia le modifiche su GitHub.

  • AEM

    1. Identifica il percorso del contenuto AEM.

    2. Utilizza l’URL di esportazione del contenuto di AEM come mostrato di seguito:

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

    3. Conferma e invia le modifiche su GitHub.

Convalida

  • Utilizzando l’estensione AEM Sidekick per Chrome, fai clic su Anteprima > Pubblica > Verifica il sito live.
  • Convalida URL: https://main--<repo>--<org>.hlx.page/

Configurare l’origine dei contenuti per Helix 5 config-helix5

Helix 5 è privo di archivio, non utilizza fstab.yaml e supporta più siti che condividono la stessa directory. La configurazione viene gestita tramite l’API del servizio di configurazione o l’interfaccia utente dei siti Edge Delivery. La configurazione è a livello di sito (non a livello di archivio).

Le differenze concettuali sono le seguenti:

Aspetto
Helix 4
Helix 5
Configurazione
Eseguita tramite fstab.yaml
Eseguita tramite l’API o l’interfaccia utente anziché tramite YAML.
Punti di montaggio
Definiti in fstab.yaml.
Non obbligatori. La directory principale è implicita.

Per configurare l’origine dei contenuti per Helix 5:

  1. Utilizzando l’API del servizio di configurazione, esegui l’autenticazione tramite una chiave API o un token di accesso.

  2. Effettua la seguente chiamata 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. Convalida la risposta (prevista: HTTP 200 OK).

Convalida

  • Utilizzando l’estensione AEM Sidekick per Chrome, fai clic su Anteprima > Pubblica > Verifica il sito live.

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

  • (Facoltativo) Ispeziona la configurazione corrente tramite la seguente chiamata API GET:

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