Documentação Commerce Guia do Commerce na nuvem

Configurar o serviço Valkey

Última atualização: 5 de maio de 2025

Tópicos:
Nuvem
Cache

Criado para:

Administrador
Desenvolvedor

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.

Consulte Configurar Valkey no Guia de configuraçã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 habilitar Valkey:

Adicione o nome e o tipo necessários ao arquivo .magento/services.yaml.
cache: type: valkey:<version>
Para fornecer sua própria configuração Valkey, adicione uma chave core_config em seu arquivo .magento/services.yaml:
cache: type: valkey:8.0
Configure as relações no arquivo .magento.app.yaml.
relationships: valkey: "cache:valkey"

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

git add .magento/services.yaml .magento.app.yaml && git commit -m "Enable valkey service" && git push origin <branch-name>

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.

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.

Use o SSH para se conectar ao ambiente de integração com o Valkey instalado e configurado.
Abra um túnel SSH para um host.
valkey-cli -h valkeycache.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 valkeycache.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