[PaaS만]{class="badge informative" title="Adobe Commerce 온 클라우드 프로젝트(Adobe 관리 PaaS 인프라) 및 온프레미스 프로젝트에만 적용됩니다."}

백업 관리

Last update: Mon May 04 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

주제:
클라우드

작성 대상:

관리자
개발자

Cloud Console의 Backup 버튼을 사용하거나 magento-cloud snapshot:create 명령을 사용하여 언제든지 활성 Starter 환경의 수동 백업을 수행할 수 있습니다.

백업 또는 스냅숏은(는) 실행 중인 서비스(MySQL 데이터베이스)의 모든 영구 데이터와 탑재된 볼륨(var, pub/media, app/etc)에 저장된 모든 파일을 포함하는 환경 데이터의 전체 백업입니다. Git 기반 저장소에 코드가 이미 저장되어 있으므로 스냅숏에 코드가 포함되지않습니다. 스냅샷의 사본은 다운로드할 수 없습니다.

WARNING

백업에는 일반적으로 pub/media과(와) 같은 공용 웹 디렉터리를 포함하여 마운트된 디렉터리의 내용이 포함되지만 백업 출력 파일을 pub/media 또는 pub/static과(와) 같은 공용 웹 디렉터리로 이동하지 마십시오.

백업/스냅숏 기능은 기본적으로 재해 복구 목적으로 일반 백업을 받는 Pro 스테이징 및 프로덕션 환경에는 적용되지 않습니다. 자세한 내용은 Pro 백업 및 재해 복구를 참조하십시오. Pro 스테이징 및 프로덕션 환경의 자동 라이브 백업과 달리 백업은 자동이 아닙니다. Starter 또는 Pro 통합 환경의 백업을 주기적으로 만들려면 백업을 수동으로 만들거나 cron 작업을 설정하는 것은 사용자의 책임입니다.

수동 백업 만들기

Cloud Console에서 활성 Starter 환경 및 통합 Pro 환경의 수동 백업을 만들거나 Cloud CLI에서 스냅숏을 만들 수 있습니다. 환경에 대한 관리자 역할이(가) 있어야 합니다.

NOTE

터미널에서 다음 명령을 실행하여 포함/제외할 폴더/경로에 대해 조정하여 Pro 프로덕션 및 스테이징 클러스터에서 직접 코드 백업을 작성할 수 있습니다.

code language-bash
`mkdir -p var/support /usr/bin/nice -n 15 /bin/tar -czhf var/support/code-$(date +"%Y%m%d%H%M%p").tar.gz app bin composer.* dev lib pub/*.php pub/errors setup vendor --exclude='pub/media'`

Pro 환경의 데이터베이스 백업을 만들려면:

스테이징 및 프로덕션을 포함한 모든 Pro 환경의 데이터베이스 덤프를 만들려면 데이터베이스 덤프 만들기 기술 자료 문서를 참조하십시오.

Cloud Console을(를) 사용하여 Starter 환경의 백업을 만들려면 다음을 수행하십시오.

Cloud Console에 로그인합니다.
프로젝트 탐색 모음에서 환경을 선택합니다. 환경이 활성화되어 있어야 합니다.
백업 보기에서 Backup을(를) 클릭합니다. Pro 환경에서는 이 옵션을 사용할 수 없습니다.

{width="150"}

Cloud Console을(를) 사용하여 통합 환경의 백업을 만들려면:

Cloud Console에 로그인합니다.
프로젝트 탐색 모음에서 통합/개발 환경을 선택합니다. 환경이 활성화되어 있어야 합니다.
오른쪽 상단 메뉴에서 Backup 옵션을 선택합니다. 이 옵션은 Starter 및 Pro 환경 모두에서 사용할 수 있습니다.
Yes 단추를 클릭합니다.

CLI를 사용하여 스냅숏을 만들려면:magento-cloud

로컬 워크스테이션에서 프로젝트 디렉터리로 변경합니다.
스냅샷에 대한 환경 분기를 확인하십시오.

스냅샷을 생성합니다.

code language-bash
`magento-cloud snapshot:create --live`

또는 magento-cloud backup short 명령을 사용할 수 있습니다. --live 옵션은 가동 중지 시간을 피하기 위해 환경을 계속 실행합니다. 전체 옵션 목록을 보려면 magento-cloud snapshot:create --help을(를) 입력하십시오.

샘플 응답:

code language-none

code language-none
`Creating a snapshot of develop-branch Waiting for the activity ID (User created a backup of develop-branch): Creating backup of develop-branch Created backup my-snapshot [============================] 45 secs (complete) Activity ID succeeded Snapshot name: my-snapshot`

Creating a snapshot of develop-branch
Waiting for the activity ID (User created a backup of develop-branch):

Creating backup of develop-branch
Created backup my-snapshot
[============================] 45 secs (complete)
Activity ID succeeded
Snapshot name: my-snapshot

최신 스냅샷을 확인합니다.

code language-bash
`magento-cloud snapshot:list`

목록에서는 스냅샷 상태에 대한 정보를 반환합니다.

code language-none

code language-none
`Snapshots on the project (project-id), environment develop-branch (type: development): +---------------------------+----------------------+------------+ \| Created \| Snapshot ID \| Restorable \| +---------------------------+----------------------+------------+ \| 2023-03-08T17:07:01+00:00 \| my-snapshot \| true \| +---------------------------+----------------------+------------+`

Snapshots on the project (project-id), environment develop-branch (type: development):
+---------------------------+----------------------+------------+
| Created                   | Snapshot ID          | Restorable |
+---------------------------+----------------------+------------+
| 2023-03-08T17:07:01+00:00 | my-snapshot          | true       |
+---------------------------+----------------------+------------+

수동 백업 복원

환경에 대한 관리자 액세스 권한이 있어야 합니다. 수동 백업은 최대 7일에서 복원할 수 있습니다. 백업을 복원해도 현재 git 분기의 코드는 변경되지 않습니다. 이러한 방식으로 백업을 복원하는 것은 Pro 스테이징 및 프로덕션 환경에는 적용되지 않습니다. Pro 백업 및 재해 복구를 참조하십시오.

복원 시간은 데이터베이스 크기에 따라 다릅니다.

대용량 데이터베이스(200GB 이상)는 5시간 소요
중간 데이터베이스(150GB)는 2시간 30분 정도 소요될 수 있음
소규모 데이터베이스(60GB)는 1시간 소요

TIP

백업 없이 복원:

이전 코드로 롤백하거나 환경에서 추가된 확장을 제거하려면 코드 롤백을 참조하십시오.
백업이 없는 불안정한 환경을 복원하려면 환경 복원을 참조하십시오.

Cloud Console을(를) 사용하여 백업을 복원하려면:

Cloud Console에 로그인합니다.
프로젝트 탐색 모음에서 환경을 선택합니다.
백업 보기의 저장 목록에서 백업을 선택하십시오. 백업 기능은 Pro 환경에 적용되지 않습니다.
{width="32"}(자세히) 메뉴에서 복원을 클릭합니다.
백업 정보에서 복원 정보를 검토하고 예, 복원을 클릭합니다.

Cloud CLI를 사용하여 스냅샷을 복원하려면:

로컬 워크스테이션에서 프로젝트 디렉터리로 변경합니다.
복원할 환경 분기를 확인하십시오.

사용 가능한 모든 스냅샷을 나열합니다.

code language-bash
`magento-cloud snapshot:list`

목록에서는 사용 가능한 스냅샷에 대한 정보를 반환합니다.

code language-none

code language-none
`Snapshots on the project (project-id), environment develop-branch (type: development): +---------------------------+----------------------+------------+ \| Created \| Snapshot ID \| Restorable \| +---------------------------+----------------------+------------+ \| 2023-03-08T17:07:01+00:00 \| my-snapshot \| true \| +---------------------------+----------------------+------------+`

Snapshots on the project (project-id), environment develop-branch (type: development):
+---------------------------+----------------------+------------+
| Created                   | Snapshot ID          | Restorable |
+---------------------------+----------------------+------------+
| 2023-03-08T17:07:01+00:00 | my-snapshot          | true       |
+---------------------------+----------------------+------------+

목록의 스냅샷 ID를 사용하여 스냅샷을 복원합니다.

code language-bash
`magento-cloud snapshot:restore <snapshot-id>`

재해 복구 스냅샷 복원

Pro 스테이징 및 프로덕션 환경에서 재해 복구 스냅숏을 복원하려면 서버에서 직접 데이터베이스 덤프를 가져옵니다.

롤백 코드

백업 및 스냅숏에 코드 사본이 포함되어 있지 않습니다. 코드가 이미 Git 기반 저장소에 저장되었으므로 Git 기반 명령을 사용하여 코드를 롤백(또는 되돌리기)할 수 있습니다. 예를 들어 git log --oneline을(를) 사용하여 이전 커밋을 스크롤한 다음 git revert을(를) 사용하여 특정 커밋에서 코드를 복원합니다.

또한 비활성 분기에 코드를 저장하도록 선택할 수 있습니다. magento-cloud 명령을 사용하는 대신 git 명령을 사용하여 분기를 만드십시오. Cloud CLI 항목에서 Git 명령 정보를 참조하십시오.

백업 관리

수동 백업 만들기

수동 백업 복원

재해 복구 스냅샷 복원

롤백 코드

관련 정보