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:
-
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
-
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.
-
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 nivelAuthoren el destino. Del mismo modo, si el origen eraPublish, el destino debería serPublishtambién.
- Si el origen era
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/page1y el destino ya contiene/content/page1/product1, la ingesta elimina toda la ruta de acceso depage1y sus subpáginas, incluidaproduct1, 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. - Las ingestas sin borrado están diseñadas específicamente para el caso de uso de ingesta superior. Estas ingestas están pensadas para tener una cantidad incremental de contenido nuevo que ha cambiado desde la última ingesta en un conjunto de migración existente. La realización de ingestas sin borrado fuera de este caso de uso podría provocar tiempos de ingesta muy largos.
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
Authorprimero solo. Al hacerlo, se acelera la ingesta dePublishcuando 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. - Conjunto de migración: Seleccione el conjunto de migración que contiene los datos extraídos como Source.
-
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.
-
Haga clic en Ingesta.
-
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.
-
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.
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.
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:
Solució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:
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.
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.
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".
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.
- 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.
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.
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 el valor de un nodo supera el tamaño admitido, la ingesta falla y el registro contiene lo siguiente:
- un error
BSONObjectTooLargey especifique qué nodo superó el máximo, o - error
BsonMaximumSizeExceededException, que indica que es probable que haya un nodo que contenga caracteres unicode que exceda el tamaño 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).
Error de ingesta debido a errores intermitentes inesperados ingestion-failure-due-to-unexpected-intermittent-errors
A veces, problemas intermitentes inesperados podrían prestarse a ingestas fallidas donde, por desgracia, el único recurso es reintentar la ingesta. Investigue el registro de ingesta para descubrir la causa del error y ver si se ajusta a alguno de los errores enumerados a continuación, donde se debe intentar un reintento.
Problemas de MongoDB mongo-db-issues
Atlas prescale timeout error: en la fase de ingesta se intentará escalar previamente la base de datos de la nube de Target a un tamaño adecuado que se ajuste al tamaño del contenido del conjunto de migración que se está ingiriendo. De forma poco frecuente, esta operación no se completa dentro del intervalo de tiempo esperado.Exhausted mongo restore retries: se agotaron los intentos de restaurar un volcado local del contenido del conjunto de migración ingerido en la base de datos de la nube. Esto indica un problema general de salud/red con MongoDB, que a menudo se cura solo después de unos minutos.
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.