Ingesta de contenido en Cloud Service ingesting-content

Proceso de ingesta en Cloud Acceleration Manager ingestion-process

Siga los pasos a continuación para ingerir el conjunto de migración mediante Cloud Acceleration Manager:

  1. Vaya a Cloud Acceleration Manager. Haga clic en la tarjeta del proyecto y en la tarjeta Transferencia de contenido. Vaya a Trabajos de ingesta y haga clic en Nueva ingesta

    imagen

  2. Revise la lista de comprobación de ingesta y asegúrese de que se han completado todos los pasos. Estos pasos son necesarios para garantizar una ingesta correcta. Continúe con el paso Siguiente solo si la lista de comprobación se ha completado.

    imagen

  3. Proporcione la información necesaria para crear una ingesta.

    • Conjunto de migración: Seleccione el conjunto de migración que contiene los datos extraídos como Source.
      • Los conjuntos de migración caducarán después de un período de inactividad prolongado, por lo que se espera que la ingesta se produzca relativamente pronto después de realizar la extracción. Revise Expiración del conjunto de migración para obtener detalles.
    note tip
    TIP
    Si la extracción se está ejecutando, el cuadro de diálogo lo indicará. Una vez que la extracción ha finalizado correctamente, la ingesta se inicia automáticamente. Si la extracción falla o se detiene, el trabajo de ingesta se rescindirá.
    • Destino: Seleccione el entorno de destino. En este entorno es donde se ingiere el contenido del conjunto de migración.

      • Las ingestas no admiten destinos de tipo Entorno de desarrollo rápido (RDE) o Vista previa, y no aparecen como una posible opción de destino, aunque el usuario tenga acceso a ellos.
      • Aunque un conjunto de migración se puede ingerir en varios destinos simultáneamente, un destino solo puede ser el destino de una ingesta en ejecución o en espera a la vez.
    • Nivel: Seleccione el nivel. (Autor/Publish).

      • Si el origen era Author, se recomienda ingerirlo en el nivel Author en el destino. Del mismo modo, si el origen era Publish, el destino debería ser Publish también.
    note note
    NOTE
    Si el nivel de destino es Author, la instancia de autor se cierra durante toda la ingesta y no está disponible para los usuarios (por ejemplo, los autores o cualquier persona que realice tareas de mantenimiento). El motivo es proteger el sistema y evitar cualquier cambio que pueda perderse o causar un conflicto de ingesta. Asegúrese de que su equipo esté al tanto de este hecho. Tenga en cuenta también que el entorno parece hibernado durante la ingesta del autor.
    • Borrar: Elija el valor Wipe

      • La opción Borrar establece el punto de inicio de la ingesta en el destino. AEM Si Borrar está habilitado, el destino que incluye todo su contenido se restablecerá a la versión de que se especifica en Cloud Manager. Si no está habilitado, el destino mantiene su contenido actual como punto de partida.
      • Esta opción NOT afecta a la forma en que se realizará la ingesta de contenido. La ingesta siempre usa una estrategia de reemplazo de contenido y no una estrategia de combinación de contenido, por lo que, en los casos de borrado y sin borrado, la ingesta de un conjunto de migración sobrescribirá el contenido en la misma ruta de acceso del destino. Por ejemplo, si el conjunto de migración contiene /content/page1 y el destino ya contiene /content/page1/product1, la ingesta elimina toda la ruta de acceso de page1 y sus subpáginas, incluida product1, y la reemplaza por el contenido del conjunto de migración. Esto significa que se debe realizar una planificación cuidadosa al realizar una ingesta de Sin borrado en un destino que contenga cualquier contenido que se deba mantener.
    note important
    IMPORTANT
    Si el ajuste Borrar está habilitado para la ingesta, restablecerá todo el repositorio existente, incluidos los permisos de usuario en la instancia de Cloud Service de destino. Este restablecimiento también se aplica a un usuario administrador agregado al grupo de administradores y ese usuario debe agregarse de nuevo al grupo de administradores para iniciar una ingesta.
    • Copia previa: Elija el valor Pre-copy

      • Puede ejecutar el paso opcional previo a la copia para acelerar de forma significativa la ingesta. Consulte Ingesta con AzCopy para obtener más información.
      • Si se utiliza la ingesta con copia previa (para S3 o Azure Data Store), se recomienda ejecutar la ingesta de Author primero solo. Al hacerlo, se acelera la ingesta de Publish cuando se ejecuta más adelante.
    note important
    IMPORTANT
    AEM Solo puede iniciar una ingesta en el entorno de destino si pertenece al grupo local administradores en el servicio de creación de Cloud Service de destino Si no puede iniciar una ingesta, consulte No se puede iniciar la ingesta para obtener más detalles.
  4. Una vez seleccionadas las opciones de ingesta, se mostrará una estimación de su duración. Se trata de una estimación del esfuerzo máximo basada en datos históricos de ingestas similares.

    • Esta estimación solo se calcula y se muestra si los valores "Comprobar tamaño" de la extracción se recopilaron y están disponibles.
    • Este valor es una estimación y, aunque se calcula de forma inteligente, no debe considerarse exacto. Varios factores pueden cambiar la duración real.
    • Mientras se ejecuta la ingesta, este valor también estará disponible en el cuadro de diálogo de duraciones, al que se accede mediante la acción "Ver duraciones" de la ingesta.

imagen

  1. Haga clic en Ingesta.

    imagen

  2. A continuación, puede monitorizar la ingesta desde la vista de lista de Trabajos de ingesta y utilizar el menú de acciones de la ingesta para ver las duraciones y registrar como progresa la ingesta.

    imagen

  3. Haga clic en el botón (i) de la fila para obtener más información sobre el trabajo de ingesta. Puede ver la duración de cada paso de la ingesta cuando se está ejecutando o se ha completado haciendo clic en y, a continuación, haciendo clic en Ver duraciones. La información de la extracción también muestra que se da cuenta de lo que se está ingiriendo.

    imagen

Ingesta superior top-up-ingestion-process

La herramienta de transferencia de contenido tiene una característica que permite extraer contenido diferencial realizando una recarga del conjunto de migración. Esto permite modificar el conjunto de migración para incluir únicamente el contenido que ha cambiado desde la extracción anterior sin tener que extraer todo el contenido de nuevo.

NOTE
Después de la transferencia de contenido inicial, se recomienda realizar frecuentes recargas de contenido diferencial para acortar el período de congelación de contenido para la transferencia de contenido diferencial final antes de lanzarse al Cloud Service. Si ha utilizado el paso de precopia para la primera ingesta, puede omitir la precopia para las ingestas de recarga posteriores (si el tamaño del conjunto de migración de recarga es inferior a 200 GB). El motivo es que puede añadir tiempo a todo el proceso.

Para ingerir contenido diferencial una vez que se hayan completado algunas ingestas, debe ejecutar una Extracción superior y luego usar el método de ingesta con la opción Borrar deshabilitada. No olvide leer la explicación Borrar anterior para evitar perder contenido que ya se encuentra en el destino.

Comience creando un trabajo de ingesta y asegúrese de que Borrar esté deshabilitado durante la ingesta, como se muestra a continuación:

imagen

Resolución de problemas troubleshooting

CAM no puede recuperar el token de migración cam-unable-to-retrieve-the-migration-token

La recuperación automática del token de migración puede fallar por diferentes motivos, entre ellos configurar una lista de permitidos IP a través de Cloud Manager en el entorno del Cloud Service de destino. En estos casos, verá el siguiente cuadro de diálogo cuando intente iniciar una ingesta:

imagen

Recupere el token de migración manualmente haciendo clic en el vínculo "Obtener token" en el cuadro de diálogo. Se abre otra pestaña que muestra el token. A continuación, puede copiar el token y pegarlo en el campo Entrada de token de migración. Ahora, debería poder iniciar la ingesta.

NOTE
AEM El token está disponible para los usuarios que pertenecen al grupo administradores locales del servicio de autor del Cloud Service de destino.

No se puede iniciar la ingesta unable-to-start-ingestion

AEM Solo puede iniciar una ingesta en el entorno de destino si pertenece al grupo local administradores en el servicio de creación de Cloud Service de destino AEM Si no pertenece al grupo de administradores de la, verá un error como se muestra a continuación cuando intente iniciar una ingesta. AEM Puede pedirle al administrador que le añada a los administradores locales o que le pida el token en sí, que puede pegar en el campo Entrada del token de migración.

imagen

No se puede conectar con el servicio de migración unable-to-reach-migration-service

Después de solicitar una ingesta, se puede presentar al usuario un mensaje como el siguiente: "El servicio de migración en el entorno de destino es inaccesible. Si es así, vuelva a intentarlo más tarde o póngase en contacto con el soporte de Adobe".

imagen

Este mensaje indica que Cloud Acceleration Manager no pudo contactar con el servicio de migración del entorno de destino para iniciar la ingesta. Esta situación puede ocurrir por varias razones.

NOTE
El campo "Token de migración" se muestra porque, en algunos casos, la recuperación de ese token es lo que realmente no está permitido. Al permitir que se proporcione manualmente, puede permitir al usuario iniciar la ingesta rápidamente, sin ninguna ayuda adicional. Si se proporciona el token y sigue apareciendo el mensaje, el problema no consistió en recuperar el token.
  • AEM as a Cloud Service mantiene el estado del entorno y, ocasionalmente, debe reiniciar el servicio de migración por varios motivos normales. Si ese servicio se está reiniciando, no se podrá acceder a él, pero estará disponible en algún momento.
  • Es posible que se esté ejecutando otro proceso en la instancia. AEM Por ejemplo, si Actualizaciones de versión de está aplicando una actualización, es posible que el sistema esté ocupado y que el servicio de migración no esté disponible con regularidad. Una vez completado ese proceso, se puede volver a intentar iniciar la ingesta.
  • Si se ha aplicado una Lista de permitidos de IP a través de Cloud Manager, se bloquea el acceso de Cloud Acceleration Manager al servicio de migración. No se puede añadir una dirección IP para ingestas porque es dinámica. Actualmente, la única solución es deshabilitar la lista de permitidos de IP durante el proceso de ingesta e indexación.
  • Puede haber otras razones que requieren investigación. Si la ingesta o la indexación siguen fallando, póngase en contacto con el Servicio de atención al cliente de Adobe.

AEM Actualizaciones e ingestas de versiones de aem-version-updates-and-ingestions

AEM Las actualizaciones de versión de se aplican automáticamente a los entornos para mantenerlos actualizados con la versión más reciente de AEM as a Cloud Service. Si la actualización se activa cuando se realiza una ingesta, puede causar resultados impredecibles, incluido el daño del entorno.

AEM Si el programa de destino incorpora las "Actualizaciones de versión de", el proceso de ingesta intenta deshabilitar su cola antes de iniciarse. Cuando se completa la ingesta, el estado del actualizador de versiones se devuelve a como estaba antes de que se iniciaran las ingestas.

NOTE
AEM Ya no es necesario registrar un ticket de asistencia para desactivar las "Actualizaciones de versión de la versión de la aplicación" de la aplicación.

AEM Si "Actualizaciones de la versión de la versión de la" está activo (es decir, las actualizaciones se están ejecutando o están en cola para ejecutarse), la ingesta no comenzará y la interfaz de usuario mostrará el siguiente mensaje. Una vez completadas las actualizaciones, se puede iniciar la ingesta. Cloud Manager se puede utilizar para ver el estado actual de las canalizaciones del programa.

NOTE
AEM "Actualizaciones de la versión de la aplicación" se ejecuta en la canalización del entorno y espera hasta que la canalización esté limpia. Si las actualizaciones se ponen en cola durante más tiempo del esperado, asegúrese de que un flujo de trabajo personalizado no tenga la canalización bloqueada de forma involuntaria.

imagen

Error de ingesta de recarga debido a una infracción de la restricción de unicidad top-up-ingestion-failure-due-to-uniqueness-constraint-violation

Una causa común de un error de ingesta superior es un conflicto en los identificadores de nodo. Para identificar este error, descargue el registro de ingesta mediante la interfaz de usuario de Cloud Acceleration Manager y busque una entrada como la siguiente:

java.lang.RuntimeException: org.apache.jackrabbit.oak.api.CommitFailedException: OakConstraint0030: La restricción de unicidad violó la propiedad [jcr:uuid] con valor a1a1a1a1a1-b2b2-c3c3-d4d4-e5e5e5e5e5e5: /some/path/jcr:content, /some/other/path/jcr:content

AEM Cada nodo de la interfaz de usuario de debe tener un uuid único. Este error indica que un nodo que se está ingiriendo tiene el mismo uuid que uno que existe en una ruta diferente en la instancia de destino. Esta situación puede ocurrir por dos razones:

  • Un nodo se mueve en el origen entre una extracción y una extracción superior posterior
    • RECORDAR: Para las extracciones de nivel superior, el nodo seguirá existiendo en el conjunto de migración, aunque ya no exista en el origen.
  • Un nodo en el destino se mueve entre una ingesta y una ingesta superior subsiguiente.

Este conflicto debe resolverse manualmente. Alguien familiarizado con el contenido debe decidir cuál de los dos nodos se debe eliminar, teniendo en cuenta otro contenido que haga referencia a él. La solución puede requerir que la extracción superior se realice de nuevo sin el nodo infractor.

Error de ingesta de recarga debido a que no se puede eliminar el nodo al que se hace referencia top-up-ingestion-failure-due-to-unable-to-delete-referenced-node

Otra causa común de un error de Ingesta superior es un conflicto de versión para un nodo en particular en la instancia de destino. Para identificar este error, descargue el registro de ingesta mediante la interfaz de usuario de Cloud Acceleration Manager y busque una entrada como la siguiente:

java.lang.RuntimeException: org.apache.jackrabbit.oak.api.CommitFailedException: OakIntegrity0001: No se puede eliminar el nodo al que se hace referencia: 8a2289f4-b904-4bd0-8410-15e41e0976a8

Esto puede ocurrir si se modifica un nodo en el destino entre una ingesta y una ingesta posterior de Sin borrado de tal manera que se ha creado una nueva versión. Si el conjunto de migración se ha extraído con la opción "incluir versiones" habilitada, puede producirse un conflicto, ya que el destino tiene ahora una versión más reciente a la que hacen referencia el historial de versiones y otro contenido. El proceso de ingesta no puede eliminar el nodo de versión infractor porque se hace referencia a él.

La solución puede requerir que la extracción superior se realice de nuevo sin el nodo infractor. O bien, creando un pequeño conjunto de migración del nodo infractor, pero con la opción "incluir versiones" deshabilitada.

Las prácticas recomendadas indican que si se debe ejecutar una ingesta de Non-Wipe mediante un conjunto de migración que incluya versiones, es crucial que el contenido del destino se modifique lo menos posible, hasta que se complete el recorrido de migración. De lo contrario, pueden producirse estos conflictos.

Error de ingesta debido a valores de propiedad de nodos grandes ingestion-failure-due-to-large-node-property-values

Los valores de propiedad del nodo almacenados en MongoDB no pueden superar los 16 MB. Si un valor de nodo supera el tamaño admitido, la ingesta falla y el registro contendrá un error de BSONObjectTooLarge y especificará qué nodo superó el máximo. Esta es una restricción de MongoDB.

Consulte la nota Node property value in MongoDB en Requisitos previos para la herramienta de transferencia de contenido para obtener más información y un vínculo a una herramienta de Oak que pueda ayudar a encontrar todos los nodos grandes. Una vez corregidos todos los nodos con tamaños grandes, ejecute de nuevo la extracción y la ingesta.

AEM Para evitar posiblemente esta restricción, ejecute el Analizador de prácticas recomendadas en la instancia de origen y revise los resultados que presenta, en particular el patrón "Estructura de repositorio no admitida" (URS).

Ingesta rescindida ingestion-rescinded

Una ingesta creada con una extracción en ejecución como el conjunto de migración de origen espera pacientemente hasta que la extracción se realice correctamente y, en ese momento, comienza con normalidad. Si la extracción falla o se detiene, la ingesta y su trabajo de indexación no comenzarán, pero se rescindirán. En este caso, compruebe la extracción para determinar por qué ha fallado, corrija el problema y vuelva a empezar a extraer. Una vez que se esté ejecutando la extracción fija, se puede programar una nueva ingesta.

El recurso eliminado no está presente después de volver a ejecutar la ingesta

En general, no se recomienda modificar los datos del entorno de la nube entre ingestas.

Cuando se elimina un recurso del destino del Cloud Service mediante la IU táctil de Assets, los datos del nodo se eliminan, pero el blob de recursos con la imagen no se elimina inmediatamente. Se marca para su eliminación de modo que ya no aparezca en la interfaz de usuario; sin embargo, permanece en el almacén de datos hasta que se produce la recolección de elementos no utilizados y se elimina el blob.

En el escenario en el que se elimina un recurso migrado anteriormente y la siguiente ingesta se ejecuta antes de que el recolector de elementos no utilizados haya terminado de eliminar el recurso, la ingesta del mismo conjunto de migración no restaurará el recurso eliminado. Cuando la ingesta comprueba el entorno de nube del recurso, no hay datos del nodo; por lo tanto, la ingesta copiará los datos del nodo en el entorno de nube. Sin embargo, cuando comprueba el almacén de blobs, ve que el blob está presente y omite la copia del blob. Por este motivo, los metadatos están presentes después de la ingesta cuando se mira el recurso desde la interfaz de usuario táctil, pero la imagen no. Recuerde que los conjuntos de migración y la ingesta de contenido no se diseñaron para manejar este caso. Su objetivo es añadir contenido nuevo al entorno de la nube y no restaurar el contenido migrado anteriormente.

Siguientes pasos whats-next

AEM Cuando la ingesta se haya realizado correctamente, la indexación de la se iniciará automáticamente. Consulte Indexación después de migrar contenido para obtener más información.

Una vez que haya completado la ingesta de contenido en Cloud Service, puede ver los registros de cada paso (extracción e ingesta) y buscar errores. Consulte Visualización de registros de un conjunto de migración para obtener más información.

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