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

Redis服务配置的最佳实践

配置Redis二级缓存

通过在REDIS_BACKEND配置文件中设置.magento.env.yaml部署变量来配置Redis二级缓存。

stage:
  deploy:
    REDIS_BACKEND: '\Magento\Framework\Cache\Backend\RemoteSynchronizedCache'

有关云基础架构上的环境配置，请参阅《云基础架构上的Commerce指南》REDIS_BACKEND中的__。

有关内部部署安装，请参阅配置指南中的​ 配置Redis页面缓存。

二级缓存内存大小(Adobe Commerce Cloud)

二级缓存使用临时文件系统作为存储机制。 与专用键值数据库系统相比，临时文件系统没有控制内存使用的键逐出策略。

内存使用率控制不足会导致二级缓存内存使用率随着时间增长，因为它会累积过时的缓存。

为避免内存耗尽二级缓存实现，Adobe Commerce会在达到特定阈值时清除存储。 默认的阈值为95%。

根据项目对高速缓存存储的要求，调整二级高速缓存内存的最大使用率非常重要。 使用以下方法之一配置内存高速缓存大小：

以下代码显示了.magento.env.yaml文件中的示例配置：

stage:
  deploy:
    REDIS_BACKEND: '\Magento\Framework\Cache\Backend\RemoteSynchronizedCache'
    CACHE_CONFIGURATION:
      _merge: true
      frontend:
        default:
          backend_options:
            cleanup_percentage: 90

缓存要求可能因项目配置和自定义第三方代码而异。 L2高速缓存内存大小的范围允许L2高速缓存在阈值命中次数不多的情况下运行。
理想情况下，二级缓存内存的使用量应该稳定在低于阈值的某个级别，只是为了避免频繁的存储清除。

您可以使用以下CLI命令检查群集的每个节点上的L2缓存存储内存使用情况，并查找/dev/shm行。
虽然使用情况可能因不同的节点而异，但应该会收敛到相同的值。

df -h

启用Redis从属连接

在.magento.env.yaml配置文件中启用Redis从属连接，以便仅允许一个节点处理读写通信，而其他节点处理只读通信。

stage:
  deploy:
    REDIS_USE_SLAVE_CONNECTION: true

请参阅《云基础架构上的Commerce指南》中的REDIS_USE_SLAVE_CONNECTION 。

对于Adobe Commerce内部部署，请使用bin/magento:setup命令配置新的Redis缓存实现。 请参阅配置指南中的​ 对默认缓存使用Redis。

预加载键

要在页面之间重用数据，请在.magento.env.yaml配置文件中列出预加载的密钥。

stage:
  deploy:
    REDIS_BACKEND: '\Magento\Framework\Cache\Backend\RemoteSynchronizedCache'
    CACHE_CONFIGURATION:
      _merge: true
      frontend:
        default:
          id_prefix: '061_'                       # Prefix for keys to be preloaded
          backend_options:
            preload_keys:                         # List the keys to be preloaded
              - '061_EAV_ENTITY_TYPES:hash'
              - '061_GLOBAL_PLUGIN_LIST:hash'
              - '061_DB_IS_UP_TO_DATE:hash'
              - '061_SYSTEM_DEFAULT:hash'

有关内部部署安装，请参阅配置指南中的​ Redis预加载功能。

启用过时的缓存

通过使用过时的缓存，同时并行生成新缓存，减少锁定等待时间并提高性能，在处理大量块和缓存键时尤其如此。 在config.php配置文件中启用过时的缓存并定义缓存类型（仅限云）：

'cache' => [
        'frontend' => [
            'stale_cache_enabled' => [
                'backend' => '\\Magento\\Framework\\Cache\\Backend\\RemoteSynchronizedCache',
                'backend_options' => [
                    'remote_backend' => '\\Magento\\Framework\\Cache\\Backend\\Redis',
                    'remote_backend_options' => [
                        'persistent' => 0,
                        'server' => 'localhost',
                        'database' => '4',
                        'port' => '6370',
                        'password' => ''
                    ],
                    'local_backend' => 'Cm_Cache_Backend_File',
                    'local_backend_options' => [
                        'cache_dir' => '/dev/shm/'
                    ],
                    'use_stale_cache' => true,
                ],
                'frontend_options' => [
                    'write_control' => false,
                ],
            ]
        ],
        'type' => [
            'default' => ['frontend' => 'default'],
            'layout' => ['frontend' => 'stale_cache_enabled'],
            'block_html' => ['frontend' => 'stale_cache_enabled'],
            'reflection' => ['frontend' => 'stale_cache_enabled'],
            'config_integration' => ['frontend' => 'stale_cache_enabled'],
            'config_integration_api' => ['frontend' => 'stale_cache_enabled'],
            'full_page' => ['frontend' => 'stale_cache_enabled'],
            'translate' => ['frontend' => 'stale_cache_enabled']
        ],
    ]

有关配置内部部署安装的信息，请参阅配置指南中的​ 过时缓存选项。

单独的Redis缓存和会话实例

通过将Redis缓存与Redis会话分离，您可以单独管理缓存和会话。 它可防止缓存问题影响会话，从而可能影响收入。 每个Redis实例都在自己的核心上运行，这可以提高性能。

在部署期间，您应该会在生成和部署日志中看到以下行：

W:   - Downloading colinmollenhour/credis (1.11.1)
W:   - Downloading colinmollenhour/php-redis-session-abstract (v1.4.5)
...
W:   - Installing colinmollenhour/credis (1.11.1): Extracting archive
W:   - Installing colinmollenhour/php-redis-session-abstract (v1.4.5): Extracting archive
...
[2022-08-17 01:13:40] INFO: Version of service 'redis' is 6.0
[2022-08-17 01:13:40] INFO: Version of service 'redis-session' is 6.0
[2022-08-17 01:13:40] INFO: redis-session will be used for session if it was not override by SESSION_CONFIGURATION

缓存压缩

如果您使用的是超过6GB的Redis maxmemory，则可以使用缓存压缩来减少密钥占用的空间。 请注意，需要权衡客户端性能。 如果您有备用CPU，请启用它。 请参阅配置指南中的​ 为会话存储 ​使用Redis。

stage:
  deploy:
    REDIS_BACKEND: '\Magento\Framework\Cache\Backend\RemoteSynchronizedCache'
    CACHE_CONFIGURATION:
      _merge: true;
      frontend:
        default:
          backend_options:
            compress_data: 4              # 0-9
            compress_tags: 4              # 0-9
            compress_threshold: 20480     # don't compress files smaller than this value
            compression_lib: 'gzip'       # snappy and lzf for performance, gzip for high compression (~69%)

启用Redis异步释放(lazyfree)

要在云基础架构上的Adobe Commerce上启用lazyfree，请提交Adobe Commerce支持票证，请求将以下Redis配置应用于您的环境：

lazyfree-lazy-eviction yes
lazyfree-lazy-expire yes
lazyfree-lazy-server-del yes
replica-lazy-flush yes
lazyfree-lazy-user-del yes

启用lazyfree后，Redis会将内存回收卸载到后台线程，以进行逐出、过期、服务器启动的删除、用户删除和副本数据集刷新。 这减少了主线程阻塞，并可降低请求延迟。

启用Redis多线程I/O

要在云基础架构上的Adobe Commerce上启用Redis I/O线程，请提交Adobe Commerce支持票证请求以下配置。 这可以通过从主线程卸载套接字读/写和命令解析来提高吞吐量，但代价是较高的CPU使用率。 在加载下验证并监视主机。

io-threads-do-reads yes
io-threads 8 # choose a value lower than the number of CPU cores (check with nproc), then tune under load

增加Redis客户端超时和重试

调整.magento.env.yaml中的后端选项，提高缓存客户端对瞬态饱和度的容错：

stage:
  deploy:
    CACHE_CONFIGURATION:
      _merge: true
      frontend:
        default:
          backend_options:
            read_timeout: 10
            connect_retries: 5

这些设置通过扩展回复等待窗口和重试连接设置，提高了客户端对Redis上短暂拥塞的容忍度。 这可以减少在短峰值期间出现间歇性cannot connect to localhost:6370和读取超时错误。

其他信息