Développement d’AEM locales avec l’éditeur universel local-dev-ue

Découvrez comment Universal Editor prend en charge la modification sur les instances d’AEM locales à des fins de développement.

Vue d’ensemble overview

Le service d’éditeur universel est ce qui lie l’éditeur universel et le système principal. Pour pouvoir développer localement pour Universal Editor, vous devez exécuter une copie locale du service Universal Editor. En effet :

  • Le service d’éditeur universel officiel d’Adobe est hébergé globalement, et votre instance AEM locale doit être exposée à Internet.
  • Lors du développement avec un SDK d’AEM local, le service d’éditeur universel d’Adobe n’est pas accessible sur Internet.
  • Si votre instance d’AEM comporte des restrictions d’adresse IP et que le service d’éditeur universel d’Adobe ne se trouve pas dans une plage d’adresses IP définie, vous pouvez l’héberger vous-même.

Ce document explique comment exécuter AEM en HTTPS avec une copie locale du service d’éditeur universel afin que vous puissiez développer localement sur AEM pour une utilisation avec l’éditeur universel.

Configuration d’AEM à exécuter sur HTTPS aem-https

Dans un cadre externe sécurisé avec HTTPS, un cadre HTTP non sécurisé ne peut pas être chargé. Le service Universal Editor s’exécute sur HTTPS. Par conséquent, AEM ou toute autre page distante doit s’exécuter également sur HTTPS.

Pour ce faire, vous devez configurer AEM pour qu’il s’exécute sur HTTPS. À des fins de développement, vous pouvez utiliser un certificat auto-signé.

Consultez ce document sur la configuration de l’AEM s’exécutant sur HTTPS, y compris un certificat auto-signé que vous pouvez utiliser.

Installation du service Universal Editor install-ue-service

Le service d’éditeur universel n’est pas une copie complète de l’éditeur universel, mais seulement un sous-ensemble de ses fonctionnalités pour s’assurer que les appels provenant de votre environnement d’AEM local ne sont pas acheminés sur Internet, mais à partir d’un point de terminaison défini que vous contrôlez.

NodeJS version 16 est nécessaire pour exécuter une copie locale du service Universal Editor.

Le service d’éditeur universel est disponible via Distribution logicielle. Pour plus d’informations sur la façon d’y accéder, consultez la documentation sur la distribution de logiciels.

Enregistrez le fichier universal-editor-service.cjs de Distribution logicielle dans votre environnement de développement local.

Création d’un certificat pour exécuter le service Universal Editor avec HTTPS ue-https

Le service d’éditeur universel requiert également un certificat à exécuter sur HTTPS dans votre environnement de développement.

Exécutez la commande suivante.

$ openssl req -newkey rsa:2048 -nodes -keyout key.pem -x509 -days 365 -out certificate.pem

La commande génère un fichier key.pem et un fichier certificate.pem. Enregistrez ces fichiers dans le même chemin que votre fichier universal-editor-service.cjs.

Configuration de la configuration du service d’éditeur universel setting-up-service

Un certain nombre de variables d’environnement doivent être définies dans NodeJS pour exécuter localement le service d’éditeur universel.

Sur le même chemin que vos fichiers universal-editor-service.cjs, key.pem et certificate.pem, créez un fichier .env avec le contenu suivant.

EXPRESS_PORT=8000
EXPRESS_PRIVATE_KEY=./key.pem
EXPRESS_CERT=./certificate.pem
NODE_TLS_REJECT_UNAUTHORIZED=0

La variable a les significations suivantes :

Exécution du service Universal Editor running-ue

Pour démarrer le service Universal Editor, exécutez la commande suivante :

$ node ./universal-editor-service.cjs

Il doit générer les résultats suivants sur votre terminal :

Universal Editor Service listening on port 8000 as HTTPS Server

Assurez-vous que le service démarre le serveur HTTPS et non le serveur HTTP.

Utilisation du service d’éditeur universel local au lieu du service global using-local-ue

Universal Editor sait quel service d’éditeur universel utiliser pour modifier une page en fonction de la manière dont la page est instrumentée. Cette opération s’effectue par le biais de balises META dans la page chargée dans Universal Editor.

Pour qu’une page soit modifiée à l’aide de votre service Universal Editor local, la balise meta suivante doit être définie :

<meta name="urn:adobe:aue:config:service" content="https://localhost:8000">

Une fois défini, vous devriez voir chaque appel de mise à jour de contenu aller à https://localhost:8000 au lieu du service d’éditeur universel par défaut.

NOTE
Toute tentative d'accès direct à https://localhost:8000 entraîne une erreur 404. Ce comportement est attendu.
Pour tester l’accès à votre service Universal Editor local, utilisez https://localhost:8000/corslib/LATEST. Pour plus d’informations, reportez-vous à la section suivante .
TIP
Pour plus d’informations sur la manière dont les pages sont instrumentées pour utiliser le service Global Universal Editor, consultez le document Prise en main d’Universal Editor dans AEM

Modification d’une page avec le service d’éditeur universel local editing

Avec le service d'éditeur universel s'exécutant localement et votre page de contenu instrumentée pour utiliser le service local,vous pouvez maintenant démarrer l'éditeur.

  1. Ouvrez votre navigateur sur https://localhost:8000/corslib/LATEST.
  2. Dirigez votre navigateur pour accepter votre certificat auto-signé.
  3. Une fois le certificat autosigné approuvé, vous pouvez modifier la page à l’aide de votre service d’éditeur universel local.
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab