[僅限PaaS]{class="badge informative" title="僅適用於雲端專案(Adobe管理的PaaS基礎結構)和內部部署專案的Adobe Commerce 。"}

設定Valkey服務

Last update: Fri Jul 18 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：
雲端
快取

建立對象：

管理員
開發人員

Valkey是選用的後端快取解決方案，可取代Adobe Commerce預設使用的Zend Framework Zend_Cache_Backend_File。

請參閱設定指南中的 設定Valkey。

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

NOTE

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

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

將必要的名稱和型別新增到.magento/services.yaml檔案。

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

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

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

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

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

設定.magento.env.yaml，如下所示：。

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

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

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組態檔，以變更已安裝服務的軟體版本。請參閱變更服務版本以取得升級或降級服務的指引。

使用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

7c2b03ac-000c-497d-aba3-2c6dc720a938