Konfigurera Valkey-tjänsten

Last update: Tue May 27 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Ämnen:
Moln
Cacheminne

Skapat för:

Administratör
Utvecklare

Valkey är en valfri serverdelscachelösning som ersätter Zend Framework Zend_Cache_Backend_File, som Adobe Commerce använder som standard.

Se Konfigurera Valkey i Konfigurationsguiden.

Använd följande instruktioner för tjänstkonfiguration i Pro Integration-miljöer och Starter-miljöer, inklusive grenen master.

NOTE

Skicka en Adobe Commerce-supportanmälan om du vill ändra tjänstkonfigurationen i Pro Production- och mellanlagringsmiljöer.

Aktivera Valkey:

Lägg till önskat namn och typ i filen .magento/services.yaml.

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

Om du vill ange en egen Valkey-konfiguration lägger du till en core_config-nyckel i .magento/services.yaml-filen:

code language-yaml
`cache: type: valkey:8.0`

Konfigurera relationerna i filen .magento.app.yaml.

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

Lägg till, implementera och push-överföra kodändringar.

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

Verifiera tjänstrelationerna.

TIP

Efter den första konfigurationen av tjänsten kan du ändra programversionen för en installerad tjänst genom att uppdatera konfigurationsfilerna för services.yaml och .magento.app.yaml. Mer information om hur du uppgraderar eller nedgraderar en tjänst finns i Ändra tjänstversion.

Använda Valkey CLI

Om du antar att din Valkey-relation har namnet valkey kan du komma åt den med verktyget valkey-cli.

Använd SSH för att ansluta till integreringsmiljön med Valkey installerat och konfigurerat.

Öppna en SSH-tunnel för en värd.

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

Hämta installerad Valkey-version

Använd följande kommando för att installera Valkey-versionen i en integreringsmiljö:

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

Svar:

valkey_version:8.0.1
gcc_version:12.2.0

Valkey on Pro staging and production

Använd kommandot valkey-server om du vill få Valkey-versionen installerad i en mellanlagrings- eller produktionsmiljö:

valkey-server -v

Valkey server v=8.0.1 ...

Använd följande kommando för att få Valkey-konfigurationen installerad i en Pro Staging- eller Production-miljö:

echo $MAGENTO_CLOUD_RELATIONSHIPS | base64 -d | json_pp

Svar:

"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