ドキュメントCommerceクラウド上の Commerce に関するガイド

[PaaS のみ]{class="badge informative" title="Adobe Commerce on Cloud プロジェクト（Adobeが管理する PaaS インフラストラクチャ）およびオンプレミスプロジェクトにのみ適用されます。"}

Valkey サービスの設定

Last update: Mon May 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

作成対象：

  • 管理者
  • 開発者

Valkey は、Adobe Commerceがデフォルトで使用する Zend Framework Zend_Cache_Backend_File に代わるオプションのバックエンドキャッシュソリューションです。

設定ガイド の Valkey の設定を参照してください。

master ブランチを含む Pro 統合環境とスターター環境でのサービス設定については、以下の手順を使用します。

NOTE
Adobe Commerce サポートチケットを送信して、Pro 実稼動環境とステージング環境のサービス設定を変更します。

Valkey を有効にするには:

  1. 必要な名前とタイプを .magento/services.yaml ファイルに追加します。

    code language-yaml 
    cache:
    type: valkey:<version>

    独自の Valkey 設定を指定するには、.magento/services.yaml ファイルに core_config キーを追加します。

    code language-yaml 
    cache:
    type: valkey:8.0

  2. .magento.app.yaml ファイルで関係を設定します。

    code language-yaml 
    relationships:
    valkey: "cache:valkey"

  3. コードの変更を追加、コミット、プッシュします。

    code language-bash 
    git add .magento/services.yaml .magento.app.yaml && git commit -m "Enable valkey service" && git push origin <branch-name>

  4. サービスの関係を確認します。

TIP
サービスの初期セットアップ後、services.yaml および .magento.app.yaml の構成ファイルを更新することで、インストールされているサービスのソフトウェア バージョンを変更できます。 サービスのアップグレードまたはダウングレードのガイダンスについては、 サービスバージョンの変更を参照してください。

Valkey CLI の使用

Valkey 関係の名前が valkey の場合は、valkey-cli ツールを使用してアクセスできます。

  1. SSH を使用して、Valkey がインストールおよび設定された統合環境に接続します。

  2. ホストへの SSH トンネルを開きます。

    code language-bash 
    valkey-cli -h valkeycache.internal

インストール済みの Valkey バージョンの取得

次のコマンドを使用して、統合環境にインストールされている Valkey のバージョンを取得します。

valkey-cli -h valkeycache.internal info | grep version

応答：

valkey_version:8.0.1
gcc_version:12.2.0

ステージング環境および実稼動環境での Valkey

ステージング環境または実稼動環境にインストールされた Valkey のバージョンを取得するには、valkey-server のコマンドを使用します。

valkey-server -v

Valkey server v=8.0.1 ...

次のコマンドを使用して、Valkey 設定を Pro ステージング環境または実稼動環境にインストールします。

echo $MAGENTO_CLOUD_RELATIONSHIPS | base64 -d | json_pp

応答：

"valkey" : [
    {
        "cluster" : "project-master-abc0003",
        "epoch" : 0,
        "fragment" : null,
        "host" : "valkeycache.internal",
        "host_mapped" : false,
        "hostname" : "oblahblahblahblahe.cache.service._.magentosite.cloud",
        "instance_ips" : [
        "123.456.789.012"
        ],
        "ip" : "123.456.789.012",
        "password" : null,
        "path" : null,
        "port" : 6379,
        "public" : false,
        "query" : {},
        "rel" : "valkey",
        "scheme" : "valkey",
        "service" : "cache",
        "type" : "valkey:8.0",
        "username" : null
    }
]
recommendation-more-help
7c2b03ac-000c-497d-aba3-2c6dc720a938