Configurazione rapida AEM Headless per AEM as a Cloud Service
La configurazione rapida AEM Headless ti consente di utilizzare AEM Headless utilizzando il contenuto del progetto di esempio del sito WKND e un esempio di app React (SPA) che consuma il contenuto rispetto alle API AEM Headless GraphQL.
Prerequisiti
Per eseguire questa configurazione rapida sono necessari i seguenti elementi:
-
Ambiente Sandbox AEM as a Cloud Service (preferibilmente Sviluppo)
-
Accesso ad AEM as a Cloud Service e Cloud Manager
- Accesso Amministratore AEM ad AEM as a Cloud Service
- Cloud Manager - Accesso a Cloud Manager da parte del Responsabile della distribuzione
-
I seguenti strumenti devono essere installati localmente:
- Node.js v18
- Git
- Un IDE (ad esempio, Microsoft® Visual Studio Code)
1. Creare un archivio Git di Cloud Manager
Innanzitutto, crea un archivio Git di Cloud Manager utilizzato per distribuire il sito WKND. Il sito WKND è un progetto di esempio per un sito web AEM che contiene contenuti (frammenti di contenuto) e un endpoint AEM GraphQL utilizzato dall’app React della configurazione rapida.
Schermata dei passaggi
-
Seleziona il programma Cloud Manager contenente l'ambiente AEM as a Cloud Service da utilizzare per questa installazione rapida
-
Creare un archivio Git per il progetto del sito WKND
- Seleziona Archivi nella navigazione superiore
- Seleziona Aggiungi archivio nella barra delle azioni superiore
- Denomina il nuovo archivio Git:
aem-headless-quick-setup-wknd
- I nomi degli archivi Git devono essere univoci per ogni organizzazione di Adobe,
- Seleziona Salva e attendi l'inizializzazione dell'archivio Git
2. Invia il progetto di esempio del sito WKND all’archivio Git di Cloud Manager
Una volta creato l’archivio Git di Cloud Manager, clona il codice sorgente del progetto del sito WKND da GitHub e invialo all’archivio Git di Cloud Manager. Ora puoi accedere a Cloud Manager e implementare il progetto del sito WKND nell’ambiente AEM as a Cloud Service.
Schermata dei passaggi
-
Dalla riga di comando, clona il codice sorgente del progetto WKND Site di esempio da GitHub
code language-shell $ mkdir -p ~/Code $ cd ~/Code $ git clone git@github.com:adobe/aem-guides-wknd.git
-
Aggiungere l’archivio Git di Cloud Manager come archivio remoto
-
Seleziona Archivi nella navigazione superiore
-
Seleziona Accedi a dati archivio dalla barra delle azioni superiore
-
Comando Execute trovato in Aggiungi un remoto all'archivio Git dalla riga di comando
code language-shell $ cd aem-guides-wknd $ git remote add adobe https://git.cloudmanager.adobe.com/<YOUR ADOBE ORGANIZATION>/aem-headless-quick-setup-wknd/
-
-
Invia il codice sorgente del progetto di esempio dall’archivio Git locale all’archivio Git di Cloud Manager
code language-shell $ git push adobe main:main
Quando vengono richieste le credenziali, fornisci il Nome utente e la Password dal modale Informazioni archivio di Cloud Manager.
3. Distribuire il sito WKND in AEM as a Cloud Service
Quando il progetto del sito WKND viene inviato all’archivio Git di Cloud Manager, non può essere distribuito ad AEM as a Cloud Service utilizzando le pipeline di Cloud Manager.
Nota: il progetto del sito WKND fornisce contenuti di esempio che l’app React utilizza rispetto alle API GraphQL headless dell’AEM.
Schermata dei passaggi
-
Allega una pipeline di distribuzione non di produzione al nuovo archivio Git
-
Seleziona Pipeline nella navigazione superiore
-
Seleziona Aggiungi pipeline dalla barra delle azioni superiore
-
Nella scheda Configurazione
- Seleziona opzione Pipeline di distribuzione
- Imposta Nome pipeline non di produzione su
Dev Deployment pipeline
- Seleziona Trigger distribuzione > In caso di modifiche Git
- Seleziona Comportamento in caso di errori di metriche importanti > Continua immediatamente
- Seleziona Continua
-
Nella scheda Codice Source
- Seleziona opzione Codice full stack
- Seleziona l'ambiente di sviluppo AEM as a Cloud Service dalla casella di selezione Ambienti di distribuzione idonei
- Seleziona
aem-headless-quick-setup-wknd
nella casella di selezione Archivio - Seleziona
main
dalla casella di selezione Ramo Git - Seleziona Salva
-
-
Esegui la pipeline di distribuzione Dev
- Seleziona Panoramica nella navigazione superiore
- Individua la pipeline di distribuzione Dev appena creata nella sezione Pipeline
- Seleziona … a destra della voce della pipeline
- Seleziona Esegui e conferma nel modale
- Seleziona … a destra della pipeline attualmente in esecuzione
- Seleziona Visualizza dettagli
-
Dai dettagli dell’esecuzione della pipeline, monitora l’avanzamento fino al suo completamento corretto. L’esecuzione della pipeline dovrebbe richiedere tra 30 e 40 minuti.
4. Scaricare ed eseguire l’app WKND React
Con AEM as a Cloud Service avviato con il contenuto del progetto del sito WKND, scarica e avvia l’app di reazione WKND di esempio che utilizza il contenuto del sito WKND sulle API GraphQL headless dell’AEM.
Schermata dei passaggi
-
Dalla riga di comando, clona il codice sorgente dell’app React da GitHub.
code language-shell $ cd ~/Code $ git clone git@github.com:adobe/aem-guides-wknd-graphql.git
-
Aprire la cartella
~/Code/aem-guides-wknd-graphql/react-app
nell'IDE. -
Nell'IDE aprire il file
.env.development
. -
Scegliere l'URI host del servizio AEM as a Cloud Service Publish dalla proprietà
REACT_APP_HOST_URI
.code language-plain REACT_APP_HOST_URI=https://publish-pXXXX-eYYYY.adobeaemcloud.com ...
Per trovare l’URI host del servizio AEM as a Cloud Service Publish:
- In Cloud Manager, seleziona Ambienti nella navigazione superiore
- Seleziona ambiente Sviluppo
- Individua la tabella Servizio Publish (AEM e Dispatcher) collegamento Segmenti di ambiente
- Copia l’indirizzo del collegamento e utilizzalo come URI del servizio AEM as a Cloud Service Publish
-
Nell'IDE, salvare le modifiche apportate a
.env.development
-
Dalla riga di comando, esegui React App
code language-shell $ cd ~/Code/aem-guides-wknd-graphql/react-app $ npm install $ npm start
-
L'app React, eseguita localmente, inizia il http://localhost:3000 e visualizza un elenco di avventure, provenienti da AEM as a Cloud Service con le API GraphQL di AEM Headless.
5. Modificare i contenuti in AEM
Con l’app di esempio WKND React che si connette e utilizza i contenuti delle API GraphQL headless dell’AEM, crea contenuti nel servizio di authoring dell’AEM e scopri come l’esperienza dell’app React si aggiorna insieme.
Schermata dei passaggi
-
Accedi al servizio AEM as a Cloud Service Author
-
Passa a Assets > File > WKND condiviso > Inglese > Avventure
-
Apri la cartella Ciclismo nello Utah meridionale
-
Seleziona il frammento di contenuto Ciclismo nello Utah meridionale e seleziona Modifica dalla barra delle azioni superiore
-
Aggiorna alcuni campi del frammento di contenuto, ad esempio:
- Titolo:
Cycling Utah's National Parks
- Durata viaggio:
6 Days
- Difficoltà:
Intermediate
- Prezzo:
3500
- Immagine principale:
/content/dam/wknd-shared/en/activities/cycling/mountain-biking.jpg
- Titolo:
-
Seleziona Salva nella barra delle azioni superiore
-
Seleziona Publish rapido dal della barra delle azioni superiore…
-
Aggiorna l'app React in esecuzione su http://localhost:3000.
-
Nell’app React, seleziona l’avventura Ciclismo ora aggiornata e verifica le modifiche al contenuto apportate al frammento di contenuto.
-
Con lo stesso approccio, nel servizio di authoring dell’AEM:
- Annulla la pubblicazione di un frammento di contenuto Adventure esistente e verifica che sia stato rimosso dall’esperienza di app di React
- Crea e pubblica un nuovo frammento di contenuto Avventura e verificane la visualizzazione nell’esperienza di React App
note tip TIP Se non hai familiarità con la creazione e la pubblicazione di nuovi frammenti di contenuto o con l’annullamento della pubblicazione di frammenti di contenuto esistenti, guarda la schermata precedente.
Congratulazioni.
Congratulazioni Hai utilizzato correttamente AEM Headless per alimentare un’app React.
Per informazioni dettagliate su come l'app React utilizza i contenuti di AEM as a Cloud Service, consulta l'esercitazione AEM headless. Il tutorial esplora come vengono creati i frammenti di contenuto in AEM e come questa app React utilizza i contenuti come JSON.