Konfigurieren der Inhaltsquelle für Edge Delivery Services mit einem Klick config-content-source

IMPORTANT
Helix ist der interne Name für die zugrunde liegende Architektur, die AEM Sites mit dokumentbasiertem Authoring unterstützt. Es handelt sich nicht um einen Funktions- oder Produktnamen. In diesem Artikel bezieht sich Helix auf die Architekturversion, die von Ihren Edge Delivery Sites verwendet wird. Helix 5 ist die aktuelle Version der zugrunde liegenden Architektur; Helix 4 ist die vorherige Version.

Adobe Experience Manager (AEM) Edge Delivery Services stellt Inhalte von Google Drive, SharePoint oder AEM mithilfe eines schnellen, global verteilten Edge-Netzwerks bereit.

Die Konfiguration der Inhaltsquellen unterscheidet sich bei den beiden Architekturversionen wie folgt:

Version
Methode zur Konfiguration der Inhaltsquelle
Helix 4
YAML-Datei (fstab.yaml)
Helix 5
Konfigurations-Service-API (ohnefstab.yaml)

Dieser Artikel enthält umfassende Konfigurationsschritte, Beispiele und Validierungsanweisungen für beide Versionen.

Bevor Sie beginnen

Wenn Sie die Funktion zum Erstellen einer Edge Delivery-Site in Cloud Manager mit einem Klick verwenden, handelt es sich um eine Helix 5-Site mit einem einzigen Repository. Befolgen Sie die Helix 5-Anweisungen und verwenden Sie die bereitgestellte Helix 4-YAML-Version der Anweisungen als Fallback.

Ermitteln der Helix-Version

Bestätigen Sie dies anhand der Repository-Metadaten oder wenden Sie sich an Ihre bzw. Ihren Admin, wenn Sie nach wie vor unsicher sind.

Konfigurieren der Inhaltsquelle für Helix 4

In Helix 4 definiert die Datei fstab.yaml die Inhaltsquelle für Ihre Site. Diese Datei befindet sich im Stammverzeichnis Ihres GitHub-Repositorys und ordnet Präfixe von URL-Pfaden (sogenannte Bereitstellungspunkte) externen Inhaltsquellen zu. Ein typisches Beispiel sieht wie folgt aus:

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

Das Beispiel oben dient nur zu Veranschaulichungszwecken. Die eigentliche URL verweist auf Ihre Inhaltsquelle, z. B. einen Google Drive-Ordner, einen SharePoint-Ordner oder einen AEM-Pfad.

Konfigurieren der Inhaltsquelle für Helix 4:

Die Schritte variieren je nach verwendetem Quellsystem.

  • Google Drive

    1. Erstellen Sie einen Google Drive-Ordner.

    2. Geben Sie den Ordner für helix@adobe.com frei.

    3. Rufen Sie den freigebbaren Ordner-Link ab.

    4. Aktualisieren Sie die Datei fstab.yaml wie folgt:

      code language-yaml
      mountpoints:
          /: https://drive.google.com/drive/folders/<folder-id>
      
    5. Übergeben und pushen Sie die Änderungen auf GitHub.

  • SharePoint

    1. Erstellen Sie einen SharePoint-Ordner oder eine Dokumentenbibliothek.

    2. Geben Sie den Zugriff für helix@adobe.com frei.

    3. Rufen Sie die Ordner-URL ab.

    4. Aktualisieren Sie die Datei fstab.yaml wie folgt:

      code language-yaml
      mountpoints:
        /: https://<tenant>.sharepoint.com/sites/<site>/Shared%20Documents/<folder>
      
    5. Übergeben und pushen Sie die Änderungen auf GitHub.

  • AEM

    1. Identifizieren Sie Ihren AEM-Inhaltspfad.

    2. Verwenden Sie die URL für den AEM-Inhaltsexport wie folgt:

      code language-yaml
      mountpoints:
        /: https://author.<your-aem-instance>.com/bin/franklin.delivery/<org>/<repo>/main
      
    3. Übergeben und pushen Sie die Änderungen auf GitHub.

Validierung

  • Klicken Sie mithilfe der AEM Sidekick Chrome-Erweiterung auf Vorschau > Veröffentlichen > Live-Site testen.
  • Validieren Sie folgende URL: https://main--<repo>--<org>.hlx.page/.

Konfigurieren der Inhaltsquelle für Helix 5 config-helix5

Helix 5 ist repo-los, verwendet keine fstab.yaml und unterstützt mehrere Websites, die denselben Ordner nutzen. Die Konfiguration wird über das Konfigurations-Service-API oder die Edge Delivery Sites-Benutzeroberfläche verwaltet. Die Konfiguration erfolgt auf Site-Ebene (nicht auf Repository-Ebene).

Die konzeptionellen Unterschiede sind:

Aspekt
Helix 4
Helix 5
Konfiguration
Erfolgt durch fstab.yaml
Erfolgt über das API oder die Benutzeroberfläche anstelle von YAML.
Bereitstellungspunkte
Definiert in fstab.yaml.
Nicht erforderlich Der Stamm wird implizit verstanden.

Konfigurieren der Inhaltsquelle für Helix 5:

  1. Führen Sie eine Authentifizierung über einen API-Schlüssel oder ein Zugriffs-Token mithilfe des Konfigurations-Service-APIs durch.

  2. Führen Sie den folgenden PUT-API-Aufruf aus:

    code language-bash
    
    PUT /api/{program}/{programId}/site/{siteId}
    Content-Type: application/json
    
  3. Validieren Sie die Antwort (erwartet: HTTP 200 OK).

Validierung

  • Klicken Sie mithilfe der AEM Sidekick Chrome-Erweiterung auf Vorschau > Veröffentlichen > Live-Site testen.

  • Validieren Sie folgende URL: https://main--<repo>--<org>.aem.page/.

  • (Optional) Überprüfen Sie die aktuelle Konfiguration mithilfe des folgenden GET-API-Aufrufs:

    code language-bash
    GET /api/{program}/{programId}/site/{siteId}
    
recommendation-more-help
experience-manager-cloud-service-help-main-toc