Scopri come utilizzare il canale prerelease per ottenere un’anteprima delle prossime funzionalità su AEM as a Cloud Service.
Adobe Experience Manager as a Cloud Service offre nuove funzionalità su cadenza regolare, secondo Roadmap dei rilasci di Experience Manager.
Per acquisire familiarità con le funzioni pianificate per la pubblicazione della seguente versione delle funzioni, puoi abbonarti al canale prerelease, accessibile configurando gli ambienti di sviluppo o qualsiasi ambiente sandbox. Puoi visualizzare in anteprima le modifiche accessibili tramite l’interfaccia utente AEM e generare codice rispetto a qualsiasi nuova API prerelease.
L’elenco delle funzioni prerelease per una determinata versione di funzioni è pubblicato all’interno di note sulla versione.
AEM as a Cloud Service dispone di due tipi di versioni.
Questo modello garantisce versioni continue senza interruzioni del servizio.
Il canale prerelease consente di visualizzare in anteprima le funzioni pianificate per la prossima versione delle funzioni, al fine di valutare le funzionalità in arrivo e pianificare la sua eventuale implementazione per i progetti personalizzati. Consente di pianificare in anticipo la prossima versione delle funzioni.
Ad esempio, se è maggio e sei abbonato al canale prerelease, puoi valutare le funzioni della prossima versione di giugno.
Prerelease offre una finestra di un mese sulle prossime funzionalità di AEMaaCS, che ti offre il tempo di valutare l’impatto di eventuali nuove funzioni sui tuoi progetti e personalizzazioni, oltre a pianificare l’implementazione di tali funzioni, test e formazione per gli utenti.
Sfruttare efficacemente il canale prerelease richiede quattro passaggi.
Le versioni con funzioni sono pianificate con largo anticipo e le date di attivazione della funzione vengono pubblicate il giorno Adobe Experience League.
Prendi nota delle date di rilascio per pianificare il tempo necessario per rivedere e testare le prossime funzioni.
Una volta che le date di rilascio sono contrassegnate nel calendario, assicurati di controllare Adobe Experience League il giorno del rilascio per le ultime note sulla versione.
A ogni versione sono associate note sulla versione che documentano non solo le novità di quella versione, ma anche le funzioni disponibili per la valutazione prerelease. Acquisisci in tempo utile e pianifica di sfruttare le funzioni più recenti di AEMaaCS!
È inoltre possibile verificare i problemi noti che vengono pubblicati insieme a ogni versione, in modo da essere consapevoli di eventuali problemi tecnici che possono rappresentare una sfida per la valutazione o l’eventuale adozione di nuove funzioni.
Il canale prerelease può essere abilitato su qualsiasi ambiente di sviluppo o sandbox. Non è possibile abilitare la versione prerelease negli ambienti di staging o produzione.
Le funzioni prerelease possono essere utilizzate in diversi modi:
Per aggiornare un ambiente cloud per utilizzare la versione prerelease, devi aggiungere una nuova variabile di ambiente. Puoi eseguire questa operazione utilizzando l’interfaccia utente di Cloud Manager o tramite CLI.
Accedi a Cloud Manager all’indirizzo my.cloudmanager.adobe.com e seleziona l’organizzazione appropriata.
Passa al programma in cui desideri abilitare la prerelease.
Seleziona l’ambiente in cui desideri abilitare la prerelease e accedi alla relativa configurazione tramite Programma > Ambiente > Configurazione dell’ambiente.
Aggiungi una nuova variabile di ambiente:
Nome | Valore | Servizio applicato | Tipo |
---|---|---|---|
AEM_RELEASE_CHANNEL |
prerelease |
Tutti i bundle | Variabile |
Salva le modifiche; l’ambiente verrà aggiornato con le funzioni prerelease attivate.
In alternativa puoi utilizzare l’API di Cloud Manager e la CLI per aggiornare le variabili di ambiente.
Utilizzando l’Endpoint per le variabili di ambiente dell’API di Cloud Manager, imposta la AEM_RELEASE_CHANNEL
variabile di ambiente al valore prerelease
.
PATCH /program/{programId}/environment/{environmentId}/variables
[
{
"name" : "AEM_RELEASE_CHANNEL",
"value" : "prerelease",
"type" : "string"
}
]
Può essere utilizzato anche CLI di Cloud Manager
aio cloudmanager:environment:set-variables <ENVIRONMENT_ID> --programId=<PROGRAM_ID> --variable AEM_RELEASE_CHANNEL “prerelease
La variabile può essere eliminata o impostata su un valore diverso se desideri che l’ambiente venga ripristinato al comportamento del canale regolare (non prerelease).
Puoi visualizzare le nuove funzioni nella console Sites nell’SDK Quickstart locale e il codice relativo alle nuove API nella versione prerelease facendo riferimento al progetto Maven nella versione prerelease API Jar
situato in Maven Central. Puoi visualizzare queste funzioni prerelease anche nell'ambiente locale avviando il normale SDK Quickstart in modalità prerelease.
-r prerelease
.Il valore è permanente quindi può essere selezionato solo al primo avvio. Reinstalla l’SDK per modificare l’opzione della riga di comando.
Poiché possono esservi più versioni di manutenzione AEM tra le versioni delle rilasci mensili, puoi scaricare questi nuovi SDK e fare riferimento alle nuove versioni SDK Jar nei progetti Maven. Le versioni di manutenzione non aggiungeranno ulteriori funzionalità prerelease, ma potrebbero includere altre modifiche minori, come correzioni di bug, correzioni di sicurezza e miglioramenti delle prestazioni.
Gli Javadoc vengono pubblicati in Maven Central.
Modifica il pom.xml
del progetto maven per fare riferimento a un jar api sdk prerelease distinto, pubblicato su Maven Central. Contiene eventuali nuove api Java per le funzionalità prerelease e ha una dipendenza dal jar dell’api SDK. Usa la stessa versione.
Come esempio, di seguito è riportato uno snippet dalla sezione gestione delle dipendenze del pom principale che fa riferimento al Jar API regolare:
<dependencyManagement>
<dependencies>
<dependency>
<groupId>com.adobe.aem</groupId>
<artifactId>aem-sdk-api</artifactId>
<version>${aem.sdk.api}</version>
<scope>provided</scope>
</dependency>
E quindi l’utilizzo in un modulo:
<dependencies>
<dependency>
<groupId>com.adobe.aem</groupId>
<artifactId>aem-sdk-api</artifactId>
</dependency>
Per passare all’SDK della versione prerelease, è sufficiente modificare la dipendenza da com.adobe.aem:aem-sdk-api
a com.adobe.aem:aem-prerelease-sdk-api
come indicato di seguito:
<dependencyManagement>
<dependencies>
<dependency>
<groupId>com.adobe.aem</groupId>
<artifactId>aem-prerelease-sdk-api</artifactId>
<version>${aem.sdk.api}</version>
<scope>provided</scope>
</dependency>
<dependencies>
<dependency>
<groupId>com.adobe.aem</groupId>
<artifactId>aem-prerelease-sdk-api</artifactId>
</dependency>
Come di consueto, i singoli progetti possono utilizzare la dipendenza.
Distribuire sul server locale.
Se si è certi che funziona come previsto localmente, invia il codice a un ramo di sviluppo e utilizza una pipeline di non produzione di Cloud Manager per l’implementazione in un ambiente che si abbona al canale prerelease.
L’ArtifactId aem-prerelease-sdk-api
non deve mai essere utilizzato quando si distribuisce in staging o produzione. Utilizza sempre aem-sdk-api
quando distribuisci tramite la pipeline di produzione. Allo stesso modo, il codice che fa riferimento alle API prerelease non deve essere distribuito tramite la pipeline di produzione.
Il plug-in maven di AEM CS SDK build Analyzer v1.0 e versioni successive rileva se l’api prerelease è utilizzata in un progetto controllando le dipendenze. Se l’analizzatore ne trova, utilizza l’API SDK prerelease per analizzare il progetto.
Dopo aver testato le nuove funzioni nel canale prerelease e aver deciso di sfruttarle nei progetti, devi formare gli utenti.
Adobe Experience League offre molte risorse per imparare AEMaaCS.
Ci sono alcuni elementi da notare quando si utilizza il canale prerelease.
Adobe Experience Manager 2021.4.5226.20210427T070726Z-210429-PRERELEASE
.