AEM Headless-Schnelleinrichtung für AEM as a Cloud Service

Mit der AEM Headless-Schnelleinrichtung erhalten Sie praktische Informationen zu AEM Headless. Sie verwenden dabei Inhalte aus dem WKND-Site-Beispielprojekt und eine Beispiel-React-App (eine SPA), die Inhalte über AEM Headless-GraphQL-APIs bezieht.

Voraussetzungen

Die folgenden Schritte sind erforderlich, um dieser Schnelleinrichtung zu folgen:

  • AEM as a Cloud Service-Sandbox-Umgebung (vorzugsweise Entwicklung)

  • Zugreifen auf AEM as a Cloud Service und Cloud Manager

    • AEM-Administratorzugriff auf AEM as a Cloud Service
    • Zugriff auf Cloud Manager als Cloud Manager – Bereitstellungs-Manager
  • Die folgenden Tools müssen lokal installiert sein:

1. Erstellen eines Cloud Manager-Git-Repositorys

Erstellen Sie zunächst ein Cloud Manager-Git-Repository, das zur Bereitstellung der WKND-Site verwendet wird. Die WKND-Site ist ein Beispielprojekt für eine AEM-Website, das Inhalte (Inhaltsfragmente) und einen GraphQL-AEM-Endpunkt enthält, der von der React-App für die Schnelleinrichtung verwendet wird.

Screencast von Schritten

  1. Navigieren Sie zu https://my.cloudmanager.adobe.com.

  2. Wählen Sie das Cloud Manager-Programm aus, das die AEM as a Cloud Service-Umgebung für diese Schnelleinrichtung enthält

  3. Erstellen Sie ein Git-Repository für das WKND-Site-Projekt.

    1. Wählen Sie Repositorys im oberen Navigationsbereich aus.
    2. Wählen Sie Repository hinzufügen in der oberen Aktionsleiste aus.
    3. Benennen Sie das neue Git-Repository: aem-headless-quick-setup-wknd
      • Git-Repository-Namen müssen pro Adobe-Organisation eindeutig sein.
    4. Wählen Sie Speichern aus und warten Sie, bis das Git-Repository initialisiert wird.

2. Übertragen des Beispielprojekts der WKND-Site in das Cloud Manager-Git-Repository

Nachdem das Cloud Manager-Git-Repository erstellt wurde, klonen Sie den Quell-Code des WKND-Site-Projekts von GitHub und übertragen Sie ihn in das Cloud Manager-Git-Repository. Jetzt kann Cloud Manager auf das WKND-Site-Projekt in der AEM as a Cloud Service-Umgebung zugreifen und es bereitstellen.

Screencast von Schritten

  1. Klonen Sie in der Befehlszeile den Quell-Code des WKND-Site-Beispielprojekts von GitHub.

    code language-shell
    $ mkdir -p ~/Code
    $ cd ~/Code
    $ git clone git@github.com:adobe/aem-guides-wknd.git
    
  2. Fügen Sie das Cloud Manager-Git-Repository als Remote-Repository hinzu.

    1. Wählen Sie Repositorys im oberen Navigationsbereich aus.

    2. Wählen Zugriff auf Repo Info in der oberen Aktionsleiste aus.

    3. Führen Sie den Befehl in Remote zu Ihrem Git-Repository hinzufügen über die Befehlszeile aus.

      code language-shell
      $ cd aem-guides-wknd
      $ git remote add adobe https://git.cloudmanager.adobe.com/<YOUR ADOBE ORGANIZATION>/aem-headless-quick-setup-wknd/
      
  3. Übertragen Sie den Quell-Code des Beispielprojekts aus Ihrem lokalen Git-Repository in das Cloud Manager-Git-Repository.

    code language-shell
    $ git push adobe main:main
    

    Wenn Sie nach Anmeldeinformationen gefragt werden, geben Sie den Benutzernamen und das Kennwort aus dem modalen Cloud Manager-Fenster Repository-Informationen ein.

3. Bereitstellen der WKND-Site für AEM as a Cloud Service

Wenn das WKND-Site-Projekt in das Cloud Manager-Git-Repository übertragen wurde, kann es nicht mithilfe von Cloud Manager-Pipelines für AEM as a Cloud Service bereitgestellt werden.

Beachten Sie, dass das WKND-Site-Projekt Beispielinhalte bereitstellt, die die React-App über AEM Headless-GraphQL-APIs nutzt.

Screencast von Schritten

  1. Fügen Sie eine produktionsfremde Bereitstellungs-Pipeline an das neue Git-Repository an.

    1. Wählen Sie Pipelines im oberen Navigationsbereich aus.

    2. Wählen Sie Pipeline hinzufügen in der oberen Aktionsleiste aus.

    3. Auf der Registerkarte Konfiguration

      1. Wählen Sie die Option Bereitstellungs-Pipeline aus.
      2. Legen Sie den Namen der produktionsfremden Pipeline auf Dev Deployment pipeline fest.
      3. Wählen Sie Bereitstellungsauslöser > Bei Git-Änderungen
      4. Wählen Sie Verhalten bei wichtigen Metrikfehlern > Sofort fortfahren
      5. Klicken Sie auf Weiter
    4. Auf der Registerkarte Quell-Code

      1. Wählen Sie die Option Vollständiger Stack-Code
      2. Wählen Sie die AEM as a Cloud Service-Entwicklungsumgebung aus dem Auswahlfeld Mögliche Bereitstellungsumgebungen
      3. Wählen Sie aem-headless-quick-setup-wknd im Auswahlfeld Repository
      4. Wählen Sie main aus dem Auswahlfeld Git-Verzweigung
      5. Wählen Sie Speichern aus
  2. Führen Sie die Dev-Bereitstellungs-Pipeline aus

    1. Wählen Sie Übersicht in der oberen Navigationsleiste
    2. Suchen Sie die neu erstellte Dev-Bereitstellungs-Pipeline im Pipelines-Abschnitt
    3. Wählen Sie rechts vom Pipeline-Eintrag
    4. Wählen Sie Ausführen und bestätigen Sie es im modalen Fenster
    5. Wählen Sie rechts von der derzeit ausgeführten Pipeline
    6. Wählen Sie Details anzeigen
  3. Überwachen Sie ausgehend von den Details der Pipeline-Ausführung den Fortschritt, bis er erfolgreich abgeschlossen ist. Die Pipelineausführung sollte zwischen 30 und 40 Minuten dauern.

4. Laden Sie die WKND React-App herunter und führen Sie sie aus.

Nachdem ein Bootstrapping von AEM as a Cloud Service für den Inhalt aus dem WKND Site-Projekt durchgeführt wurde, laden Sie die WKND React App-Beispielanwendung, die den Inhalt der WKND-Site über AEM Headless GraphQL-APIs nutzt, herunter und starten Sie sie.

Screencast von Schritten

  1. Klonen Sie den Quell-Code der React-App von GitHub aus der Befehlszeile.

    code language-shell
    $ cd ~/Code
    $ git clone git@github.com:adobe/aem-guides-wknd-graphql.git
    
  2. Öffnen Sie den Ordner ~/Code/aem-guides-wknd-graphql/react-app in Ihrer IDE.

  3. Öffnen Sie in der IDE die Datei .env.development.

  4. Zeigen Sie auf den Host-URI des Veröffentlichungsinstanz-Service von AEM as a Cloud Service aus der Eigenschaft REACT_APP_HOST_URI.

    code language-plain
    REACT_APP_HOST_URI=https://publish-pXXXX-eYYYY.adobeaemcloud.com
    ...
    

    So suchen Sie Ihren Host-URI des Veröffentlichungsinstanz-Service von AEM as a Cloud Service:

    1. Wählen Sie in Cloud Manager Umgebungen in der oberen Navigationsleiste
    2. Wählen Sie Implementierungsumgebung
    3. Suchen Sie den Link zum Veröffentlichungsinstanz-Service (AEM und Dispatcher) in der Tabelle Umgebungssegmente
    4. Kopieren Sie die Adresse des Links und verwenden Sie sie als URI des Veröffentlichungs-Service von AEM as a Cloud Service
  5. Speichern Sie in der IDE die Änderungen in .env.development

  6. Führen Sie in der Befehlszeile die React-App aus.

    code language-shell
    $ cd ~/Code/aem-guides-wknd-graphql/react-app
    $ npm install
    $ npm start
    
  7. Die React-App, die lokal ausgeführt wird, beginnt auf http://localhost:3000 und zeigt eine Liste von Adventures an, die über GraphQL-APIs von AEM Headless aus AEM as a Cloud Service aufgerufen werden.

5. Bearbeiten von Inhalten in AEM

Mit der WKND-React-Beispiel-App, die eine Verbindung zu Inhalten aus den AEM Headless-GraphQL-APIs herstellt und diese verwendet, erstellen Sie Inhalte im AEM-Autoren-Service und sehen Sie, wie das Erlebnis der React-App übereinstimmend aktualisiert wird.

Screencast von Schritten

  1. Melden Sie sich beim Authoring-Service von AEM as a Cloud Service an

  2. Navigieren Sie zu Assets > Dateien > WKND Shared > Englisch > Adventures

  3. Öffnen Sie den Ordner Cycling Southern Utah

  4. Wählen Sie das Inhaltsfragment Cycling Southern Utah und wählen Sie Bearbeiten in der oberen Aktionsleiste

  5. Aktualisieren Sie einige Felder des Inhaltsfragments, z. B.:

    • Titel: Cycling Utah's National Parks
    • Trip Length: 6 Days
    • Difficulty: Intermediate
    • Price: 3500
    • Primäres Bild: /content/dam/wknd-shared/en/activities/cycling/mountain-biking.jpg
  6. Wählen Sie Speichern in der oberen Aktionsleiste

  7. Wählen Sie Quick Publish aus den in der oberen Aktionsleiste

  8. Aktualisieren Sie die React-App, die auf http://localhost:3000 ausgeführt wird.

  9. Wählen Sie in der React-App das jetzt aktualisierte Cycling-Adventure aus und überprüfen Sie die Inhaltsänderungen, die am Inhaltsfragment vorgenommen wurden.

  10. Verwenden Sie denselben Ansatz im AEM-Autoren-Service:

    1. Machen Sie die Veröffentlichung eines vorhandenen Adventure-Inhaltsfragments rückgängig und überprüfen Sie, ob es aus dem React-App-Erlebnis entfernt wird
    2. Erstellen und veröffentlichen Sie ein neues Adventure-Inhaltsfragment und überprüfen Sie, ob es im React-App-Erlebnis angezeigt wird
    note tip
    TIP
    Wenn Sie nicht mit dem Erstellen und Veröffentlichen neuer oder dem Rückgängigmachen der Veröffentlichung vorhandener Inhaltsfragmente vertraut sind, sehen Sie sich den obigen Screencast an.

Herzlichen Glückwunsch!

Herzlichen Glückwunsch! Sie haben erfolgreich AEM Headless verwendet, um eine React-App zu betreiben!

Um genau zu verstehen, wie die React-App Inhalte von AEM as a Cloud Service nutzt, besuchen Sie das AEM Headless-Tutorial. In diesem Tutorial wird untersucht, wie Inhaltsfragmente in AEM erstellt wurden und wie diese React-App ihren Inhalt als JSON nutzt.

Nächste Schritte

recommendation-more-help
e25b6834-e87f-4ff3-ba56-4cd16cdfdec4