[仅限PaaS]{class="badge informative" title="仅适用于云项目(Adobe管理的PaaS基础架构)和内部部署项目上的Adobe Commerce 。"}

设置Redis服务

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

主题：
云
缓存

创建对象：

管理员
开发人员

Redis是一个可选的后端缓存解决方案，它取代了Adobe Commerce默认使用的Zend Framework Zend_Cache_Backend_File。

请参阅 配置指南 中的配置红色。

请按照以下说明在专业集成环境和入门环境（包括master分支）上进行服务设置。

NOTE

提交Adobe Commerce支持票证以更改Pro生产和暂存环境中的服务配置。

启用Redis：

将所需的名称和类型添加到.magento/services.yaml文件中。

code language-yaml
`myredis: type: redis:<version>`

要提供您自己的Redis配置，请在.magento/services.yaml文件中添加core_config密钥：

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

在.magento.app.yaml文件中配置关系。

code language-yaml
`runtime: extensions: - redis relationships: redis: "redis:redis"`

添加、提交和推送代码更改。

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

验证服务关系。

TIP

在初始服务设置之后，您可以通过更新services.yaml和.magento.app.yaml配置文件来更改已安装服务的软件版本。有关升级或降级服务的指导，请参阅更改服务版本。

使用Redis CLI

假定您的Redis关系名为redis，则可以使用redis-cli工具访问它。

使用SSH连接到已安装并配置了Redis的集成环境。

打开到主机的SSH通道。

code language-bash
`redis-cli -h redis.internal`

获取已安装的Redis版本

使用以下命令获取集成环境中安装的Redis版本：

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

示例响应：

redis_version:7.0.5
gcc_version:8.3.0

Redis on Pro暂存和生产环境

要在暂存或生产环境中安装Redis版本，请使用redis-server命令：

redis-server -v

Redis server v=7.0.5 ...

使用以下命令获取Redis配置在Pro暂存或生产环境中安装：

echo $MAGENTO_CLOUD_RELATIONSHIPS | base64 -d | json_pp

示例响应：

"redis" : [
    {
        "cluster" : "project-master-123abc4",
        "fragment" : null,
        "host" : "redis.internal",
        "host_mapped" : false,
        "hostname" : "oblahblahblahblahe.redis.service._.magentosite.cloud",
        "ip" : "169.254.10.10",
        "password" : null,
        "path" : null,
        "port" : 6379,
        "public" : false,
        "query" : {},
        "rel" : "redis",
        "scheme" : "redis",
        "service" : "redis",
        "type" : "redis:7.0.5",
        "username" : null
    }
]

Redis疑难解答

请参阅以下Adobe Commerce支持文章，以获取有关Redis问题疑难解答的帮助：

recommendation-more-help

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