Docker Compose를 사용하여 Milvus 독립형 버전 업그레이드하기
이 가이드에서는 Docker Compose를 사용하여 Milvus 2.6.x 독립형 배포 환경을 v3.0.2로 업그레이드하는 방법을 설명합니다.
이 절차는 공식 Milvus 2.6.20 독립형 Docker Compose 구성에서 검증되었습니다. 업그레이드 과정에서 etcd, MinIO, Woodpecker 및 기존 데이터 디렉터리는 그대로 유지되었으며, Milvus 이미지만 milvusdb/milvus:v3.0.2 로 변경되었습니다.
필수 조건
- Docker Engine 및 Docker Compose V2
- Docker Compose로 관리되는 기존 Milvus 2.6.x 독립형 배포 환경
- 기존 배포에 사용된 Docker Compose 파일 및 구성
- Milvus 메타데이터 및 영구 데이터의 최신 백업
메시지 큐 제한 사항: Milvus v3.0.2로 업그레이드할 때는 현재 사용 중인 메시지 큐를 유지해야 합니다. 업그레이드 과정에서 다른 메시지 큐 시스템으로 전환하는 것은 지원되지 않습니다. 메시지 큐 시스템 변경에 대한 지원은 향후 버전에서 제공될 예정입니다.
이 절차의 일환으로 현재 Compose 파일을 교체하거나 종속성 버전을 변경하지 마십시오. 기존 etcd, 객체 스토리지, 메시지 큐, 볼륨 및 구성을 그대로 유지하십시오. Milvus 이미지 태그만 업데이트하십시오.
이 절차는 Milvus 이미지를 2.6.x 버전으로 되돌리는 다운그레이드 또는 롤백을 검증하지 않습니다. v3.0.2가 데이터를 기록한 후에는, 이미지 전용 롤백 시 업데이트된 상태를 읽지 못할 수 있습니다. 업그레이드가 실패하면 쓰기 작업을 중지하고, 업그레이드 이전의 메타데이터 및 영구 데이터 백업을 복원하는 복구 계획을 사용하십시오. 먼저 비생산 환경에서 복구 계획을 검증하십시오.
업그레이드 절차
1단계: 현재 구성 백업
현재 Compose 파일과 마운트된 모든 Milvus 구성 파일의 사본을 저장하십시오:
cp docker-compose.yml docker-compose-before-upgrade.yml
업그레이드를 시작하기 전에 현재 컨테이너의 상태가 정상인지 확인하십시오:
docker compose ps
2단계: Milvus 이미지 업데이트
기존 Compose 파일에서 ‘ standalone ’ 서비스에 대한 이미지만 업데이트하십시오:
services:
standalone:
image: milvusdb/milvus:v3.0.2
대상 이미지를 가져온 후 Milvus 컨테이너만 다시 생성하십시오:
docker compose pull standalone
docker compose up --detach standalone
Docker Compose는 기존 etcd 및 object-storage 컨테이너를 계속 실행하고, 구성된 데이터 디렉터리를 재사용합니다.
업그레이드 확인
컨테이너 상태와 Milvus 컨테이너에서 사용 중인 이미지를 확인합니다:
docker compose ps
docker compose images standalone
docker compose logs --tail 100 standalone
standalone 서비스가 정상적으로 작동하는지, 해당 이미지가 milvusdb/milvus:v3.0.2 인지, 그리고 기존 컬렉션을 계속 쿼리하고 검색할 수 있는지 확인하십시오. v3.0.2 전용 기능을 활성화하기 전에 이러한 확인 절차를 완료하십시오.
