Valley-Service einrichten

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

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.

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

Fügen Sie den erforderlichen Namen und den erforderlichen Typ zur .magento/services.yaml hinzu.

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`

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

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

Konfigurieren Sie .magento.env.yaml wie folgt:.

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

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

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

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

7c2b03ac-000c-497d-aba3-2c6dc720a938