HELM_RELEASE_FAILEDと503 エラーが発生し、デプロイステップでAEM Cloud Manager パイプラインが失敗する

この記事では、ヘルスチェック中にHELM_RELEASE_FAILEDとHTTP 503 エラーが発生してデプロイメントステップが失敗するAdobe Experience Manager(AEM)Cloud Manager パイプラインのデプロイメントエラーをトラブルシューティングおよび解決する方法について説明します。

説明 description

環境

  • Adobe Experience Manager as a Cloud Service
  • Cloud Manager デプロイメントパイプライン
  • ロールアウト時および起動時の公開環境

症状

  • パイプラインの実行は、デプロイステップで一貫して失敗します。
  • 環境のデプロイメント中にHELM_RELEASE_FAILED エラーが報告されます。
  • ロールアウト中に/libs/granite/security/currentuser.json エンドポイントでHTTP 503 エラーが発生したため、パブリッシュサービスのヘルスチェックがクリティカルとマークされます。
  • 環境の起動後、同じエンドポイントがHTTP 200を返し、回復を示します。
  • パイプラインと環境のログに、未解決のアプリケーションの依存関係または起動エラーが表示されます。

原因

デプロイメントのエラーは、主に、環境起動時のアプリケーションの依存関係やタイミングの問題が解決されていないことが原因で発生し、パイプラインでHELM_RELEASE_FAILEDを報告する一時的なヘルスチェックのエラー(HTTP 503)が発生します。

解決策 resolution

問題を解決するには、次の手順に従います。

  1. アプリケーションコードを確認し、必要な依存関係が含まれており、デプロイメント環境と互換性があることを確認します。 アプリケーションでそれらを使用している場合は、twitter4j、Composum、ES6 clientlibsなどの依存関係を確認してください。
  2. 起動エラーまたはデプロイメントをブロックする可能性のある未解決の依存関係について、Cloud Manager パイプラインとAEM環境ログを確認します。
  3. ロールアウト中およびパブリッシュの起動後に、/libs/granite/security/currentuser.jsonのパブリッシュ ヘルスチェック結果を確認します。 ロールアウト中にHTTP 503、起動後にHTTP 200を返すかどうかを確認します。 注:後のHTTP 200は、エンドポイントが回復したことを示します。準備が遅れた理由は特定できません。 ヘルスチェックのタイミングをパイプラインとAEMの起動ログに関連付けます。 Adobeがサポートされているデプロイメント固有のオプションを確認しない限り、ヘルスチェックのタイミングを変更しないでください。
  4. 特定されたコード、依存関係、または設定の問題を修正した後、Cloud Manager パイプラインを再実行し、デプロイメントが正常に完了したことを確認します。
  5. パイプラインが引き続き失敗する場合は、Adobe サポート ​にお問い合わせください。 最新のパイプライン実行ログ、関連するAEM起動ログ、ヘルスチェックのタイムライン、コードまたは依存関係の変更の詳細を提供します。
recommendation-more-help
experience-cloud-kcs-help-kbarticles