Konfigurera innehållskällan med ett klick för Edge Delivery Services config-content-source

IMPORTANT
Helix är det interna namnet på den underliggande arkitekturen som driver AEM Sites med dokumentbaserad redigering. Det är inte en funktion eller ett produktnamn. I den här artikeln hänvisar Helix till den arkitekturversion som används av dina Edge Delivery Sites. Helix 5 är den nuvarande versionen av den underliggande arkitekturen; Helix 4 är den tidigare versionen.

Adobe Experience Manager (AEM) Edge Delivery Services tillåter innehållsleverans från flera källor, som Google Drive, SharePoint eller AEM, via ett snabbt, globalt distribuerat gränsnätverk.

Innehållskällans konfiguration skiljer sig mellan de två arkitekturversionerna på följande sätt:

Version
Konfigurationsmetod för innehållskälla
Helix 4
YAML-fil (fstab.yaml)
Helix 5
Konfigurationstjänstens API (nofstab.yaml)

I den här artikeln finns omfattande konfigurationssteg, exempel och valideringsinstruktioner för båda versionerna.

Innan du börjar

Om du använder ett klick i Edge Delivery i Cloud Manager använder webbplatsen Helix 5 med en enda databas. Följ Helix 5-instruktionerna och använd den medföljande Helix 4 YAML-versionen av instruktionerna som reserv.

Bestäm din Helix-version

Bekräfta via databasmetadata eller kontakta administratören om du fortfarande är osäker.

Konfigurera innehållskällan för Helix 4

I Helix 4 definierar filen fstab.yaml platsens innehållskälla. Den här filen finns i roten av GitHub-databasen och mappar URL-sökvägsprefix (kallas monteringspunkter) till externa innehållskällor. Ett typiskt exempel ser ut så här:

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

Exemplet ovan är endast för illustrationer. Den faktiska URL:en ska peka mot innehållskällan, t.ex. en Google Drive-mapp, SharePoint-katalog eller AEM-sökväg.

Så här konfigurerar du innehållskällan för Helix 4:

Stegen varierar beroende på vilket källsystem du använder.

  • Google Drive

    1. Skapa en Google Drive-mapp.

    2. Dela mappen med helix@adobe.com.

    3. Hämta länken för den delningsbara mappen.

    4. Uppdatera din fstab.yaml så som visas i följande:

      code language-yaml
      mountpoints:
          /: https://drive.google.com/drive/folders/<folder-id>
      
    5. Verkställ och skicka ändringar till GitHub.

  • SharePoint

    1. Skapa en SharePoint-mapp eller ett dokumentbibliotek.

    2. Dela åtkomst med helix@adobe.com.

    3. Hämta mappens URL.

    4. Uppdatera din fstab.yaml så som visas i följande:

      code language-yaml
      mountpoints:
        /: https://<tenant>.sharepoint.com/sites/<site>/Shared%20Documents/<folder>
      
    5. Verkställ och skicka ändringar till GitHub.

  • AEM

    1. Identifiera AEM innehållssökväg.

    2. Använd AEM innehållsexportadress enligt följande:

      code language-yaml
      mountpoints:
        /: https://author.<your-aem-instance>.com/bin/franklin.delivery/<org>/<repo>/main
      
    3. Verkställ och skicka ändringar till GitHub.

Validering

  • Klicka på Förhandsgranska > Publicera > Testa den publicerade webbplatsen med AEM Sidekick Chrome Extension.
  • Verifiera URL: https://main--<repo>--<org>.hlx.page/

Konfigurera innehållskällan för Helix 5 config-helix5

Helix 5 är svarslös, använder inte fstab.yaml och stöder flera platser som delar samma katalog. Konfigurationen hanteras via konfigurationstjänstens API eller användargränssnittet för Edge Delivery Sites. Konfigurationen är platsnivå (inte databasnivå).

Följande skillnader är konceptuella:

Proportioner
Helix 4
Helix 5
Konfiguration
Klart till fstab.yaml
Klar via API:t eller användargränssnittet i stället för YAML.
Monteringspunkter
Definieras i fstab.yaml.
Krävs inte. Roten är implicit känd.

Konfigurera innehållskällan för Helix 5:

  1. Använd konfigurationstjänstens API för att autentisera via en API-nyckel eller åtkomsttoken.

  2. Gör följande PUT API-anrop:

    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. Validera svar (förväntat: HTTP 200 OK).

Validering

  • Klicka på Förhandsgranska > Publicera > Testa den publicerade webbplatsen med AEM Sidekick Chrome Extension.

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

  • (Valfritt) Kontrollera den aktuella konfigurationen via följande GET API-anrop:

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