DocumentaciónAEMTutoriales de AEMTutoriales de AEM as a Cloud Service

Solucionar problemas de extensibilidad de Asset compute

Last update: Sun Jul 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creado para:

  • Intermedio
  • Experimentado
  • Desarrollador

A continuación se muestra un índice de problemas y errores comunes, junto con las soluciones que podrían encontrarse al desarrollar e implementar Assets computes personalizadas para AEM Assets.

Desarrollar develop

La representación se devuelve parcialmente dibujada/dañada rendition-returned-partially-drawn-or-corrupt

  • Error: la representación no se procesa por completo (cuando hay una imagen) o está dañada y no se puede abrir.

    La representación se ha devuelto parcialmente dibujada

  • Causa: la función renditionCallback del trabajador se está cerrando antes de que la representación se pueda escribir completamente en rendition.path.

  • Resolución: revise el código de trabajo personalizado y asegúrese de que todas las llamadas asincrónicas se realizan sincrónicas mediante await.

Herramienta de desarrollo development-tool

Falta el archivo Console.json en el proyecto de Asset compute missing-console-json

  • Error: Error: faltan los archivos necesarios en la validación (.../node_modules/@adobe/asset-compute-client/lib/integrationConfiguration.js:XX:YY) en setupAssetCompute asincrónico (.../node_modules/@adobe/asset-compute-devtool/src/assetComputeDevTool.js:XX:YY)

  • Causa: Falta el archivo console.json en la raíz del proyecto de Asset compute

  • Resolución: Descargue un nuevo(a) console.json de su proyecto de Adobe I/O

    1. En console.adobe.io, abra el proyecto de Adobe I/O que el proyecto de Asset compute está configurado para utilizar
    2. Pulsa el botón Descargar en la parte superior derecha
    3. Guarde el archivo descargado en la raíz del proyecto de Asset compute con el nombre de archivo console.json

Sangría YAML incorrecta en manifest.yml incorrect-yaml-indentation

  • Error: YAMLException: sangría incorrecta de una entrada de asignación en la línea X, columna Y:(a través de la salida estándar del comando aio app run)
  • Causa: los archivos Yaml distinguen entre espacios en blanco, por lo que es probable que la sangría sea incorrecta.
  • Resolución: Revise su manifest.yml y asegúrese de que toda la sangría sea correcta.

El límite memorySize se ha establecido en un valor demasiado bajo memorysize-limit-is-set-too-low

  • Error: OpenWhiskError del servidor de desarrollo local: PUT https://adobeioruntime.net/api/v1/namespaces/xxx-xxx-xxx/actions/xxx-0.0.1/__secured_workeroverwrite=true Devolvió HTTP 400 (Solicitud incorrecta) —> "El contenido de la solicitud tenía un formato incorrecto: error de requisito: la memoria está 64 MB por debajo del umbral permitido de 134217728 B"
  • Causa: Se estableció un límite de memorySize para el trabajador en manifest.yml por debajo del umbral mínimo permitido indicado en el mensaje de error en bytes.
  • Resolución: Revise los límites de memorySize en manifest.yml y asegúrese de que todos superen el umbral mínimo permitido.

No se puede iniciar la herramienta de desarrollo porque falta private.key missing-private-key

  • Error: Error del servidor de desarrollo local: faltan los archivos necesarios en validatePrivateKeyFile… (mediante salida estándar desde el comando aio app run)
  • Causa: El valor ASSET_COMPUTE_PRIVATE_KEY_FILE_PATH del archivo .env, no apunta a private.key o private.key no es legible para el usuario actual.
  • Resolución: Revise el valor ASSET_COMPUTE_PRIVATE_KEY_FILE_PATH del archivo .env y asegúrese de que contiene la ruta de acceso completa y absoluta a private.key en su sistema de archivos.

Menú desplegable de archivos Source incorrecto source-files-dropdown-incorrect

Es posible que la herramienta de desarrollo de assets computes introduzca un estado en el que extrae datos antiguos y que sea más visible en la lista desplegable archivo Source que muestra elementos incorrectos.

  • Error: La lista desplegable del archivo Source muestra elementos incorrectos.
  • Causa: El estado de explorador en caché obsoleto causa el error
  • Resolución: En su explorador borre completamente el "estado de aplicación" de la ficha del explorador, la caché del explorador, el almacenamiento local y el trabajador de servicio.

Parámetro de consulta devToolToken faltante o no válido missing-or-invalid-devtooltoken-query-parameter

  • Error: notificación "no autorizada" en la herramienta de desarrollo de Assets computes
  • Falta la causa: devToolToken o no es válida
  • Resolución: Cierre la ventana del explorador de la Herramienta de desarrollo de Assets computes, termine cualquier proceso de la Herramienta de desarrollo que se esté ejecutando iniciado mediante el comando aio app run y vuelva a iniciar la Herramienta de desarrollo (con aio app run).

No se pueden eliminar los archivos de origen unable-to-remove-source-files

  • Error: No hay forma de quitar los archivos de origen agregados de la interfaz de usuario de las herramientas de desarrollo

  • Causa: Esta funcionalidad no se ha implementado

  • Resolución: Inicie sesión en su proveedor de almacenamiento en la nube con las credenciales definidas en .env. Busque el contenedor utilizado por las herramientas de desarrollo (también especificado en .env), navegue hasta la carpeta source y elimine las imágenes de origen. Es posible que tenga que realizar los pasos descritos en Lista desplegable de archivos Source incorrecta si los archivos de origen eliminados siguen mostrándose en la lista desplegable, ya que pueden almacenarse en la caché local en el "estado de aplicación" de las herramientas de desarrollo.

    Almacenamiento de blob de Microsoft Azure

Prueba test

No se ha generado ninguna representación durante la ejecución de la prueba test-no-rendition-generated

  • Error: Error: No se generó ninguna representación.

  • Causa: El trabajador no pudo generar una representación debido a un error inesperado, como un error de sintaxis de JavaScript.

  • Resolución: Revise test.log de la ejecución de la prueba a las /build/test-results/test-worker/test.log. Busque la sección de este archivo correspondiente al caso de prueba que falla y revise los errores.

    Solución de problemas - No se generó ninguna representación

La prueba genera una representación incorrecta que provoca que la prueba falle tests-generates-incorrect-rendition

  • Error: Error: La representación 'rendition.xxx' no es la esperada.

  • Causa: El trabajador generó una representación que no era la misma que la rendition.<extension> proporcionada en el caso de prueba.

    • Si el archivo rendition.<extension> esperado no se crea exactamente de la misma manera que la representación generada localmente en el caso de prueba, es posible que la prueba falle, ya que puede haber alguna diferencia en los bits. Por ejemplo, si el trabajador de Asset compute cambia el contraste mediante API y el resultado esperado se crea ajustando el contraste en Adobe Photoshop CC, los archivos pueden aparecer igual, pero las variaciones menores en los bits pueden ser diferentes.

  • Resolución: revise el resultado de la representación de la prueba navegando hasta /build/test-worker/<worker-name>/<test-run-timestamp>/<test-case>/rendition.<extension> y compárelo con el archivo de representación esperado en el caso de prueba. Para crear un recurso esperado exacto, haga lo siguiente:

    • Utilice la herramienta de desarrollo para generar una representación, valide que es correcta y utilícela como el archivo de representación esperado
    • O bien, valide el archivo generado por la prueba en /build/test-worker/<worker-name>/<test-run-timestamp>/<test-case>/rendition.<extension>, valide que es correcto y utilícelo como el archivo de representación esperado

Depurar

El depurador no se asocia debugger-does-not-attach

  • Error: Error al procesar el inicio: Error: No se pudo conectar con el destino de depuración en…
  • Causa: Docker Desktop no se está ejecutando en el sistema local. Compruebe esto revisando la consola de depuración de código de VS (Ver > Consola de depuración), confirmando que se ha informado de este error.
  • Resolución: Inicie Docker Desktop y confirme que se han instalado las imágenes de Docker necesarias.

Los puntos de interrupción no se pausan breakpoints-no-pausing

  • Error: Al ejecutar el trabajo de Asset compute desde la herramienta de desarrollo de depuración, el código VS no se pausa en los puntos de interrupción.

El depurador de código VS no está adjunto vs-code-debugger-not-attached

  • Causa: Se detuvo o desconectó el depurador de código de VS.
  • Resolución: Reinicie el depurador de código de VS y compruebe que se adjunta observando la consola de salida de depuración de código de VS (Ver > Consola de depuración)

Se adjuntó el depurador de código VS después de iniciar la ejecución del trabajador vs-code-debugger-attached-after-worker-execution-began

  • Causa: El depurador de código VS no se adjuntó antes de pulsar Ejecutar en la herramienta de desarrollo.
  • Resolución: Asegúrese de que el depurador se ha adjuntado revisando la consola de depuración de VS Code (Ver > Consola de depuración) y, a continuación, vuelva a ejecutar el trabajo de Asset compute desde la herramienta de desarrollo.

Se agota el tiempo de espera del trabajador durante depuración worker-times-out-while-debugging

  • Error: la consola de depuración informa de que la acción agotará el tiempo de espera en -XXX milisegundos" o que la vista previa de la representación de Herramienta de desarrollo de Assets computes gira indefinidamente o
  • Causa: el tiempo de espera del trabajador definido en el manifest.yml se excede durante la depuración.
  • Resolución: aumente temporalmente el tiempo de espera del trabajador en manifest.yml o acelere las actividades de depuración.

No se puede finalizar el proceso del depurador cannot-terminate-debugger-process

  • Error: Ctrl-C en la línea de comandos no finaliza el proceso del depurador (npx adobe-asset-compute devtool).

  • Causa: Un error en @adobe/aio-cli-plugin-asset-compute 1.3.x hace que Ctrl-C no se reconozca como un comando de terminación.

  • Resolución: actualizar @adobe/aio-cli-plugin-asset-compute a la versión 1.4.1 o posterior

    code language-none 
    $ aio update

    Solución de problemas - actualización de aio

Implementación de deploy

AEM Falta la representación personalizada en el recurso en el recurso en el que se ha realizado el custom-rendition-missing-from-asset

  • Error: Los recursos nuevos y reprocesados se procesaron correctamente, pero faltan en la representación personalizada

Perfil de procesamiento no aplicado a la carpeta antecesora

  • Causa: El recurso no existe en una carpeta con el perfil de procesamiento que usa el trabajador personalizado
  • Resolución: Aplicar el perfil de procesamiento a una carpeta antecesora del recurso

Perfil de procesamiento reemplazado por un perfil de procesamiento inferior

  • Causa: El recurso existe debajo de una carpeta con el perfil de procesamiento de trabajador personalizado aplicado, pero se ha aplicado un perfil de procesamiento diferente que no utiliza el trabajador del cliente entre esa carpeta y el recurso.
  • Resolución: Combine o reconcilie los dos perfiles de procesamiento y quite el perfil de procesamiento intermedio

AEM El procesamiento de recursos falla en la asset-processing-fails

  • Error: Error al procesar el recurso mostrado en el recurso
  • Causa: Se produjo un error en la ejecución del trabajador personalizado
  • Resolución: Siga las instrucciones de depuración de activaciones de Adobe I/O Runtime mediante aio app logs.
recommendation-more-help
4859a77c-7971-4ac9-8f5c-4260823c6f69