백업에 들어가는 것
전체 수동 백업에는 코어 DB, 설치 레지스트리의 확장 테이블, 첨부·에디터·프로필 등 업로드와 설정, 확장의 영속 상태가 포함됩니다. 배포 PHP 소스와 vendor는 별도 완성 배포본으로 보관합니다. 잠금·임시 파일과 확장 런타임 캐시는 백업 대상에서 제외됩니다.
자동화 범위와 실행 조건
전체 백업 생성에는 mysqldump와 PHP 외부 명령 실행이 필요합니다. ZIP은 zip, TAR 대체 형식은 phar를 사용합니다. 자동 복원, 정기 백업 예약, 최근 5개 자동 보관, DB 업그레이드 직전 자동 백업은 제공하지 않습니다. 필요한 정기 백업은 서버의 스케줄러에서 bin/backup.php CLI를 별도로 실행합니다. 공개 GET 백업 URL은 제공하지 않습니다.
관리 화면에서 백업
- 설정 → 유지보수(/admin/settings/maintenance)를 엽니다.
- 전체 백업 만들기를 실행합니다. zip을 쓸 수 없으면 TAR 대체 형식을 사용합니다.
- 완료 후 파일 이름·크기·검증 결과를 확인하고 백업을 내려받습니다.
- 업그레이드 직전 백업과 정기 운영 백업을 구분해 보관합니다.
- 기존 백업을 삭제할 때는 별도 보관본이 있는지 확인합니다. 파일 삭제는 복구되지 않습니다.
CLI 백업
셸
php bin/backup.php create --format=zip
php bin/backup.php list
php bin/backup.php verify gnucms-mysql-날짜.zipCLI는 기존 config/config.php를 사용합니다. 서버 PHP 실행 계정이 저장소를 읽고 백업 폴더에 쓸 수 있어야 합니다. 명령에 DB 비밀번호를 넣을 필요가 없습니다. 검증은 백업 형식·파일 체크섬을 확인하며 실제 서비스 복구까지 자동 보장하는 것은 아닙니다.
수동 복원 절차 (자동 복원 미지원)
- 새 주문·회원 변경·외부 발송을 멈추고 PG 승인과 예약 문자를 확인합니다. 현재 데이터도 별도로 백업합니다.
- 백업과 같은 시점의 소스·vendor·테마·확장을 준비합니다. 관리 화면의 백업 가져오기는 보관과 검증만 하며 DB나 파일을 복원하지 않습니다.
- 백업을 비공개 작업 폴더에 풀고 database/mysql.sql을 mysql 클라이언트나 호스팅 DB 관리 도구로 대상 MySQL/MariaDB에 수동으로 가져옵니다. DB 이름과 테이블 접두어를 확인합니다.
- 업로드와 확장 영속 상태를 원래 경로에 수동 복원하고 기존 config/config.php와 암호화 비밀값을 대조합니다. 공개 웹 폴더에 백업이나 설정을 두지 않습니다.
- 외부 실행 허용값을 재검토하고 토큰 캐시를 정리합니다. 백업 이후 외부 거래·주문·발송을 대조한 뒤 운영을 재개합니다.
문서 파일 갱신 26-10-21 16:27:42