구성 요소 장애 복구

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

관리자
개발자

이 항목에서는 구성 요소가 제대로 배포되지 않을 경우 복구하는 방법을 설명합니다. 일반적인 예에는 호환되지 않는 PHP 버전과 같이 원격 환경에서 충족되지 않는 종속성이 있는 구성 요소가 포함됩니다.

다음 방법 중 하나로 실패한 배포에서 복구할 수 있습니다.

백업 복원
이전 변경 사항에서 프로젝트 및 코드 정리 및 재배포

정리, 제거 및 재배포

이전 배포에서 정리하려면 추가되거나 업데이트된 구성 요소를 식별한 다음 제거합니다. 먼저 원격 환경에 로그인하고 var 디렉터리의 내용을 수동으로 지웁니다. 그런 다음 composer.json 파일에서 구성 요소를 제거하고 환경을 다시 배포합니다.

var 디렉터리를 정리하려면:

로컬 워크스테이션에서 프로젝트 디렉터리로 변경합니다.

SSH를 사용하여 원격 환경에 로그인합니다.

code language-bash
`magento-cloud ssh`

var 디렉터리를 지웁니다.

code language-shell
`rm -rf var/*`

로그아웃.

구성 요소를 제거하려면:

로컬 워크스테이션에서 프로젝트 디렉터리로 변경합니다.

캐시를 지웁니다.

code language-bash
`composer clear-cache`

composer.json 파일에서 구성 요소를 제거합니다.

code language-bash
`composer remove <component-name>:<version>`

다음 메시지가 표시되면 더 이상 작업을 수행하지 않아도 됩니다.

code language-none
`Package "<name>:<version>" listed for update is not installed. Ignoring.`

종속성이 업데이트되는 동안 잠시 기다려 주십시오.

코드 변경 사항을 추가, 커밋 및 푸시합니다.

code language-bash
`git add -A`

code language-bash
`git commit -m "<message>"`

code language-bash
`git push origin <environment-ID>`

WARNING

배포 프로세스는 환경의 병합, 푸시 또는 동기화를 수행하거나 수동 재배포를 트리거할 때 시작되며, 이 기간 동안 Commerce 응용 프로그램은 유지 관리 모드에 있습니다. Adobe 프로덕션 환경의 경우, 서비스가 중단되지 않도록 사용량이 적은 시간 동안 이 작업을 완료하는 것이 좋습니다.

환경 복원에서 백업 없이 환경을 복원하는 방법에 대해 자세히 알아보세요.

TIP

중단 배포에 대한 도움말을 보려면 Adobe Commerce 도움말 센터 에서 Commerce 배포 문제 해결사를 사용하십시오.

recommendation-more-help

05f2f56e-ac5d-4931-8cdb-764e60e16f26