설명서Experience Cloud KCS

Adobe Commerce의 잘못된 Valkey 포트 구성으로 인해 배포 실패

마지막 업데이트: 2026년 7월 31일

Valkey Stale Cache 구성이 .magento.env.yaml 파일에서 잘못된 포트를 사용하는 경우 클라우드 인프라의 Adobe Commerce에서 배포 오류가 발생합니다. 이 문제를 해결하려면 Valkey 포트를 업데이트하고 재배포하십시오.

설명 description

환경

  • 클라우드 인프라의 제품: Adobe Commerce
  • 버전: 2.4.8
  • 배포 환경: 통합

문제/증상

  • .magento.env.yaml에서 부실 캐시 구성을 적용할 때 배포가 실패합니다.
  • 배포 로그에는 다음 오류가 표시됩니다. Redis 독립 실행형 연결 tcp://localhost:6370이 1회 실패 후 실패했습니다. 마지막 오류: (111) 연결이 거부되었습니다.
  • Adobe Commerce이 구성된 Valkey 캐시 백엔드에 연결하지 못했습니다.
  • 유효성 검사 연결 설정이 구성에서 잘못된 포트를 참조합니다.
  • 캐시 백엔드 구성 중에 배포 유효성 검사가 실패합니다.

해결 방법 resolution

아래 단계에 따라 문제를 해결하십시오.

  1. .magento.env.yaml에서 부실 캐시 구성을 푸시하기 전에 다음 명령을 실행하여 Valkey 관계의 세부 정보를 가져옵니다.

    code language-none 
    magento-cloud relationships
...
       port: <port_number>

  2. 기존 Valkey 서비스에 대해 반환된 포트 값을 확인합니다.

  3. .magento.env.yaml 파일에서 Valkey 포트에 대한 모든 참조를 찾아 각 포트 6370을 이전 단계에서 식별된 올바른 포트 값으로 업데이트합니다.

  4. backend_options 섹션을 검토하고 포트 26370에 대한 참조가 있는 경우 올바른 Valkey 포트로 업데이트하십시오.

  5. 업데이트된 .magento.env.yaml 파일을 저장하고 변경 내용을 커밋하십시오.

  6. 수정된 구성을 사용하여 Adobe Commerce 애플리케이션을 다시 배포합니다.

  7. 배포가 성공적으로 완료되었는지 확인하고 배포 로그에 Valkey 연결 오류가 표시되지 않는지 확인합니다.

참고: .magento.app.yaml 및 services.yaml을(를) 포함하여 Valkey를 참조하는 모든 구성 파일이 동일한 포트 구성을 사용하는지 확인하십시오.

관련 읽기

recommendation-more-help
experience-cloud-kcs-help-kbarticles