영구 앱 데이터, 데이터베이스 스키마, 볼륨 소유권 또는 스토리지 레이아웃을 변경할 수 있는 컨테이너 업데이트 전에 롤백 지점을 만들어야 합니다. 서비스가 상태 비저장이고 영구 경로가 변경되지 않았으며 테스트된 백업이 이미 데이터를 포함하는 경우 무해한 이미지 풀 또는 재시작 전에 새 파일시스템 스냅샷은 필요하지 않습니다.
홈 NAS에 유용한 규칙은 “모든 업데이트를 스냅샷하라”가 아니라 “상태를 변경하는 모든 업데이트를 보호하라”입니다. 이는 컨테이너 이미지가 무엇을 제어하는지, 볼륨이나 바인드 마운트에 무엇이 있는지, 애플리케이션이 충돌 일관성 스냅샷에서 복구할 수 있는지 알아야 합니다.
한 가지 스냅샷 규칙이 실패하는 이유는 컨테이너 업데이트가 서로 다른 것을 변경하기 때문입니다
컨테이너가 일회용 코드만 제공하고 버전 관리에서 구성을 읽을 때 이미지를 교체하는 것은 위험이 낮을 수 있습니다. 그러나 새 버전이 데이터베이스를 마이그레이션하거나 인덱스를 다시 작성하거나 파일 소유권을 변경하거나 영구 볼륨의 레이아웃을 변환하면 동일해 보이는 업데이트도 위험할 수 있습니다.
컨테이너 지속성은 올바르게 매핑된 스토리지에 달려 있습니다. 홈 서버 업데이트 가이드는 볼륨 매핑이 재생성 시 앱 데이터를 보존한다고 설명하지만, 지속성만으로는 애플리케이션이 해당 파일을 변경한 후 롤백 지점을 만들지 않습니다.
스냅샷을 선택하기 전에 롤백 단위를 선택하세요
| 보호할 상태 | 롤백 객체 | 스냅샷만? |
|---|---|---|
| 컨테이너 이미지 및 태그 | 이전 이미지 다이제스트 또는 고정 버전 | 영구적으로 변경되는 것이 없으면 데이터 스냅샷이 필요하지 않습니다 |
| 컴포즈 파일, 환경, 포트 및 마운트 | 버전 관리된 구성 내보내기 | 아니요; 스토리지 스냅샷은 배포 정의를 복원하지 않습니다 |
| 일반 파일이 있는 바인드 마운트 및 명명된 볼륨 | 파일시스템 스냅샷 또는 검증된 파일 백업 | 일반적으로 파일이 정지 상태이고 모든 경로가 포함될 때 |
| PostgreSQL, MariaDB, SQLite 또는 다른 활성 데이터베이스 | 앱 인식 덤프, 조정된 스냅샷 또는 간단한 정상 종료 복사본 | 자동으로 하지 않음 |
| 비밀, 인증서 및 외부 자격 증명 | 독립적인 비밀 백업 및 복구 기록 | 아니요; 스냅샷된 데이터셋 외부에 있을 수 있습니다 |
롤백 단위는 앱이 시작하는 데 필요한 모든 구성 요소를 포함해야 합니다. 이미지 롤백만 하면 새 데이터베이스 스키마가 남아 있을 수 있고, 볼륨 롤백만 하면 호환되지 않는 이미지나 구성이 활성화될 수 있습니다.
영구 상태를 다시 쓸 수 있는 업데이트 전에 스냅샷 만들기
데이터베이스 및 스키마 마이그레이션
릴리스 노트에 스키마 마이그레이션, 데이터베이스 변환, 재인덱싱 또는 일방향 업그레이드 단계가 언급된 업데이트 전에 앱 인지 백업 또는 조정된 스냅샷을 만드세요. 실용적인 컨테이너 업데이트 워크플로는 앱 데이터 백업과 현재 버전 기록을 명확히 결합합니다.
볼륨 레이아웃 및 권한 변경
업데이트가 마운트 경로, UID/GID 소유권, 데이터베이스 디렉터리, 미디어 메타데이터, 생성된 썸네일 또는 애플리케이션 저장 형식을 변경할 때 롤백 지점을 만드세요. 이러한 변경은 파일이 여전히 존재하더라도 이전 컨테이너가 업데이트된 데이터를 읽지 못하게 할 수 있습니다.
크거나 재생성이 어려운 홈 데이터
상태를 재구성하는 데 롤백 지점을 만들고 테스트하는 것보다 시간이 더 오래 걸리는 경우 사진 라이브러리, 문서 시스템, 홈 자동화 기록, 비밀번호 관리자 또는 미디어 메타데이터를 업데이트하기 전에 스냅샷을 만드세요.
업데이트가 진정으로 상태 비저장일 때 스냅샷 건너뛰기
컨테이너에 쓰기 가능한 영구 경로가 없고, 모든 구성이 재현 가능하며, 외부 데이터가 이미 보호되고, 롤백이 이전에 고정된 이미지를 시작하는 것을 의미할 때 별도의 저장소 스냅샷은 큰 가치를 추가하지 않을 수 있습니다. 앱이 예상 데이터셋 외부의 익명 볼륨이나 호스트 경로에 조용히 쓰기하지 않는지 확인하세요.
이 낮은 위험 경로에서도 정확한 이전 이미지 다이제스트를 기록하세요. 홈 서버 운영자는 일반적으로 이전 이미지 다이제스트를 원합니다. 여러 번 재시작 후 발견된 문제도 변경된 버전과 연결할 수 있기 때문입니다.
라이브 파일시스템 스냅샷은 애플리케이션 일관성을 보장하지 않을 수 있습니다
파일시스템 스냅샷은 시점을 캡처하지만, 활성 데이터베이스는 메모리에 더티 페이지, 부분적으로 기록된 트랜잭션 또는 서로 일치해야 하는 종속 파일을 가질 수 있습니다. 데이터베이스 백업 지침은 충돌 일관 복사본과 백업 모드에서 생성된 애플리케이션 일관 스냅샷을 구분합니다.
작은 홈 NAS 앱의 경우 가장 간단하고 안전한 선택은 논리적 덤프 또는 스냅샷 전에 짧은 정지일 수 있습니다. 라이브 MySQL 볼륨의 단순 아카이브는 동등하지 않습니다; 직접 데이터 볼륨을 아카이브하기 전에 데이터베이스를 중지해야 한다는 컨테이너 백업 조언을 참고하세요 데이터베이스를 중지하세요.
모든 업데이트 규칙 대신 위험 매트릭스 사용
| 업데이트 조건 | 권장 보호 방법 | 이유 |
|---|---|---|
| 패치 릴리스, 마이그레이션 없음, 상태 비저장 서비스 | 이전 이미지를 고정하고 구성 기록을 유지하세요 | 변경될 영구 상태가 예상되지 않습니다 |
| 앱이 하나의 스냅샷된 데이터셋에 일반 파일을 씁니다 | 빠른 사전 업데이트 스냅샷과 일반 백업 | 모든 경로가 커버되면 롤백이 간단합니다 |
| 데이터베이스 마이그레이션 또는 새로운 저장 형식 | 데이터베이스 네이티브 백업과 조정된 스냅샷 | 이전 이미지가 마이그레이션된 데이터를 이해하지 못할 수 있습니다 |
| 여러 데이터셋, 외부 데이터베이스, 비밀 정보 또는 인증서 | 종속성 체크리스트 및 각 상태 소유자별 별도 백업 | 하나의 파일시스템 스냅샷으로 전체 앱을 커버할 수 없습니다 |
| 업데이트는 되돌릴 수 없거나 롤백이 테스트된 적이 없습니다 | 유지보수 시간, 격리된 복원 테스트 및 더 긴 스냅샷 보존 기간 | 알 수 없는 롤백 경로가 주요 위험입니다 |
가역적인 홈 NAS 업데이트 워크플로우 사용
- 마이그레이션, 권한 변경, 제거된 설정 및 최소 데이터베이스 버전에 대한 릴리스 노트를 읽으세요.
- 현재 이미지 다이제스트, 컴포즈 파일, 환경 변수, 마운트, 애플리케이션 버전을 기록하세요.
- 위험 매트릭스에 따라 필요한 보호를 만드세요: 스냅샷 없음, 빠른 파일시스템 스냅샷, 애플리케이션 인지 데이터베이스 백업 또는 둘 다.
- 한 번에 하나의 앱 스택만 업데이트하고 이전 이미지를 사용할 수 있도록 유지하세요.
- 로그인, 핵심 데이터, 백그라운드 작업, 업로드, 데이터베이스 쓰기, 그리고 대표적인 복원 또는 내보내기 작업을 테스트하세요.
- 앱이 정상적인 가정용 사용과 정기 백업 주기를 견딜 때까지 업데이트 전 롤백 지점을 보관하세요.
- 별도 백업이 현재 상태를 재구성할 수 있을 때만 임시 스냅샷을 정리하세요.
스토리지 플랫폼이 허용하는 경우 롤백은 클론이나 별도 대상에서 테스트해야 합니다. 직접 롤백은 최신 상태를 버릴 수 있습니다. 예를 들어 ZFS 사용자는 롤백 시 이후 스냅샷과 선택 시점 이후 생성된 변경 사항이 삭제됨을 이해해야 합니다.
자주 묻는 질문
실행 중인 데이터베이스 컨테이너의 스냅샷만으로 충분한가요?
데이터베이스와 저장 방식이 복구 가능한 충돌 일관 상태를 생성할 수 있거나 스냅샷이 데이터베이스와 조정된 경우에만 가능합니다. 더 가치 있는 홈 서버 앱의 경우, 라이브 볼륨 스냅샷이 충분하다고 가정하지 말고 데이터베이스 일관성 컨테이너 백업을 사용하세요.
업데이트 전 스냅샷은 얼마나 오래 보관해야 하나요?
업데이트된 앱이 기능 검사를 통과하고 정상 사용을 견뎌내며 최소한 한 번의 별도 검증된 백업을 완료할 때까지 보관하세요. 마이그레이션이 되돌릴 수 없거나 문제가 천천히 나타날 수 있거나 이전 앱 스택을 재구성하기 어려운 경우에는 더 오래 보관하세요.
스냅샷은 짧은 롤백 도구일 뿐이며, 버전 관리된 백업, 구성 이력, 비밀 복구 또는 애플리케이션 인지 데이터베이스 보호를 대체하지 않습니다. 업데이트가 상태를 변경할 수 있을 때 사용하고, 업데이트가 진정으로 일회성이고 롤백 경로가 이미 검증된 경우에는 건너뛰세요.
지원 및 팁
더 읽어보기

라이브 TV 녹화 저장 공간, 보존 기간 및 정리 가이드
실제 녹화 데이터를 측정하고, 헤드룸을 확보하며, 보관 기간과 용량 제한을 함께 적용하고, 저장 공간이 가득 차기 전에 가장 오래된 조건 충족 프로그램이 삭제되는지 확인하세요.

데이터베이스 복원 후 홈 미디어 메타데이터 복구 워크플로우
복원된 상태를 보호하고 미디어 식별 정보와 경로를 확인한 다음, 메타데이터를 광범위하게 변경하기 전에 파일럿 라이브러리에서 누락된 아트워크나 일치 항목을 복구하세요.

오디오, 비디오 및 자막용 Jellyfin 클라이언트 호환성 체크리스트
대표 파일을 한 번에 하나의 변수만 테스트하고, 모든 클라이언트에 대해 Direct Play, 리먹스, 오디오 변환, 비디오 트랜스코딩 또는 실패를 기록하세요.

