L’SDK AEM as a Cloud Service

L’SDK dell’AEM as a Cloud Service è costituito dai seguenti artefatti:

  • Jar Quickstart - Il runtime AEM utilizzato per lo sviluppo locale
  • Java API Jar - La dipendenza Java Jar/Maven che espone tutte le API Java consentite che possono essere utilizzate per sviluppare contro l’AEM come Cloud Service. Precedentemente denominato Uberjar
  • Jar Javadoc - Java per Java API Jar
  • Strumenti di Dispatcher : set di strumenti utilizzati per sviluppare a livello locale rispetto a Dispatcher. Separa gli artefatti per unix e windows

Inoltre, alcuni clienti che sono stati distribuiti in precedenza con AEM 6.5 o versioni precedenti utilizzeranno gli artefatti riportati di seguito. Se la compilazione locale non funziona con Quickstart Jar e pensi che sia dovuta a interfacce che sono state rimosse da AEM implementato as a Cloud Service, contatta l’Assistenza clienti per determinare se è necessario l’accesso. Questo richiederà modifiche nel backend.

  • Jar API Java 6.5 obsoleto - una serie aggiuntiva di interfacce che sono state rimosse dopo l'AEM 6.5
  • Jar Javadoc Obsoleto 6.5 - JavaScript per il set aggiuntivo di interfacce

Creazione per l’SDK

L’SDK as a Cloud Service dall’AEM viene utilizzato per generare e distribuire il codice personalizzato. Per maggiori dettagli, fare riferimento a Documentazione di Archetipo progetto AEM. Ad alto livello, vengono eseguiti i seguenti passaggi:

  • Compila codice. Come previsto, il codice sorgente viene compilato, generando i pacchetti di contenuti risultanti
  • Creare artefatti. Gli artefatti vengono generati durante questo processo
  • Analizzare i bundle. I bundle vengono analizzati utilizzando il plug-in Maven Analyzer, che cerca problemi nel progetto Maven, come dipendenze mancanti
  • Distribuire gli artefatti. Gli artefatti vengono distribuiti nel server locale.

Gli stessi passaggi vengono eseguiti da Cloud Manager durante la distribuzione in ambienti Cloud. L’esecuzione locale delle build consente lo sviluppo e i test locali, in modo che gli sviluppatori possano individuare in modo efficiente i problemi di codice o strutturali ben prima di passare al controllo del codice sorgente e attivare le distribuzioni di Cloud Manager, che possono richiedere più tempo.

Accesso all’SDK as a Cloud Service per l’AEM

  • Puoi controllare l’Admin Console dell’AEM Informazioni su Adobe Experience Manager per individuare la versione di AEM in esecuzione in produzione.
  • Il file jar quickstart e gli strumenti di Dispatcher possono essere scaricati come file zip dal file Portale di distribuzione software. L’accesso agli elenchi dell’SDK è limitato a quelli con ambienti AEM Managed Services o AEM as a Cloud Service.
  • Il file JAR dell’API Java e il file JAR di Java possono essere scaricati tramite gli strumenti maven, tramite la riga di comando o con l’IDE preferito.
  • Le pom del progetto Maven devono fare riferimento al seguente pacchetto API Jar. Questa dipendenza deve essere indicata anche in qualsiasi pacchetto secondario pom.
<dependency>
  <groupId>com.adobe.aem</groupId>
  <artifactId>aem-sdk-api</artifactId>
  <version>2019.11.3006.20191108T223635Z-191201</version>
  <scope>provided</scope>
</dependency>
NOTA

La voce di versione per l’SDK deve corrispondere alla versione dell’AEM as a Cloud Service. Per vedere quale versione stai utilizzando, accedi all’AEM, quindi vai al punto interrogativo nell’angolo in alto a destra dello schermo e seleziona Informazioni su Adobe Experience Manager

Aggiornamento di un progetto locale con una nuova versione SDK

Quando è consigliabile aggiornare il progetto locale con un nuovo SDK?

È consigliato per aggiornarla almeno dopo una versione di manutenzione mensile.

È facoltativo per aggiornarla dopo qualsiasi versione di manutenzione giornaliera. I clienti verranno informati quando la loro istanza di produzione verrà aggiornata correttamente a una nuova versione AEM. Per le versioni di manutenzione giornaliere, non ci si aspetta che il nuovo SDK sia cambiato in modo significativo, se non del tutto. Tuttavia, si consiglia di aggiornare occasionalmente l’ambiente di sviluppo AEM locale con l’SDK più recente, quindi di ricreare e testare l’applicazione personalizzata. La versione di manutenzione mensile in genere include modifiche di maggiore impatto e pertanto gli sviluppatori devono immediatamente aggiornare, ricreare e testare.

Di seguito è riportata la procedura consigliata per l’aggiornamento di un ambiente locale:

  1. Assicurati che qualsiasi contenuto utile sia confermato nel progetto nel controllo del codice sorgente o disponibile in un pacchetto di contenuto mutabile per un’importazione successiva
  2. Il contenuto dei test di sviluppo locale deve essere archiviato separatamente in modo che non venga distribuito come parte della build della pipeline di Cloud Manager. Questo perché deve essere utilizzato solo per lo sviluppo locale
  3. Arresta avvio rapido in esecuzione
  4. Sposta il crx-quickstart cartella in un'altra cartella per la conservazione sicura
  5. Nota la nuova versione dell’AEM, riportata in Cloud Manager (verrà utilizzata per identificare la nuova versione di QuickStart Jar per scaricarla ulteriormente in)
  6. Scarica il file JAR QuickStart la cui versione corrisponde alla versione Production AEM dal portale di distribuzione software
  7. Crea una nuova cartella e inserisci il nuovo file JAR QuickStart
  8. Avviare il nuovo QuickStart con le modalità di esecuzione desiderate (rinominando il file o passando in modalità di esecuzione tramite -r).
    • Assicurati che nella cartella non sia presente alcun resto del vecchio modulo quickstart.
  9. Creare l’applicazione AEM
  10. Implementare l’applicazione AEM nell’AEM locale tramite PackageManager
  11. Installare tutti i pacchetti di contenuti mutabili necessari per il test dell’ambiente locale tramite PackageManager
  12. Continua lo sviluppo e implementa le modifiche necessarie

Se è necessario installare un contenuto con ogni nuova versione di avvio rapido per AEM, includerlo in un pacchetto di contenuti e nel controllo del codice sorgente del progetto. Quindi, installarlo ogni volta.

Si consiglia di aggiornare frequentemente l’SDK (ad esempio ogni due settimane) ed eliminare tutti i giorni lo stato locale in modo che non dipenda accidentalmente dai dati di stato nell’applicazione.

Nel caso in cui si dipenda da CryptoSupport (configurando le credenziali di Cloud Services o del servizio di posta SMTP in AEM oppure utilizzando l’API CryptoSupport nell’applicazione), le proprietà crittografate verranno crittografate da una chiave generata automaticamente al primo avvio di un ambiente AEM. Mentre cloudsetup si occupa di riutilizzare automaticamente la CryptoKey specifica per l’ambiente, è necessario inserire la crittografia nell’ambiente di sviluppo locale.

Per impostazione predefinita, l’AEM è configurato per memorizzare i dati chiave nella cartella dati di una cartella, ma per facilitare il riutilizzo in fase di sviluppo, il processo AEM può essere inizializzato al primo avvio con "-Dcom.adobe.granite.crypto.file.disable=true". I dati di crittografia verranno generati in "/etc/key".

Per poter riutilizzare i pacchetti di contenuto contenenti i valori crittografati, è necessario seguire questi passaggi:

  • Quando avvii inizialmente il file quickstart.jar locale, assicurati di aggiungere il seguente parametro: "-Dcom.adobe.granite.crypto.file.disable=true". Si consiglia, ma facoltativo, di aggiungerlo sempre.
  • La prima volta che hai avviato un’istanza, crea un pacchetto contenente un filtro per la radice "/etc/key". Questo conterrà il segreto da riutilizzare in tutti gli ambienti per i quali desideri che vengano riutilizzati
  • Esporta eventuali contenuti modificabili contenenti segreti o cerca i valori crittografati tramite /crx/de per aggiungerlo al pacchetto che verrà riutilizzato nelle diverse installazioni
  • Ogni volta che crei una nuova istanza (per sostituirla con una nuova versione o poiché più ambienti di sviluppo devono condividere le credenziali per il test), installa il pacchetto prodotto nei passaggi 2 e 3 per poter riutilizzare il contenuto senza dover riconfigurare manualmente. Questo perché ora la crittografia è sincronizzata.

In questa pagina