Redis サービスの設定

最終更新日： 2025年10月14日

トピック：
{"id":"dac87252-6066-4d6e-a9d2-f6d84c323de7"}

作成対象：

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

Redisは、Adobe Commerceがデフォルトで使用するZend Framework Zend_Cache_Backend_Fileに代わるオプションのバックエンドキャッシュソリューションです。

設定ガイドの「Redisの設定」を参照してください。

master ブランチを含むPro統合環境およびスターター環境でのサービス設定については、次の手順を使用します。

NOTE

Adobe Commerce サポートチケットを送信して、Pro実稼動環境とステージング環境のサービス構成を変更します。

Redisを有効にするには：

必要な名前と種類を.magento/services.yaml ファイルに追加します。

code language-yaml
`myredis: type: redis:<version>`

独自のRedis設定を提供するには、.magento/services.yaml ファイルにcore_config キーを追加します。

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

.magento.app.yaml ファイルの関係を設定します。

code language-yaml
`runtime: extensions: - redis relationships: redis: "redis:redis"`

コード変更を追加、コミット、プッシュします。

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

サービス関係を確認します。

TIP

最初のサービス設定の後、services.yamlおよび.magento.app.yaml設定ファイルを更新することで、インストール済みサービスのソフトウェアバージョンを変更できます。サービスのアップグレードまたはダウングレードに関するガイダンスについては、サービスバージョンの変更を参照してください。

Redis CLIの使用

Redis関係がredisであると仮定すると、redis-cli ツールを使用してアクセスできます。

Redisをインストールして設定した統合環境に接続するには、SSHを使用します。

ホストへのSSH トンネルを開きます。

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

インストールされたRedis バージョンを取得

統合環境にインストールされているRedis バージョンを取得するには、次のコマンドを使用します。

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

回答サンプル：

redis_version:7.0.5
gcc_version:8.3.0

Redis on Proのステージングと実稼動

ステージング環境または実稼動環境にインストールされたRedis バージョンを取得するには、redis-server コマンドを使用します。

redis-server -v

Redis server v=7.0.5 ...

次のコマンドを使用して、Pro ステージング環境または実稼動環境にインストールされたRedis設定を取得します。

echo $MAGENTO_CLOUD_RELATIONSHIPS | base64 -d | json_pp

回答サンプル：

"redis" : [
    {
        "cluster" : "project-master-123abc4",
        "fragment" : null,
        "host" : "redis.internal",
        "host_mapped" : false,
        "hostname" : "oblahblahblahblahe.redis.service._.magentosite.cloud",
        "ip" : "169.254.10.10",
        "password" : null,
        "path" : null,
        "port" : 6379,
        "public" : false,
        "query" : {},
        "rel" : "redis",
        "scheme" : "redis",
        "service" : "redis",
        "type" : "redis:7.0.5",
        "username" : null
    }
]

Redisのトラブルシューティング

Redisの問題のトラブルシューティングについては、次のAdobe Commerce サポート記事を参照してください。

recommendation-more-help

commerce-on-cloud-help-cloud-guide