Ingestion de contenu dans Cloud Service ingesting-content

Processus d’ingestion dans Cloud Acceleration Manager ingestion-process

Suivez les étapes ci-dessous pour ingérer votre jeu de migration à l’aide de Cloud Acceleration Manager :

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

    image

  2. Consultez la liste de contrôle d’ingestion et assurez-vous que toutes les étapes sont effectuées. Ces étapes sont nécessaires à la réussite de l’ingestion. Vous devez terminer la liste de contrôle avant de pouvoir passer à l’étape suivante.

    image

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

    • Jeu de migration : Sélectionnez le jeu de migration contenant les données extraites comme 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.
    note tip
    TIP
    Si l’extraction est en cours d’exécution, la boîte de dialogue l’indique. Une fois l’extraction terminée, l’ingestion démarre automatiquement. Si l’extraction échoue ou est arrêtée, la tâche d’ingestion est annulée.
    • Destination : Sélectionnez l’environnement de destination. C’est dans cet environnement que le contenu du jeu de migration est ingéré.

      • Les ingestion ne prennent pas en charge les destinations de type Environnement de développement rapide (RDE) ou Aperçu, et elles n’apparaissent pas comme un choix de destination possible, même si l’utilisateur y a accès.
      • Bien qu’un jeu de migration puisse être ingéré simultanément dans plusieurs destinations, une destination peut être la cible d’une seule ingestion en cours d’exécution ou en attente à la fois.
    • Niveau : Sélectionnez le niveau. (Auteur/Publication).

      • Si la source était Author, il est recommandé de l’ingérer dans la variable Author niveau sur la cible. De même, si la source était Publish, la cible doit être Publish ainsi que .
    note note
    NOTE
    Si le niveau cible est Author, l’instance de création est arrêtée pendant la durée de l’ingestion et n’est pas disponible pour les utilisateurs et utilisatrices (par exemple, les auteurs ou autrices ou toute personne effectuant la maintenance). La raison est de protéger le système et d’empêcher toute modification qui pourrait être perdue ou provoquer un conflit d’ingestion. Assurez-vous d’en informer votre équipe. Notez également que l’environnement apparaît en veille pendant l’ingestion de l’instance de création.
    • Wipe : Choisissez la Wipe value

      • La variable Wipe définit le point de départ de la destination de l’ingestion. If Wipe est activée, la destination, y compris tout son contenu, est réinitialisée à la version d’AEM spécifiée dans Cloud Manager. Si elle n’est pas activée, la destination conserve son contenu actuel comme point de départ.
      • Cette option permet de NOT affectent la manière dont l’ingestion du contenu sera effectuée. L’ingestion utilise toujours une stratégie de remplacement de contenu et not une stratégie de fusion de contenu, de sorte que dans les deux Wipe et Non effacé dans certains cas, l’ingestion d’un jeu de migration remplace le contenu situé dans le même chemin sur la destination. Par exemple, si le jeu de migration contient /content/page1 et la destination contient déjà /content/page1/product1, l’ingestion supprime l’intégralité de la page1 chemin et ses sous-pages, y compris product1et remplacez-le par le contenu du jeu de migration. Cela signifie qu’une planification minutieuse doit être effectuée lors de l’exécution d’une Non effacé l’ingestion vers une destination contenant tout contenu à conserver.
    note important
    IMPORTANT
    Si le paramètre Wipe est activé pour l’ingestion, elle réinitialise l’ensemble du référentiel existant, y compris les autorisations utilisateur sur l’instance du Cloud Service cible. Cette réinitialisation est également vraie pour un utilisateur administrateur ajouté à la variable administrateurs et cet utilisateur doivent être à nouveau ajoutés au groupe administrateurs pour démarrer une ingestion.
    • Pré-copie : Choisissez la Pre-copy value

      • Vous pouvez exécuter l’étape de précopie facultative pour accélérer considérablement l’ingestion. Pour plus d’informations, veuillez consulter la section Ingestion avec AzCopy.
      • Si l’ingestion avec une précopie est utilisée (pour S3 ou Azure Data Store), il est recommandé de l’exécuter. Author l'ingestion seule en premier. Cela permet d’accélérer la Publish lorsqu’elle est exécutée ultérieurement.
    note important
    IMPORTANT
    Vous pouvez déclencher une ingestion vers un environnement de destination seulement si vous appartenez au groupe local Administrateurs et administratrices d’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.
  4. Cliquez sur Ingérer.

    image

  5. Vous pouvez ensuite surveiller l’ingestion dans la vue de liste Tâches d’ingestion et utiliser le menu d’action de l’ingestion pour afficher les durées et le journal au fur et à mesure de l’ingestion.

    image

  6. Cliquez sur le bouton (i) sur la ligne pour 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 sur Afficher les durées. Les informations de l’extraction sont également affichées pour réaliser ce qui est ingéré.

    image

Ingestion complémentaire top-up-ingestion-process

L’outil de transfert de contenu dispose d’une fonctionnalité qui permet d’extraire du contenu différentiel en exécutant une complément du jeu de migration. Cela permet de modifier le jeu de migration pour inclure uniquement le contenu qui a changé depuis l’extraction précédente sans avoir à extraire à nouveau tout le contenu.

NOTE
Suite au transfert initial d’un contenu, il est recommandé d’effectuer fréquemment des compléments différentiels pour réduire la période de gel du transfert final de contenu différentiel avant de passer en ligne sur Cloud Service. Si vous avez utilisé l’étape de précopie pour la première ingestion, vous pouvez ignorer la précopie pour les prochaines assimilations de complément (si la taille du jeu de migration de complément est inférieure à 200 Go). La raison est qu’il peut ajouter du temps à l’ensemble du processus.

Pour ingérer un contenu différentiel une fois certaines assimilations terminées, vous devez exécuter une Extraction de complément, puis utilisez la méthode d’ingestion avec la méthode Wipe option disabled. Veillez à lire le Wipe explication ci-dessus pour éviter de perdre du contenu déjà présent sur la destination.

Commencez par créer une tâche d’ingestion et assurez-vous que Wipe est désactivé lors de l’ingestion, comme illustré ci-dessous :

image

Résolution des problèmes troubleshooting

Impossible pour CAM de récupérer le jeton de migration cam-unable-to-retrieve-the-migration-token

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 :

image

Récupérez manuellement le jeton de migration en cliquant sur le lien « Obtenir le jeton » dans la boîte de dialogue. Un autre onglet qui affiche le jeton s’ouvre. 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.

NOTE
Le jeton sera disponible pour les utilisateurs et utilisatrices qui appartiennent au groupe local Administrateurs AEM sur le service de création Cloud Service de destination.

Impossible de démarrer l’ingestion unable-to-start-ingestion

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

image

Impossible d’atteindre le service de migration unable-to-reach-migration-service

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 inatteignable. Réessayez ultérieurement ou contactez l’assistance Adobe. »

image

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

NOTE
Le champ « Jeton de migration » s’affiche, car dans certains cas, la récupération de ce jeton est ce qui est en fait interdit. En autorisant sa mise à disposition manuelle, cela peut permettre à l’utilisateur ou l’utilisatrice de démarrer rapidement l’ingestion, sans aide supplémentaire. Si le jeton est fourni et que le message s’affiche toujours, ce n’est donc pas la récupération du jeton qui a posé problème.
  • 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 il finit par être disponible.
  • Il est possible qu’un autre processus soit en cours d’exécution sur l’instance. Par exemple, si AEM mises à jour de version applique une mise à jour, le système peut être occupé et le service de migration régulièrement indisponible. Une fois ce processus terminé, le début de l’ingestion peut à nouveau être tenté.
  • 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 dynamique. Actuellement, la seule solution est de désactiver la liste autorisée IP pendant le processus d’ingestion et d’indexation.
  • D’autres raisons peuvent nécessiter un examen. Si l’ingestion ou l’indexation continue d’échouer, contactez l’assistance clientèle d’Adobe.

AEM des mises à jour et des ingérations de version aem-version-updates-and-ingestions

AEM mises à jour de version sont automatiquement appliqués aux environnements afin de les mettre à jour avec la version la plus récente AEM as a Cloud Service. Si la mise à jour est déclenchée lorsqu’une ingestion est effectuée, elle peut entraîner des résultats imprévisibles, y compris la corruption de l’environnement.

Si les "Mises à jour de version AEM" sont intégrées dans le programme de destination, le processus d’ingestion tente de désactiver sa file d’attente avant de commencer. Une fois l’ingestion terminée, l’état du mise à jour de version est renvoyé à son état avant le début des ingérations.

NOTE
Il n’est plus nécessaire de consigner un ticket d’assistance pour que "AEM mises à jour de version" soit désactivé.

Si "AEM mises à jour de version" est actif (c’est-à-dire que les mises à jour sont en cours d’exécution ou sont placées en file d’attente pour être exécutées), l’ingestion ne démarre pas et l’interface utilisateur présente le message suivant. Une fois les mises à jour terminées, l’ingestion peut être lancée. Cloud Manager peut être utilisé pour afficher l’état actuel des pipelines du programme.

NOTE
"AEM les mises à jour de version" est exécuté dans le pipeline de l’environnement et attend que le pipeline soit clair. Si les mises à jour sont mises en file d’attente plus longtemps que prévu, assurez-vous qu’un workflow personnalisé ne verrouille pas involontairement le pipeline.

image

Échec de l’ingestion de complément en raison d’une violation de contrainte d’unicité top-up-ingestion-failure-due-to-uniqueness-constraint-violation

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 noeud en cours d’ingestion possède le même uuid que celui qui existe à un autre chemin sur l’instance de destination. Cette situation peut se produire pour deux raisons :

  • Un noeud est déplacé sur la source entre une extraction et une Extraction de complément
    • RAPPELER: pour les extractions de complément, le noeud existe toujours dans le jeu de migration, même s’il n’existe plus sur la source.
  • Un noeud sur la destination est déplacé entre une ingestion et une ingestion de complément ultérieure.

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.

Échec de l’ingestion de complément en raison de l’impossibilité de supprimer le noeud référencé top-up-ingestion-failure-due-to-unable-to-delete-referenced-node

Une autre cause commune d'une Ingestion de complément L’échec est un conflit de version pour un noeud particulier sur l’instance de destination. 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 : OakIntegrity0001 : impossible de supprimer le noeud référencé : 8a289f4-b904-4bd0-8410-15e41e0976a8

Cela peut se produire si un noeud de la destination est modifié entre une ingestion et une Non effacé de sorte qu’une nouvelle version ait été créée. Si le jeu de migration a été extrait avec l’option "Inclure les versions" activée, un conflit peut se produire, car la destination possède désormais une version plus récente qui est référencée par l’historique des versions et d’autres contenus. Le processus d’ingestion ne parvient pas à supprimer le noeud de version offensante, car il est référencé.

La solution peut nécessiter que l’extraction de complément soit effectuée à nouveau sans le noeud offensif. Vous pouvez également créer un petit jeu de migration du noeud incriminé, mais en désactivant l’option "Versions d’inclusion".

Les bonnes pratiques indiquent que si une Non effacé l’ingestion doit être exécutée à l’aide d’un jeu de migration qui inclut des versions. Il est essentiel que le contenu de la destination soit modifié le moins possible jusqu’à ce que le parcours de migration soit terminé. Sinon, ces conflits peuvent se produire.

Échec de l’ingestion en raison de valeurs de propriété de noeud volumineuses ingestion-failure-due-to-large-node-property-values

La valeur des propriétés de nœud stockées dans MongoDB ne doit pas dépasser 16 Mo. Si une valeur de noeud dépasse la taille prise en charge, l’ingestion échoue et le journal contient une BSONObjectTooLarge et indiquez le noeud qui a dépassé le maximum. Il s’agit d’une restriction MongoDB.

Voir Node property value in MongoDB remarque dans Conditions préalables pour l’outil de transfert de contenu pour plus d’informations et un lien vers un outil Oak qui peut aider à trouver tous les noeuds volumineux. Une fois tous les noeuds de grande taille corrigés, exécutez à nouveau l’extraction et l’ingestion.

Ingestion annulée ingestion-rescinded

Une ingestion créée avec une extraction en cours d’exécution comme jeu de migration source attend patiemment jusqu’à ce que cette extraction réussisse, et démarre normalement à ce moment. Si l’extraction échoue ou est arrêtée, l’ingestion et sa tâche d’indexation ne démarrent pas, mais sont annulées. Dans ce cas, vérifiez l’extraction pour déterminer pourquoi elle a échoué, corrigez le problème et recommencez à extraire. Une fois l’extraction fixe en cours d’exécution, une nouvelle ingestion peut être planifiée.

Prochaines étapes whats-next

Une fois l’ingestion terminée, AEM indexation démarre automatiquement. Voir Indexation après migration de contenu pour plus d’informations.

Une fois l’ingestion de contenu dans Cloud Service terminée, vous pouvez afficher 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.

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab