DocumentaçãoCommerceCommerce na nuvem

Configurar o serviço Valkey

Última atualização: 18 de julho de 2025

Criado para:

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

Valkey é uma solução de cache de back-end opcional que substitui o Zend Framework Zend_Cache_Backend_File, que a Adobe Commerce usa por padrão. Se você substituir o padrão na versão 2.4.9+ do Commerce ou versões de patch posteriores a 2.4.5-p16, 2.4.6-p14, 2.4.7-p9 e as linhas de versão 2.4.8-p4, deverá usar Valkey.

Consulte Configurar Valkey no Guia de práticas recomendadas do manual de implementação.

Use as instruções a seguir para a configuração do serviço em ambientes Pro Integration e Starter, incluindo a ramificação master.

NOTE
Envie um tíquete de Suporte da Adobe Commerce para alterar a configuração do serviço em ambientes de Produção e Preparo Profissionais.

Para substituir Redis por Valkey, atualize a configuração nos três arquivos a seguir:

  1. Substitua a configuração Redis pelo nome e tipo Valkey necessários no arquivo .magento/services.yaml.

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

    Para fornecer sua própria configuração Valkey, adicione uma chave core_config em seu arquivo .magento/services.yaml:

    code language-yaml 
    cache:
    type: valkey:8.0

  2. Configure as relações no arquivo .magento.app.yaml.

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

  3. Configure .magento.env.yaml para substituir a configuração Redis da seguinte maneira:.

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

  4. Adicionar, confirmar e enviar por push as alterações de código.

    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. Verifique as relações de serviço.

TIP
Após a configuração inicial do serviço, você pode alterar a versão do software de um serviço instalado atualizando os arquivos de configuração services.yaml e .magento.app.yaml. Consulte Alterar versão de serviço para obter orientação sobre como atualizar ou rebaixar um serviço.
NOTE
O New Relic ainda pode mostrar o Redis mesmo após a migração para o Valkey
Espera-se que o New Relic continue se referindo ao serviço de cache como Redis mesmo após o ambiente ter sido migrado para o Valkey.
Valkey é uma bifurcação de código aberto da Redis, e algumas ferramentas e integrações continuam a identificar o serviço usando a nomenclatura Redis em vez de um rótulo distinto da Valkey. Isso não indica necessariamente que o Redis ainda está instalado.

Uso da CLI do Valkey

Supondo que sua relação com Valkey tenha o nome valkey, você poderá acessá-la usando a ferramenta valkey-cli.

  1. Use o SSH para se conectar ao ambiente de integração com o Valkey instalado e configurado.

  2. Abra um túnel SSH para um host.

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

Obter versão do Valkey instalada

Use o comando a seguir para instalar a versão do Valkey em um ambiente de integração:

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

Resposta:

valkey_version:8.0.1
gcc_version:12.2.0

Valkey no preparo e produção Pro

Para obter a versão Valkey instalada em um ambiente de preparo ou produção, use o comando valkey-server:

valkey-server -v

Valkey server v=8.0.1 ...

Use o comando a seguir para obter a configuração do Valkey instalada em um ambiente Pro Staging ou Production:

echo $MAGENTO_CLOUD_RELATIONSHIPS | base64 -d | json_pp

Resposta:

"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