Documentazione AEM as a Cloud Service Guida utente

Canale prerelease Adobe Experience Manager as a Cloud Service prerelease-channel

Last update: Tue Sep 05 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Scopri come utilizzare il canale prerelease per ottenere un’anteprima delle prossime funzionalità su AEM as a Cloud Service.

Introduzione introduction

Adobe Experience Manager as a Cloud Service offre nuove funzionalità su cadenza mensile, secondo la road map di versioni di Experience Manager.

Per acquisire familiarità con le funzionalità programmate per essere pubblicate nella prossima versione funzionale, puoi abbonarti al canale prerelease, che è accessibile configurando gli ambienti di sviluppo o qualsiasi ambiente sandbox. Puoi visualizzare in anteprima le modifiche accessibili tramite l’interfaccia utente di AEM e generare il codice rispetto a qualsiasi nuova API prerelease.

L’elenco delle funzioni prerelease per una data funzione è pubblicato all’interno delle note sulla versione.

Versioni di AEM as a Cloud Service releases

AEM as a Cloud Service dispone di due tipi di versioni.

Una volta attivate, le versioni funzionali aggiungono funzionalità ad AEM as a Cloud Service
Le versioni di manutenzione aggiungono aggiornamenti di sicurezza, miglioramenti delle prestazioni e correzioni di bug e vengono applicate su base periodica e frequente.

Questo modello garantisce versioni continue senza interruzioni del servizio.

Il canale prerelease consente di visualizzare in anteprima le funzioni pianificate per la prossima versione funzionale, per poter valutare le funzionalità in arrivo e pianificare la loro eventuale implementazione per i progetti. Consente di pianificare in anticipo la prossima versione funzionale.

Ad esempio, se siamo nel mese di maggio e sei abbonato al canale prerelease, puoi valutare le funzionalità della prossima versione di giugno.

Grafico a cadenza prerelease

La versione 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 e di pianificare l’implementazione di tali funzioni, test e formazione per gli utenti.

Sfruttare efficacemente il canale prerelease richiede quattro passaggi.

Contrassegnare i calendari
Consultare le note sulla versione
Accedere e provare le nuove funzioni
Formare gli utenti

Contrassegnare i calendari mark-calendars

Le versioni funzionali sono pianificate con largo anticipo e le rispettive date di attivazione sono pubblicate su Adobe Experience League.

Prendi nota delle date di rilascio per pianificare il tempo necessario per rivedere e testare le prossime funzioni.

Consultare le note sulla versione release-notes

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.

Abilitare il canale prerelease per accedere e provare nuove funzioni new-features

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:

Ambienti cloud
SDK locale

Ambienti cloud cloud-environments

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.

Aggiungere una variabile di ambiente utilizzando l’interfaccia utente add-with-ui

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:

table 0-row-4 1-row-4
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.

Aggiungi una variabile di ambiente utilizzando CLI add-with-cli

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_CHANNELvariabile di ambiente al valore prerelease.

code language-text
`PATCH /program/{programId}/environment/{environmentId}/variables [ { "name" : "AEM_RELEASE_CHANNEL", "value" : "prerelease", "type" : "string" } ]`

Può essere utilizzato anche CLI di Cloud Manager

code language-shell
`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).

SDK locale local-sdk

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.

Avviare l’SDK di Quickstart in modalità prerelease prerelease-mode

Scarica l’SDK dal portale di distribuzione del software e installalo come descritto in Accesso a SDK AEM as a Cloud Service.
Quando avvii l’SDK Quickstart, includi l’argomento -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.

Generare in base all’SDK della versione prerelease build-sdk

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:

code language-none
`<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:

code language-none
`<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:

code language-none

code language-none
`<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>`

<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.

CAUTION

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.

Formazione degli utenti train-users

Dopo aver testato le nuove funzioni nel canale prerelease e aver deciso di utilizzarle nei progetti, è necessario formare gli utenti.

Adobe Experience League offre molte risorse per imparare AEMaaCS.

Documentazione di AEMaaCS
Esercitazioni
Video introduttivo sulle versioni mensili nelle note sulla versione

Considerazioni considerations

Ci sono alcuni elementi da notare quando si utilizza il canale prerelease.

Il canale prerelease non contiene necessariamente tutte le nuove funzioni da distribuire nella versione successiva.
Le funzioni della versione prerelease sono garantite da una qualità elevata e sono state progettate per essere complete piuttosto che per la qualità beta. Se noti eventuali problemi, segnalali, come faresti se sospettassi bug nelle funzioni in una versione AEM regolare.
Per determinare se un ambiente è configurato per il canale prerelease, vai alla pagina Informazioni della console AEM e controlla se il numero di versione AEM include un suffisso prerelease come Adobe Experience Manager 2021.4.5226.20210427T070726Z-210429-PRERELEASE.

Informazioni su

recommendation-more-help

fbcff2a9-b6fe-4574-b04a-21e75df764ab