업그레이드하기

교체 전에 준비

1. 현재 버전과 적용할 버전의 변경 내역을 읽습니다. 별도 테마와 확장의 호환 여부도 확인합니다.
2. 유지보수에서 전체 백업을 만들고 내려받습니다. 서버 안의 백업만 믿지 말고 소스·테마도 별도로 보관합니다.
3. 주문 처리·글쓰기 등 변경 작업을 잠시 멈추는 시간을 정합니다. 예약 문자와 처리 중 결제를 파악합니다.
4. 새 완성 배포 ZIP을 로컬에서 풀어 업로드할 파일을 준비합니다.

제품 버전은 version.txt, DB 구조의 판 번호는 Schema::VERSION입니다. 두 값은 서로 다른 목적이며 같은 숫자일 필요가 없습니다.

보존할 파일과 교체할 파일

적용 순서

1. 현재 전체 소스와 runtime 백업의 보관 위치를 확인합니다.
2. 새 파일을 별도 위치에 준비하거나 작업 시간에 코드만 교체합니다. 파일을 반만 업로드한 상태에서 요청을 처리하지 않도록 배치합니다.
3. 기존 설정과 storage, 사용자 자산을 유지하고 완성 vendor를 함께 적용합니다.
4. 사이트를 열어 DB 자동 업그레이드가 완료되게 합니다. 권한 오류가 있으면 DB 변경 권한과 storage 쓰기 권한을 확인합니다.
5. 관리자 로그인·일반 화면·상품과 기존 주문 조회를 확인한 뒤 운영을 재개합니다.

되돌려야 할 때

코드만 예전 버전으로 돌린다고 DB까지 예전 구조로 돌아가지는 않습니다. 복원은 업그레이드 직전 소스와 전체 백업을 한 쌍으로 사용합니다. 이미 새 주문·PG 결제·발송이 발생했다면 백업 시점 이후의 외부 거래를 먼저 확인해야 합니다.

오류가 생겨도 설치기를 재실행하거나 DB를 비우지 않습니다. 기록을 보관하고 로그의 첫 오류와 마이그레이션 상태를 확인한 뒤 복구합니다.