Redis 서비스 설정

마지막 업데이트: 2025년 5월 5일

주제:
{"id":"dac87252-6066-4d6e-a9d2-f6d84c323de7"}

작성 대상:

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

Redis은(는) Adobe Commerce에서 기본적으로 사용하는 Zend 프레임워크 Zend_Cache_Backend_File을 대체하는 선택적 백엔드 캐시 솔루션입니다.

IMPORTANT

Redis 캐시는 Adobe Commerce 2.4.9 또는 2.4.5-p16, 2.4.6-p14, 2.4.7-p9 및 2.4.8-p5 이상의 패치 릴리스에서는 지원되지 않습니다. Redis가 지원되지 않는 캐시 구성에 Valkey를 사용합니다. 릴리스별로 지원되는 캐시 서비스에 대해서는 시스템 요구 사항을 참조하십시오.

master 분기를 포함하여 Pro 통합 환경 및 스타터 환경에서 서비스를 설정하려면 다음 지침을 사용하십시오.

NOTE

Pro 프로덕션 및 스테이징 환경에서 서비스 구성을 변경하려면 Adobe Commerce 지원 티켓을 제출하십시오.

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 구성 사용자 지정

Redis 구성 사용자 지정에 대한 자세한 내용은 구현 플레이북 모범 사례 안내서에서 Redis 구성을 참조하십시오.

Redis CLI 사용

Redis 관계의 이름이 redis이라고 가정하면 redis-cli 도구를 사용하여 액세스할 수 있습니다.

SSH를 사용하여 Redis가 설치 및 구성된 통합 환경에 연결합니다.

호스트에 대한 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

Pro 스테이징 및 프로덕션에 있는 Redis

스테이징 또는 프로덕션 환경에 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