AEM Headless snabbinstallation av AEM as a Cloud Service
Med snabbinstallationen AEM Headless får du tillgång till AEM Headless med hjälp av innehåll från exempelprojektet WKND Site, och ett exempel på en React App (SPA) som förbrukar innehållet i AEM Headless GraphQL API:er.
Förutsättningar
Följande krävs för att följa den här snabbinstallationen:
-
AEM as a Cloud Service sandlådemiljö (helst Utveckling)
-
Tillgång till AEM as a Cloud Service och Cloud Manager
- AEM Administrator åtkomst till AEM as a Cloud Service
- Cloud Manager - Deployment Manager åtkomst till Cloud Manager
-
Följande verktyg måste installeras lokalt:
- Node.js v18
- Git
- En IDE (till exempel Microsoft® Visual Studio Code)
1. Skapa en Cloud Manager Git-databas
Skapa först en Cloud Manager Git-databas som används för att distribuera WKND-webbplatsen. WKND-webbplatsen är ett exempel på ett AEM-webbplatsprojekt som innehåller innehåll (innehållsfragment) och en GraphQL AEM-slutpunkt som används av snabbinstallationsprogrammets React App (React App).
Genomgång av steg
-
Navigera till https://my.cloudmanager.adobe.com
-
Välj den Program för Cloud Manager som innehåller den AEM as a Cloud Service-miljö som ska användas för den här snabbinstallationen
-
Skapa en Git-databas för WKND-webbplatsprojektet
- Välj Databaser i den övre navigeringen
- Välj Lägg till databas i det övre åtgärdsfältet
- Namnge den nya Git-databasen:
aem-headless-quick-setup-wknd- Git-databasnamn måste vara unika för varje Adobe-organisation,
- Välj Spara och vänta tills Git-databasen initieras
2. Push sample WKND Site project to Cloud Manager Git Repository
När Cloud Manager Git-databasen har skapats klonar du WKND Site-projektets källkod från GitHub och skickar den till Cloud Manager Git-databasen. Nu kan Cloud Manager komma åt och driftsätta WKND Site-projektet i AEM as a Cloud Service.
Genomgång av steg
-
Klona WKND-webbplatsprojektets källkod från GitHub från kommandoraden
code language-shell $ mkdir -p ~/Code $ cd ~/Code $ git clone git@github.com:adobe/aem-guides-wknd.git -
Lägg till Cloud Manager Git-databasen som en fjärrserver
-
Välj Databaser i den övre navigeringen
-
Välj Åtkomst till replikinformation i det övre åtgärdsfältet
-
Kommandot Kör hittades i Lägg till en fjärranslutning till Git-databasen från kommandoraden
code language-shell $ cd aem-guides-wknd $ git remote add adobe https://git.cloudmanager.adobe.com/<YOUR ADOBE ORGANIZATION>/aem-headless-quick-setup-wknd/
-
-
Överför exempelprojektets källkod från din lokala Git-databas till Cloud Manager Git-databasen
code language-shell $ git push adobe main:mainAnge användarnamn och lösenord från Cloud Manager databasinformation när du uppmanas att ange autentiseringsuppgifter.
3. Distribuera WKND-webbplatsen till AEM as a Cloud Service
När WKND Site-projektet skickas till Cloud Manager Git-databasen kan det inte distribueras till AEM as a Cloud Service med Cloud Manager-pipelines.
Tänk på att WKND Site-projektet innehåller exempelinnehåll som React-appen förbrukar jämfört med AEM Headless GraphQL API:er.
Genomgång av steg
-
Bifoga en icke-produktionsdistributionspipeline till den nya Git-databasen
-
Välj Förgreningar i den övre navigeringen
-
Välj Lägg till pipeline i det övre åtgärdsfältet
-
På fliken Konfiguration
- Välj alternativet Distributionspipeline
- Ange icke-produktionsförloppsnamnet till
Dev Deployment pipeline - Välj Distributionsutlösare > Vid Git-ändringar
- Välj Beteende vid viktiga mätfel > Fortsätt omedelbart
- Välj Fortsätt
-
På fliken Source Code
- Välj alternativet Fullständig stackkod
- Välj AEM as a Cloud Service-utvecklingsmiljö i rutan Berättigade distributionsmiljöer
- Välj
aem-headless-quick-setup-wkndi valrutan Databas - Välj
maini Git-grenen - Välj Spara
-
-
Kör Dev Deployment Pipeline
- Markera Översikt i den övre navigeringen
- Leta reda på den nyskapade Dev Deployment-pipelinen i avsnittet Pipelines
- Välj … till höger om pipeline-posten
- Välj Kör och bekräfta i den modala
- Välj … till höger om den pipeline som nu körs
- Välj Visa information
-
Övervaka förloppet tills det har slutförts utifrån information om pipelinekörningen. Körning av pipeline bör ta mellan 30 och 40 minuter.
4. Ladda ned och kör appen WKND React
När AEM as a Cloud Service har startat med innehållet från WKND Site-projektet hämtar och startar du exempelappen WKND React som använder WKND Site-innehållet via AEM Headless GraphQL API:er.
Genomgång av steg
-
Från kommandoraden klonar du React Apps källkod från GitHub.
code language-shell $ cd ~/Code $ git clone git@github.com:adobe/aem-guides-wknd-graphql.git -
Öppna mappen
~/Code/aem-guides-wknd-graphql/react-appi din IDE. -
Öppna filen
.env.developmenti IDE. -
Peka på AEM as a Cloud Service Publish-tjänstens värd-URI från egenskapen
REACT_APP_HOST_URI.code language-plain REACT_APP_HOST_URI=https://publish-pXXXX-eYYYY.adobeaemcloud.com ...Så här hittar du AEM as a Cloud Service Publish-tjänstens värd-URI:
- I Cloud Manager väljer du Miljö i den översta navigeringen
- Välj Utvecklingsmiljö
- Leta reda på tabellen Publiceringstjänst (AEM & Dispatcher) link Miljösegment
- Kopiera länkens adress och använd den som URI för AEM as a Cloud Service Publish-tjänsten
-
I IDE sparar du ändringarna i
.env.development -
Kör React App från kommandoraden
code language-shell $ cd ~/Code/aem-guides-wknd-graphql/react-app $ npm install $ npm start -
React-appen, som körs lokalt, börjar http://localhost:3000 och visar en lista över äventyren som kommer från AEM as a Cloud Service med AEM Headless GraphQL API:er.
5. Redigera innehåll i AEM
Med exempelappen WKND React App som ansluter till och förbrukar innehåll från AEM Headless GraphQL API:er kan du skapa innehåll i tjänsten AEM Author och se hur upplevelsen av React App uppdateras i samförstånd.
Genomgång av steg
-
Logga in på tjänsten AEM as a Cloud Service Author
-
Navigera till Assets > Filer > WKND Delad > Engelska > Tillägg
-
Öppna mappen Cycling Southern Utah
-
Markera innehållsavsnittet Cycling Southern Utah och välj Redigera i det övre åtgärdsfältet
-
Uppdatera vissa fält i innehållsfragmentet, till exempel:
- Titel:
Cycling Utah's National Parks - Reselängd:
6 Days - Svårighet:
Intermediate - Pris:
3500 - Primär bild:
/content/dam/wknd-shared/en/activities/cycling/mountain-biking.jpg
- Titel:
-
Välj Spara i det övre åtgärdsfältet
-
Välj Snabbpublicering i det övre åtgärdsfältets …
-
Uppdatera React App som körs http://localhost:3000.
-
I React App (Reagera app) markerar du det nu uppdaterade Cycling-äventyret och verifierar innehållsändringarna i Content Fragment.
-
På samma sätt som i tjänsten AEM Author:
- Avpublicera ett befintligt Adventure-innehållsfragment och verifiera att det har tagits bort från upplevelsen React App
- Skapa och publicera ett nytt Adventure Content Fragment och verifiera att det visas i React App Experience
note tip TIP Om du inte är bekant med att skapa och publicera nya eller att avpublicera befintliga innehållsfragment tittar du på skärmbilden ovan.
Grattis!
Grattis! Du har använt AEM Headless för att driva en React App!
Om du vill veta mer om hur React App konsumerar innehåll från AEM as a Cloud Service kan du titta på den kostnadsfria självstudiekursen för AEM. I självstudiekursen utforskas hur innehållsfragment i AEM har skapats och hur denna React App använder sitt innehåll som JSON.