AEM as a Cloud Serviceのフロントエンドパイプラインエラーのトラブルシューティング

package-lock.json モジュールに ui.frontend が存在し、リポジトリにコミットされていることを確認します。

Linux 環境を使用して package-lock.json と node_modules を再生成します（Linux 用 Windows サブシステムまたは Docker を使用）。 FE 専用パイプラインのプラットフォーム固有の依存関係の問題を再現して解決するには、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"

 
または、Linux コンテナで実行します。
 

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

Jest、Storybook、Webpack など、古い依存関係を更新します。

npm audit を実稼動環境および重大な監査レベルのフラグと共に使用して、残りの依存関係の問題を特定します。 例：npm audit --production --audit-level=critical

再生成された package-lock.json ファイルを Linux 環境からリポジトリにコミットします。

FE 専用パイプラインで使用されるブランチに変更をプッシュします。

Cloud Managerで FE 専用パイプラインを再実行します。

ビルドプロセス中に報告された ESLint/コードスタイルのエラーに対処します。デプロイメントを成功させるには、すべてのリントエラーを解決する必要があります。

検証目的でのみ必要な場合は、package.json のビルドスクリプトから linting を一時的に削除します。 ただし、実稼動での使用はお勧めしません。

依存関係やリンティングエラーを発生させずに、ビルドステップが正常に完了することを確認します。

デプロイメントに成功してもサイトのスタイルとスクリプトが読み込まれない場合は、Dispatcher設定と CDN 設定を確認します。 有効な vhost に、静的ドメインに適した ServerAlias が含まれていることを確認します。 手順については、​ フロントエンドパイプラインのデプロイメントが web サイトを中断 ​ を参照してください。

パイプラインが BUILD_NPM_AUDIT_ERROR で失敗した場合は、競合する SiteConfig ノードまたは HtmlPageItemsConfig ノードを削除します。 手順については、AEM as a Cloud Service フロントエンドパイプラインでの BUILD_NPM_AUDIT_ERROR の解決方法 ​ を参照してください。