Problemen met de uitbreidbaarheid van Asset Compute oplossen
- Onderwerpen:
- Asset Compute-microservices
Gemaakt voor:
- tussenpersoon
- Ervaren
- Ontwikkelaar
Hieronder volgt een index met veelvoorkomende problemen en fouten, samen met de resoluties, die kunnen optreden bij het ontwikkelen en implementeren van aangepaste Asset Compute-workers voor AEM Assets.
Ontwikkelen
Vertoning wordt gedeeltelijk getekend/beschadigd geretourneerd
-
Fout: Vertoning geeft volledig (wanneer een beeld) terug of is corrupt en kan niet worden geopend.
-
Oorzaak: De functie van de worker
renditionCallback
bestaat alvorens de vertoning volledig aanrendition.path
kan worden geschreven. -
Resolutie: Herzie de code van de douanearbeider en zorg ervoor alle asynchrone vraag synchroon wordt gemaakt gebruikend
await
.
Ontwikkelingsinstrument
Het bestand Console.json ontbreekt in het Asset Compute-project
-
Fout: Fout: Ontbrekende vereiste dossiers bij bevestigt (
.../node_modules/@adobe/asset-compute-client/lib/integrationConfiguration.js:XX:YY
) bij async setupAssetCompute (.../node_modules/@adobe/asset-compute-devtool/src/assetComputeDevTool.js:XX:YY
) -
Oorzaak: het
console.json
dossier mist van de wortel van het project van Asset Compute -
Resolutie: Download een nieuw
console.json
van uw project van Adobe I/O- Open in console.adobe.io het Adobe I/O-project waarvoor het Asset Compute-project is geconfigureerd
- Tik de knoop van de Download in het hoogste recht
- Sla het gedownloade bestand met de bestandsnaam op in de hoofdmap van het Asset Compute-project
console.json
Onjuiste YAML-inspringing in manifest.yml
- Fout: YAMLException: slechte inkeping van een afbeeldingsingang bij lijn X, kolom Y: (via standaard uit
aio app run
bevel) - Oorzaak: Yaml de dossiers zijn gevoelig wit-uit elkaar geplaatst, het waarschijnlijk dat uw inkeping onjuist is.
- Resolutie: herzie uw
manifest.yml
en zorg ervoor al inspringing correct is.
memorySize limit is set to low
- Fout: Lokale Dev Server OpenWhiskError: PUT https://adobeioruntime.net/api/v1/namespaces/xxx-xxx-xxx/actions/xxx-0.0.1/__secured_workeroverwrite=true Geretourneerde HTTP 400 (Slecht Verzoek) —> "De verzoekinhoud werd misvormd:vereiste ontbrak: geheugen 64 MB onder toegestane drempel van 134217728 B"
- Oorzaak: A
memorySize
grens voor de worker inmanifest.yml
werd geplaatst onder de minimum toegestane drempel zoals die door het foutenbericht in bytes wordt gemeld. - Resolutie: herzie de
memorySize
grenzen inmanifest.yml
en zorg ervoor zij allen groot zijn dan de minimaal toegestane drempel.
Development Tool kan niet worden gestart omdat private.key ontbreekt
- Fout: Lokale Dev ServerError: Ontbrekende vereiste dossiers bij validatePrivateKeyFile… (via standaard uit
aio app run
opdracht) - Oorzaak: de
ASSET_COMPUTE_PRIVATE_KEY_FILE_PATH
waarde in.env
dossier, richt niet aanprivate.key
ofprivate.key
is niet leesbaar door de huidige gebruiker. - Resolutie: herzie de
ASSET_COMPUTE_PRIVATE_KEY_FILE_PATH
waarde in.env
dossier, en zorg ervoor het de volledige, absolute weg aanprivate.key
op uw dossiersysteem bevat.
Vervolgkeuzelijst Source-bestanden is onjuist
Het Hulpmiddel van de Ontwikkeling van Asset Compute kan een staat ingaan waar het stapelgegevens trekt, en is het meest merkbaar in het dossier van Source dropdown tonend onjuiste punten.
- Fout: het dossierdropdown van Source toont onjuiste punten.
- Oorzaak: de de browser van de Stale in het voorgeheugen ondergebrachte staat veroorzaakt
- Resolutie: in uw browser ontruimen volledig de browser "toepassingsstaat van het lusje", het browser geheime voorgeheugen, lokale opslag en de dienstarbeider.
Ontbrekende of ongeldige devToolToken-queryparameter
- Fout: "Onbevoegd"bericht in het Hulpmiddel van de Ontwikkeling van Asset Compute
- Oorzaak:
devToolToken
mist of ongeldig - Resolutie: sluit het browser venster van het Hulpmiddel van de Ontwikkeling van Asset Compute, beëindigt om het even welke lopende processen van het Hulpmiddel van de Ontwikkeling die via het
aio app run
bevel worden in werking gesteld, en herstart het Hulpmiddel van de Ontwikkeling (gebruikendaio app run
).
Kan bronbestanden niet verwijderen
-
Fout: Er is geen manier om toegevoegde brondossiers uit de UI van Hulpmiddelen van de Ontwikkeling te verwijderen
-
Oorzaak: Deze functionaliteit is niet uitgevoerd
-
Resolutie: Login uw leverancier van de wolkenopslag gebruikend de geloofsbrieven die in
.env
worden bepaald. Bepaal de plaats van de container die door de Hulpmiddelen van de Ontwikkeling (ook in.env
wordt gespecificeerd) wordt gebruikt, navigeer in de bron omslag, en schrap om het even welke bronbeelden die. U kunt de stappen moeten uitvoeren die in worden geschetst Source dossiers dropdown onjuistals de geschrapte brondossiers in dropdown blijven tonen aangezien zij plaatselijk in de "toepassingsstaat van de Ontwikkeling hulpmiddelen"kunnen worden in het voorgeheugen ondergebracht.
Testen
Geen uitvoering gegenereerd tijdens de uitvoering van de test
-
Fout: Mislukking: Geen geproduceerde vertoning.
-
Oorzaak: de worker slaagde erin om een vertoning te produceren wegens een onverwachte fout zoals een de syntaxisfout van JavaScript.
-
Resolutie: herzie de 2} van de testuitvoering bij
/build/test-results/test-worker/test.log
.test.log
Zoek de sectie in dit bestand die overeenkomt met de testcase voor mislukken en controleer of er fouten zijn opgetreden.
Test genereert onjuiste uitvoering, waardoor de test mislukt
-
Fout: Mislukking: Vertoning "rendition.xxx"niet zoals verwacht.
-
Oorzaak: de arbeidersoutput een vertoning die niet het zelfde als
rendition.<extension>
in het testgeval verstrekte was.- Als het verwachte
rendition.<extension>
-bestand niet op dezelfde manier wordt gemaakt als de lokaal gegenereerde uitvoering in het testgeval, kan de test mislukken omdat er een verschil in de bits kan zijn. Als de Asset Compute-worker bijvoorbeeld het contrast wijzigt met behulp van API's en het verwachte resultaat wordt bereikt door het contrast aan te passen in Adobe Photoshop CC, kunnen de bestanden er hetzelfde uitzien, maar kleine variaties in de bits kunnen verschillen.
- Als het verwachte
-
Resolutie: de uitvoeringen van de vertoning van de Overzicht van de test door aan
/build/test-worker/<worker-name>/<test-run-timestamp>/<test-case>/rendition.<extension>
te navigeren, en het te vergelijken met het verwachte vertoningsdossier in het testgeval. Om een exact verwacht actief te maken:- Gebruik het gereedschap Ontwikkeling om een vertoning te genereren, te valideren dat deze correct is en te gebruiken als het verwachte vertoningsbestand
- U kunt ook het bestand dat tijdens de test is gegenereerd op
/build/test-worker/<worker-name>/<test-run-timestamp>/<test-case>/rendition.<extension>
valideren, controleren of het bestand juist is en gebruiken als het verwachte renderingsbestand
Foutopsporing
Foutopsporing wordt niet gekoppeld
- Fout: De verwerkingslancering van de fout: Fout: Kon niet verbinden met zuiveren doel bij…
- Oorzaak: De Desktop van de Docker loopt niet op het lokale systeem. Verifieer dit door de Console van de Foutopsporing van de Code van VS (Mening > Debug Console) te herzien, bevestigend deze fout wordt gemeld.
- Resolutie: De Desktop van het Begin van de Dokker en bevestigt de vereiste beelden van de Dokker worden geïnstalleerd.
Onderbrekingspunten worden niet gepauzeerd
- Fout: Wanneer het runnen van de worker van Asset Compute van het zuivert-able Hulpmiddel van de Ontwikkeling, pauzeert de Code van VS niet bij breekpunten.
Foutopsporing VS-code niet gekoppeld
- Oorzaak: debugger van de Code van VS werd tegengehouden/losgemaakt.
- Resolutie: herstart foutopsporing van de Code van VS, en verifieert het door de console van de Output van de Output van de Code van VS te bekijken zuivert (Mening > zuivert Console)
Foutopsporing voor VS-code gekoppeld nadat uitvoering van worker is gestart
- Oorzaak: de debugger van de Code van VS maakte niet vast voorafgaand aan het tappen Looppas in het Hulpmiddel van de Ontwikkeling.
- Resolutie: verzeker debugger door de Foutopsporingsconsole van de Code van VS te herzien (Mening > zuivert Console), en dan de worker van Asset Compute van het Hulpmiddel van de Ontwikkeling opnieuw in werking te stellen.
Worker-time-out tijdens foutopsporing
- Fout: Zuiver de rapporten van de Console "Actie zal onderbreking in -XXX milliseconden"of 🔗 de vertoningsvoorproef van de vertoningen van het Hulpmiddel van de Ontwikkeling van Asset Compute voor onbepaalde tijd of
- Oorzaak: De arbeidersonderbreking zoals bepaald in manifest.ymlwordt overschreden tijdens het zuiveren.
- Resolutie: Verhoog tijdelijk de onderbreking van de worker in manifest.ymlof versnelt het zuiveren activiteiten.
Kan foutopsporingsproces niet beëindigen
-
Fout:
Ctrl-C
op de bevellijn beëindigt niet het debugger proces (npx adobe-asset-compute devtool
). -
Oorzaak: Een insect in
@adobe/aio-cli-plugin-asset-compute
1.3.x, resulteert inCtrl-C
die niet als beëindigend bevel wordt erkend. -
Resolutie: Update
@adobe/aio-cli-plugin-asset-compute
aan versie 1.4.1+$ aio update
Implementeren
Aangepaste uitvoering ontbreekt in element in AEM
- Fout: Nieuwe en opnieuw verwerkte activa verwerken met succes, maar missen de douanevertoning
Profiel verwerken dat niet is toegepast op de bovenliggende map
- Oorzaak: het element bestaat niet onder een omslag met het Profiel van de Verwerking dat de douanearbeider gebruikt
- Resolutie: pas het Profiel van de Verwerking op een voorouderomslag van de activa toe
Bezig met verwerken van profiel vervangen door lager verwerkingsprofiel
- Oorzaak: het middel bestaat onder een omslag met het toegepaste Profiel van de douanearbeidersverwerking, nochtans een verschillend Profiel van de Verwerking dat niet de klantenarbeider gebruikt is toegepast tussen die omslag en het middel.
- Resolutie: combineer, of op een andere manier, de twee Profielen van de Verwerking en verwijder het middenProfiel van de Verwerking
Verwerking van middelen mislukt in AEM
- Fout: Ontbroken symbool van de Verwerking van Activa dat op activa wordt getoond
- Oorzaak: een fout kwam in de uitvoering van de douanearbeider voor
- Resolutie: volg de instructies op het zuiveren Adobe I/O Runtime actitiesgebruikend
aio app logs
.