Solucionar problemas de extensibilidad de Asset compute

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 se procesa de forma incompleta (cuando una imagen) o está dañada y no se puede abrir.

    La representación se devuelve parcialmente dibujada

  • Causa: del trabajador renditionCallback 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ónicamente 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: El console.json falta un archivo en la raíz del proyecto de Asset compute

  • Resolución: Descargar una nueva 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. Pulse el botón Descargar botón en la parte superior derecha
    3. Guarde el archivo descargado en la raíz del proyecto de Asset compute utilizando 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 salida estándar de aio app run command)
  • Causa: Los archivos Yaml distinguen entre espacios en blanco y 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 es 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 en el requisito: la memoria está 64 MB por debajo del umbral permitido del 134217728 B"
  • Causa: A memorySize límite para el trabajador en manifest.yml se estableció por debajo del umbral mínimo permitido según lo informado por el mensaje de error en bytes.
  • Resolución: Revise la memorySize límites en la manifest.yml y asegúrese de que todos superan 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… (a través de salida estándar desde aio app run command)
  • Causa: El ASSET_COMPUTE_PRIVATE_KEY_FILE_PATH valor en .env archivo, no apunta a private.key o private.key el usuario actual no puede leer.
  • Resolución: Revise la ASSET_COMPUTE_PRIVATE_KEY_FILE_PATH valor en .env y asegúrese de que contiene la ruta completa y absoluta al archivo. private.key en su sistema de archivos.

Lista desplegable de archivos de origen incorrecta source-files-dropdown-incorrect

La herramienta de desarrollo de assets computes puede introducir un estado en el que extrae datos antiguos y es más visible en el Archivo de origen desplegable que muestra elementos incorrectos.

  • Error: La lista desplegable del archivo de origen muestra elementos incorrectos.
  • Causa: El estado de explorador en caché obsoleto provoca el
  • Resolución: En su navegador borre completamente el "estado de aplicación" de la pestaña del navegador, la caché del navegador, 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
  • Causa: devToolToken falta o no es válido
  • Resolución: Cierre la ventana del explorador de la Herramienta de desarrollo de Assets computes y finalice cualquier proceso de la Herramienta de desarrollo en ejecución iniciado mediante el 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 código fuente agregados de la IU 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), vaya al origen y elimine las imágenes de origen. Es posible que tenga que realizar los pasos descritos en Lista desplegable de archivos de origen incorrecta si los archivos de origen eliminados siguen mostrándose en el menú desplegable, ya que pueden almacenarse en la caché local en el "estado de aplicación" de las herramientas de desarrollo.

    Almacenamiento del 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 ha generado ninguna representación.

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

  • Resolución: Revise el de la ejecución de la prueba test.log en /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 genera 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 el rendition.<extension> en el caso de ensayo.

    • Si el rendition.<extension> El archivo no se crea de la misma manera que la representación generada localmente en el caso de prueba. La prueba puede fallar, 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
    • También puede validar 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 lanzamiento: Error: No se ha podido 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: inicio Docker Desktop y confirmar 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 trabajador de Asset compute desde la herramienta de desarrollo depurable, 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/desconectó el depurador de código de VS.
  • Resolución: Reinicie el depurador de código VS y compruebe que se adjunta mirando la consola de salida de depuración de código 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 de VS no se adjuntó antes de pulsar Ejecutar en la herramienta de desarrollo.
  • Resolución: Asegúrese de que el depurador se ha asociado revisando la consola de depuración del código VS (Ver > Consola de depuración) y, a continuación, vuelva a ejecutar el trabajador 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 "La acción agotará el tiempo de espera en -XXX milisegundos" o Herramienta de desarrollo de asset compute la previsualización de la representación gira indefinidamente o
  • Causa: el tiempo de espera del trabajador tal como se define en la manifest.yml se supera durante la depuración.
  • Resolución: Aumente temporalmente el tiempo de espera del trabajador en la manifest.yml o acelerar 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, resultados en Ctrl-C no se reconoce como un comando de terminación.

  • Resolución: actualización @adobe/aio-cli-plugin-asset-compute a la versión 1.4.1+

    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 procesan correctamente, pero falta 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 utiliza 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 elimine el perfil de procesamiento intermedio

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

  • Error: Distintivo de error de procesamiento de recursos mostrado en el recurso
  • Causa: Error en la ejecución del trabajador personalizado
  • Resolución: Siga las instrucciones de depurar activaciones de Adobe I/O Runtime usando aio app logs.
recommendation-more-help
4859a77c-7971-4ac9-8f5c-4260823c6f69