Show Menu
ARGOMENTI×

The AEM as a Cloud Service SDK

L’AEM come SDK per Cloud Service è composta 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 lo sviluppo rispetto a AEM come Cloud Service. Precedentemente denominato Uberjar
  • Javadoc Jar - I javadocs per Java API Jar
  • Strumenti Dispatcher - Set di strumenti utilizzati per lo sviluppo locale contro il Dispatcher. Artefatti separati per unix e finestre
Inoltre, alcuni clienti che erano stati precedentemente distribuiti con AEM 6.5 o versioni precedenti utilizzeranno gli artifact riportati di seguito. Se la compilazione locale non funziona con l'archivio di avvio rapido e si sospetta che sia dovuta a interfacce rimosse dall'AEM distribuito come Cloud Service, contattare l'Assistenza clienti per determinare se è necessario accedere. Ciò richiederà modifiche nel backend.
  • 6.5 Jar API Java obsoleto - un set aggiuntivo di interfacciati rimosso dalla AEM 6.5
  • 6.5 Javadoc Jar obsoleto - i Javadocs per il set aggiuntivo di interfacciati

Accessing the AEM as a Cloud Service SDK

  • Potete controllare l'icona AEM Admin Console Informazioni su Adobe Experience Manager per scoprire la versione di AEM in esecuzione in produzione.
  • Gli strumenti di avvio rapido e Dispatcher possono essere scaricati come file ZIP dal portale di distribuzione software. L'accesso agli elenchi dell'SDK è limitato a quelli con AEM Managed Services o AEM come ambienti di Cloud Service.
  • Java API Jar e Javadoc Jar possono essere scaricati tramite gli strumenti maven, sia dalla riga di comando che con l'IDE preferito.
  • I promotori del progetto maven devono fare riferimento al seguente pacchetto API Jar. È inoltre necessario fare riferimento a questa dipendenza in qualsiasi sottomodulo.
<dependency>
  <groupId>com.adobe.aem</groupId>
  <artifactId>aem-sdk-api</artifactId>
  <version>2019.11.3006.20191108T223635Z-191201</version>
  <scope>provided</scope>
</dependency>

La voce della versione per l’SDK deve corrispondere alla versione di AEM come Cloud Service. Per visualizzare la versione in uso, effettuate l’accesso al AEM, quindi selezionate il punto interrogativo nell’angolo in alto a destra della schermata e selezionate Informazioni su Adobe Experience Manager

Aggiornamento di un progetto locale con una nuova versione SDK

Quando si consiglia di aggiornare il progetto locale con un nuovo SDK?
È consigliabile aggiornarlo almeno dopo una versione di manutenzione mensile.
È facoltativo aggiornarlo dopo qualsiasi rilascio giornaliero di manutenzione. I clienti verranno informati quando la loro istanza di produzione verrà aggiornata a una nuova versione AEM. Per le versioni di manutenzione giornaliera, non è previsto che il nuovo SDK sarà cambiato in modo significativo, se del caso. Tuttavia, si consiglia di aggiornare occasionalmente l'ambiente locale AEM sviluppatore con l'SDK più recente, quindi di rigenerare e testare l'applicazione personalizzata. La versione di manutenzione mensile in genere include modifiche di maggiore impatto e pertanto gli sviluppatori dovrebbero aggiornare, ricreare e testare immediatamente.
Di seguito è riportata la procedura consigliata per l'aggiornamento di un ambiente locale:
  1. Verificate che eventuali contenuti utili siano impegnati nel progetto nel controllo del codice sorgente o siano disponibili in un pacchetto di contenuti modificabile per un'importazione successiva
  2. Il contenuto del test di sviluppo locale deve essere memorizzato 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. Interrompi Avvio rapido in esecuzione
  4. Spostate la crx-quickstart cartella in un'altra cartella per mantenerla sicura
  5. Prendete nota della nuova versione AEM, nota in Cloud Manager (che verrà utilizzata per identificare la nuova versione di QuickStart Jar da scaricare ulteriormente in seguito)
  6. Scaricate il JAR di QuickStart la cui versione corrisponde alla versione di Production AEM dal portale di distribuzione del software
  7. Create una nuova cartella e inserite il nuovo QuickStart Jar all'interno
  8. Avviate la nuova Avvio rapido con le modalità di esecuzione desiderate (rinominando il file o passando le modalità di esecuzione tramite -r ).
    • Accertatevi che nella cartella non rimangano altri collegamenti di avvio rapido.
  9. Creare l'applicazione AEM
  10. Distribuzione dell'applicazione AEM a AEM locale tramite PackageManager
  11. Installate tutti i pacchetti di contenuto modificabile necessari per il test dell'ambiente locale tramite PackageManager
  12. Proseguire lo sviluppo e distribuire le modifiche in base alle esigenze
Se è presente del contenuto che deve essere installato con ogni nuova AEM versione di QuickStart, includetelo in un pacchetto di contenuto e nel controllo del sorgente del progetto. Quindi, installatelo ogni volta.
È consigliabile aggiornare frequentemente l'SDK (ad esempio, due volte alla settimana) e smaltire giornalmente lo stato locale completo in modo che non dipenda accidentalmente dai dati sullo stato dell'applicazione.
Nel caso in cui si dipenda da CryptoSupport ( sia configurando le credenziali di Cloudservices che il servizio di posta SMTP in AEM o utilizzando l'API CryptoSupport nella vostra applicazione ), le proprietà crittografate saranno crittografate da una chiave generata automaticamente al primo avvio di un ambiente AEM. Mentre la configurazione del cloud si occupa di riutilizzare automaticamente la CryptoKey specifica per l'ambiente, è necessario inserire la chiave di crittografia nell'ambiente di sviluppo locale.
Per impostazione predefinita AEM è configurato per memorizzare i dati chiave nella cartella di dati di una cartella, ma per semplificare il riutilizzo in fase di sviluppo, il processo di AEM può essere inizializzato al primo avvio con " -Dcom.adobe.granite.crypto.file.disable=true ". In questo modo i dati di crittografia verranno generati in " /etc/key ".
Per poter riutilizzare i pacchetti di contenuto contenenti i valori crittografati, è necessario eseguire la procedura seguente:
  • Quando avviate inizialmente quickstart.jar locale, accertatevi di aggiungere il parametro seguente: " -Dcom.adobe.granite.crypto.file.disable=true ". È consigliabile, ma facoltativo, aggiungerlo sempre.
  • La prima volta che avete avviato un'istanza create un pacchetto contenente un filtro per la radice " /etc/key ". Questo manterrà il segreto per essere riutilizzato in tutti gli ambienti per i quali si desidera che vengano riutilizzati
  • Esportate eventuale contenuto modificabile contenente segreti o cercate i valori crittografati tramite /crx/de per aggiungerlo al pacchetto che verrà riutilizzato tra le installazioni
  • Ogni volta che eseguite il spin up di una nuova istanza (per sostituire una nuova versione o in quanto più ambienti di sviluppo dovrebbero condividere le credenziali per il test), installate il pacchetto prodotto nei passaggi 2 e 3 per poter riutilizzare il contenuto senza dover riconfigurare manualmente. Questo perché ora la crittografia è sincronizzata.