Dokumentation Commerce Handbuch zu Commerce für Cloud

Valley-Service einrichten

Letzte Aktualisierung: 7. April 2025

Themen:
Cloud
Cache

Erstellt für:

Admin
Entwickler

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 Konfigurationshandbuch.

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.

So aktivieren Sie Valkey:

Fügen Sie den erforderlichen Namen und den erforderlichen Typ zur .magento/services.yaml hinzu.
cache: type: valkey:<version>
Um Ihre eigene Valkey-Konfiguration bereitzustellen, fügen Sie einen core_config Schlüssel in Ihrer .magento/services.yaml hinzu:
cache: type: valkey:8.0
Konfigurieren Sie die Beziehungen in der .magento.app.yaml.
relationships: valkey: "cache:valkey"

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

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

Ü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.

Verwenden Sie SSH, um eine Verbindung zur Integrationsumgebung herzustellen, wenn Valley installiert und konfiguriert ist.
Öffnen Sie einen SSH-Tunnel zu einem Host.
valkey-cli -h valkeycache.internal

Installierte Valley-Version abrufen

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

valkey-cli -h valkeycache.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