Snelle installatie van AEM headless voor AEM as a Cloud Service

Met de snelle installatie zonder AEM Headless kunt u de inhoud in de praktijk brengen met AEM Headless via inhoud van het WKND-voorbeeldproject Site en een voorbeeldtoepassing React (een SPA) die de inhoud gebruikt boven AEM Headless GraphQL API's.

Vereisten

U hebt het volgende nodig om deze snelle installatie te kunnen uitvoeren:

  • AEM as a Cloud Service Sandbox-omgeving (bij voorkeur ontwikkeling)

  • Toegang tot AEM as a Cloud Service en Cloud Manager

    • AEM Beheerder toegang tot AEM as a Cloud Service
    • Cloud Manager - de Toegang van de Manager van de Plaatsing tot Cloud Manager
  • De volgende gereedschappen moeten lokaal zijn geïnstalleerd:

1. Een Cloud Manager Git-opslagplaats maken

Maak eerst een Cloud Manager Git-opslagplaats die wordt gebruikt om de WKND-site te implementeren. De WKND-site is een voorbeeld AEM websiteproject dat inhoud (Content Fragments) en een GraphQL-AEM bevat die wordt gebruikt door de React App van de snelle setup.

Screencast van stappen

  1. Navigeer aan https://my.cloudmanager.adobe.com

  2. Selecteer het Cloud Manager Programma dat het milieu van AEM as a Cloud Service aan gebruik voor deze snelle opstelling bevat

  3. Een Git-opslagplaats maken voor het WKND-siteproject

    1. Selecteer Bewaarplaatsen in de hoogste navigatie
    2. Selecteer toevoegt Bewaarplaats in de hoogste actiebar
    3. Geef de nieuwe Git-opslagplaats een naam: aem-headless-quick-setup-wknd
      • Namen van Git-opslagplaats moeten uniek zijn per Adobe-organisatie.
    4. Selecteer sparen, en wacht op de bewaarplaats van het Git om te initialiseren

2. Steek een voorbeeld van een WKND-siteproject naar een Cloud Manager Git Repository

Met de gemaakte opbergplaats van Cloud Manager Git, kloon de broncode van het project van de Plaats WKND van GitHub en duw het aan de bewaarplaats van Cloud Manager Git. Cloud Manager heeft nu toegang tot het WKND-siteproject en implementeert dit in de AEM as a Cloud Service-omgeving.

Screencast van stappen

  1. Van de bevellijn, kloon de broncode van het project van de steekproefWKND van de Plaats van GitHub

    code language-shell
    $ mkdir -p ~/Code
    $ cd ~/Code
    $ git clone git@github.com:adobe/aem-guides-wknd.git
    
  2. De Cloud Manager Git-opslagplaats toevoegen als een externe

    1. Selecteer Bewaarplaatsen in de hoogste navigatie

    2. Selecteer Info van de Reactie van de Toegang van de hoogste actiebar

    3. Uitvoeren bevel dat in wordt gevonden voegt ver aan uw bewaarplaats van het Git van bevel-lijn toe

      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. Zet de broncode van het voorbeeldproject van uw lokale Git-opslagplaats naar de Cloud Manager Git-opslagplaats

    code language-shell
    $ git push adobe main:main
    

    Wanneer ertoe aangezet voor geloofsbrieven, verstrek het Gebruikersnaam en Wachtwoord van de Informatie van de Bewaarplaats van Cloud Manager ____ modaal.

3. De WKND-site implementeren in AEM as a Cloud Service

Als het WKND-siteproject naar de Cloud Manager Git-opslagplaats wordt geduwd, kan het niet worden geïmplementeerd naar AEM as a Cloud Service met behulp van Cloud Manager-pijpleidingen.

Het WKND-siteproject biedt voorbeeldinhoud die door de React-app wordt gebruikt via AEM GraphQL-API's zonder koppen.

Screencast van stappen

  1. Verbind a niet-productie plaatsingspijpleiding aan de nieuwe bewaarplaats van het Git

    1. Selecteer Pijpleidingen in de hoogste navigatie

    2. Selecteer toevoegen Pijpleiding van de hoogste actiebar

    3. Op het lusje van de Configuratie

      1. Selecteer optie van de Pijl van de Plaatsing 0}
      2. Plaats de Naam van de niet-Productie Pijpleiding aan Dev Deployment pipeline
      3. Selecteer Trigger van de Plaatsing > op de Veranderingen van de it
      4. Selecteer Belangrijk Metrisch Gedrag van Mislukt > ga onmiddellijk
      5. Selecteer verdergaan
    4. Op het Source Code lusje

      1. Selecteer de Volledige optie van de Code van de Stapel 0}
      2. Selecteer het de ontwikkelomgeving van AEM as a Cloud Service van de In aanmerking komende Milieu's van de Plaatsing uitgezochte doos
      3. Selecteer aem-headless-quick-setup-wknd in de 2} uitgezochte doos van de Bewaarplaats {
      4. Selecteer main van de Tak van het Git uitgezochte doos
      5. Selecteer sparen
  2. Stel de Dev Pipeline van de Plaatsing in werking

    1. Selecteer Overzicht in de hoogste navigatie
    2. Bepaal de plaats van de pas gecreëerde Dev pijpleiding van de Plaatsing in de Pijpleidingen sectie
    3. Selecteer rechts van de pijpleidingsingang
    4. Selecteer Looppas, en bevestig in modaal
    5. Selecteer rechts van de nu lopende pijpleiding
    6. Selecteer details van de Mening
  3. Van de details van de pijpleidingsuitvoering, controleer vooruitgang tot het met succes voltooide. De uitvoering van de pijpleiding moet tussen 30 en 40 minuten duren.

4. Download en voer de WKND React-app uit

Met AEM as a Cloud Service bootstrapped met de inhoud van het project van de Plaats WKND, download, en begin de steekproefWKND React App die de inhoud van de Plaats van WKND over AEM Koploze GraphQL APIs verbruikt.

Screencast van stappen

  1. Van de bevellijn, kloon de React broncode van App van GitHub.

    code language-shell
    $ cd ~/Code
    $ git clone git@github.com:adobe/aem-guides-wknd-graphql.git
    
  2. Open de map ~/Code/aem-guides-wknd-graphql/react-app in uw IDE.

  3. Open het bestand .env.development in de IDE.

  4. Punt aan AEM as a Cloud Service Publish de gastheer URI van de dienst van de dienst van het REACT_APP_HOST_URI bezit.

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

    Ga als volgt te werk om de host-URI van uw AEM as a Cloud Service Publish-service te vinden:

    1. In Cloud Manager, uitgezochte Milieu's in de hoogste navigatie
    2. Selecteer het milieu van de Ontwikkeling
    3. Bepaal de plaats van de Dienst van Publish (AEM & Dispatcher) verbinding de lijst van de Segmenten van het Milieu
    4. Kopieer het adres van de koppeling en gebruik deze als URI van de AEM as a Cloud Service Publish-service
  5. In winde, sparen de veranderingen in .env.development

  6. Voer de React App vanaf de opdrachtregel uit

    code language-shell
    $ cd ~/Code/aem-guides-wknd-graphql/react-app
    $ npm install
    $ npm start
    
  7. React App, die plaatselijk loopt, begint op http://localhost:3000en toont een lijst van avonturen, die uit AEM as a Cloud Service gebruikend AEM Hoofdloze GraphQL APIs worden voortgebracht.

5. Inhoud bewerken in AEM

Met het voorbeeld van de WKND React-app die verbinding maakt met en inhoud van de AEM Headless GraphQL-API's, ontwikkelt u inhoud in AEM Auteursservice en ziet u hoe de ervaring van React App in overleg wordt bijgewerkt.

Screencast van stappen

  1. Aanmelden bij AEM as a Cloud Service Author-service

  2. Navigeer aan Assets > Dossiers > Gedeelde WKND > Engels > avonturen

  3. Open de Omslag van 0} Cycli Zuidelijke Utah {

  4. Selecteer het Cyclische Zuidelijke Fragment van de Inhoud, en selecteer uitgeven van de hoogste actiebar

  5. Werk enkele velden van het inhoudsfragment bij, bijvoorbeeld:

    • Titel: Cycling Utah's National Parks
    • Lengte van strook: 6 Days
    • Probleem: Intermediate
    • Prijs: 3500
    • Primaire afbeelding: /content/dam/wknd-shared/en/activities/cycling/mountain-biking.jpg
  6. Selecteer sparen in de hoogste actiebar

  7. Selecteer Snelle Publish van de hoogste actiebar

  8. Vernieuw React App die op http://localhost:3000loopt.

  9. Selecteer in React App het nu bijgewerkte cyclusavontuur, en verifieer de inhoudsveranderingen die aan het Inhoudsfragment worden aangebracht.

  10. Dezelfde aanpak gebruiken in AEM Auteursservice:

    1. Publiceer een bestaand fragment van de Inhoud van het Avontuur, en verifieer het wordt verwijderd uit React App ervaring
    2. Maak en publiceer een nieuw Adventure Content Fragment en controleer of dit wordt weergegeven in de React App-ervaring
    note tip
    TIP
    Als u niet bekend bent met het maken en publiceren van nieuwe of het ongedaan maken van bestaande inhoudsfragmenten, bekijkt u de bovenstaande screencast.

Gefeliciteerd!

Gefeliciteerd! U hebt AEM Headless met succes gebruikt om een React App aan te drijven!

Om in detail te begrijpen hoe React App inhoud van AEM as a Cloud Service verbruikt, controleer uit het AEM Hoofdloze leerprogramma. In de zelfstudie wordt onderzocht hoe inhoudsfragmenten in AEM worden gemaakt en hoe deze React-app hun inhoud als JSON-inhoud verbruikt.

Volgende stappen

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