Adobe Experience Manager canal de version prédéfinie du Cloud Service

Présentation

Adobe Experience Manager as a Cloud Service offre de nouvelles fonctionnalités à une cadence mensuelle, conformément au planning des versions de Experience Manager. Pour vous familiariser avec les fonctionnalités programmées pour le mois suivant, les clients peuvent s’abonner au canal de version préliminaire, accessible en configurant de manière appropriée dans des environnements de développement de programme standard ou dans tout environnement de programme de test. Les clients peuvent prévisualiser les modifications apportées à la console Sites, ainsi que créer du code par rapport à toute nouvelle API de version préliminaire.

La liste des fonctionnalités de version préliminaire pour un mois donné est publiée dans les notes de mise à jour mensuelles.

Comment activer la version préliminaire

Les fonctionnalités de la version préliminaire peuvent être expérimentées de différentes manières :

  • Environnements cloud (environnements de développement de programme standard ou tout type d’environnement de programme sandbox)
  • SDK local

Environnements cloud

Pour afficher les nouvelles fonctionnalités de la console Sites dans les environnements de développement cloud, ainsi que le résultat de toute personnalisation de projet :

  • À l’aide du point de terminaison 🔗 des variables d’environnement de l’API Cloud Manager, définissez la variable d’environnement AEM_RELEASE_CHANNEL sur la valeur prerelrelease.
PATCH /program/{programId}/environment/{environmentId}/variables
[
        {
                "name" : "AEM_RELEASE_CHANNEL",
                "value" : "prerelease",
                "type" : "string"
        }
]

L’interface de ligne de commande de Cloud Manager peut également être utilisée, conformément aux instructions à l’adresse https://github.com/adobe/aio-cli-plugin-cloudmanager#aio-cloudmanagerset-environment-variables-environmentid
aio cloudmanager:environment:set-variables <ENVIRONMENT_ID> --programId=<PROGRAM_ID> --variable AEM_RELEASE_CHANNEL “prerelease”

La variable peut être supprimée ou redéfinie sur une autre valeur si vous souhaitez que l’environnement soit restauré avec le comportement du canal normal (hors version préliminaire).

SDK local

Vous pouvez voir les nouvelles fonctionnalités dans la console Sites dans le SDK Quickstart local et le code par rapport aux nouvelles API dans la version préliminaire en demandant à votre projet Maven de référencer la version préliminaire API Jar située dans Maven Central. Vous pouvez également voir ces fonctionnalités de version préliminaire sur votre ordinateur local en démarrant le SDK Quickstart standard en mode bêta :

  • Téléchargez le SDK à partir du portail de distribution de logiciels et procédez à l’installation comme décrit dans la section Accès à l’AEM en tant que SDK Cloud Service
  • Lors du lancement du démarrage rapide du SDK, incluez l’argument -r prerelease.
  • La valeur est sticky. Elle ne peut donc être sélectionnée que lors du premier démarrage. Réinstallez le SDK pour modifier l’option de ligne de commande.

Comme il peut y avoir plusieurs versions de maintenance AEM entre les versions mensuelles des fonctionnalités, vous pouvez télécharger ces nouveaux SDK et référencer les nouvelles versions du SDK API Jar dans les projets Maven. Les versions de maintenance n’ajouteront pas de fonctionnalités de version préliminaire supplémentaires, mais pourraient inclure d’autres modifications plus petites telles que des correctifs de bogues, des correctifs de sécurité et des améliorations de performances.
Les JavaDocs sont publiés sur Maven Central.

Pour créer à partir du SDK de version préliminaire :

  1. modifiez le fichier pom.xml de votre projet maven pour référencer un fichier jar api du sdk de version préliminaire distinct, qui est publié sur Maven central. Contient toute nouvelle api Java pour les fonctionnalités de la version préliminaire et a une dépendance sur le jar de l’api du sdk. Il utilise la même version.

    À titre d’exemple, voici un extrait de code de la section de gestion des dépendances du modèle pom parent faisant référence au fichier Jar d’API classique :

    <dependencyManagement>
     <dependencies>
         <dependency>
             <groupId>com.adobe.aem</groupId>
             <artifactId>aem-sdk-api</artifactId>
             <version>${aem.sdk.api}</version>
             <scope>provided</scope>
         </dependency>
    

    Puis l’utilisation dans un module :

     <dependencies>
      <dependency>
          <groupId>com.adobe.aem</groupId>
          <artifactId>aem-sdk-api</artifactId>
      </dependency>
    

    Pour passer au SDK de la version préliminaire, remplacez simplement la dépendance de com.adobe.aem:aem-sdk-api par com.adobe.aem:aem-prerelease-sdk-api comme indiqué ci-dessous :

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

    Comme d’habitude, les projets individuels peuvent utiliser la dépendance.

  2. Déployer sur votre serveur local

  3. Si vous êtes satisfait de son fonctionnement local, validez le code d’une branche de développement et utilisez un pipeline hors production Cloud Manager pour le déploiement dans un environnement qui s’abonne au canal de version préliminaire.

ATTENTION

L’aem-prerelease-sdk-api artifactId ne doit jamais être utilisé lors d’un déploiement dans l’environnement intermédiaire ou de production. Utilisez toujours aem-sdk-api lors d’un déploiement via le pipeline de production. De même, les API de version préliminaire de référencement de code ne doivent pas être déployées via le pipeline de production.

Le module externe maven Analyzer de build du SDK CS AEM version 1.0 et ultérieure détectera si l’api de version préliminaire est utilisée dans un projet en examinant les dépendances. Si l’analyseur le trouve, il utilisera l’api sdk de version préliminaire pour analyser le projet.

Considérations

Il y a quelques points à noter concernant le canal bêta :

  • Certaines fonctionnalités qui seront déployées dans la version du mois suivant peuvent ne pas être incluses dans le canal de version préliminaire.
  • Les fonctionnalités de la version préliminaire sont soumises à un contrôle qualité rigoureux et sont conçues pour être complètes plutôt que bêta. Si vous constatez des problèmes, signalez-les, comme vous le feriez si vous suspectez des bogues dans des fonctionnalités d’une version d’AEM régulière.
  • Pour déterminer si un environnement est configuré pour le canal de version préliminaire, accédez à la page À propos de la console AEM et vérifiez si le numéro de version AEM comprend un suffixe prerelrelease tel que Adobe Experience Manager 2021.4.5226.20210427T070726Z-210429-PRERELEASE.

about

Sur cette page