SDK voor lokale AEM instellen set-up-local-aem-sdk

Adobe Experience Manager (AEM) kan lokaal worden uitgevoerd met de QuickStart Jar van de AEM as a Cloud Service SDK. Dit staat ontwikkelaars toe om op te stellen aan, en douanecode, configuratie, en inhoud te testen alvorens het aan broncontrole te bevestigen, en het op te stellen aan een AEM as a Cloud Service milieu.

Let op: ~ wordt gebruikt als steno voor de Folder van de Gebruiker. In Windows is dit het equivalent van %HOMEPATH%.

Java™ installeren

Experience Manager is een Java™-toepassing en daarom is de Oracle Java™ SDK vereist voor ondersteuning van de ontwikkelingstool.

  1. [Download en installeer de nieuwste 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%2 Fjcr%3AlastModified&orderby.sort=desc&layout=list&p.offset=0&p.limit=14)
  2. Controleer of Oracle Java™ 11 SDK is geïnstalleerd door de opdracht uit te voeren:
macOS
code language-shell
$ java --version
Windows
code language-shell
$ java -version
Linux®
code language-shell
$ java --version

Java

Download de AEM as a Cloud Service SDK

De AEM as a Cloud Service SDK, of AEM SDK, bevat de Quickstart Jar die wordt gebruikt om AEM Auteur en Publish plaatselijk voor ontwikkeling in werking te stellen, evenals de compatibele versie van de Hulpmiddelen van de Verzender.

  1. Aanmelden bij https://experience.adobe.com/#/downloads met uw Adobe ID
    • Merk op dat uw organisatie van de Adobe moet is ingericht voor AEM as a Cloud Service om de AEM as a Cloud Service SDK te downloaden.
  2. Ga naar de AEM as a Cloud Service tab
  3. Sorteren op Gepubliceerde datum in Aflopend bestellen
  4. Klik op de nieuwste AEM SDK resultatenrij
  5. Reviseer en accepteer de EULA en tik op de Downloaden knop

Haal de QuickStart Jar uit het ZIP van de AEM SDK

  1. De gedownloade gegevens decomprimeren aem-sdk-XXX.zip file

Lokale AEM Auteur-service instellen set-up-local-aem-author-service

De lokale AEM Auteur Service biedt ontwikkelaars een lokale ervaring met ontwerpers van digitale markten/content die ze delen om inhoud te maken en te beheren. AEM Auteursdienst wordt ontworpen zowel als creatie als voorproefmilieu, toestaand de meeste bevestigingen van eigenschapontwikkeling kunnen tegen het worden uitgevoerd, die tot het een essentieel element van het lokale ontwikkelingsproces maken.

  1. De map maken ~/aem-sdk/author

  2. De QuickStart JAR bestand naar ~/aem-sdk/author en hernoemen aem-author-p4502.jar

  3. Start de lokale AEM Auteur Service door het volgende uit te voeren vanaf de opdrachtregel:

    • java -jar aem-author-p4502.jar
      • Geef het beheerderswachtwoord op als admin. Om het even welk admin wachtwoord is aanvaardbaar, nochtans adviseert het om het gebrek voor lokale ontwikkeling te gebruiken om de behoefte te verminderen om te vormen.

    U kan start de AEM als Cloud Service QuickStart Jar door te dubbelklikken.

  4. Ga naar de lokale AEM Auteur-service op http://localhost:4502 in een webbrowser

macOS
code language-shell
$ mkdir -p ~/aem-sdk/author
$ cp aem-sdk-Quickstart-XXX.jar ~/aem-sdk/author/aem-author-p4502.jar
$ cd ~/aem-sdk/author
$ java -jar aem-author-p4502.jar
Windows
code language-shell
$ mkdir -p c:\Users\<My User>\aem-sdk\author
$ copy aem-sdk-Quickstart-XXX.jar c:\Users\<My User>\aem-sdk\author\aem-author-p4502.jar
$ cd c:\Users\<My User>\aem-sdk\author
$ java -jar aem-author-p4502.jar
Linux®
code language-shell
$ mkdir -p ~/aem-sdk/author
$ cp aem-sdk-Quickstart-XXX.jar ~/aem-sdk/author/aem-author-p4502.jar
$ cd ~/aem-sdk/author
$ java -jar aem-author-p4502.jar

Lokale AEM publicatieservice instellen

De lokale AEM publicatieservice biedt ontwikkelaars de lokale ervaring die eindgebruikers van de AEM zullen hebben, zoals bladeren door de website die op AEM wordt gehost. Een lokale AEM publicatieservice is belangrijk omdat deze integreert met AEM SDK's Verzendgereedschappen en stelt ontwikkelaars in staat de ervaring voor eindgebruikers te testen en te verfijnen.

  1. De map maken ~/aem-sdk/publish

  2. De QuickStart JAR bestand naar ~/aem-sdk/publish en hernoemen aem-publish-p4503.jar

  3. Start de lokale AEM publicatieservice door het volgende vanaf de opdrachtregel uit te voeren:

    • java -jar aem-publish-p4503.jar
      • Geef het beheerderswachtwoord op als admin. Om het even welk admin wachtwoord is aanvaardbaar, nochtans adviseert het om het gebrek voor lokale ontwikkeling te gebruiken om de behoefte te verminderen om te vormen.

    U kan start de AEM als Cloud Service QuickStart Jar door te dubbelklikken.

  4. Heb toegang tot de lokale AEM publicatieservice bij http://localhost:4503 in een webbrowser

macOS
code language-shell
$ mkdir -p ~/aem-sdk/publish
$ cp aem-sdk-Quickstart-XXX.jar ~/aem-sdk/publish/aem-publish-p4503.jar
$ cd ~/aem-sdk/publish
$ java -jar aem-publish-p4503.jar
Windows
code language-shell
$ mkdir -p c:\Users\<My User>\aem-sdk\publish
$ copy aem-sdk-Quickstart-XXX.jar c:\Users\<My User>\aem-sdk\publish\aem-publish-p4503.jar
$ cd c:\Users\<My User>\aem-sdk\publish
$ java -jar aem-publish-p4503.jar
Linux®
code language-shell
$ mkdir -p ~/aem-sdk/publish
$ cp aem-sdk-Quickstart-XXX.jar ~/aem-sdk/publish/aem-publish-p4503.jar
$ cd ~/aem-sdk/publish
$ java -jar aem-publish-p4503.jar

Lokale AEM instellen in de pre-releasemodus

De lokale AEM-runtime kan worden gestart in pre-releasemodus zodat een ontwikkelaar kan bouwen op basis van de functies van de volgende release van de AEM as a Cloud Service. Prerelease wordt ingeschakeld door het -r prerelease argument op het eerste begin van de lokale AEM runtime. Dit kan zowel met lokale AEM Auteur als AEM de diensten van de Publicatie worden gebruikt.

macOS
code language-shell
# For AEM Author service in prerelease mode
$ java -jar aem-author-p4502.jar -r prerelease

# For AEM Publish service in prerelease mode
$ java -jar aem-publish-p4503.jar -r prerelease
Windows
code language-shell
# For AEM Author service in prerelease mode
$ java -jar aem-author-p4502.jar -r prerelease

# For AEM Publish service in prerelease mode
$ java -jar aem-publish-p4503.jar -r prerelease
Linux®
code language-shell
# For AEM Author service in prerelease mode
$ java -jar aem-author-p4502.jar -r prerelease

# For AEM Publish service in prerelease mode
$ java -jar aem-publish-p4503.jar -r prerelease

Inhoudsdistributie simuleren content-distribution

In een ware milieu van de Cloud Service wordt de inhoud van de Auteur aan de Publish Dienst verdeeld gebruikend Distributie van inhoud verkopen en de Adobe Pipeline. De Adobe Pipet is een geïsoleerde microservice die alleen beschikbaar is in de cloud-omgeving.

Tijdens de ontwikkeling, kan het wenselijk zijn om de distributie van inhoud te simuleren gebruikend de lokale auteur en de Publish dienst. Dit kan worden bereikt door de agenten van de erfenisReplicatie toe te laten.

NOTE
De agenten van de replicatie zijn slechts beschikbaar aan gebruik in lokale QuickStart JAR en verstrekken slechts een simulatie van inhoudsdistributie.
  1. Aanmelden bij de Auteur service en navigeer naar http://localhost:4502/etc/replication/agents.author.html.

  2. Klikken Standaardagent (publiceren) om de standaardagent van de Replicatie te openen.

  3. Klikken Bewerken om de configuratie van de agent te openen.

  4. Onder de Instellingen werkt u de volgende velden bij:

    • Ingeschakeld - true controleren
    • Gebruiker-id agent - Dit veld leeg laten

    Configuratie van replicatieagent - instellingen

  5. Onder de Vervoer werkt u de volgende velden bij:

    • URI - http://localhost:4503/bin/receive?sling:authRequestLogin=1
    • Gebruiker - admin
    • Wachtwoord - admin

    Configuratie replicatieagent - Vervoer

  6. Klikken OK om de configuratie op te slaan en de Standaard Replication Agent.

  7. U kunt nu wijzigingen aanbrengen in de inhoud van de service Auteur en deze publiceren naar de service Publiceren.

Pagina publiceren

Snelstartmodi voor Jar

De naam van de QuickStart-jar, aem-<tier>_<environment>-p<port number>.jar geeft aan hoe de toepassing wordt gestart. Wanneer AEM zoals begonnen in een specifieke rij, auteur of publiceert, kan het niet in de afwisselende rij worden veranderd. Om dit te doen, crx-Quickstart de map die tijdens de eerste uitvoering wordt gegenereerd, moet worden verwijderd en QuickStart Jar moet opnieuw worden uitgevoerd. Het milieu en de Havens kunnen worden veranderd, nochtans vereisen zij einde/begin van de lokale AEM instantie.

Omgevingen wijzigen, dev, stage en prod, kan voor ontwikkelaars nuttig zijn om ervoor te zorgen dat de milieu-specifieke configuraties correct worden bepaald en door AEM worden opgelost. Aanbevolen wordt om lokale ontwikkeling in de eerste plaats tegen de standaardinstelling uit te voeren dev de uitvoermodus van de omgeving.

De beschikbare permutaties zijn als volgt:

Quickstart Jar-bestandsnaam
Beschrijving van modus
aem-author-p4502.jar
Als Auteur in Dev loopwijze op haven 4502
aem-author_dev-p4502.jar
Als Auteur in Dev loopwijze op haven 4502 (het zelfde als aem-author-p4502.jar)
aem-author_stage-p4502.jar
Als Auteur in Staging run mode op poort 4502
aem-author_prod-p4502.jar
Als Auteur in de run mode van de Productie op haven 4502
aem-publish-p4503.jar
Als Publiceren in Dev loopwijze op haven 4503
aem-publish_dev-p4503.jar
Zoals publiceren op Dev loopwijze op haven 4503 (zelfde als aem-publish-p4503.jar)
aem-publish_stage-p4503.jar
Als Publiceren in Staging-uitvoeringsmodus op poort 4503
aem-publish_prod-p4503.jar
Als Publish op de loopwijze van de Productie op haven 4503

Merk op dat het havenaantal om het even welke beschikbare haven op de lokale ontwikkelingsmachine kan zijn, echter door overeenkomst:

  • Poort 4502 wordt gebruikt voor de lokale AEM Auteur-service
  • Poort 4503 wordt gebruikt voor de lokale AEM publicatieservice

Het wijzigen van deze instellingen kan aanpassingen in AEM SDK-configuraties vereisen

Een lokale AEM-runtime stoppen

Als u een lokale AEM-runtime wilt stoppen, AEM de service Auteur of Publiceren, opent u het opdrachtregelvenster dat is gebruikt om de AEM-runtime te starten en tikt u op Ctrl-C. Wacht tot AEM is afgesloten. Wanneer het sluitingsproces volledig is, is de herinnering van de bevellijn beschikbaar.

Optionele lokale AEM-runtime instellingstaken

Wanneer werkt u de QuickStart-jar bij

Werk de AEM SDK ten minste maandelijks bij op of kort na de laatste donderdag van elke maand. Dit is de releasekadentie voor AEM as a Cloud Service "feature releases".

WARNING
Als u de QuickStart-jar wilt bijwerken naar een nieuwe versie, moet u de volledige lokale ontwikkelomgeving vervangen. Dit leidt tot verlies van alle code, configuratie en inhoud in de lokale AEM. Zorg ervoor dat om het even welke code, config of inhoud die niet zou moeten worden vernietigd veilig aan Git wordt begaan, of uit de lokale AEM instantie als AEM Pakketten wordt uitgevoerd.

Hoe te om inhoudsverlies te vermijden wanneer het bevorderen van de AEM SDK

Door de upgrade van de AEM SDK wordt in feite een geheel nieuwe AEM-runtime gemaakt, waaronder een nieuwe opslagplaats. Dit betekent dat eventuele wijzigingen in de opslagplaats van een eerdere AEM SDK verloren gaan. Hieronder volgen levensvatbare strategieën voor het ondersteunen van blijvende inhoud tussen AEM SDK-upgrades en u kunt deze op discrete wijze of in overleg gebruiken:

  1. Maak een inhoudspakket dat gewijd is aan het bevatten van 'sample'-inhoud voor hulp bij ontwikkeling en onderhoud dit in Git. Alle inhoud die via AEM SDK-upgrades moet worden voortgezet, blijft in dit pakket aanwezig en wordt opnieuw geïmplementeerd nadat de AEM SDK is bijgewerkt.
  2. Gebruiken eik-upgrade met de includepaths gebruiken, om inhoud van de vorige AEM SDK-opslagplaats te kopiëren naar de nieuwe AEM SDK-opslagplaats.
  3. Maak een back-up van alle inhoud met AEM pakketbeheer en inhoudspakketten op de vorige AEM SDK en installeer deze opnieuw op de nieuwe AEM SDK.

Herinner me, gebruikend de bovengenoemde benaderingen om code tussen AEM verbeteringen van SDK te handhaven, wijst op een ontwikkelantipatroon. De niet-besteedbare code zou in uw Ontwikkeling winde moeten voortkomen en in AEM SDK via plaatsingen stromen.

Problemen oplossen

Als u dubbelklikt op het QuickStart Jar-bestand, treedt er een fout op troubleshooting-double-click

Wanneer u dubbelklikt op de Quickstart Jar om te starten, wordt een modaal foutbericht weergegeven om te voorkomen dat AEM lokaal wordt gestart.

Problemen oplossen - Dubbelklik op het QuickStart Jar-bestand

Dit komt doordat AEM as a Cloud Service QuickStart Jar dubbelklikken van de QuickStart Jar om AEM lokaal te starten niet ondersteunt. In plaats daarvan moet u het Jar-bestand vanaf die opdrachtregel uitvoeren.

Ga als volgt te werk om AEM Auteur te starten: cd in de directory met de Quickstart Jar en voer de opdracht uit:

macOS
code language-shell
$ java -jar aem-author-p4502.jar
Windows
code language-shell
$ java -jar aem-author-p4502.jar
Linux®
code language-shell
$ java -jar aem-author-p4502.jar

of, om AEM publicatieservice te starten, cd in de directory met de Quickstart Jar en voer de opdracht uit:

macOS
code language-shell
$ java -jar aem-publish-p4503.jar
Windows
code language-shell
$ java -jar aem-publish-p4503.jar
Linux®
code language-shell
$ java -jar aem-publish-p4503.jar

Het beginnen van Jar Quickstart van de bevellijn aborteert onmiddellijk troubleshooting-java-8

Wanneer het beginnen van Jar QuickStart van de bevellijn, het proces onmiddellijk aborteert en de AEM dienst begint niet, met de volgende fout:

➜  ~/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

Dit komt omdat AEM as a Cloud Service Java™ SDK 11 vereist en u een andere versie gebruikt, zeer waarschijnlijk Java™ 8. Download en installeer om dit probleem op te lossen [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%2 Fjcr%3AlastModified&orderby.sort=desc&layout=list&p.offset=0&p.limit=14).

Zodra Oracle Java™ 11 SDK wordt geïnstalleerd, verifieer het de actieve versie door het bevel van de bevellijn in werking te stellen:

macOS
code language-shell
$ java --version
Windows
code language-shell
$ java -version
Linux®
code language-shell
$ java --version

Aanvullende bronnen

recommendation-more-help
4859a77c-7971-4ac9-8f5c-4260823c6f69