Ingestion de contenu dans Target

Processus d’ingestion dans l’outil de transfert de contenu

Pour ingérer le jeu de migration obtenu à l’aide de l’outil de transfert de contenu, procédez comme suit :

1. Présentation de Cloud Acceleration Manager. Cliquez sur la carte de votre projet, puis sur la carte Transfert de contenu. Accédez aux Tâches d’ingestion et cliquez sur Nouvelle ingestion.

   

2. Consultez la liste de contrôle d’ingestion et assurez-vous que toutes les étapes ont été effectuées. Ces étapes constituent un préalable indispensable à la réussite de l’ingestion. Vous devez d’abord terminer la liste de contrôle avant de pouvoir passer à l’étape suivante.

   

3. Fournissez les informations requises pour créer une ingestion.

   • Sélectionnez le jeu de migration contenant les données extraites en tant que source.
     • Les jeux de migration expirent après une longue période d’inactivité. Il est donc probable que l’ingestion se produise peu de temps après l’exécution de l’extraction. Consultez Expiration du jeu de migration pour plus d’informations.
   • Sélectionnez l’environnement de destination. C’est à ce moment que le contenu du jeu de migration sera ingéré. Sélectionnez le niveau. (Création/Publication). Les environnements de développement rapide ne sont pas pris en charge.
   REMARQUE

   Les remarques suivantes s’appliquent à l’ingestion de contenu :
   Si la source était en Auteur, il est recommandé de l’ingérer dans le niveau Auteur sur la cible. De même, si la source était en Publication, la cible doit également être en Publication.
   Si le niveau cible est Author, l’instance de création sera arrêtée pendant la durée de l’ingestion et ne sera pas disponible pour les utilisateurs et utilisatrices (par exemple, les auteurs ou autrices ou toute personne effectuant la maintenance, etc.). Cela permet de protéger le système et d’empêcher toute modification qui pourrait être perdue ou entraîner un conflit d’ingestion. Assurez-vous d’en informer votre équipe. Notez également que l’environnement apparaîtra en veille pendant l’ingestion de l’instance de création.
   Vous pouvez exécuter l’étape de précopie facultative pour accélérer considérablement la phase d’ingestion. Pour plus d’informations, voir Ingestion avec AzCopy.
   Si l’ingestion avec une précopie est utilisée (pour S3 ou Azure Data Store), il est recommandé d’exécuter l’ingestion d’auteur en premier, seule. Cela permet d’accélérer l’ingestion de publication lorsqu’elle est exécutée ultérieurement.
   Les ingestions ne prennent pas en charge une destination d’environnement de développement rapide (RDE). Elles n’apparaîtront pas comme choix de destination possible, même si l’utilisateur ou l’utilisatrice y a accès.

   IMPORTANT

   Les remarques importantes suivantes s’appliquent à l’ingestion de contenu :
   Vous pourrez déclencher une ingestion vers un environnement de destination seulement si vous appartenez au groupe local Administrateurs AEM sur le service de création Cloud Service de destination. Si vous ne parvenez pas à démarrer une ingestion, reportez-vous à la section Impossible de démarrer l’ingestion pour plus d’informations.
   Si le paramètre Effacer est activé avant l’ingestion, il supprime l’intégralité du référentiel existant et crée un nouveau référentiel dans lequel ingérer du contenu. Cela signifie que tous les paramètres sont réinitialisés, y compris les autorisations relatives à l’instance Cloud Service cible. C’est également vrai pour un utilisateur administrateur ajouté au groupe administrateurs. Vous devez être de nouveau ajouté au groupe d’administrateurs pour démarrer une ingestion.

4. Cliquez sur Ingérer.

   

5. Vous pouvez ensuite surveiller la phase d’ingestion dans la vue Liste des Tâches d’ingestion. Vous pouvez également utiliser le menu Action de l’ingestion pour consulter le journal consignant la progression de l’ingestion.

   

6. Cliquez sur (i) sur la ligne pour obtenir plus d’informations sur la tâche d’ingestion. Vous pouvez voir la durée de chaque étape de l’ingestion lorsqu’elle est en cours d’exécution ou terminée en cliquant sur … puis Afficher les durées. Les informations de l’extraction sont également affichées pour réaliser ce qui est ingéré.

   

Ingestion complémentaire

L’outil de transfert de contenu comporte une fonctionnalité pour traiter un complément de contenu différentiel. Dans ce cas, seules les modifications effectuées depuis l’activité de transfert de contenu précédente sont transférées.

Une fois le processus d’ingestion terminé, vous devrez exécuter une Extraction de complément pour ingérer le contenu manquant puis utiliser la méthode d’ingestion de complément.

Pour ce faire, créez une tâche d’ingestion et assurez-vous que l’option Effacer est désactivé pendant la phase d’ingestion, comme illustré ci-dessous :

Résolution des problèmes

Impossible pour CAM de récupérer le jeton de migration

La récupération automatique du jeton de migration peut échouer pour différentes raisons, y compris la configuration d’une liste autorisée d’adresses IP via Cloud Manager dans l’environnement Cloud Service cible. Dans ce cas de figure, la boîte de dialogue suivante s’affiche lorsque vous tentez de démarrer une ingestion :

Vous devez récupérer manuellement le jeton de migration en cliquant sur le lien « Obtenir le jeton » dans la boîte de dialogue. Cette action a pour effet d’ouvrir un autre onglet affichant le jeton. Vous pouvez ensuite copier le jeton et le coller dans le champ Entrée du jeton de migration. À présent, vous devriez être en mesure de commencer l’ingestion.

Impossible de démarrer l’ingestion

Vous pourrez déclencher une ingestion vers un environnement de destination seulement si vous appartenez au groupe local Administrateurs AEM sur le service de création Cloud Service de destination. Si vous n’appartenez pas au groupe d’administrateurs AEM, une erreur s’affiche lorsque vous essayez de démarrer une ingestion, comme illustré ci-dessous. Vous pouvez demander à votre administrateur de vous ajouter au groupe local Administrateurs AEM ou demander directement le jeton, que vous pouvez ensuite coller dans le champ Entrée du jeton de migration.

Impossible d’atteindre le service de migration

Une fois l’ingestion demandée, un message comme celui-ci peut être présenté à l’utilisateur ou l’utilisatrice : « Le service de migration sur l’environnement de destination est actuellement inatteignable. Veuillez réessayer ultérieurement ou contacter l’assistance Adobe. »

Cela indique que Cloud Acceleration Manager n’a pas pu atteindre le service de migration de l’environnement cible pour démarrer l’ingestion. Cela peut se produire pour plusieurs raisons.

• AEM as a Cloud Service conserve l’état de l’environnement et peut parfois devoir redémarrer le service de migration pour plusieurs raisons normales. Si ce service redémarre, il ne peut pas être atteint, mais sera rapidement disponible.
• Il est possible qu’un autre processus soit en cours d’exécution sur l’instance. Si, par exemple, l’application d’une mise à jour est lancée par Release Orchestration, le système peut être occupé et le service de migration régulièrement indisponible. C’est pour cette raison, ainsi qu’en raison du risque de corruption de l’instance d’évaluation ou de production, il est fortement recommandé de suspendre les mises à jour lors d’une ingestion.
• Si une liste autorisée d’adresses IP a été appliquée via Cloud Manager, cela empêche Cloud Acceleration Manager d’accéder au service de migration. Une adresse IP ne peut pas être ajoutée pour les ingestions, car leur adresse est très dynamique. Actuellement, la seule solution consiste à désactiver la liste autorisée d’adresses IP pendant l’exécution de l’ingestion.
• D’autres raisons peuvent nécessiter un examen. Si l’ingestion continue d’échouer, veuillez contacter l’assistance clientèle Adobe.

Les mises à jour automatiques par l’intermédiaire de l’orchestrateur de versions sont toujours activées.

L’orchestrateur de versions applique les mises à jour automatiquement, ce qui permet de maintenir les environnements à jour. Si la mise à jour est déclenchée lors de l’ingestion, elle peut entraîner des résultats imprévisibles, y compris la corruption de l’environnement. C’est l’une des raisons pour lesquelles un ticket d’assistance doit être soumis avant de commencer une ingestion (voir la « Remarque » ci-dessus), de sorte que la désactivation temporaire de l’orchestrateur de versions puisse être planifiée.

Si l’orchestrateur de versions est toujours en cours d’exécution au moment où une ingestion commence, l’interface utilisateur affichera ce message. Vous pouvez choisir de continuer tout de même, en acceptant le risque, en cochant le champ et en appuyant à nouveau sur le bouton.

Échec de l’ingestion complémentaire

Les conflits entre identifiants de nœud sont une cause courante de l’échec de l’Ingestion complémentaire. Pour identifier cette erreur, téléchargez le journal d’ingestion à l’aide de l’interface utilisateur de Cloud Acceleration Manager et recherchez une entrée du type suivant :

java.lang.RuntimeException: org.apache.jackrabbit.oak.api.CommitFailedException: OakConstraint0030: Uniqueness constraint violated property [jcr:uuid] having value a1a1a1a1-b2b2-c3c3-d4d4-e5e5e5e5e5e5: /some/path/jcr:content, /some/other/path/jcr:content

Chaque nœud d’AEM doit disposer d’un UUID unique. Cette erreur indique qu’un nœud en cours d’ingestion présente un uuid qui existe déjà au niveau d’un autre chemin d’accès sur l’instance cible.
Cela peut se produire si un nœud est déplacé sur la source entre une extraction et une extraction complémentaire suivante.
Cela peut également se produire si un nœud de la cible est déplacé entre une ingestion et une ingestion complémentaire suivante.

Ce conflit doit être résolu manuellement. Une personne qui connait le contenu doit décider lequel des deux nœuds doit être supprimé, sans oublier tout autre contenu qui y fait référence. La solution peut nécessiter que l’extraction complémentaire soit effectuée à nouveau sans le nœud fautif.

Prochaines étapes

Une fois que vous avez terminé l’ingestion de contenu dans Target, vous pouvez consulter les journaux de chaque étape (extraction et ingestion) et rechercher les erreurs. Consultez la section Affichage des journaux d’un jeu de migration pour en savoir plus.

Ressources Business.Adobe.com