ドキュメントExperience Cloud KCS

AEMでのDispatcher設定のデプロイメントエラーの修正

最終更新日： 2026年7月2日

ファイル構造が正しくないか、パッケージがサポートされていないか、パイプラインとキャッシュの設定が正しく調整されていないため、デプロイメントまたは移行中にDispatcherの設定が失敗します。 これらの問題は、デプロイメントの成功を防いだり、AEM環境全体で予期しない動作を引き起こしたりする可能性があります。 この問題を解決するには、設定構造を修正し、パイプラインの動作を確認し、設定を検証します。

説明 description

環境

  • Adobe Experience Manager as a Cloud Service （AEMaaCS）
  • AEM Managed Services（AMS）
  • Dispatcher設定のデプロイメントと移行のシナリオ

問題/症状

  • Dispatcher設定が生のフォルダーではなくzip アーカイブとしてアップロードすると、デプロイメントが失敗する
  • 移行でエラーが表示される​EPERM：操作が許可されていません。Windows システム上のsymlink
  • Dispatcherのみのパイプラインで、設定が期待どおりに更新されない
  • 設定の更新にもかかわらず、デプロイメント後にキャッシュがクリアされない

原因

デプロイメントエラーが発生するのは、Cloud Managerでは圧縮されたアーカイブではなく生のDispatcher フォルダー構造が必要だからです。 AMSでは、環境固有の変数は、ハードコーディングするのではなく、外部で定義する必要があります。 移行時に、Dispatcher Converterはシンボリックリンクに依存し、オペレーティングシステムの制限によってブロックされる可能性があります。

解決策 resolution

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

  1. リポジトリにconf.dやconf.dispatcher.dなどの圧縮されていないDispatcher フォルダーが正しい場所に含まれていることを確認し、手動で作成されたzip ファイルをすべて削除します。
  2. Cloud Managerで専用のweb階層パイプラインを作成し、正しいリポジトリパスを選択して、完全なデプロイメントをトリガーせずにDispatcher設定を個別にデプロイします。
  3. デプロイメントの動作を確認し、選択したパイプラインにDispatcher ソース構造が含まれ、更新されたログで正常に実行されていることを確認します。Dispatcherのみのパイプラインは段階的に更新されます。
  4. AEM as a Cloud Serviceのフラッシュエンドポイントを有効にするか、AMSでカスタムスクリプトを使用することで、サポートされているキャッシュのクリア方法を適用し、Dispatcher キャッシュのタイムスタンプを確認してキャッシュの更新を確認します。
  5. 変数ファイルを使用してManaged Servicesで環境固有の変数を定義し、それらをバーチャルホスト設定に含め、リクエスト中に設定が正しく解決されるようにします。
  6. 必要に応じて、環境からDispatcher設定パッケージを取得し、抽出されたファイルが想定されるディレクトリ構造に一致することを確認します。
  7. 適切なシステム権限でDispatcher変換を実行するか、サポートされている環境を使用してシンボリックリンクエラーを回避し、変換された構造が正常に生成されるようにします。
  8. パイプライン実行ログを確認し、Dispatcher ログを確認し、設定の更新が正しく適用されていることを確認して、環境全体のデプロイメントを検証します。
  9. プログラムによるキャッシュのクリアが必要な場合は、Adobe アカウントチームに連絡して、CDN パージ API資格情報をリクエストしてください。

関連トピックス

recommendation-more-help
experience-cloud-kcs-help-kbarticles