プレビューディスパッチャーの準備ができていないと、Cloud Manager パイプラインが停止し、失敗します
この記事では、プレビューディスパッチャーの準備が整っていない場合に、開始状態が何時間も続き、失敗したAEM as a Cloud Service デプロイメントパイプラインを解決する方法について説明します。
説明 description
環境
- Adobe Experience Manager（AEM）as a Cloud Service
- マネージド書き換えマップを使用したDispatcher設定を使用したCloud Manager デプロイメントパイプライン
問題/症状
- デプロイメントパイプラインは、失敗する前に、長期間にわたって開始状態またはウォームアップ状態のままになります。
- Dispatcherの起動および準備確認のエラーは、
content/dam/rewrites/redirectsに関連するログに表示されます。 - Cloud Managerに、長い遅延後に汎用的なデプロイメントエラーのメッセージが表示される。
The deployment failed due to a system issue. Contact Adobe Support if the issue recurs.
- ビルドとコード品質の手順は正常に完了しますが、デプロイメントは正常に完了しません。
- 同じブランチまたはコードが以前の実行で正常にデプロイされた場合でも、問題が発生する可能性があります。
- これは、プロジェクトがマネージド書き換えマップを使用し、プレビューディスパッチャーの起動が遅れている場合に起こりやすくなります。
再生条件
- Cloud Managerを使用して、開発環境にコード（以前に成功したコードも含む）をデプロイしようとしています。
- プレビューディスパッチャーまたは関連するプレビューサービスは、予想される期間内に正常に動作しません。
- パイプラインは、長い待機後に失敗するか、正常に完了しますが、実行時間が異常に長くなります。
原因
プレビューディスパッチャーコンテナが準備状態に達せず、Cloud Managerがタイムアウトが発生するまで待機するため、デプロイメントパイプラインがハングし、最終的に失敗します。 待機フラグをfalseに設定するようにDispatcher YAML設定を更新すると、パイプラインをブロックせずにプレビューディスパッチャーを開始できます。
解決策 resolution
管理対象の書き換えマップでプレビューディスパッチャーのスタートアップブロックによって発生するパイプラインの遅延とエラーを修正するには、次の手順に従います。
- Dispatcherを含むすべてのプレビューサービスが正しく設定され、エラーなしで開始できることを確認します。 プレビューディスパッチャーに関連する準備状況またはヘルスチェックのエラーについて、Cloud Manager ログを確認します。
rewrite-maps.yamlやmanaged-rewrite-maps.yamlなどのDispatcher設定YAML ファイルを編集します。 起動をブロックできるマップエントリのファイルを確認し、すべてのマップエントリでwaitフラグがfalseに設定されていることを確認します。 次に例を示します。
maps:
- name: redirects-301.map
path: /content/dam/rewrites/redirects-301.txt
ttl: 300
wait: false
- name: redirects-302.map
path: /content/dam/rewrites/redirects-302.txt
ttl: 300
wait: false
- リポジトリに変更を保存してコミットし、Cloud Managerでパイプラインを再実行します。
- パイプラインの実行を監視して、プレビューディスパッチャと関連サービスが、長い開始状態やウォームアップ状態に留まることなく、タイムリーに正常な状態に到達することを確認します。
- デプロイメントが正常に完了したら、Dispatcher コードが期待どおりにデプロイされていることを確認します。
- パイプラインに予想以上の時間がかかったり、失敗したりする場合は、Dispatcherとプレビューサービスログを確認して、追加の準備状況、ヘルスチェック、またはスタートアップの問題について確認します。
recommendation-more-help
experience-cloud-kcs-help-kbarticles