DokumentationCommerceCommerce in Cloud Manager

Valley-Service einrichten

Letzte Aktualisierung: 18. Juli 2025

Erstellt für:

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

Valkey ist eine optionale Backend-Cache-Lösung, die den Zend Framework Zend_Cache_Backend_File ersetzt, den Adobe Commerce standardmäßig verwendet. Wenn Sie den Standardwert in Commerce ab Version 2.4.9 oder Patch-Versionen nach Version 2.4.5-p16, 2.4.6-p14, 2.4.7-p9 und den 2.4.8-p4-Release-Zeilen überschreiben, müssen Sie Valkey verwenden.

Siehe Konfigurieren von Valkey im Handbuch zu Best Practices für Implementierungswiedergaben.

Verwenden Sie die folgenden Anweisungen für die Einrichtung des Services in Pro Integration-Umgebungen und Starter-Umgebungen, einschließlich der master.

NOTE
Senden eines Adobe Commerce Support-Tickets um die Service-Konfiguration in Pro-Produktions- und Staging-Umgebungen zu ändern.

Um Redis durch Valkey zu ersetzen, aktualisieren Sie die Konfiguration in den folgenden drei Dateien:

  1. Ersetzen Sie die Redis-Konfiguration durch den erforderlichen Valley-Namen und geben Sie die .magento/services.yaml ein.

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

    Um Ihre eigene Valkey-Konfiguration bereitzustellen, fügen Sie einen core_config Schlüssel in Ihrer .magento/services.yaml hinzu:

    code language-yaml 
    cache:
    type: valkey:8.0

  2. Konfigurieren Sie die Beziehungen in der .magento.app.yaml.

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

  3. Konfigurieren Sie .magento.env.yaml so, dass die Redis-Konfiguration wie folgt ersetzt wird:.

    code language-yaml 
     stage:
     deploy:
     VALKEY_USE_SLAVE_CONNECTION: true
     VALKEY_BACKEND: '\Magento\Framework\Cache\Backend\RemoteSynchronizedCache'
    note tip
    TIP
    Für Adobe Commerce 2.4.9 und höher können Sie die moderne L2-Cache-basierte Implementierung von Symfony anstelle von RemoteSynchronizedCache verwenden, indem Sie VALKEY_BACKEND: symfony_l2 festlegen. Siehe VALKEY_BACKEND in der Referenz Variablen bereitstellen.

  4. Code-Änderungen hinzufügen, übertragen und per Push übertragen.

    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. Überprüfen Sie die Service-Beziehungen.

TIP
Nach der Ersteinrichtung des Service können Sie die Softwareversion für einen installierten Service ändern, indem Sie die services.yaml und .magento.app.yaml Konfigurationsdateien aktualisieren. Unter Ändern der Service-Version finden Sie Anleitungen zum Aktualisieren oder Herunterstufen eines Services.
NOTE
New Relic zeigt möglicherweise auch nach der Migration nach Valkey noch Redis
Es wird erwartet, dass New Relic den Cache-Service auch nach der Migration der Umgebung zu Valkey weiterhin als Redis bezeichnet.
Valkey ist eine Open-Source-Form von Redis, und einige Tools und Integrationen identifizieren den Service weiterhin mit Redis-Namen anstatt einer eindeutigen Valkey-Kennzeichnung. Dies bedeutet nicht unbedingt, dass Redis noch installiert ist.

Verwenden der Valley-CLI

Wenn Ihre Valley-Beziehung valkey heißt, können Sie mit dem valkey-cli-Tool darauf zugreifen.

  1. Verwenden Sie SSH, um eine Verbindung zur Integrationsumgebung herzustellen, wenn Valley installiert und konfiguriert ist.

  2. Öffnen Sie einen SSH-Tunnel zu einem Host.

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

Installierte Valley-Version abrufen

Verwenden Sie den folgenden Befehl, um die Valley-Version in einer Integrationsumgebung zu installieren:

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

Antwort:

valkey_version:8.0.1
gcc_version:12.2.0

Valley auf Pro-Staging und Produktion

Um die Valkey-Version in einer Staging- oder Produktionsumgebung zu installieren, verwenden Sie den valkey-server:

valkey-server -v

Valkey server v=8.0.1 ...

Verwenden Sie den folgenden Befehl, um die Valley-Konfiguration in einer Pro-Staging- oder Produktionsumgebung zu installieren:

echo $MAGENTO_CLOUD_RELATIONSHIPS | base64 -d | json_pp

Antwort:

"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