Local AEM Development with the Universal Editor local-dev-ue

Läs om hur den universella redigeraren stöder redigering i lokala AEM för utvecklingsändamål.

Ökning overview

Universal Editor-tjänsten är den som binder Universal Editor och serverdelssystemet. Om du vill kunna utveckla lokalt för den universella redigeraren måste du köra en lokal kopia av den universella redigeringstjänsten. Detta beror på:

I det här dokumentet förklaras hur du kör AEM i HTTPS tillsammans med en lokal kopia av Universal Editor-tjänsten så att du kan utveckla lokalt på AEM för användning med Universal Editor.

Konfigurera AEM som ska köras på HTTPS aem-https

I en yttre ram som skyddas med HTTPS går det inte att läsa in en osäker HTTP-ram. Tjänsten Universal Editor körs på HTTPS och därför måste AEM eller andra fjärrsidor också köras på HTTPS.

För att göra detta måste du konfigurera AEM för att köra HTTPS. I utvecklingssyfte kan du använda självsignerade certifikat.

Se det här dokumentet om hur du konfigurerar AEM som körs på HTTPS, inklusive ett självsignerat certifikat som du kan använda.

Installera Universal Editor-tjänsten install-ue-service

Den universella redigeringstjänsten är inte en fullständig kopia av den universella redigeraren, utan bara en delmängd av dess funktioner för att säkerställa att samtal från den lokala AEM inte dirigeras över Internet, utan från en definierad slutpunkt som du kontrollerar.

NodeJS version 16 krävs för att köra en lokal kopia av Universal Editor-tjänsten.

Tjänsten Universal Editor är tillgänglig via Software Distribution. Mer information om hur du får åtkomst till programdistributionsdokumentationen finns i dokumentationen för programvarudistribution.

Spara filen universal-editor-service.cjs från programvarudistribution till den lokala utvecklingsmiljön.

Skapa ett certifikat som kör den universella redigeringstjänsten med HTTPS ue-https

Tjänsten Universal Editor kräver också ett certifikat som kan köras på HTTPS i din utvecklingsmiljö.

Kör följande kommando.

$ openssl req -newkey rsa:2048 -nodes -keyout key.pem -x509 -days 365 -out certificate.pem

Kommandot genererar en key.pem- och en certificate.pem-fil. Spara dessa filer i samma sökväg som din universal-editor-service.cjs-fil.

Konfigurera Universal Editor Service-konfigurationen setting-up-service

Ett antal miljövariabler måste anges i NodeJS för att den universella redigeringstjänsten ska kunna köras lokalt.

Skapa en .env-fil med följande innehåll på samma sökväg som dina universal-editor-service.cjs-, key.pem- och certificate.pem-filer.

EXPRESS_PORT=8000
EXPRESS_PRIVATE_KEY=./key.pem
EXPRESS_CERT=./certificate.pem
NODE_TLS_REJECT_UNAUTHORIZED=0

Variabeln har följande betydelse:

Kör den universella redigeringstjänsten running-ue

Kör följande kommando för att starta Universal Editor-tjänsten:

$ node ./universal-editor-service.cjs

Följande bör skickas till din terminal:

Universal Editor Service listening on port 8000 as HTTPS Server

Kontrollera att HTTPS-servern inte är en HTTP-server startas av tjänsten.

Använda den lokala universella redigeringstjänsten i stället för den globala tjänsten using-local-ue

Den universella redigeraren vet vilken Universal Editor-tjänst som ska användas för att redigera en sida baserat på hur sidan är instrumenterad. Detta görs via metataggar på sidan som läses in i Universal Editor.

För att en sida ska kunna redigeras med din lokala Universal Editor-tjänst måste följande meta-tagg anges:

<meta name="urn:adobe:aue:config:service" content="https://localhost:8000">

När den är inställd ska du se alla anrop om innehållsuppdatering gå till https://localhost:8000 i stället för standardtjänsten Universal Editor.

Redigera en sida med den lokala universella redigeringstjänsten editing

Med den universella redigeringstjänsten som körs lokalt och innehållssidan som är instrumenterad för att använda den lokala tjänsten kan du nu starta redigeraren.