클라우드 인프라에서 Adobe Commerce의 버전 불일치 해결
스테이징의 클라우드 인프라 Adobe Commerce 버전이 프로덕션 버전보다 오래된 경우 스테이징에서 프로덕션으로 배포가 실패합니다. 이러한 불일치는 호환성 문제를 트리거하고 배포를 차단할 수 있습니다. 환경 버전을 맞추거나 프로덕션을 재설정하면 문제를 해결하고 원활한 배포가 보장됩니다.
설명 description
환경
- 클라우드 인프라의 Adobe Commerce
- Pro Staging / 운영 클러스터
문제/증상
- 스테이징에서 프로덕션으로 코드를 푸시할 때 배포 파이프라인이 실패합니다.
- 로그는 프로덕션 환경에서 Adobe Commerce 버전을 다운그레이드하려고 시도하여 오류가 발생했음을 나타냅니다.
- 스테이징 환경과 프로덕션 환경 간의 버전이 서로 달라 호환성 문제가 발생합니다.
해결 방법 resolution
참고:
환경 재설정 또는 데이터베이스 변경을 진행하기 전에 프로덕션 환경에 대한 완전하고 검증된 백업이 있는지 확인하십시오. 스냅숏 기능을 사용하여 백업을 안전하게 만들고 관리할 수 있습니다.
이 문제를 해결하려면 모든 환경이 프로덕션과 동일한 클라우드 인프라 상의 Adobe Commerce 버전과 일치해야 합니다. 다음 단계를 수행하십시오.
- 프로덕션에 사용되는 버전과 일치하도록 스테이징 환경을 업그레이드합니다. 이를 통해 환경 간에 일관성을 유지하고 배포 실패를 방지할 수 있습니다. 자세한 내용은 Commerce 버전 업그레이드를 참조하세요.
- 스테이징을 업그레이드할 수 없는 경우 스테이징과 일치하도록 프로덕션 환경을 재설정하는 것이 좋습니다. 계속하기 전에 이미 백업을 수행했는지 확인하십시오. 필요한 경우 기존 프로덕션 데이터베이스를 삭제할 권한을 얻습니다. 자세한 내용은 클라우드 인프라에서 Adobe Commerce 환경 재설정을 참조하세요.
- 저장소에서 구성 파일(
config.php)을 임시로 제거합니다.- 이렇게 하면 재설정 작업 중에 구성 관리가 비활성화됩니다. 자세한 내용은 클라우드 스냅숏이 없는 환경 롤백을 참조하세요.
- setup:uninstall 명령을 사용하여 Adobe Commerce 소프트웨어를 제거합니다.
- 재배포하기 전에 이전 구성이 모두 지워졌는지 확인합니다. 자세한 내용은 Adobe Commerce 제거를 참조하세요.
- 버전을 정렬하거나 환경을 재설정한 후 코드베이스를 재배포합니다.
- 적절한 종속성 관리를 위해 저장소에
composer.lock을(를) 포함합니다.
- 적절한 종속성 관리를 위해 저장소에
- 모든 변경 사항이 성공적으로 적용되었는지 확인하고 배포 후 기능을 확인합니다.
모든 환경에서 일관된 버전을 유지하거나 호환되지 않는 설정을 재설정하여 호환성 문제가 발생하지 않고 원활한 배포를 보장할 수 있습니다.
recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f