Configurare il servizio Valkey

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

Argomenti:
Cloud
Cache

Creato per:

Amministratore
Sviluppatore

Valkey è una soluzione cache back-end facoltativa che sostituisce Zend Framework Zend_Cache_Backend_File, utilizzata da Adobe Commerce per impostazione predefinita.

Vedi Configurazione di Valkey nella Guida alla configurazione.

Utilizzare le istruzioni seguenti per la configurazione del servizio negli ambienti di integrazione Pro e negli ambienti Starter, incluso il ramo master.

NOTE

Invia un ticket di supporto Adobe Commerce per modificare la configurazione del servizio negli ambienti di produzione e staging di Pro.

Per sostituire Redis con Valkey, aggiornare la configurazione nei tre file seguenti:

Aggiungere il nome e il tipo richiesti al file .magento/services.yaml.

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

Per fornire la tua configurazione Valkey, aggiungi una chiave core_config nel file .magento/services.yaml:

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

Configurare le relazioni nel file .magento.app.yaml.

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

Configura .magento.env.yaml come segue:.

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

Aggiungi, esegui il commit e invia le modifiche al codice.

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>`

Verificare le relazioni del servizio.

TIP

Dopo la configurazione iniziale del servizio, è possibile modificare la versione del software per un servizio installato aggiornando i file di configurazione services.yaml e .magento.app.yaml. Per informazioni sull'aggiornamento o il downgrade di un servizio, vedere Modifica versione del servizio.

Utilizzo di Valkey CLI

Se la relazione Valkey è denominata valkey, è possibile accedervi utilizzando lo strumento valkey-cli.

Utilizza SSH per connettersi all’ambiente di integrazione con Valkey installato e configurato.

Aprire un tunnel SSH a un host.

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

Scarica versione di Valkey installata

Utilizza il seguente comando per ottenere la versione di Valkey installata in un ambiente di integrazione:

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

Risposta:

valkey_version:8.0.1
gcc_version:12.2.0

Valkey su staging e produzione Pro

Per ottenere la versione di Valkey installata in un ambiente di staging o produzione, utilizzare il comando valkey-server:

valkey-server -v

Valkey server v=8.0.1 ...

Utilizzate il seguente comando per installare la configurazione Valkey in un ambiente di staging o produzione Pro:

echo $MAGENTO_CLOUD_RELATIONSHIPS | base64 -d | json_pp

Risposta:

"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