Résolution des problèmes liés aux pipelines front-end dans AEM as a Cloud Service

Assurez-vous package-lock.json existe dans le module ui.frontend et qu’il est validé dans votre référentiel.

Régénérez les package-lock.json et les node_modules à l’aide d’un environnement Linux (utilisez le sous-système Windows pour Linux ou Docker). Pour reproduire et résoudre les problèmes de dépendance spécifiques à la plateforme pour les pipelines FE uniquement, utilisez les commandes suivantes dans un terminal WSL :  

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"

 
Ou exécutez dans un conteneur Linux :
 

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

Mettez à jour des dépendances obsolètes, notamment Jest, Storybook et Webpack.

Utilisez npm audit avec les indicateurs de niveau de production et d’audit critique pour identifier les problèmes de dépendance restants. Par exemple : npm audit --production --audit-level=critical

Validez le fichier package-lock.json régénéré de l’environnement Linux dans votre référentiel.

Envoyez les modifications à la branche utilisée par le pipeline FE uniquement.

Réexécutez le pipeline FE-uniquement dans Cloud Manager.

Résolvez les erreurs de style ESLint/code signalées pendant le processus de création ; toutes les erreurs de ligne doivent être résolues pour un déploiement réussi.

Si nécessaire à des fins de validation uniquement, supprimez temporairement linting du script de build dans package.json. Toutefois, cela n’est pas recommandé pour une utilisation en production.

Vérifiez que l’étape de build se termine correctement sans erreurs de dépendance ou de liaison.

Si le déploiement réussit, mais que les styles et scripts de votre site ne se chargent pas, vérifiez les paramètres Dispatcher et la configuration du réseau CDN. Assurez-vous que le vhost activé inclut le ServerAlias correct pour le domaine statique. Pour connaître les étapes, reportez-vous à ​ Le déploiement du pipeline front-end rompt le site web.

Si le pipeline échoue avec BUILD_NPM_AUDIT_ERROR, supprimez tous les nœuds SiteConfig ou HtmlPageItemsConfig en conflit. Pour connaître les étapes, reportez-vous à la section Comment résoudre BUILD_NPM_AUDIT_ERROR dans le pipeline front-end AEM as a Cloud Service.