DocumentazioneCommerceCommerce su Cloud

Configurazione del servizio Redis

Ultimo aggiornamento: 5 maggio 2025

Creato per:

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

Redis è una soluzione cache back-end opzionale che sostituisce Zend Framework Zend_Cache_Backend_File, utilizzato da Adobe Commerce per impostazione predefinita.

Consulta Configurare Redis nella Guida alle best practice per l’implementazione del playbook.

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 abilitare Redis:

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

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

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

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

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

    code language-yaml 
    runtime:
    extensions:
        - redis

relationships:
    redis: "redis:redis"

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

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

  4. 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 Redis CLI

Se la relazione Redis si chiama redis, è possibile accedervi utilizzando lo strumento redis-cli.

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

  2. Aprire un tunnel SSH a un host.

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

Ottieni versione Redis installata

Utilizza il seguente comando per installare la versione di Redis in un ambiente di integrazione:

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

Risposta di esempio:

redis_version:7.0.5
gcc_version:8.3.0

Redis su staging e produzione Pro

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

redis-server -v

Redis server v=7.0.5 ...

Utilizzate il seguente comando per installare la configurazione Redis in un ambiente Pro Staging o Production:

echo $MAGENTO_CLOUD_RELATIONSHIPS | base64 -d | json_pp

Risposta di esempio:

"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
    }
]

Risoluzione dei problemi di Redis

Consulta i seguenti articoli sul supporto Adobe Commerce per assistenza nella risoluzione dei problemi Redis:

recommendation-more-help
commerce-on-cloud-help-cloud-guide