재배포 후 Compose 스택이 비어 있는 새 이름 지정 볼륨을 연결하는 이유는 무엇인가요?

Eva Wong 는 테크니컬 라이터 이자 상주 메이커 로 ZimaSpace에서 활동합니다. 평생 기술을 사랑해 온 그녀는 홈랩과 오픈 소스 소프트웨어에 열정을 품고 있으며, 복잡한 기술 개념을 누구나 이해하기 쉬운 실습 가이드로 풀어내는 데 전문성을 갖추고 있습니다. Eva는 셀프 호스팅이 어렵고 부담스러운 일이 아니라 즐거워야 한다고 믿습니다. 그녀는 튜토리얼을 통해 커뮤니티가 하드웨어 설정의 어려움을 풀어내고, 첫 NAS를 조립하는 것부터 Docker 컨테이너를 능숙하게 다루는 것까지 도전하도록 돕습니다.

재배포로 인해 프로젝트 범위 볼륨 이름이 변경되거나 원래 볼륨을 찾지 못하면 Compose 스택이 새 이름의 빈 볼륨을 연결할 수 있습니다.

재생성된 서비스가 같은 컨테이너 경로에 새로 생성된 볼륨을 마운트하는 동안 이전 데이터가 다른 Docker 볼륨에 남아 있을 수 있습니다. 일반적인 원인으로는 스택 또는 프로젝트 이름 변경, 볼륨 키 이름 변경, 볼륨을 삭제하는 명령을 사용한 삭제, 외부 볼륨 선언 누락, 다른 관리자를 통한 배포 또는 이제 다르게 확인되는 명시적 볼륨 이름 등이 있습니다. 데이터를 복원하거나 앱을 초기화하기 전에 마운트된 볼륨과 고아 볼륨 후보를 모두 목록으로 정리하세요.

새 컨테이너에 마운트된 정확한 볼륨 식별

실행 중인 컨테이너의 마운트를 검사하고 볼륨 이름, 드라이버, 마운트 지점, 레이블, 생성 시간, 컨테이너 내 대상 경로 및 읽기-쓰기 모드를 기록하세요. 재배포 전 기록과 비교하세요.

Ubuntu의 docker volume inspect 명령은 볼륨 식별 정보를 표시하므로, 새 빈 볼륨을 이름이 비슷한 이전 미마운트 볼륨과 구분할 수 있습니다.

기존 볼륨을 찾기 전에는 데이터를 새 볼륨에 복사하지 마세요. 앱을 시작하면 새 데이터베이스가 생성되어 대상 볼륨이 원래부터 초기화된 것처럼 보일 수 있습니다.

Compose 프로젝트 이름이 변경되었는지 확인

이전 프로젝트 이름, 새 프로젝트 이름, 스택 이름, Compose 디렉터리, -p 옵션, COMPOSE_PROJECT_NAME, 최상위 name: 및 배포 관리자를 비교하세요.

Docker 설명에 따르면, 명시적 이름을 지정하거나 외부 볼륨 조회를 설정하지 않은 경우 Compose는 일반적으로 볼륨 이름의 범위를 프로젝트 이름과 볼륨 키로 지정합니다.

따라서 같은 Compose 파일을 다른 디렉터리로 옮기면 서비스 및 볼륨 키가 그대로여도 두 번째 프로젝트와 두 번째 볼륨이 생성될 수 있습니다.

안정적인 이름 및 외부 볼륨 설정 확인

재배포 전후의 최상위 볼륨 정의를 비교하세요. name:, external:, 드라이버 옵션, 보간 변수를 확인하고 예상한 볼륨이 있는지 살펴보세요.

Microsoft’s Docker Compose tutorial notes that named volumes persist independently of container replacement, so a new empty state usually means a different volume identity was attached or the old volume was removed.

수명 주기를 스택 외부에서 의도적으로 관리할 때만 볼륨을 외부 볼륨으로 표시하세요. 외부 볼륨이 없으면 Compose가 대체 볼륨을 조용히 생성하지 말고 명확한 오류를 내야 합니다.

정리 작업으로 원래 볼륨이 삭제되었는지 확인

볼륨 삭제와 관련된 배포 로그, 스크립트, UI 작업, 정리 작업, 명령을 검토하세요. 볼륨 생성 시점과 재배포 이벤트를 비교하세요.

Red Hat 문서에 따르면 컨테이너가 관리하는 명명된 볼륨은 컨테이너 쓰기 가능 레이어와 별도의 저장 위치를 사용합니다. 따라서 컨테이너 제거와 명명된 볼륨 제거는 서로 다른 수명 주기 이벤트입니다.

원래 볼륨이 없다면 자동 시작을 중지하고 검증된 백업에서만 복원하세요. 비어 있는 대체 볼륨에 복구할 수 있는 삭제된 레이어가 있다고 가정하지 마세요.

스택 관리자 식별 정보와 배포 방식 비교

스택이 CLI, Portainer, NAS 앱 스토어, Git 배포 또는 다른 자동화 도구 중 무엇으로 시작되었는지 기록하세요. 해당 관리 도구에 저장된 스택 이름과 환경 변수를 비교하세요.

Portainer에서는 배포 시 설명적인 스택 이름이 필요하며, 관리자가 제어하는 이 이름은 수동 Compose 명령에서 사용하는 디렉터리 기반 프로젝트 이름과 다를 수 있습니다.

따라서 수동으로 긴급 시작하면 다른 프로젝트 접두사로 리소스가 생성될 수 있습니다. 배포 소유자를 하나로 정하고, 생성되는 최종 볼륨 이름을 문서화하세요.

새 볼륨 마운트 지점 아래에 숨겨진 데이터인지 확인하기

컨테이너를 중지하고 이름 있는 볼륨을 연결하지 않은 상태로 임시 테스트 환경에서 이미지나 바인드 경로를 검사하세요. 볼륨이 마운트되기 전에 시작 과정에서 데이터가 컨테이너 계층에 기록되었는지 확인하세요.

Linux 마운트 설명서에 따르면 마운트하면 기존 디렉터리 콘텐츠가 가려집니다. 따라서 새 빈 볼륨이 이미지나 쓰기 가능 계층에서 생성된 파일을 덮으면 데이터가 사라진 것처럼 보일 수 있습니다.

숨겨진 계층과 기존 영구 볼륨을 무턱대고 병합하지 마세요. 어느 쪽의 상태가 기준인지 확인하고 애플리케이션에서 지원하는 복구 방법을 사용하세요.

제어된 테스트로 기존 볼륨 다시 연결하기

스택을 중지하고 후보 볼륨 두 개를 모두 백업한 다음, 기존 볼륨을 임시 컨테이너나 임시 서비스 경로에 연결하고 애플리케이션 파일, 데이터베이스 정체성, 소유권, 타임스탬프를 확인하세요.

컨테이너 데이터를 마운트 문제 없이 이동하는 방법에 관한 ZimaSpace 가이드는 이어지는 경로 매핑 절차를 다룹니다. 이 글에서는 프로젝트 범위로 지정된 이름 있는 볼륨의 정체성에 초점을 맞춥니다.

기존 볼륨에 안정적인 명시적 이름이나 외부 이름을 지정해 마운트하고, 재배포를 반복해도 다른 빈 후보 볼륨을 만들지 않고 해당 볼륨을 재사용하면 문제가 해결됩니다.

자주 묻는 질문

이름이 지정된 볼륨이 비어 있다는 것은 기존 데이터가 삭제되었다는 뜻인가요?

반드시 그렇지는 않습니다. 기존 볼륨이 다른 프로젝트 접두사나 명시적 이름으로 여전히 존재하는 동안 새 컨테이너가 다른 빈 볼륨을 사용할 수 있습니다.

Compose 폴더 이름을 바꾸면 새 볼륨이 만들어질 수 있나요?

네. 프로젝트 이름이 고정되어 있지 않으면 Compose가 프로젝트 디렉터리에서 이름을 추론해 접두사가 서로 다른 리소스를 만들 수 있습니다.

중요한 볼륨을 외부 볼륨으로 표시해야 하나요?

외부 볼륨은 스택 제거 시 수명 주기 관리를 방해할 수 있지만, 의도적으로 생성하고 이름을 지정하고 백업하며 배포 시 확인해야 합니다.

지원 및 팁

더 읽어보기

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.