Felsöka frontendsfel i AEM as a Cloud Service

Kontrollera att package-lock.json finns i modulen ui.frontend och att den har implementerats i din databas.

Återskapa package-lock.json och node_modules med en Linux-miljö (använd Windows-undersystem för Linux eller Docker). Använd följande kommandon i en WSL-terminal för att reproducera och lösa plattformsspecifika beroendeproblem för pipelines som bara är för FE:  

cd /path/to/your/project
rm -rf package-lock.json node_modules
npm install
git add package-lock.json
git commit -m "Regenerate package-lock.json on Linux"

 
Eller kör i en Linux-behållare:
 

docker run --rm -v $(pwd):/app -w /app node:16-alpine \
  sh -c "rm -rf node_modules package-lock.json && npm install"

Uppdatera föråldrade beroenden som Jest, Storybook och Webpack.

Använd npm audit med produktionsflaggor och kritiska granskningsnivåflaggor för att identifiera återstående beroendeproblem. Till exempel: npm audit --production --audit-level=critical

Genomför den återskapade package-lock.json-filen från Linux-miljön till din databas.

Överför ändringar till grenen som används av pipelinen för enbart FE.

Kör om pipelinen för enbart FE i Cloud Manager.

Åtgärda eventuella ESLint-/kodliknande fel som rapporteras under byggprocessen. Alla kodfel måste åtgärdas för att distributionen ska lyckas.

Om det bara är nödvändigt för valideringsändamål tar du tillfälligt bort linting från byggskriptet i package.json. Detta rekommenderas dock inte för produktion.

Kontrollera att byggsteget har slutförts utan beroendefel eller lintingfel.

Om distributionen lyckas men stilarna och skripten på platsen inte läses in, kontrollerar du Dispatcher-inställningarna och CDN-konfigurationen. Kontrollera att den aktiverade värden innehåller rätt ServerAlias för den statiska domänen. Anvisningar om hur du gör detta finns i Framtida pipeline-distribution bryter webbplatsen.

Om pipeline misslyckas med BUILD_NPM_AUDIT_ERROR tar du bort alla SiteConfig- eller HtmlPageItemsConfig-noder som står i konflikt. Anvisningar finns i Så här löser du BUILD_NPM_AUDIT_ERROR i AEM as a Cloud Service frontendpipeline.