Résolution des problèmes d'extensibilité des Assets compute

Vous trouverez ci-dessous un index des problèmes et erreurs courants, ainsi que des résolutions, qui peuvent se produire lors du développement et du déploiement de travailleurs d'Asset compute personnalisés pour AEM Assets.

Développer

Le rendu est renvoyé partiellement dessiné/corrompu

  • Erreur : Le rendu est rendu incomplet (lorsqu’une image) ou endommagé et ne peut pas être ouvert.

    Le rendu est renvoyé partiellement tracé

  • Cause : La renditionCallback fonction du collaborateur s’arrête avant que le rendu ne puisse être entièrement écrit rendition.path.

  • Résolution : Vérifiez le code de travail personnalisé et assurez-vous que tous les appels asynchrones sont effectués de manière synchrone à l’aide de await.

Outil de développement

Fichier Console.json manquant dans le projet d'Asset compute

  • Erreur : Erreur : Fichiers requis manquants lors de la validation (…/node_modules/@adobe/asset-compute-client/lib/integrationConfiguration.js:XX:YY) sur async setupAssetCompute (…/node_modules/@adobe/asset-compute-devtool/src/assetComputeDevTool.js:XX:YY)
  • Cause : Le console.json fichier est absent de la racine du projet d'Asset compute
  • Résolution : Télécharger un nouveau console.json formulaire à partir de votre projet Adobe I/O
    1. Dans console.adobe.io, ouvrez le projet Adobe I/O que le projet Asset compute est configuré pour utiliser
    2. Appuyez sur le bouton Télécharger en haut à droite.
    3. Enregistrez le fichier téléchargé à la racine de votre projet d’Asset compute en utilisant le nom de fichier console.json.

Retrait YAML incorrect dans manifest.yml

  • Erreur : YAMLException : indentation incorrecte d'une entrée de mappage à la ligne X, colonne Y : (via standard out from aio app run command)
  • Cause : les fichiers Yaml sont sensibles à l’espacement blanc ; il est probable que votre mise en retrait soit incorrecte.
  • Résolution : Vérifiez votre mise en retrait manifest.yml et assurez-vous que toutes les mises en retrait sont correctes.

La limite memorySize est définie sur too low

  • Erreur : OpenWhiskError du serveur de développement local : PUT https://adobeioruntime.net/api/v1/namespaces/xxx-xxx-xxx/actions/xxx-0.0.1/__secured_workeroverwrite=true renvoyé HTTP 400 (Requête incorrecte) —> "Le contenu de la requête n’est pas correct : l’exigence a échoué : mémoire 64 Mo en dessous du seuil autorisé de 134217728 B"
  • Cause : Une memorySize limite pour le collaborateur dans le manifest.yml a été définie en dessous du seuil minimum autorisé, comme indiqué par le message d'erreur en octets.
  • Résolution : Vérifiez les memorySize limites dans le manifest.yml et assurez-vous qu'elles sont toutes supérieures au seuil minimum autorisé.

L'outil de développement ne peut pas être début en raison de l'absence de private.key

  • Erreur : serveur de développement localErreur : Fichiers requis manquants à validatePrivateKeyFile… (via standard out from aio app run command)
  • Cause : La ASSET_COMPUTE_PRIVATE_KEY_FILE_PATH valeur du .env fichier ne pointe pas vers private.key ou private.key n'est pas lisible par l'utilisateur actuel.
  • Résolution : Vérifiez la ASSET_COMPUTE_PRIVATE_KEY_FILE_PATH valeur du .env fichier et assurez-vous qu'elle contient le chemin d'accès complet et absolu au fichier private.key sur votre système de fichiers.

Liste déroulante des fichiers source incorrecte

L'outil de développement d'Asset compute peut entrer un état où il extrait les données obsolètes et est le plus visible dans la liste déroulante Fichier source affichant des éléments incorrects.

  • Erreur : la liste déroulante du fichier source affiche des éléments incorrects.
  • Cause : l'état obsolète du navigateur mis en cache provoque la
  • Résolution : dans votre navigateur, effacez complètement l'"état d'application" de l'onglet du navigateur, le cache du navigateur, l'enregistrement local et le travailleur de services.

Paramètre de requête devToolToken manquant ou non valide

  • Erreur : notification "non autorisée" dans l'outil de développement d'Asset compute
  • Cause : devToolToken est manquante ou non valide
  • Résolution : fermez la fenêtre du navigateur de l'outil de développement d'Asset compute, arrêtez tout processus d'outil de développement en cours d'exécution initié par l'intermédiaire de la aio app run commande, puis redébut Development Tool (à l'aide aio app run).

Impossible de supprimer les fichiers source

  • Erreur : il n’existe aucun moyen de supprimer les fichiers source ajoutés de l’interface utilisateur des outils de développement.

  • Cause : Cette fonctionnalité n'a pas été implémentée

  • Résolution : connectez-vous à votre fournisseur d'enregistrements cloud à l'aide des informations d'identification définies dans .env. Recherchez le conteneur utilisé par les outils de développement (également spécifié dans .env), accédez au dossier source et supprimez les images source. Vous devrez peut-être exécuter les étapes décrites dans la liste déroulante Fichiers source incorrecte si les fichiers source supprimés continuent à s’afficher dans la liste déroulante car ils peuvent être mis en cache localement dans l’"état de l’application" des outils de développement.

    Stockage Microsoft Azure Blob

Test

Aucun rendu généré lors de l'exécution du test

  • Erreur : échec : Aucun rendu généré.

  • Cause : le programme de travail n'a pas pu générer de rendu en raison d'une erreur inattendue, telle qu'une erreur de syntaxe JavaScript.

  • Résolution : passez en revue l'exécution du test test.log à /build/test-results/test-worker/test.log. Localisez la section de ce fichier correspondant au cas de test d’échec et recherchez les erreurs.

    Dépannage - Aucun rendu généré

Le test génère un rendu incorrect provoquant l’échec du test

  • Erreur : échec : Rendition 'rendition.xxx' pas comme prévu.
  • Cause : le collaborateur génère un rendu différent de celui rendition.<extension> fourni dans le cas de test.
    • Si le fichier rendition.<extension> attendu n'est pas créé exactement de la même manière que le rendu généré localement dans le cas de test, le test peut échouer car il peut y avoir une différence dans les bits. Par exemple, si le programme de travail des Assets compute modifie le contraste à l’aide d’API et que le résultat attendu est créé en ajustant le contraste dans Adobe Photoshop CC, les fichiers peuvent apparaître de la même manière, mais des variations mineures dans les bits peuvent être différentes.
  • Résolution : Examinez la sortie du rendu du test en naviguant vers /build/test-worker/<worker-name>/<test-run-timestamp>/<test-case>/rendition.<extension>et comparez-la au fichier de rendu attendu dans le cas du test. Pour créer une ressource attendue exacte, procédez comme suit :
    • Utilisez l’outil de développement pour générer un rendu, le valider et l’utiliser comme fichier de rendu attendu.
    • Ou, validez le fichier généré par le test sur /build/test-worker/<worker-name>/<test-run-timestamp>/<test-case>/rendition.<extension>, validez-le correctement et utilisez-le comme fichier de rendu attendu.

Déboguer

Le débogueur ne joint pas

  • Erreur : Erreur de traitement du lancement : Erreur : Impossible de se connecter à la cible de débogage à…
  • Cause : Docker Desktop n'est pas en cours d'exécution sur le système local. Vérifiez ce point en examinant la console de débogage du code VS (Vue > Console de débogage), en confirmant que cette erreur est signalée.
  • Résolution : Début Docker Desktop et vérifiez que les images Docker requises sont installées.

Points d’arrêt en pause

  • Erreur : Lors de l'exécution du programme de travail des Assets compute à partir de l'outil de développement débogage, le code VS ne s'arrête pas aux points d'arrêt.

Débogueur de code VS non joint

  • Cause : Le débogueur du code VS a été arrêté/déconnecté.
  • Résolution : Redémarrez le débogueur du code VS et vérifiez qu'il est joint en regardant la console de sortie de débogage du code VS (Vue > Console de débogage)

Débogueur de code VS attaché après le début de l'exécution du programme de travail

  • Cause : Le débogueur du code VS n'était pas joint avant d'appuyer sur l'outil de développement ____ d'exécution.
  • Résolution : assurez-vous que le débogueur est joint en examinant la Console de débogage de VS Code (Vue > Console de débogage), puis relancez l'agent d'Asset compute à partir de l'outil de développement.

Le programme de travail expire lors du débogage

  • Erreur : La console de débogage signale que "l'action va expirer dans -XXX millisecondes" ou que la prévisualisation de rendu de l'outil de développement d' Asset compute tourne indéfiniment ou indéfiniment
  • Cause : Le délai d'expiration du programme de travail défini dans le fichier manifest. ymlis a été dépassé pendant le débogage.
  • Résolution : Augmentez temporairement le délai d’attente du collaborateur dans le manifest. ymlor accélère les activités de débogage.

Impossible d'arrêter le processus de débogage

  • Erreur : Ctrl-C sur la ligne de commande n'arrête pas le processus de débogage (npx adobe-asset-compute devtool).

  • Cause : Un bogue de la @adobe/aio-cli-plugin-asset-compute version 1.3.x Ctrl-C n'est pas reconnu comme une commande d'arrêt.

  • Résolution : Mise @adobe/aio-cli-plugin-asset-compute à jour vers la version 1.4.1+

    $ aio update
    

    Dépannage - Mise à jour d’aio

Déploiement

Rendu personnalisé manquant de l’élément dans AEM

  • Erreur : Le traitement des ressources nouvelles et retraitées a réussi, mais le rendu personnalisé est absent

Profil de traitement non appliqué au dossier ancêtre

  • Cause : Le fichier n'existe pas sous un dossier avec le Profil de traitement qui utilise le programme de travail personnalisé
  • Résolution : Application du Profil de traitement à un dossier ancêtre de la ressource

Profil de traitement remplacé par Profil de traitement inférieur

  • Cause : La ressource existe sous un dossier auquel est appliqué le Profil de traitement personnalisé du programme de travail. Toutefois, un autre Profil de traitement qui n’utilise pas le programme de travail client a été appliqué entre ce dossier et la ressource.
  • Résolution : combiner ou réconcilier les deux Profils de traitement et supprimer le Profil de traitement intermédiaire

Échec du traitement des ressources dans AEM

  • Erreur : badge Échec du traitement des ressources affiché sur la ressource
  • Cause : une erreur s'est produite dans l'exécution du programme de travail personnalisé
  • Résolution : Suivez les instructions relatives au débogage de l’ activation de Adobe I/O Runtime à l’aide aio app logsde.

Sur cette page

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free