Resolución de problemas de extensibilidad del Asset compute
A continuación se muestra un índice de problemas y errores comunes, junto con las resoluciones, que podrían producirse al desarrollar e implementar Assets computes personalizados para AEM Assets.
Desarrollar
La representación se devuelve parcialmente dibujada/dañada
Error: La representación se procesa incompletamente (cuando una imagen está dañada) o no se puede abrir.
Causa: La renditionCallback función del trabajador se cierra 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
Falta el archivo Console.json en el proyecto de Asset compute
Error: Error: Faltan archivos requeridos en la validación (…/node_module/@adobe/asset-compute-client/lib/integrationConfiguration.:XX:jsYY) en async setupAssetCompute (…/node_module/@adobe/asset-compute-devtool/src/assetComputeDevTool.:XX:jsYY)
Causa: falta el console.json archivo en la raíz del proyecto de Asset compute
Resolución: Descargar un nuevo console.json formulario del proyecto de Adobe I/O
En console.adobe.io, abra el proyecto de Adobe I/O que el proyecto de Asset compute está configurado para usar
Toque el botón Download en la parte superior derecha
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
Error: YAMLException: sangría incorrecta de una entrada de asignación en la línea X, columna Y: (a través de standard out from aio app run command)
Causa: Los archivos de Yaml distinguen entre espacios en blanco, es probable que la sangría sea incorrecta.
Solución: revise su manifest.yml y asegúrese de que toda la sangría sea correcta.
memorySize limit está configurado en demasiado bajo
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 HTTP 400 devuelto (solicitud incorrecta) —> "El contenido de la solicitud tenía un formato incorrecto:requisito fallido: memoria 64 MB por debajo del umbral permitido de 134217728 B"
Causa: se memorySize estableció un manifest.yml límite para el trabajador en por debajo del umbral mínimo permitido, tal como indica el mensaje de error en bytes.
Solución: revise los memorySize límites en manifest.yml y asegúrese de que son todos grandes con respecto al umbral mínimo permitido.
La herramienta de desarrollo no se puede iniciar debido a la falta de private.key
Error: Error del servidor de desarrollo local: Faltan archivos necesarios en validatePrivateKeyFile… (a través del comando estándar out de aio app run)
Causa: el ASSET_COMPUTE_PRIVATE_KEY_FILE_PATH valor del .env archivo no apunta a private.key o el usuario actual no private.key puede leerlo.
Solución: revise el ASSET_COMPUTE_PRIVATE_KEY_FILE_PATH valor del .env archivo y asegúrese de que contiene la ruta completa y absoluta a private.key la del sistema de archivos.
Lista desplegable de archivos de origen incorrecta
La herramienta de desarrollo de assets computes puede introducir un estado en el que extrae datos antiguos y es más visible en el menú desplegable Source file que muestra elementos incorrectos.
Error: la lista desplegable Archivo de origen muestra los elementos incorrectos.
Causa: el estado del explorador almacenado en caché antiguo hace que la variable
Solución: En el explorador, borre completamente el "estado de la aplicación" de la pestaña del explorador, la caché del explorador, el almacenamiento local y el trabajador del servicio.
Falta el parámetro de consulta devToolToken o no es válido
Error: notificación "no autorizada" en la herramienta de desarrollo de Asset compute
Causa:devToolToken falta o no es válido
Solución: cierre la ventana del explorador de la herramienta de desarrollo de Asset compute, finalice los procesos de la herramienta de desarrollo que se ejecuten iniciados mediante el aio app run comando y reinicie la herramienta de desarrollo (con aio app run).
No se pueden quitar los archivos de origen
Error: no hay forma de eliminar los archivos de origen añadidos de la interfaz de usuario de las herramientas de desarrollo
Causa: esta funcionalidad no se ha implementado
Solución: inicie sesión en el proveedor de almacenamiento en la nube con las credenciales definidas en .env. Busque el contenedor utilizado por las herramientas de desarrollo (también especificadas en .env), navegue hasta la carpeta source y elimine las imágenes de origen. Es posible que tenga que realizar los pasos descritos en la lista desplegable Source files grepldown incorrecto si los archivos de origen eliminados siguen mostrándose en la lista desplegable, ya que se pueden almacenar en caché localmente en el "estado de aplicación" de las herramientas de desarrollo.
Probar
No se genera ninguna representación durante la ejecución de la prueba
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.
Solución: revise la ejecución de la prueba test.log en /build/test-results/test-worker/test.log. Busque la sección en este archivo correspondiente al caso de prueba fallido y revise si hay errores.
La prueba genera una representación incorrecta, lo que provoca que la prueba falle
Error: error: La representación "rendition.xxx" no se ajusta a lo esperado.
Causa: el trabajador genera una representación que no es la misma que la rendition.<extension> proporcionada en el caso de prueba.
Si el archivo rendition.<extension> esperado 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 programa de trabajo del Asset compute cambia el contraste mediante API y el resultado esperado se crea ajustando el contraste en Adobe Photoshop CC, los archivos pueden aparecer del mismo modo, pero las variaciones menores en los bits pueden ser diferentes.
Solución: revise la salida de representación de la prueba navegando hasta /build/test-worker/<worker-name>/<test-run-timestamp>/<test-case>/rendition.<extension> y compárela 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, validar que sea correcta y utilizarla 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
Debugger no se adjunta
Error: Error al procesar el inicio: Error: No se pudo conectar para depurar el destino en…
Causa: Docker Desktop no se está ejecutando en el sistema local. Para verificarlo, revise la consola de depuración de código de VS (Ver > Consola de depuración), confirmando este error.
Error: Al ejecutar el programa de trabajo 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
Causa: el depurador de código VS se detuvo/desconectó.
Solución: reinicie el depurador de código VS y verifique que se adjunte mirando la consola de salida de depuración de código VS (Ver > Consola de depuración)
Depurador de código VS adjunto después de iniciar la ejecución del trabajo
Causa: el depurador de código VS no se adjuntó antes de pulsar la ____ Herramienta de desarrollo de ejecución.
Solució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 programa de trabajo de Asset compute desde la herramienta de desarrollo.
Se agota el tiempo de espera del trabajo durante la depuración
Error: La consola de depuración informa de que la acción agotará el tiempo de espera en -XXX milisegundos" o de que la vista previa de la herramienta de desarrollo de Asset compute gira indefinidamente o
Causa: Se ha superado el tiempo de espera de trabajador definido en manifest. ymlis durante la depuración.
Resolución: Aumente temporalmente el tiempo de espera del trabajador en manifest. ymlor acelere las actividades de depuración.
No se puede finalizar el proceso de depuración
Error: Ctrl-C en la línea de comandos no finaliza el proceso de depuración (npx adobe-asset-compute devtool).
Causa: Un error en @adobe/aio-cli-plugin-asset-compute 1.3.x 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+
$ aio update
Implementar
Falta una representación personalizada en el recurso en AEM
Error: los recursos nuevos y reprocesados se procesan correctamente, pero no tienen 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 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.
Solución: combine o reconcilie los dos perfiles de procesamiento y elimine el perfil de procesamiento intermedio
El procesamiento de recursos falla en AEM
Error: se muestra el distintivo Error en el procesamiento de recursos en el recurso
Causa: error en la ejecución del trabajador personalizado
Solución: siga las instrucciones sobre la depuración de la activación de Adobe I/O Runtime mediante aio app logs.
