Docker에서 Milvus 실행하기 (Windows)

기본적으로 이 배포 환경은 Woodpecker (로컬 파일 시스템)를 메시지 큐로 사용하므로, 별도의 외부 메시지 큐 서비스가 필요하지 않습니다. Woodpecker를 참조하십시오.

이 페이지에서는 Windows용 Docker Desktop을 사용하여 Windows에서 Milvus를 실행하는 방법을 설명합니다.

필수 조건

• Docker Desktop을 설치하십시오.

• Windows Subsystem for Linux 2(WSL 2)를 설치하십시오.

• Python 3.8 이상을 설치하십시오.

Docker에서 Milvus 실행

Milvus는 Docker 컨테이너로 설치할 수 있는 설치 스크립트를 제공합니다. Microsoft Windows에 Docker Desktop을 설치하면, 관리자 모드의 PowerShell 또는 Windows 명령 프롬프트와 WSL 2에서 Docker CLI에 액세스할 수 있습니다.

PowerShell 또는 Windows 명령 프롬프트에서

PowerShell이나 Windows 명령 프롬프트에 더 익숙하다면, 명령 프롬프트 사용 방법은 다음과 같습니다.

1. 마우스 오른쪽 버튼을 클릭하고 ‘관리자 권한으로 실행’을 선택하여 Docker Desktop을 관리자 모드로 엽니다.

2. 설치 스크립트를 다운로드하여 ‘ standalone.bat ’로 저장합니다.

   C:\>Invoke-WebRequest https://raw.githubusercontent.com/milvus-io/milvus/refs/heads/master/scripts/standalone_embed.bat -OutFile standalone.bat
   
   

3. 다운로드한 스크립트를 실행하여 Milvus를 Docker 컨테이너로 시작합니다.

   C:\>standalone.bat start
   Wait for Milvus starting...
   Start successfully.
   To change the default Milvus configuration, edit user.yaml and restart the service.
   
   

   설치 스크립트 실행 후:

   • milvus-standalone이라는 이름의 Docker 컨테이너가 포트 19530에서 시작되었습니다.

   • Milvus와 함께 동일한 컨테이너 내에 임베디드 etcd가 설치되었으며, 포트 2379에서 서비스를 제공합니다. 해당 구성 파일은 현재 폴더의 embedEtcd.yaml 에 매핑되어 있습니다.

   • Milvus 데이터 볼륨은 현재 폴더의 volumes/milvus 에 매핑됩니다.

   다음 명령어를 사용하여 Milvus 컨테이너와 저장된 데이터를 관리할 수 있습니다.

   # Stop Milvus
   C:\>standalone.bat stop
   Stop successfully.
   
   # Delete Milvus container
   C:\>standalone.bat delete
   Delete Milvus container successfully. # Container has been removed.
   Delete successfully. # Data has been removed.
   
   

WSL 2에서

Windows에서 Linux 명령어와 셸 스크립트를 사용하여 Milvus를 시작하려는 경우, WSL 2가 이미 설치되어 있는지 확인하십시오. WSL 2 설치 방법에 대한 자세한 내용은 이 Microsoft 문서를 참조하십시오.

1. WSL 2를 시작합니다.

   C:\>wsl --install
   Ubuntu already installed.
   Starting Ubuntu...
   
   

2. 설치 스크립트를 다운로드합니다.

   # Download the installation script
   $ curl -sfL https://raw.githubusercontent.com/milvus-io/milvus/master/scripts/standalone_embed.sh -o standalone_embed.sh
   
   # Start the Docker container
   $ bash standalone_embed.sh start
   
   

3. Milvus를 Docker 컨테이너로 시작합니다.

   $ bash standalone_embed.sh start
   Wait for Milvus Starting...
   Start successfully.
   To change the default Milvus configuration, add your settings to the user.yaml file and then restart the service.
   
   

   다음 명령어를 사용하여 Milvus 컨테이너와 저장된 데이터를 관리할 수 있습니다.

   # Stop Milvus
   $ bash standalone_embed.sh stop
   Stop successfully.
   
   # Delete Milvus data
   $ bash standalone_embed.sh delete
   Delete Milvus container successfully.
   Delete successfully.
   
   

Docker Compose를 사용하여 Milvus 실행

Microsoft Windows에 Docker Desktop을 설치하면 관리자 모드의 PowerShell 또는 Windows 명령 프롬프트에서 Docker CLI에 액세스할 수 있습니다. PowerShell, Windows 명령 프롬프트 또는 WSL 2에서 Docker Compose를 실행하여 Milvus를 시작할 수 있습니다.

PowerShell 또는 Windows 명령 프롬프트에서

1. Docker Desktop을 마우스 오른쪽 버튼으로 클릭하고 ‘관리자 권한으로 실행’을 선택하여 관리자 모드로 엽니다.

2. PowerShell 또는 Windows 명령 프롬프트에서 다음 명령을 실행하여 Milvus Standalone용 Docker Compose 구성 파일을 다운로드하고 Milvus를 시작하세요.

   # Download the configuration file and rename it as docker-compose.yml
   C:\>Invoke-WebRequest https://github.com/milvus-io/milvus/releases/download/v3.0.1/milvus-standalone-docker-compose.yml -OutFile docker-compose.yml
   
   # Start Milvus
   C:\>docker compose up -d
   Creating milvus-etcd  ... done
   Creating milvus-minio ... done
   Creating milvus-standalone ... done
   
   

   네트워크 연결 상태에 따라 Milvus 설치용 이미지를 다운로드하는 데 시간이 다소 걸릴 수 있습니다. milvus-standalone, milvus-minio, milvus-etcd라는 이름의 컨테이너가 실행되면 다음을 확인할 수 있습니다.

   • milvus-etcd 컨테이너는 호스트에 어떤 포트도 노출하지 않으며, 데이터를 현재 폴더의 volumes/etcd에 매핑합니다.

   • milvus-minio 컨테이너는 기본 인증 자격 증명을 사용하여 로컬에서 9000번 및 9001번 포트를 제공하며, 데이터를 현재 폴더의 volumes/minio에 매핑합니다.

   • milvus-standalone 컨테이너는 기본 설정으로 로컬에서 19530번 포트를 제공하며, 데이터를 현재 폴더의 volumes/milvus에 매핑합니다.

WSL 2가 설치되어 있다면 Linux 버전의 Docker Compose 명령어를 호출할 수도 있습니다.

WSL 2에서

이 절차는 Linux 시스템에서 Docker Compose를 사용하여 Milvus를 설치하는 방법과 유사합니다.

1. WSL 2를 시작합니다.

   C:\>wsl --install
   Ubuntu already installed.
   Starting Ubuntu...
   
   

2. Milvus 구성 파일을 다운로드합니다.

   $ wget https://github.com/milvus-io/milvus/releases/download/v3.0.1/milvus-standalone-docker-compose.yml -O docker-compose.yml
   
   

3. Milvus를 시작합니다.

   $ sudo docker compose up -d
   
   Creating milvus-etcd  ... done
   Creating milvus-minio ... done
   Creating milvus-standalone ... done
   
   

자주 묻는 질문

Docker Engine stopped 오류는 어떻게 해결하나요?

Windows에 Docker Desktop을 설치한 후, 컴퓨터가 제대로 구성되지 않은 경우 ' Docker Engine stopped ' 오류가 발생할 수 있습니다. 이 경우 다음 사항을 확인해 보시기 바랍니다:

1. 가상화가 활성화되어 있는지 확인하십시오.

   작업 관리자의 ‘성능’ 탭에서 가상화 기능이 활성화되어 있는지 확인할 수 있습니다.

   작업 관리자의 가상화 설정

   가상화가 비활성화되어 있다면, 마더보드 펌웨어의 BIOS 설정을 확인해야 할 수 있습니다. BIOS 설정에서 가상화를 활성화하는 방법은 마더보드 제조사에 따라 다릅니다. 예를 들어, ASUS 마더보드의 경우 가상화 활성화에 관한 이 문서를 참조할 수 있습니다.

   그런 다음 컴퓨터를 다시 시작하고 Hyper-V를 활성화해야 합니다. 자세한 내용은 이 Microsoft 문서를 참조하십시오.

2. Docker Desktop 서비스가 시작되었는지 확인하십시오.

   다음 명령어를 실행하여 Docker Desktop 서비스를 시작할 수 있습니다.

   C:\>net start com.docker.service
   The Docker for Windows Service service is starting.
   The Docker for Windows Service service was started successfully.
   
   

3. WSL이 제대로 설치되었는지 확인하십시오.

   다음 명령을 실행하여 WSL 2를 설치하거나 업데이트할 수 있습니다.

   C:\>wsl --update
   Checking for updates.
   The most recent version of Windows Subsystem for Linux is already installed.
   
   

4. Docker 데몬이 시작되었는지 확인하십시오.

   Docker Desktop의 설치 디렉터리로 이동하여 ` .\DockerCli.exe -SwitchDaemon ` 명령을 실행하여 Docker 데몬을 시작해야 합니다.

   C:\>cd "C:\Program Files\Docker\Docker"
   C:\Program Files\Docker\Docker>.\DockerCli.exe -SwitchDaemon
   Switching to windows engine: Post "http://ipc/engine/switch": open \\.\pipe\dockerBackendApiServer: The system cannot find the file specified.
   
   

5. Docker Desktop을 관리자 모드로 시작했는지 확인하십시오.

   Docker Desktop을 관리자 모드로 실행했는지 확인하십시오. 이를 위해 Docker Desktop을 마우스 오른쪽 버튼으로 클릭하고 ‘관리자 권한으로 실행’을 선택하십시오.

   관리자 권한으로 Docker Desktop 시작

Milvus 배포 시 WSL 관련 문제를 어떻게 해결할 수 있나요?

WSL 2에서 Milvus를 실행하는 동안 WSL 관련 문제가 발생한 경우, 다음과 같이 Docker Desktop이 WSL 2 기반 엔진을 사용하도록 구성되어 있는지 확인해야 할 수 있습니다:

1. '설정 > 일반'에서 “WSL 2 기반 엔진 사용” 항목이 선택되어 있는지 확인하십시오.

   Docker Desktop 설정에서 WSL 2 기반 엔진 사용

2. 설정 > 리소스 > WSL 통합으로 이동하여, Docker 통합을 활성화할 설치된 WSL 2 배포판을 선택하십시오.

   Docker Desktop 설정에서 WSL 2 배포판 선택

Milvus 시작 시 “ Read config failed ”라는 볼륨 관련 오류가 표시되면 어떻게 해결해야 하나요?

Milvus 시작 시 ‘ ’ 오류 메시지

Milvus 시작 시 “Read config failed”라는 오류 메시지가 표시될 경우, Milvus 컨테이너에 마운트된 볼륨이 올바른지 확인해야 합니다. 볼륨이 컨테이너에 올바르게 마운트되어 있다면, docker exec 명령어를 사용하여 컨테이너로 진입한 후 다음과 같이 /milvus/configs 폴더의 내용을 확인할 수 있습니다:

Milvus 구성 파일 나열

다음 단계

Docker에 Milvus를 설치했다면 다음을 수행할 수 있습니다:

• '빠른 시작'을 확인하여 Milvus의 기능을 살펴보세요.

• Milvus의 기본 작동 방식을 알아보세요:

  • 데이터베이스 관리
  • 컬렉션 관리
  • 파티션 관리
  • 삽입, 업데이트 및 삭제
  • 단일 벡터 검색
  • 하이브리드 검색

• Helm 차트를 사용하여 Milvus 업그레이드하기.

• Milvus 클러스터 확장하기.

• 클라우드에 Milvus 클러스터 배포:

  • Amazon EKS
  • Google Cloud
  • Microsoft Azure

• Milvus의 가시성 및 관리를 위한 직관적인 웹 인터페이스인 Milvus WebUI를 살펴보세요.

• Milvus 데이터 백업을 위한 오픈소스 도구인 Milvus Backup을 살펴보세요.

• Milvus 디버깅 및 동적 구성 업데이트를 위한 오픈 소스 도구인 Birdwatcher를 살펴보세요.

• 직관적인 Milvus 관리를 위한 오픈 소스 GUI 도구인 Attu를 살펴보세요.

• Prometheus를 사용하여 Milvus를 모니터링하세요.