Configurare AEM Runtime locale

Adobe Experience Manager (AEM) può essere eseguito localmente utilizzando il Jar Quickstart dell’SDK AEM as a Cloud Service. Questo consente agli sviluppatori di implementare e testare il codice personalizzato, la configurazione e i contenuti prima di passare al controllo del codice sorgente e di distribuirli in un ambiente AEM as a Cloud Service.

Tieni presente che ~ viene utilizzato come abbreviazione per la directory dell'utente. In Windows, è l'equivalente di %HOMEPATH%.

Installa Java

Experience Manager è un’applicazione Java e quindi richiede l’SDK Java per supportare gli strumenti di sviluppo.

  1. Scarica e installa l'SDK Java più recente 11
  2. Verifica che Java 11 SDK sia installato eseguendo il comando :
    • Windows:java -version
    • macOS / Linux: java --version

Java

Scaricare l’SDK AEM as a Cloud Service

L’SDK AEM as a Cloud Service, o SDK di AEM, contiene il Jar Quickstart utilizzato per eseguire AEM Author e Publish localmente per lo sviluppo, nonché la versione compatibile degli strumenti di Dispatcher.

  1. Accedi a https://experience.adobe.com/#/downloads con il tuo Adobe ID
    • Tieni presente che la tua organizzazione Adobe deve è stato effettuato il provisioning per AEM as a Cloud Service per scaricare l’SDK as a Cloud Service AEM.
  2. Passa a AEM as a Cloud Service scheda
  3. Ordina per Data di pubblicazione in Decrescente ordine
  4. Fai clic sull'ultima SDK AEM riga risultato
  5. Rivedi e accetta l’EULA e tocca il Scarica pulsante

Estrai il file JAR Quickstart dal file ZIP dell’SDK AEM

  1. Decomprimi il file scaricato aem-sdk-XXX.zip file

Configurare il servizio AEM Author locale

Il Servizio locale di authoring di AEM fornisce agli sviluppatori un’esperienza locale che gli autori di contenuti e marketer digitali condivideranno per creare e gestire i contenuti. AEM Author Service è progettato sia come ambiente di authoring che di anteprima e consente di eseguire la maggior parte delle convalide relative allo sviluppo di funzioni, rendendolo un elemento fondamentale del processo di sviluppo locale.

  1. Crea la cartella ~/aem-sdk/author

  2. Copia il JAR per avvio rapido file a ~/aem-sdk/author e rinominalo in aem-author-p4502.jar

  3. Avvia il servizio locale di authoring di AEM eseguendo quanto segue dalla riga di comando:

    • java -jar aem-author-p4502.jar
      • Fornisci la password dell’amministratore come admin. Qualsiasi password amministratore è accettabile, tuttavia si consiglia di utilizzare l'impostazione predefinita per lo sviluppo locale per ridurre la necessità di riconfigurare.

    You impossibile avvia il AEM come Jar Quickstart Cloud Service facendo doppio clic.

  4. Accedi al servizio locale di authoring di AEM all’indirizzo http://localhost:4502 in un browser Web

Windows:

$ 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

macOS / Linux:

$ 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

Configurare il servizio AEM Publish locale

Il servizio di pubblicazione AEM locale fornisce agli sviluppatori l’esperienza locale che gli utenti finali del AEM avranno, ad esempio la navigazione nel sito Web ospitato su AEM. Un servizio AEM Publish locale è importante in quanto si integra con AEM SDK Strumenti di Dispatcher e consente agli sviluppatori di fumare-test e di ottimizzare l'esperienza finale rivolta all'utente finale.

  1. Crea la cartella ~/aem-sdk/publish

  2. Copia il JAR per avvio rapido file a ~/aem-sdk/publish e rinominalo in aem-publish-p4503.jar

  3. Avvia il servizio AEM Publish locale eseguendo quanto segue dalla riga di comando:

    • java -jar aem-publish-p4503.jar
      • Fornisci la password dell’amministratore come admin. Qualsiasi password amministratore è accettabile, tuttavia si consiglia di utilizzare l'impostazione predefinita per lo sviluppo locale per ridurre la necessità di riconfigurare.

    You impossibile avvia il AEM come Jar Quickstart Cloud Service facendo doppio clic.

  4. Accedi al servizio AEM Publish locale all'indirizzo http://localhost:4503 in un browser Web

Windows:

$ 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

macOS / Linux:

$ 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

Simula distribuzione dei contenuti

In un ambiente di Cloud Service reale il contenuto viene distribuito da Author Service a Publish Service tramite Distribuzione dei contenuti Sling e la pipeline di Adobe. La Pipeline di Adobe è un microservizio isolato disponibile solo nell’ambiente cloud.

Durante lo sviluppo, può essere opportuno simulare la distribuzione dei contenuti utilizzando il servizio locale Author e Publish . Questo può essere ottenuto abilitando gli agenti di replica legacy.

NOTA

Gli agenti di replica sono disponibili solo per l’utilizzo nel JAR di Quickstart locale e forniscono solo una simulazione della distribuzione dei contenuti.

  1. Accedi a Autore assistenza e passa a http://localhost:4502/etc/replication/agents.author.html.

  2. Fai clic su Agente predefinito (pubblicazione) per aprire l'agente di replica predefinito.

  3. Fai clic su Modifica per aprire la configurazione dell'agente.

  4. Sotto la Impostazioni , aggiorna i campi seguenti:

    • Abilitato - verifica true
    • ID utente agente - Lascia vuoto questo campo

    Configurazione dell'agente di replica - Impostazioni

  5. Sotto la Trasporti , aggiorna i campi seguenti:

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

    Configurazione dell'agente di replica - Trasporto

  6. Fai clic su Ok per salvare la configurazione e abilitare il Predefinito Agente di replica.

  7. È ora possibile apportare modifiche al contenuto del servizio Author e pubblicarlo nel servizio Publish.

Pubblica pagina

Modalità di avvio di Jar Quickstart

Il nome del file JAR di Quickstart, aem-<tier>_<environment>-p<port number>.jar specifica come verrà avviato. Una volta AEM come avviato in un livello specifico, autore o pubblicazione, non può essere modificato nel livello alternativo. Per eseguire questa operazione, crx-Quickstart la cartella generata durante la prima esecuzione deve essere eliminata e Quickstart Jar deve essere eseguito di nuovo. L’ambiente e le porte possono essere modificate, tuttavia richiedono l’arresto/avvio dell’istanza AEM locale.

Modifica degli ambienti dev, stage e prod, può essere utile per gli sviluppatori per garantire che le configurazioni specifiche per l’ambiente siano definite correttamente e risolte da AEM. Si consiglia di eseguire lo sviluppo locale principalmente contro l'impostazione predefinita dev modalità di esecuzione dell'ambiente.

Le permutazioni disponibili sono le seguenti:

Nome file JAR di Quickstart Descrizione del modo
aem-author-p4502.jar Autore in modalità di esecuzione Dev sulla porta 4502
aem-author_dev-p4502.jar Come autore in modalità di esecuzione Dev sulla porta 4502 (come aem-author-p4502.jar)
aem-author_stage-p4502.jar Autore in modalità di esecuzione temporanea sulla porta 4502
aem-author_prod-p4502.jar Autore in modalità di esecuzione produzione sulla porta 4502
aem-publish-p4503.jar Come pubblicazione in modalità di esecuzione Dev sulla porta 4503
aem-publish_dev-p4503.jar Come Pubblica in modalità di esecuzione Dev sulla porta 4503 (come aem-publish-p4503.jar)
aem-publish_stage-p4503.jar Come pubblicare in modalità di esecuzione temporanea sulla porta 4503
aem-publish_prod-p4503.jar Come pubblicazione in modalità di esecuzione produzione sulla porta 4503

Tieni presente che il numero di porta può essere qualsiasi porta disponibile sulla macchina di sviluppo locale, tuttavia per convenzione:

  • Porta 4502 viene utilizzato per servizio locale di authoring di AEM
  • Porta 4503 viene utilizzato per servizio AEM Publish locale

La modifica di queste impostazioni potrebbe richiedere modifiche AEM configurazioni SDK

Arresto di un runtime AEM locale

Per arrestare un runtime di AEM locale, sia il servizio AEM Author che Publish, apri la finestra della riga di comando utilizzata per avviare il runtime di AEM e tocca Ctrl-C. Attendi AEM lo spegnimento. Al termine del processo di arresto, sarà disponibile il prompt della riga di comando.

Attività di configurazione del runtime di AEM locale opzionali

Quando aggiornare Quickstart Jar

Aggiorna l'SDK AEM almeno mensilmente l'ultimo giovedì di ogni mese, o poco dopo, che è la frequenza di rilascio per AEM "release di funzioni" as a Cloud Service.

AVVERTENZA

L’aggiornamento del Jar Quickstart a una nuova versione richiede la sostituzione dell’intero ambiente di sviluppo locale, con la conseguente perdita di tutto il codice, la configurazione e il contenuto negli archivi AEM locali. Assicurati che qualsiasi codice, configurazione o contenuto che non deve essere distrutto sia correttamente impegnato in Git o esportato dall'istanza AEM locale come Pacchetti AEM.

Come evitare la perdita di contenuto durante l'aggiornamento dell'SDK AEM

L’aggiornamento dell’SDK di AEM sta creando in modo efficace un nuovo runtime AEM, incluso un nuovo archivio, il che significa che tutte le modifiche apportate all’archivio di un SDK di AEM precedente andranno perse. Le seguenti sono strategie valide per aiutare a mantenere i contenuti tra gli aggiornamenti dell’SDK AEM e possono essere utilizzate in modo discreto o di concerto:

  1. Crea un pacchetto di contenuti dedicato a contenere contenuti di "esempio" per facilitarne lo sviluppo e mantenilo in Git. I contenuti che devono essere mantenuti tramite AEM aggiornamenti SDK verranno memorizzati in questo pacchetto e ridistribuiti dopo l'aggiornamento dell'SDK AEM.
  2. Utilizzo oak-upgrade con includepaths , per copiare il contenuto dall'archivio SDK AEM precedente al nuovo archivio SDK AEM.
  3. Esegui il backup di qualsiasi contenuto utilizzando AEM Package Manager e i pacchetti di contenuto nell’SDK AEM precedente e reinstallali nel nuovo SDK AEM.

Ricorda che l’utilizzo degli approcci di cui sopra per mantenere il codice tra AEM aggiornamenti dell’SDK indica un pattern di sviluppo non conforme. Il codice non usa e getta deve originarsi nell'IDE di sviluppo e fluire nell'SDK AEM tramite implementazioni.

Risoluzione dei problemi

Facendo doppio clic sul file Jar Quickstart si verifica un errore

Quando fai doppio clic sul Jar Quickstart per avviare, viene visualizzato un modale di errore che impedisce l’avvio locale di AEM.

Risoluzione dei problemi - Fai doppio clic sul file Jar Quickstart

Questo perché AEM Jar Quickstart as a Cloud Service non supporta il doppio clic del Jar Quickstart per iniziare a AEM localmente. Devi invece eseguire il file Jar da quella riga di comando.

Per avviare il servizio AEM Author, cd nella directory contenente il file JAR di Quickstart ed esegui il comando:

$ java -jar aem-author-p4502.jar

o, per avviare il servizio AEM Publish, cd nella directory contenente il file JAR di Quickstart ed esegui il comando:

$ java -jar aem-publish-p4503.jar

L'avvio del Jar Quickstart dalla riga di comando interrompe immediatamente

Quando si avvia il file JAR Quickstart dalla riga di comando, il processo si interrompe immediatamente e il servizio AEM non si avvia, con il seguente errore:

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

Questo perché AEM as a Cloud Service richiede Java SDK 11 e stai eseguendo una versione diversa, molto probabilmente Java 8. Per risolvere il problema, scaricare e installare Oracle Java SDK 11.
Una volta installato Java SDK 11, verifica che sia la versione attiva eseguendo quanto segue dalla riga di comando.

Una volta installato Java 11 SDK, verifica che sia la versione attiva eseguendo il comando dalla riga di comando:

  • Windows: java -version
  • macOS / Linux: java --version

Risorse aggiuntive

In questa pagina