Konfigurera lokal AEM SDK set-up-local-aem-sdk
Adobe Experience Manager (AEM) kan köras lokalt med den AEM as a Cloud Service SDK:ns 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ändarkatalogen. I Windows motsvarar detta %HOMEPATH%
.
Installera Java™
Experience Manager är en Java™-applikation och därför krävs Oraclet 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%2FDK jcr%3AlastModified&orderby.sort=desc&layout=list&p.offset=0&p.limit=14)
- Kontrollera att Oraclet Java™ 11 SDK är installerat genom att köra kommandot:
code language-shell |
---|
|
code language-shell |
---|
|
code language-shell |
---|
|
Hämta AEM as a Cloud Service SDK
Den AEM as a Cloud Service SDK, eller AEM SDK, innehåller den QuickStart Jar som används för att köra AEM författare och publicera lokalt för utveckling, samt den kompatibla versionen av Dispatcher Tools.
- Logga in på https://experience.adobe.com/#/downloads med din Adobe ID
- Observera att din Adobe-organisation måste etableras för AEM as a Cloud Service att hämta AEM as a Cloud Service SDK.
- Navigera till AEM as a Cloud Service tab
- Sortera efter Publiceringsdatum in Fallande beställa
- Klicka på den senaste AEM SDK resultatrad
- Granska och godkänn slutanvändaravtalet och tryck på Ladda ned knapp
Extrahera Quickstart Jar från AEM SDK-zip
- Zippa upp det nedladdade
aem-sdk-XXX.zip
fil
Konfigurera lokal AEM Author Service set-up-local-aem-author-service
Den lokala AEM författartjänsten 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 utformad både som en redigerings- och förhandsvisningsmiljö, vilket gö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 fil till
~/aem-sdk/author
och ändra namnet 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 inte starta AEM som Cloud Service QuickStart Jar genom att dubbelklicka.
-
Gå till den lokala AEM författartjänsten på http://localhost:4502 i en webbläsare
code language-shell |
---|
|
code language-shell |
---|
|
code language-shell |
---|
|
Konfigurera lokal AEM Publiceringstjänst
Den lokala AEM-publiceringstjänsten ger utvecklare den lokala upplevelse som slutanvändarna av AEM har, till exempel den webbplats som är AEM. En lokal AEM är viktig eftersom den kan integreras med AEM SDK:er Dispatcher-verktyg och gör det möjligt för utvecklare att röka och finjustera slutanvändarupplevelsen.
-
Skapa mappen
~/aem-sdk/publish
-
Kopiera Quickstart JAR fil till
~/aem-sdk/publish
och ändra namnet tillaem-publish-p4503.jar
-
Starta den lokala AEM-publiceringstjänsten 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 inte starta AEM som Cloud Service QuickStart Jar genom att dubbelklicka.
-
Åtkomst till den lokala AEM-publiceringstjänsten på http://localhost:4503 i en webbläsare
code language-shell |
---|
|
code language-shell |
---|
|
code language-shell |
---|
|
Konfigurera lokala AEM i förhandsversionsläge
Den lokala AEM kan startas i prerelease-läge som gör det möjligt för en utvecklare att bygga vidare på den AEM as a Cloud Service nästa releases funktioner. Förhandsversionen aktiveras genom att användaren skickar -r prerelease
argument på den lokala AEM körtidens första start. Detta kan användas med både AEM och AEM publiceringstjänster.
code language-shell |
---|
|
code language-shell |
---|
|
code language-shell |
---|
|
Simulera innehållsdistribution content-distribution
I en riktig Cloud Service distribueras innehåll från författartjänsten till publiceringstjänsten med Distribution av säljinnehåll och Adobe Pipeline. The 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å Upphovsman och navigera till http://localhost:4502/etc/replication/agents.author.html.
-
Klicka Standardagent (publicera) om du vill öppna standardreplikeringsagenten.
-
Klicka Redigera för att öppna agentens konfiguration.
-
Under Inställningar uppdaterar du följande fält:
- Aktiverad - kontrollera sant
- Användar-ID för agent - Lämna fältet tomt
-
Under Transport uppdaterar du följande fält:
- URI -
http://localhost:4503/bin/receive?sling:authRequestLogin=1
- Användare -
admin
- Lösenord -
admin
- URI -
-
Klicka OK för att spara konfigurationen och aktivera Standard Replikeringsagent.
-
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 den kommer att starta. När AEM har startats i ett visst skikt, författare eller publicering kan det inte ändras till det alternativa skiktet. För att göra detta crx-Quickstart
mappen som skapades under den första körningen måste tas bort och QuickStart Jar måste köras igen. Miljö och portar kan ändras, men de kräver stopp/start för den lokala AEM.
Föränderliga miljöer, dev
, stage
och prod
, kan vara användbart för utvecklare för att säkerställa att miljöspecifika konfigurationer definieras och löses korrekt av AEM. Vi rekommenderar att lokal utveckling huvudsakligen görs mot standardinställningen dev
miljö, körningsläge.
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 lokal AEM
- Port 4503 används för lokal AEM
Om du ändrar dessa kan du behöva justera AEM SDK-konfigurationer
Stoppa en lokal AEM
Om du vill stoppa en lokal AEM, antingen AEM författare eller publiceringstjänst, öppnar du kommandoradsfönstret som användes för att starta AEM körningsmiljö och trycker på Ctrl-C
. Vänta på att AEM stängs av. Kommandoradsprompten är tillgänglig när avstängningsprocessen är slutförd.
Inställningsåtgärder för lokal AEM
- OSGi-konfigurationsmiljövariabler och hemliga variabler är särskilt inställd för AEM lokala körningsmiljöni stället för att hantera dem med AIR 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å här undviker du innehållsförluster när du uppgraderar AEM SDK
Genom att uppgradera AEM SDK skapas en helt ny AEM, inklusive en ny databas, vilket innebär att ändringar som gjorts i en tidigare AEM SDK-databas går förlorade. Följande är användbara strategier för att hjälpa till med bestående innehåll mellan AEM SDK-uppgraderingar 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 AEM SDK-uppgraderingar kommer att finnas kvar i det här paketet och återdistribueras efter uppgraderingen av AEM SDK.
- Använd oak-upgrade med
includepaths
för att 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å den tidigare AEM SDK:n och installera om dem på den nya AEM SDK:n.
Kom ihåg att om du använder ovanstående metoder för att underhålla kod mellan AEM SDK-uppgraderingar, så visas ett mönster för utveckling. Kod som inte kan användas för engångsbruk ska ha sitt ursprung i din utvecklingsutvecklingsutvecklingsutvecklingsmiljö 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 startas lokalt.
Detta beror på att AEM as a Cloud Service QuickStart Jar inte stöder dubbelklickning av 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 författartjänsten cd
till katalogen som innehåller QuickStart Jar och kör kommandot:
code language-shell |
---|
|
code language-shell |
---|
|
code language-shell |
---|
|
eller, för att starta AEM Publish-tjänsten, cd
till katalogen som innehåller QuickStart Jar och kör 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 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, troligtvis Java™ 8. Lös 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%2FDK jcr%3AlastModified&orderby.sort=desc&layout=list&p.offset=0&p.limit=14).
När Oraclet Java™ 11 SDK är installerat 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 |
---|
|