안전한 접근 방식은 쓰기 중지 후 만든 아카이브 또는 명확히 식별된 대상 볼륨에 동기화한 복사본을 체크섬 및 애플리케이션 검증과 함께 일련의 확인 가능한 단계로 다루는 것이며, 단일 명령으로 취급하지 않는 것입니다.
Docker Compose를 사용하는 두 대의 Linux 홈 서버에서 실제로 주의해야 할 위험은 상태 저장 컨테이너를 다른 호스트로 옮길 때 실행 중이거나 이름이 잘못 지정된 볼륨을 복사하는 것입니다. 현재 볼륨의 식별 정보와 복구 지점을 기록하고, 영향이 가장 적은 구분 방법부터 시작합니다. 다른 변수를 바꾸기 전에 통과 및 실패 결과를 해석하고, 스토리지가 불안정해지거나 복구 가능한 유일한 사본이 위험에 노출되면 중단합니다. 아래 절차는 원래 워크로드가 정상 작동하거나 증거가 에스컬레이션 경계에 도달한 경우에만 완료됩니다.
소스 및 대상 볼륨 사양 확인
소스 컨테이너 이미지 다이제스트, Compose 프로젝트 이름, 서비스, 볼륨 키, 실제 Docker 볼륨 이름, 마운트 대상 경로, 볼륨 드라이버, 애플리케이션 버전을 기록합니다. docker inspect와 docker volume inspect를 사용하고 YAML 레이블만으로 실제 경로를 추정하지 마세요.
명시적인 이름이나 외부 볼륨을 사용하지 않으면 Compose는 일반적으로 프로젝트 이름을 볼륨 이름 앞에 붙입니다. 대상에서 Compose 구성을 렌더링하고 사용할 빈 볼륨을 명시적으로 만들어, 마이그레이션 데이터가 한 볼륨에 들어가고 서비스는 다른 볼륨을 시작하는 일이 없도록 합니다.
볼륨에 데이터베이스가 있다면 기본적인 이식 가능 복구 경로로 데이터베이스 고유의 덤프나 지원되는 백업을 사용하고, 볼륨 복사본은 동일 버전에서의 복구 지점으로 간주합니다. 드라이버가 원격이거나, 소스 스토리지가 불안정하거나, 애플리케이션 상태가 범위에 포함되지 않은 추가 볼륨에 걸쳐 있다면 중단합니다.
쓰기 작업을 중지하고 메타데이터를 보존하는 복사본 생성
애플리케이션을 유지보수 모드로 전환하고 백그라운드 작업을 중지한 다음, 애플리케이션과 데이터베이스를 정상적으로 종료합니다. 볼륨을 읽기-쓰기로 마운트한 컨테이너가 없는지 확인합니다. 임시 컨테이너를 통해 아카이브를 만들거나, 필요한 경우 숫자 형식의 소유권, 권한, 심볼릭 링크, 확장 속성, 스파스 파일을 보존하는 통제된 파일시스템 복사를 사용합니다.
독립적인 Docker 볼륨을 rsync로 마이그레이션하는 방법 가이드에서는 rsync로 Docker 볼륨 데이터를 옮기는 방법을 설명합니다. 중요한 경계 조건은 소스의 쓰기를 중지해야 하며, 복사 명령은 데몬이 사용하는 Docker 내부 디렉터리를 무작정 조작하는 것이 아니라 식별된 볼륨의 콘텐츠를 대상으로 해야 한다는 점입니다.
파일 개수, 전체 바이트 수, 대표 해시 및 압축 파일 체크섬이 포함된 매니페스트를 생성하세요. 원본 볼륨과 기본 백업은 변경하지 않은 상태로 유지하세요. 대상 호스트에서 전송 아티팩트를 읽을 수 있을 때만 복사 단계가 통과한 것으로 간주하세요.
명시적인 대상 볼륨에 복원
대상 파일 시스템의 용량, 사용 가능한 inode, UID 및 GID 요구 사항, 동일한 애플리케이션 이미지 버전을 확인하세요. 최상위 디렉터리 구조를 평탄화하지 말고 빈 대상 볼륨에 압축 파일을 복원한 다음 소유권, 개수, 크기 및 일부 해시를 비교하세요.
이름이 지정된 볼륨의 마이그레이션 실패 사례에 관한 커뮤니티 토론은 Docker의 볼륨 내부 파일을 직접 교체할 때 작업이 실패하거나 상태가 혼란스러워질 수 있는 이유를 보여 줍니다. 런타임을 사용해 볼륨을 보조 컨테이너에 마운트하고, 제어된 인터페이스를 통해 복원하세요.
먼저 대체 포트를 사용하고 프로덕션 피어에 접근할 수 없도록 설정해 서비스의 테스트용 사본만 연결하세요. 애플리케이션에서 스키마 업그레이드나 손상된 상태가 보고되면 중지하고, 버전 호환성 문제를 해결한 후 변경되지 않은 백업 파일에서 볼륨을 다시 복원하세요.
전환하고 롤백 호스트 유지하기
애플리케이션보다 먼저 종속 서비스를 시작하고, 로그, 로그인, 최근 기록, 첨부 파일, 예약 작업 및 테스트용 쓰기 작업을 확인하세요. 대상 스택을 다시 시작하고 동일한 이름의 볼륨이 다시 연결되는지 확인하세요. 이러한 검사를 모두 통과한 후에만 프록시 또는 DNS를 업데이트하세요.
컨테이너 데이터 일관성 백업에 관한 관련 ZimaSpace 문서는 복사 작업이 성공했는데도 대상이 비어 있는 경우 도움이 됩니다. 데이터를 다시 복사하기 전에 실제 런타임의 마운트 소스와 의도한 볼륨을 비교하세요. 잘못된 대상에 반복해서 복사하면 혼란만 커집니다.
새 백업 및 복원 테스트가 대상에서 성공할 때까지 원본 애플리케이션을 중지하고 기존 볼륨을 읽기 전용으로 유지하세요. 대상에서 새로운 쓰기가 허용되지 않은 경우에만 변경되지 않은 원본으로 트래픽을 돌려 롤백하세요. 그렇지 않으면 중단하고 데이터를 신중하게 조정하세요.
지원 및 팁
더 읽어보기

Transformers에서 커뮤니티 모델을 불러오기 전에 확인할 사항
Transformers Jinja 샌드박스 업데이트를 활용해 모델의 출처, 채팅 템플릿, 원격 코드, 직렬화된 가중치, 격리된 첫 실행을 검토하세요.

Mirage를 로컬에서 실행: 한 장의 이미지로 OCR 및 객체 감지
Cactus Compute의 소형 로컬 비전 모델을 사용해 보고, 실제 입력으로 OCR 및 객체 추출을 검증하며, 메모리, 언어 및 개인정보 보호의 한계를 파악해 보세요.

홈 서버에서 Open WebUI 코딩 에이전트 예약 실행하는 방법
Open WebUI에서 보고 전용 코딩 에이전트 자동화를 설정하고, 터미널과 작업 공간을 선택한 다음 권한, 로그 및 오류 복구를 확인하세요.



