Konfigurera lokal AEM SDK set-up-local-aem-sdk
Adobe Experience Manager (AEM) kan köras lokalt med AEM as a Cloud Service SDK QuickStart Jar. Detta gör att utvecklare kan distribuera till och testa anpassad kod, konfiguration och innehåll innan de implementerar det i källkontrollen och distribuerar det i en AEM as a Cloud Service-miljö.
Observera att ~
används som kortskrift för användarens katalog. I Windows motsvarar detta %HOMEPATH%
.
Installera Java™
Experience Manager är en Java™-applikation och därför krävs Oracle Java™ SDK för utvecklingsverktygen.
- [Hämta och installera den senaste Java™ SDK 11](https://experience.adobe.com/#/downloads/content/software-distribution/en/general.html?1_group.propertyvalues.property=.%2Fjcr%3Acontent%2Fmetadata%2FDc%3AsoftwareType&1_group.propertyvalues.operation=equals&1_group.propertyvalues.0_values=software-type%3Atooling&fulltext=Oracle%7E+JDK%7E+11%7E&orderby=%40jcr%3Acontent%2Fjcr cr%3AlastModified&orderby.sort=desc&layout=list&p.offset=0&p.limit=14)
- Kontrollera att Oracle Java™ 11 SDK är installerat genom att köra kommandot:
code language-shell |
---|
|
code language-shell |
---|
|
code language-shell |
---|
|
Ladda ned AEM as a Cloud Service SDK
AEM as a Cloud Service SDK, eller AEM SDK, innehåller den QuickStart Jar som används för att köra AEM Author och Publish lokalt för utveckling, samt den kompatibla versionen av Dispatcher Tools.
- Logga in på https://experience.adobe.com/#/downloads/content/software-distribution/en/aemcloud.html med din Adobe ID
- Observera att din Adobe-organisation måste etableras för att AEM as a Cloud Service ska kunna hämta AEM as a Cloud Service SDK.
- Gå till fliken AEM as a Cloud Service
- Sortera efter Publicerat den i Fallande ordning
- Klicka på den senaste AEM SDK-resultatraden
- Granska och godkänn slutanvändaravtalet och tryck på knappen Hämta
Extrahera Quickstart Jar från AEM SDK zip
- Zippa upp den hämtade
aem-sdk-XXX.zip
-filen
Konfigurera lokal AEM Author Service set-up-local-aem-author-service
Den lokala AEM Author Service ger utvecklare en lokal upplevelse som digitala marknadsförare/innehållsförfattare delar för att skapa och hantera innehåll. AEM Author Service är framtagen både som redigerings- och förhandsvisningsmiljö, vilket innebär att de flesta valideringar av funktionsutveckling kan utföras mot den, vilket gör den till en viktig del i den lokala utvecklingsprocessen.
-
Skapa mappen
~/aem-sdk/author
-
Kopiera Quickstart JAR-filen till
~/aem-sdk/author
och byt namn på den tillaem-author-p4502.jar
-
Starta den lokala AEM Author Service genom att köra följande från kommandoraden:
java -jar aem-author-p4502.jar
- Ange administratörslösenordet som
admin
. Alla administratörslösenord är tillåtna, men du bör använda standardvärdet för lokal utveckling för att minska behovet av att konfigurera om.
- Ange administratörslösenordet som
Du kan inte starta AEM som Cloud Service Quickstart Jar genom att dubbelklicka på.
-
Gå till den lokala AEM Author Service på http://localhost:4502 i en webbläsare
code language-shell |
---|
|
code language-shell |
---|
|
code language-shell |
---|
|
Konfigurera lokal AEM Publish-tjänst
Den lokala AEM Publish Service ger utvecklare den lokala upplevelse som slutanvändarna av AEM har, till exempel den webbplats som är värd för AEM. En lokal AEM-publiceringstjänst är viktig eftersom den integreras med AEM SDK Dispatcher-verktyg så att utvecklare kan röka och finjustera slutanvändarupplevelsen.
-
Skapa mappen
~/aem-sdk/publish
-
Kopiera Quickstart JAR-filen till
~/aem-sdk/publish
och byt namn på den tillaem-publish-p4503.jar
-
Starta den lokala AEM Publish Service genom att köra följande från kommandoraden:
java -jar aem-publish-p4503.jar
- Ange administratörslösenordet som
admin
. Alla administratörslösenord är tillåtna, men du bör använda standardvärdet för lokal utveckling för att minska behovet av att konfigurera om.
- Ange administratörslösenordet som
Du kan inte starta AEM som Cloud Service Quickstart Jar genom att dubbelklicka på.
-
Gå till den lokala AEM Publish Service på http://localhost:4503 i en webbläsare
code language-shell |
---|
|
code language-shell |
---|
|
code language-shell |
---|
|
Konfigurera lokala AEM-tjänster i förhandsversionsläge
Den lokala AEM-miljön kan startas i prerelease-läge, vilket gör att en utvecklare kan bygga på funktionerna i AEM as a Cloud Service nästa release. Förhandsversionen aktiveras genom att argumentet -r prerelease
skickas från den lokala AEM-körningens första start. Detta kan användas med både AEM Author och AEM Publish.
code language-shell |
---|
|
code language-shell |
---|
|
code language-shell |
---|
|
Simulera innehållsdistribution content-distribution
I en äkta Cloud Service-miljö distribueras innehåll från författartjänsten till publiceringstjänsten med hjälp av Sling Content Distribution och Adobe Pipeline. Adobe Pipeline är en isolerad mikrotjänst som bara är tillgänglig i molnmiljön.
Under utvecklingen kan det vara önskvärt att simulera distributionen av innehåll med hjälp av den lokala redigerings- och publiceringstjänsten. Detta kan uppnås genom att aktivera de äldre replikeringsagenterna.
-
Logga in på tjänsten Författare och gå till http://localhost:4502/etc/replication/agents.author.html.
-
Klicka på Standardagent (publicera) för att öppna standardsreplikeringsagenten.
-
Klicka på Redigera för att öppna agentens konfiguration.
-
Uppdatera följande fält på fliken Inställningar:
- Aktiverad - kontrollera sant
- Agentanvändar-ID - Lämna det här fältet tomt
-
Uppdatera följande fält på fliken Transport:
- URI -
http://localhost:4503/bin/receive?sling:authRequestLogin=1
- Användare -
admin
- Lösenord -
admin
- URI -
-
Klicka på OK om du vill spara konfigurationen och aktivera standard-replikeringsagenten.
-
Nu kan du ändra innehåll i författartjänsten och publicera det i publiceringstjänsten.
Snabbstarta JAR-startlägen
Namnet på QuickStart Jar, aem-<tier>_<environment>-p<port number>.jar
, anger hur det kommer att starta. När AEM har startats i ett visst skikt, författare eller publicerat kan det inte ändras till det alternativa skiktet. Det gör du genom att ta bort mappen crx-Quickstart
som skapades under den första körningen och köra Quickstart Jar igen. Miljö och portar kan ändras, men de kräver stopp/start för den lokala AEM-instansen.
Förändrade miljöer, dev
, stage
och prod
, kan vara användbara för utvecklare för att säkerställa att miljöspecifika konfigurationer definieras korrekt och löses av AEM. Vi rekommenderar att lokal utveckling primärt utförs mot standardkörningsläget för miljön dev
.
Tillgängliga permutationer är följande:
aem-author-p4502.jar
aem-author_dev-p4502.jar
aem-author-p4502.jar
)aem-author_stage-p4502.jar
aem-author_prod-p4502.jar
aem-publish-p4503.jar
aem-publish_dev-p4503.jar
aem-publish-p4503.jar
)aem-publish_stage-p4503.jar
aem-publish_prod-p4503.jar
Observera att portnumret kan vara vilken tillgänglig port som helst på den lokala utvecklingsdatorn, men enligt konvention:
- Port 4502 används för den lokala AEM Author-tjänsten
- Porten 4503 används för den lokala AEM Publish-tjänsten
Om du ändrar dessa kan du behöva justera AEM SDK-konfigurationer
Stoppa en lokal AEM-miljö
Om du vill stoppa en lokal AEM-miljö öppnar du kommandoradsfönstret som användes för att starta AEM Runtime, antingen AEM Author eller Publish, och trycker sedan på Ctrl-C
. Vänta tills AEM stängs av. Kommandoradsprompten är tillgänglig när avstängningsprocessen är slutförd.
Valfria lokala konfigurationsuppgifter för AEM runtime
- Systemspecifika konfigurationsmiljövariabler och hemliga variabler är särskilt inställda för AEM lokala körningsmiljö i stället för att hantera dem med AIO CLI.
När QuickStart Jar ska uppdateras
Uppdatera AEM SDK minst en gång i månaden, eller kort efter, den sista torsdagen i varje månad, vilket är versionsslutet för AEM as a Cloud Service"funktionsreleaser".
Så undviker du innehållsförluster när du uppgraderar AEM SDK
Genom att uppgradera AEM SDK skapas en helt ny AEM-runtime, inklusive en ny lagringsplats, vilket innebär att alla ändringar som gjorts i en tidigare AEM SDK-lagringsplats går förlorade. Följande är användbara strategier för att hjälpa till med bestående innehåll mellan uppgraderingar av AEM SDK och kan användas diskret eller i kombination:
- Skapa ett innehållspaket som är avsett för att innehålla exempelinnehåll som ska vara till hjälp vid utvecklingen, och behåll det i Git. Allt innehåll som ska bevaras genom uppgraderingar av AEM SDK bevaras i det här paketet och återdistribueras efter uppgraderingen av AEM SDK.
- Använd ek-upgrade med direktivet
includepaths
om du vill kopiera innehåll från den tidigare AEM SDK-databasen till den nya AEM SDK-databasen. - Säkerhetskopiera allt innehåll med AEM Package Manager och innehållspaket på tidigare AEM SDK och installera om dem på nya AEM SDK.
Kom ihåg att när du använder ovanstående metoder för att underhålla kod mellan uppgraderingar av AEM SDK, så visas ett mönster för utveckling. Kod som inte kan användas för engångsbruk ska ha sitt ursprung i din utvecklingsutvecklingsutvecklingsutvecklingsutvecklingsutvecklingsmiljö och flöda in i AEM SDK via distributioner.
Felsökning
Om du dubbelklickar på Quickstart JAR-filen uppstår ett fel troubleshooting-double-click
När du dubbelklickar på QuickStart Jar för att starta visas ett felmodalt fel som förhindrar att AEM startar lokalt.
Detta beror på att AEM as a Cloud Service Quickstart Jar inte stöder dubbelklickning på QuickStart Jar för att starta AEM lokalt. Du måste i stället köra JAR-filen från kommandoraden.
Om du vill starta AEM Author-tjänsten cd
i katalogen som innehåller QuickStart Jar och kör kommandot:
code language-shell |
---|
|
code language-shell |
---|
|
code language-shell |
---|
|
eller, om du vill starta tjänsten AEM Publish, cd
i katalogen som innehåller snabbstartsverktyget och köra kommandot:
code language-shell |
---|
|
code language-shell |
---|
|
code language-shell |
---|
|
Starten av snabbstartsgaren från kommandoraden avbryts omedelbart troubleshooting-java-8
När du startar Quickstart Jar från kommandoraden avbryts processen omedelbart och AEM-tjänsten startar inte, med följande fel:
➜ ~/aem-sdk/author: java -jar aem-author-p4502.jar
Loading quickstart properties: default
Loading quickstart properties: instance
java.lang.Exception: Quickstart requires a Java Specification 11 VM, but your VM (Java HotSpot(TM) 64-Bit Server VM / Oracle Corporation) reports java.specification.version=1.8
at com.adobe.granite.quickstart.base.impl.Main.checkEnvironment(Main.java:1046)
at com.adobe.granite.quickstart.base.impl.Main.<init>(Main.java:646)
at com.adobe.granite.quickstart.base.impl.Main.main(Main.java:981)
Quickstart: aborting
Detta beror på att AEM as a Cloud Service kräver Java™ SDK 11 och du kör en annan version, troligen Java™ 8. Du löser det här problemet genom att hämta och installera [Oracle Java™ SDK 11](https://experience.adobe.com/#/downloads/content/software-distribution/en/general.html?1_group.propertyvalues.property=.%2Fjcr%3Acontent%2Fmetadata%2FDc%3AsoftwareType&1_group.propertyvalues.operation=equals&1_group.propertyvalues.0_values=software-type%3Atooling&fulltext=Oracle%7E+JDK%7E+11%7E&orderby=%40jcr%3Acontent%2Fjcr cr%3AlastModified&orderby.sort=desc&layout=list&p.offset=0&p.limit=14).
När Oracle Java™ 11 SDK har installerats kontrollerar du att det är den aktiva versionen genom att köra kommandot från kommandoraden:
code language-shell |
---|
|
code language-shell |
---|
|
code language-shell |
---|
|