DocumentazioneAEMTutorial su AEMTutorial su AEM as a Cloud Service

Risoluzione dei problemi di estensibilità degli Asset compute

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

Creato per:

  • Intermedio
  • Esperto
  • Sviluppatore

Di seguito è riportato un indice dei problemi e degli errori più comuni, insieme alle relative risoluzioni, che possono verificarsi durante lo sviluppo e la distribuzione di processi di lavoro di Asset compute personalizzati per AEM Assets.

Sviluppa develop

La rappresentazione è parzialmente disegnata/danneggiata rendition-returned-partially-drawn-or-corrupt

  • Errore: il rendering della rappresentazione non viene eseguito completamente (quando un'immagine) o è danneggiato e non può essere aperto.

    Rendering restituito parzialmente disegnato

  • Causa: la funzione renditionCallback del processo di lavoro verrà chiusa prima che il rendering possa essere scritto completamente in rendition.path.

  • Risoluzione: rivedere il codice del processo di lavoro personalizzato e assicurarsi che tutte le chiamate asincrone siano sincronizzate utilizzando await.

Strumento di sviluppo development-tool

File Console.json mancante nel progetto Asset Compute missing-console-json

  • Errore: Errore: file richiesti mancanti alla convalida (.../node_modules/@adobe/asset-compute-client/lib/integrationConfiguration.js:XX:YY) in setupAssetCompute asincrono (.../node_modules/@adobe/asset-compute-devtool/src/assetComputeDevTool.js:XX:YY)

  • Causa: file console.json mancante nella radice del progetto Asset Compute

  • Risoluzione: Scarica un nuovo console.json dal tuo progetto di Adobe I/O

    1. In console.adobe.io, apri il progetto Adobe I/O per il quale il progetto Asset Compute è configurato
    2. Tocca il pulsante Scarica in alto a destra
    3. Salvare il file scaricato nella directory principale del progetto di Asset compute utilizzando il nome file console.json

Rientro YAML non corretto in manifest.yml incorrect-yaml-indentation

  • Errore: YAMLException: rientro non valido di una voce di mapping alla riga X, colonna Y:(tramite l'uscita standard dal comando aio app run)
  • Causa: i file Yaml sono sensibili agli spazi vuoti, è probabile che il rientro non sia corretto.
  • Risoluzione: Rivedi manifest.yml e assicurati che tutti i rientri siano corretti.

Il limite memorySize è impostato su un valore troppo basso memorysize-limit-is-set-too-low

  • Errore: OpenWhiskError del server di sviluppo locale: PUT https://adobeioruntime.net/api/v1/namespaces/xxx-xxx-xxx/actions/xxx-0.0.1/__secured_workeroverwrite=true ha restituito HTTP 400 (richiesta non valida) —> "Il contenuto della richiesta non è valido:requisito non riuscito: memoria inferiore di 64 MB alla soglia consentita di 134217728 B"
  • Causa: Un limite memorySize per il processo di lavoro in manifest.yml è stato impostato al di sotto della soglia minima consentita, come riportato dal messaggio di errore in byte.
  • Risoluzione: Rivedi i limiti di memorySize in manifest.yml e assicurati che siano tutti grandi rispetto alla soglia minima consentita.

Impossibile avviare lo strumento di sviluppo. Private.key mancante missing-private-key

  • Errore: Errore server di sviluppo locale: file richiesti mancanti in validatePrivateKeyFile… (tramite uscita standard dal comando aio app run)
  • Causa: Il valore ASSET_COMPUTE_PRIVATE_KEY_FILE_PATH nel file .env non punta a private.key o private.key non è leggibile dall'utente corrente.
  • Risoluzione: Esaminare il valore ASSET_COMPUTE_PRIVATE_KEY_FILE_PATH nel file .env e assicurarsi che contenga il percorso completo e assoluto di private.key nel file system.

Lo strumento di sviluppo Asset Compute può entrare in uno stato in cui vengono estratti dati non aggiornati ed è più evidente nel menu a discesa Source file che mostra elementi non corretti.

  • Errore: nel menu a discesa del file Source vengono visualizzati elementi non corretti.
  • Causa: lo stato non aggiornato del browser nella cache causa la
  • Risoluzione: Nel browser cancellare completamente lo "stato dell'applicazione" della scheda del browser, la cache del browser, l'archiviazione locale e il processo di lavoro del servizio.

Parametro query devToolToken mancante o non valido missing-or-invalid-devtooltoken-query-parameter

  • Errore: notifica "Non autorizzato" nello strumento di sviluppo Asset compute
  • Causa: devToolToken mancante o non valido
  • Risoluzione: Chiudere la finestra del browser dello strumento di sviluppo Asset Compute, terminare tutti i processi dello strumento di sviluppo in esecuzione avviati tramite il comando aio app run e riavviare lo strumento di sviluppo (utilizzando aio app run).

Impossibile rimuovere i file di origine unable-to-remove-source-files

  • Errore: Non è possibile rimuovere i file di origine aggiunti dall'interfaccia utente degli strumenti di sviluppo

  • Causa: questa funzionalità non è stata implementata

  • Risoluzione: Accedi al provider di archiviazione cloud utilizzando le credenziali definite in .env. Individuare il contenitore utilizzato dagli strumenti di sviluppo (specificato anche in .env), passare alla cartella source ed eliminare le immagini di origine. Potrebbe essere necessario eseguire i passaggi descritti nel menu a discesa File Source non corretti se i file di origine eliminati continuano a essere visualizzati nel menu a discesa in quanto potrebbero essere memorizzati nella cache locale nello "stato applicazione" degli strumenti di sviluppo.

    Archiviazione BLOB di Microsoft Azure

Test test

Nessuna rappresentazione generata durante l’esecuzione del test test-no-rendition-generated

  • Errore: Errore: nessuna rappresentazione generata.

  • Causa: Il processo di lavoro non è riuscito a generare una rappresentazione a causa di un errore imprevisto, ad esempio un errore di sintassi JavaScript.

  • Risoluzione: Rivedi test.log dell'esecuzione del test alle /build/test-results/test-worker/test.log. Individua la sezione in questo file corrispondente al test case non riuscito e individua eventuali errori.

    Risoluzione dei problemi - Nessuna rappresentazione generata

Il test genera una rappresentazione errata causando un errore del test tests-generates-incorrect-rendition

  • Errore: Errore: la rappresentazione 'rendition.xxx' non è quella prevista.

  • Causa: Il processo di lavoro ha generato una rappresentazione diversa da quella fornita per rendition.<extension> nel test case.

    • Se il file rendition.<extension> previsto non viene creato esattamente nello stesso modo della rappresentazione generata localmente nel test case, il test potrebbe non riuscire in quanto ci potrebbe essere una qualche differenza nei bit. Ad esempio, se il processo di lavoro Asset Compute modifica il contrasto utilizzando le API e il risultato atteso viene creato regolando il contrasto in Adobe Photoshop CC, i file possono apparire gli stessi, ma le variazioni minori nei bit possono essere diverse.

  • Risoluzione: esaminare l'output del rendering dal test passando a /build/test-worker/<worker-name>/<test-run-timestamp>/<test-case>/rendition.<extension> e confrontarlo con il file di rendering previsto nel test case. Per creare una risorsa prevista esatta:

    • Utilizza lo strumento di sviluppo per generare una rappresentazione, convalidarla correttamente e utilizzarla come file di rappresentazione previsto
    • In alternativa, convalidare il file generato da test in /build/test-worker/<worker-name>/<test-run-timestamp>/<test-case>/rendition.<extension>, verificarne la correttezza e utilizzarlo come file di rendering previsto

Debug

Il debugger non si collega debugger-does-not-attach

  • Errore: errore durante l'elaborazione del lancio. Errore: impossibile connettersi alla destinazione di debug in…
  • Causa: Docker Desktop non è in esecuzione nel sistema locale. Verifica questo fatto esaminando la console di debug del codice VS (Visualizza > Console di debug), e conferma che questo errore sia segnalato.
  • Risoluzione: avviare Docker Desktop e verificare che le immagini Docker richieste siano installate.

Punti di interruzione non in pausa breakpoints-no-pausing

  • Errore: durante l'esecuzione del processo di lavoro Asset Compute dallo strumento di sviluppo con debug, il codice VS non viene messo in pausa nei punti di interruzione.

Debugger codice VS non collegato vs-code-debugger-not-attached

  • Causa: Il debugger del codice di Visual Studio è stato arrestato/disconnesso.
  • Risoluzione: riavvia il debugger del codice VS e verifica che sia collegato guardando la console di output di debug del codice VS (Visualizza > Console di debug)

Debugger del codice VS collegato dopo l'avvio dell'esecuzione del processo di lavoro vs-code-debugger-attached-after-worker-execution-began

  • Causa: il debugger del codice di Visual Studio non è stato collegato prima di toccare Esegui nello strumento di sviluppo.
  • Risoluzione: Verificare che il debugger sia collegato esaminando la console di debug di VS Code (Visualizza > Console di debug), quindi eseguire nuovamente il processo di lavoro Asset Compute da Strumento di sviluppo.

Timeout del processo di lavoro durante il debug worker-times-out-while-debugging

  • Errore: nella console di debug viene segnalato che "l'azione verrà interrotta tra -XXX millisecondi" oppure che l'anteprima della copia trasformata 🔗 di Asset Compute Development Tool si estende per un tempo indefinito oppure
  • Causa: il timeout del processo di lavoro definito in manifest.yml è stato superato durante il debug.
  • Risoluzione: aumenta temporaneamente il timeout del lavoratore in manifest.yml o accelera le attività di debug.

Impossibile terminare il processo del debugger cannot-terminate-debugger-process

  • Errore: Ctrl-C nella riga di comando non termina il processo del debugger (npx adobe-asset-compute devtool).

  • Causa: un bug in @adobe/aio-cli-plugin-asset-compute 1.3.x causa il mancato riconoscimento di Ctrl-C come comando di terminazione.

  • Risoluzione: aggiornamento di @adobe/aio-cli-plugin-asset-compute alla versione 1.4.1+

    code language-none 
    $ aio update

    Risoluzione dei problemi - Aggiornamento aio

Distribuzione deploy

Rappresentazione personalizzata mancante dalla risorsa in AEM custom-rendition-missing-from-asset

  • Errore: le risorse nuove ed elaborate nuovamente sono state elaborate correttamente, ma manca la rappresentazione personalizzata

Profilo di elaborazione non applicato alla cartella predecessore

  • Causa: la risorsa non esiste in una cartella con il profilo di elaborazione che utilizza il processo di lavoro personalizzato
  • Risoluzione: Applica il profilo di elaborazione a una cartella predecessore della risorsa

Profilo di elaborazione sostituito da Profilo di elaborazione inferiore

  • Causa: la risorsa si trova in una cartella alla quale è stato applicato il profilo di elaborazione del processo di lavoro personalizzato. Tra la cartella e la risorsa è stato tuttavia applicato un profilo di elaborazione diverso che non utilizza il processo di lavoro del cliente.
  • Risoluzione: combinare o altrimenti riconciliare i due profili di elaborazione e rimuovere il profilo di elaborazione intermedio

Elaborazione delle risorse non riuscita in AEM asset-processing-fails

  • Errore: visualizzazione del badge Elaborazione risorsa non riuscita sulla risorsa
  • Causa: Errore durante l'esecuzione del processo di lavoro personalizzato
  • Risoluzione: Segui le istruzioni su debug delle attivazioni di Adobe I/O Runtime tramite aio app logs.
recommendation-more-help
4859a77c-7971-4ac9-8f5c-4260823c6f69