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.

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'

  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.

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