Prise en main de l’agent de modernisation de l’expérience getting-started

Découvrez les premières étapes pour commencer à utiliser l’agent de modernisation d’expérience et la console de modernisation d’expérience.

NOTE
Si vous souhaitez utiliser la console de modernisation de l’expérience, vous pouvez demander l’accès par l’intermédiaire de votre gestionnaire de compte pour garantir une expérience d’intégration fluide.

Préparation d’un référentiel GitHub Edge Delivery prepare-repo

NOTE
Vous utilisez un projet AEM Sites et l’éditeur universel ? Suivez Prise en main d’AEM Sites/de l’éditeur universel étapes de configuration.
  1. Sélectionnez un référentiel 🔗 à utiliser avec la console de modernisation de l’expérience.

  2. Assurez-vous que le AEM Code Connector est installé dans le référentiel.

    • Cela permet à la console d’inspecter votre code.
  3. Assurez-vous que l’application GitHub de synchronisation du code ​ est installée dans le référentiel.

    • Cela permet à Edge Delivery Services de synchroniser votre code.
    • Si votre référentiel est basé sur le tutoriel, cette étape est déjà terminée.

Ouvrir la console de modernisation de l’expérience open-console

  1. Accéder à aemcoder.adobe.io.
  2. Connectez-vous avec votre Adobe ID.

Mode de démonstration demo-mode

La console se lance en mode de démonstration lorsque vous vous connectez pour la première fois. Ce mode vous permet d’explorer un site existant où vous pouvez tester la migration de pages supplémentaires. Une bannière en bas de l’écran indique que vous êtes en mode de démonstration.

Mode de démonstration

Connecter votre site connect-repo

Lorsque vous êtes prêt à commencer à travailler sur votre propre site, vous pouvez quitter le mode de démonstration en vous connectant à votre propre projet.

  1. Cliquez sur Changer de site dans la bannière du mode de démonstration.
  2. Vous êtes alors invité à autoriser l’application AEM Code Connector à l’aide de vos informations d’identification GitHub. Cliquez sur Autoriser AEM Code Connector.
  3. De retour dans la console, spécifiez l’URL de prévisualisation du site. L’URL de prévisualisation peut être obtenue en prévisualisant n’importe quel document du site ou en la construisant à partir d’une branche, de site-name et d’org. Le système récupère automatiquement le projet Github associé. Vous pouvez également effectuer une recherche dans vos projets GitHub autorisés pour trouver un site.
    Connexion à un projet GitHub
  4. Cliquez sur Extraire dans l’espace de travail une fois le site vérifié.
  5. Lorsque vous êtes invité à Remplacer l’espace de travail existant, cliquez sur Remplacer l’espace de travail.
    Remplacer l’espace de travail existant

Votre projet et votre site GitHub sont maintenant connectés à la console.

Si le mode de démonstration a été quitté mais qu’un nouveau projet n’a pas été connecté, les visites ultérieures de l’agent de modernisation de l’expérience forceront un site à être connecté en premier.

​ Connexion au site ​

Page de départ Console console-home

Lorsque vous visitez aemcoder la page d’accueil s’affiche jusqu’à ce qu’une conversation en chat ait été lancée. La page d’accueil vous permet de commencer à discuter en tapant votre première invite ou en sélectionnant l’une des invites suggérées.

Console d’accueil

Démarrer l’invite start-prompting

Maintenant que votre console peut accéder à votre code, vous êtes prêt à démarrer l’invite.

  1. Pour commencer, vous pouvez importer le contenu d’un site :

    • « Migrer la page https://wknd-trendsetters.site. »
  2. Le contenu du site est ainsi importé.

    • La console observe une séparation des préoccupations et gère le contenu et la présentation séparément.
    • L’importation initiale du contenu d’un site peut prendre plusieurs minutes.
    • La console vous présente des commentaires au fur et à mesure qu’elle commence son travail, y compris un aperçu de ses étapes planifiées.
      Import de contenu
  3. Une fois le site importé, le panneau ​affiche les pages. Sélectionnez une page pour la prévisualiser dans le panneau de droite.
    ​ Contenu importé ​

  4. Maintenant que vous disposez de contenu, vous pouvez demander à importer les styles à partir de la même source.

    • « Importez les styles généraux à partir de https://wknd-trendsetters.site. »
  5. Comme pour l’importation de contenu initiale, l’importation peut prendre plusieurs minutes et la console fournit des commentaires pendant le traitement de votre demande et l’importation des styles. Une fois la tâche terminée, cliquez sur Actualiser l’aperçu dans le panneau de droite pour afficher le contenu stylisé.
    ​ Styles importés ​

Le contenu et les styles sont maintenant importés dans la console.

TIP
Consultez le guide de l'agent pour plus d'idées sur la façon d'inviter l'agent et ce que ses compétences peuvent faire.

Chargement du contenu upload-content

Pour charger le contenu vers Création de documents :

  1. Assurez-vous que vous êtes dans une vue Contenu, puis cliquez sur le bouton Charger le contenu en haut à droite.

    • Par défaut, vous êtes dans la vue Contenu lorsque vous accédez à la console.
    • Votre affichage est indiqué par l’élément de sélecteur d’affichage sélectionné dans la zone de l’espace de travail de la console.
  2. La boîte de dialogue Télécharger le contenu s’ouvre avec l’organisation de destination et le référentiel préremplis à partir des paramètres de votre projet.

    • Si un fstab.yaml n’est pas présent dans votre référentiel connecté, vous devez saisir manuellement les valeurs Organisation et Référentiel
    • Si vous avez utilisé la plaque chauffante, un fstab.yaml est fourni.
  3. Sélectionnez les fichiers à charger, puis cliquez sur Charger.
    Boîte de dialogue Charger le contenu

  4. La console indique le processus de chargement en désactivant le bouton Charger.

  5. Une fois l’opération terminée, une notification s’affiche au bas de la console.
    Afficher dans AEM

Pour accéder au contenu chargé dans la création de documents, vous pouvez cliquer sur Afficher dans AEM dans la notification une fois le chargement terminé ou accéder à https://da.live/#/{organization}/{repository}.

Contenu dans la création de documents

Le contenu que vous avez importé se trouve maintenant dans l’instance de création de documents.

TIP
Si vous travaillez sur un projet AEM Sites et Universal Editor, le chargement de contenu vers AEM fonctionne légèrement différemment. Consultez Prise en main des projets de l’agent de modernisation de l’expérience pour AEM Sites/l’éditeur universel pour obtenir des instructions de chargement spécifiques.

Modifications du code push push-code-changes

Une fois que vous êtes satisfait des modifications apportées à votre code, vous pouvez les pousser vers votre référentiel GitHub.

  1. Basculez vers l’affichage Modifications (icône de branche dans le sélecteur d’affichage).
    Affichage du code
  2. Dans la liste des fichiers modifiés, si certains fichiers s’affichent comme non suivis, cliquez sur leur bouton + pour les préparer.
  3. Cliquez sur le bouton Push en haut à droite.
  4. Dans la boîte de dialogue Pousser les modifications, choisissez de pousser les modifications vers une nouvelle RP (par défaut) ou la branche actuelle et cliquez sur Confirmer pour pousser.
    • En cas de doute, vous pouvez pousser vers la branche actuelle pour garder les choses simples.
  5. Une fois l’opération terminée, une notification s’affiche au bas de la console.
    Afficher PR

Si vous souhaitez accéder directement aux modifications transmises dans GitHub, cliquez sur Afficher PR dans la notification une fois la transmission terminée.

Code dans GitHub

Votre code se trouve désormais dans GitHub.

Aperçu du site preview-site

Pour afficher les modifications dans l’environnement de prévisualisation :

  1. Revenez à la création de documents.

    • Il se peut qu’il soit toujours ouvert dans un onglet du navigateur que vous avez ouvert après avoir cliqué sur Afficher dans AEM après avoir chargé le contenu.
    • Ou accédez à https://da.live/#/{organization}/{repository}
  2. Ouvrez l’une des pages que vous avez précédemment chargées dans AEM.

  3. Cliquez sur l’icône du plan de papier (en haut à droite) et sélectionnez Aperçu.
    Publier pour prévisualisation

Félicitations ! Le contenu et les styles migrés sont désormais en ligne dans l’environnement d’aperçu AEM.

Contenu de prévisualisation publié

Si vous avez poussé votre code vers une branche autre que main, l’aperçu ouvert à partir de l’instance de création de document n’affiche pas les styles. Remplacez par la branche en mettant à jour l’URL de l’aperçu pour afficher vos styles.

Résolution des problèmes troubleshooting

Placer sur la liste autorisée les adresses IP allowlist-ip-addresses

Si votre site se trouve derrière un pare-feu ou des restrictions d’accès, vous pouvez placer sur la liste autorisée les adresses IP suivantes afin que les services principaux puissent gratter votre site :

  • 34.228.136.112
  • 54.90.51.39
  • 3.224.194.242

Ressources supplémentaires additional-resources

Les documents suivants peuvent s’avérer utiles lorsque vous continuez à explorer l’agent de modernisation de l’expérience et sa console.

recommendation-more-help
experience-manager-cloud-service-help-main-toc