設定Valkey服務

最後更新： 2025年7月18日

主題：
{"id":"dac87252-6066-4d6e-a9d2-f6d84c323de7"}

建立對象：

{"id":"c66ffd68-0f65-42bb-aa23-b4020f12e0bd"},{"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

Valkey是選用的後端快取解決方案，可取代Adobe Commerce預設使用的Zend Framework Zend_Cache_Backend_File。如果您覆寫Commerce 2.4.9+版或2.4.5-p16、2.4.6-p14、2.4.7-p9以上修補程式發行版本的預設值，以及2.4.8-p4版本行，則必須使用Valkey。

請參閱 實作行動手冊最佳實務指南 中的設定Valkey。

使用下列指示在Pro整合環境與入門環境（包括master分支）上進行服務設定。

NOTE

提交Adobe Commerce支援票證以變更Pro生產和中繼環境上的服務組態。

若要以Valkey取代Redis，請更新下列三個檔案中的組態：

以必要的Valkey名稱取代Redis設定，並在.magento/services.yaml檔案中輸入。

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

若要提供您自己的Valkey設定，請在.magento/services.yaml檔案中新增core_config金鑰：

code language-yaml
`cache: type: valkey:8.0`

設定.magento.app.yaml檔案中的關聯性。

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

設定.magento.env.yaml以取代Redis設定，如下所示：

code language-yaml
`stage: deploy: VALKEY_USE_SLAVE_CONNECTION: true VALKEY_BACKEND: '\Magento\Framework\Cache\Backend\RemoteSynchronizedCache'`

note tip
TIP
若是Adobe Commerce 2.4.9和更新版本，您可以設定`VALKEY_BACKEND: symfony_l2`，改用現代的Symfony快取型L2快取實作，而非`RemoteSynchronizedCache`。請參閱_部署變數_參考中的`VALKEY_BACKEND`。

新增、提交和推送您的程式碼變更。

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>`

驗證服務關係。

TIP

初始服務安裝之後，您可以更新services.yaml和.magento.app.yaml組態檔，以變更已安裝服務的軟體版本。請參閱變更服務版本以取得升級或降級服務的指引。

NOTE

即使在移轉至Valkey後，New Relic仍可能顯示Redis

即使在環境已移轉至Valkey後，預計New Relic仍可能會繼續將快取服務稱為Redis。

Valkey是Redis的開放原始碼復本，而且有些工具和整合專案會繼續使用Redis命名來識別服務，而非不同的Valkey標籤。這並不一定表示仍安裝Redis。

使用Valkey CLI

假設您的Valkey關聯性名稱為valkey，您可以使用valkey-cli工具加以存取。

使用SSH連線至已安裝並設定Valkey的整合環境。

開啟連線至主機的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

Pro測試與生產環境上的Valkey

若要在測試或生產環境中安裝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