Valkey サービスの設定

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

実装プレイブックのベストプラクティスガイド​の「Valkeyの設定」を参照してください。

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

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

RedisをValkeyに置き換えるには、次の3つのファイル​で設定を更新します。

  1. Redis設定を必要なValkey名に置き換え、.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. 次のように、Redis設定を置き換えるように.magento.env.yamlを設定します。

    code language-yaml
     stage:
         deploy:
         VALKEY_USE_SLAVE_CONNECTION: true
         VALKEY_BACKEND: '\Magento\Framework\Cache\Backend\RemoteSynchronizedCache'
    
  4. コード変更を追加、コミット、プッシュします。

    code language-bash
    git add .magento/services.yaml .magento.app.yaml .magento.env.yaml && git commit -m "Enable valkey service" && git push origin <branch-name>
    
  5. ​ サービス関係を確認します

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

Valkey CLIの使用

Valkey関係の名前がvalkeyであると仮定すると、valkey-cli ツールを使用してアクセスできます。

  1. Valkeyをインストールして設定した統合環境に接続するには、SSHを使用します。

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

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

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

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

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

応答:

valkey_version:8.0.1
gcc_version:12.2.0

Valkey on Proのステージングと制作

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

valkey-server -v
Valkey server v=8.0.1 ...

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

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
commerce-on-cloud-help-cloud-guide