ドキュメントExperience Cloud KCS

Adobe CommerceのValkey ポート設定が正しくないため、デプロイメントに失敗しました

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

Valkey Stale Cache設定で.magento.env.yaml ファイル内の誤ったポートが使用されている場合、クラウド インフラストラクチャ上のAdobe Commerceでデプロイメント エラーが発生します。 この問題を解決するには、Valkey ポートを更新し、正常に再デプロイします。

説明 description

環境

  • 製品： Adobe Commerce クラウド インフラストラクチャ
  • バージョン： 2.4.8
  • デプロイメント環境：統合

問題/症状

  • .magento.env.yamlで古いキャッシュ設定を適用すると、デプロイメントが失敗します。
  • デプロイメントログに次のエラーが表示されます：プレーンテキスト 1Redis スタンドアロン tcp://localhost:6370への接続が1回のエラーの後に失敗しました。 最後のエラー：（111）接続が拒否されました。
  • Adobe Commerceは、設定されたValkey キャッシュバックエンドに接続できません。
  • Valkey接続設定が、設定のポートが正しくありません。
  • キャッシュバックエンドの設定中にデプロイメントの検証が失敗します。

解決策 resolution

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

  1. .magento.env.yamlで古いキャッシュ設定をプッシュする前に、次のコマンドを実行してValkey関係の詳細を取得します。

    code language-none 
    magento-cloud relationships
...
       port: <port_number>

  2. 既存のValkey サービスに対して返されるポート値に注意してください。

  3. .magento.env.yaml ファイル内のValkey ポートへのすべての参照を見つけ、ポート 6370の各出現を、前の手順で特定した正しいポート値に更新します。

  4. backend_options セクションを確認し、ポート 26370への参照を正しいValkey ポートに更新します（存在する場合）。

  5. 更新した.magento.env.yaml ファイルを保存し、変更を確定します。

  6. 修正された設定を使用して、Adobe Commerce アプリケーションを再デプロイします。

  7. デプロイメントが正常に完了したことを確認し、Valkey接続エラーがデプロイメントログに表示されないことを確認します。

メモ： Valkeyを参照しているすべての設定ファイル（.magento.app.yamlおよびservices.yamlを含む）で、同じポート設定が使用されていることを確認します。

関連トピックス

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