Menjalankan Milvus di Docker (Windows)

Secara default, deployment ini menjalankan Woodpecker (sistem berkas lokal) sebagai antrean pesan, sehingga tidak diperlukan layanan antrean pesan eksternal. Lihat Woodpecker.

Halaman ini menunjukkan cara menjalankan Milvus di Windows menggunakan Docker Desktop untuk Windows.

Prasyarat

• Instal Docker Desktop.

• Instal Windows Subsystem for Linux 2 (WSL 2).

• Instal Python 3.8+.

Menjalankan Milvus di Docker

Milvus menyediakan skrip instalasi untuk menginstalnya sebagai kontainer Docker. Setelah Anda menginstal Docker Desktop di Microsoft Windows, Anda dapat mengakses Docker CLI dari PowerShell atau Command Prompt Windows dalam mode administrator dan dari WSL 2.

Dari PowerShell atau Windows Command Prompt

Jika Anda lebih terbiasa dengan PowerShell atau Command Prompt Windows, perintahnya adalah sebagai berikut.

1. Buka Docker Desktop dalam mode administrator dengan mengklik kanan dan memilih " Run as administrator".

2. Unduh skrip instalasi dan simpan sebagai " standalone.bat".

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

3. Jalankan skrip yang telah diunduh untuk memulai Milvus sebagai kontainer Docker.

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

   Setelah menjalankan skrip instalasi:

   • Sebuah kontainer Docker bernama milvus-standalone telah dimulai di port 19530.

   • Embed etcd diinstal bersama Milvus dalam kontainer yang sama dan berjalan di port 2379. Berkas konfigurasinya dipetakan ke ` embedEtcd.yaml ` di folder saat ini.

   • Volume data Milvus dipetakan ke ` volumes/milvus ` di folder saat ini.

   Anda dapat menggunakan perintah berikut untuk mengelola kontainer Milvus dan data yang disimpan.

   # 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.
   
   

Dari WSL 2

Jika Anda lebih suka menjalankan Milvus menggunakan perintah Linux dan skrip shell di Windows, pastikan Anda telah menginstal WSL 2. Untuk detail tentang cara menginstal WSL 2, Anda dapat merujuk ke artikel Microsoft ini.

1. Jalankan WSL 2.

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

2. Unduh skrip instalasi

   # 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. Jalankan Milvus sebagai kontainer 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.
   
   

   Anda dapat menggunakan perintah berikut untuk mengelola kontainer Milvus dan data yang disimpan.

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

Jalankan Milvus dengan Docker Compose

Setelah Anda menginstal Docker Desktop di Microsoft Windows, Anda dapat mengakses Docker CLI dari PowerShell atau Windows Command Prompt dalam mode administrator. Anda dapat menjalankan Docker Compose baik di PowerShell, Windows Command Prompt, maupun WSL 2 untuk memulai Milvus.

Dari PowerShell atau Command Prompt Windows

1. Buka Docker Desktop dalam mode administrator dengan mengklik kanan dan memilih Jalankan sebagai administrator.

2. Jalankan perintah berikut di PowerShell atau Command Prompt Windows untuk mengunduh berkas konfigurasi Docker Compose untuk Milvus Standalone dan memulai 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.2/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
   
   

   Tergantung pada koneksi jaringan Anda, mengunduh gambar untuk instalasi Milvus mungkin memerlukan waktu cukup lama. Setelah kontainer bernama milvus-standalone, milvus-minio, dan milvus-etcd aktif, Anda dapat melihat bahwa

   • Kontainer milvus-etcd tidak mengekspos port apa pun ke host dan memetakan datanya ke volumes/etcd di folder saat ini.

   • Kontainer milvus-minio melayani port 9000 dan 9001 secara lokal dengan kredensial otentikasi default dan memetakan datanya ke volumes/minio di folder saat ini.

   • Kontainer milvus-standalone melayani port 19530 secara lokal dengan pengaturan default dan memetakan datanya ke volumes/milvus di folder saat ini.

Anda juga dapat menjalankan perintah Docker Compose versi Linux jika WSL 2 telah terinstal.

Dari WSL 2

Prosedurnya mirip dengan menggunakan Docker Compose untuk menginstal Milvus di sistem Linux.

1. Jalankan WSL 2.

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

2. Unduh berkas konfigurasi Milvus.

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

3. Jalankan Milvus.

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

Pertanyaan Umum

Bagaimana cara mengatasi kesalahan " Docker Engine stopped "?

Setelah Anda menginstal Docker Desktop di Windows, Anda mungkin mengalami kesalahan " Docker Engine stopped " jika komputer Anda tidak dikonfigurasi dengan benar. Dalam hal ini, Anda mungkin perlu melakukan pemeriksaan berikut:

1. Periksa apakah virtualisasi telah diaktifkan.

   Anda dapat memeriksa apakah virtualisasi telah diaktifkan dengan melihat tab " Performance " di Task Manager.

   Virtualisasi di Task Manager

   Jika virtualisasi dinonaktifkan, Anda mungkin perlu memeriksa pengaturan BIOS pada firmware motherboard Anda. Cara mengaktifkan virtualisasi di pengaturan BIOS bervariasi tergantung pada produsen motherboard. Untuk motherboard ASUS, misalnya, Anda dapat merujuk ke artikel ini tentang cara mengaktifkan virtualisasi.

   Kemudian, Anda perlu me-restart komputer dan mengaktifkan Hyper-V. Untuk detailnya, lihat artikel Microsoft ini.

2. Periksa apakah Layanan Docker Desktop telah dijalankan.

   Anda dapat menjalankan perintah berikut untuk memulai Layanan 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. Periksa apakah WSL telah terinstal dengan benar.

   Anda dapat menjalankan perintah berikut untuk menginstal atau memperbarui WSL 2.

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

4. Periksa apakah Docker Daemon sudah dijalankan.

   Anda perlu membuka direktori instalasi Docker Desktop dan menjalankan perintah ` .\DockerCli.exe -SwitchDaemon ` untuk memulai Docker Daemon.

   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. Periksa apakah Anda telah menjalankan Docker Desktop dalam mode administrator.

   Pastikan Anda telah menjalankan Docker Desktop dalam mode administrator. Untuk melakukannya, klik kanan pada Docker Desktop dan pilih " Run as administrator".

   Jalankan Docker Desktop sebagai Administrator

Bagaimana cara mengatasi masalah terkait WSL saat melakukan deployment Milvus?

Jika Anda mengalami masalah terkait WSL saat menjalankan Milvus dari WSL 2, Anda mungkin perlu memeriksa apakah Anda telah mengonfigurasi Docker Desktop untuk menggunakan mesin berbasis WSL 2 sebagai berikut:

1. Pastikan opsi “Gunakan mesin berbasis WSL 2” telah dicentang di Pengaturan > Umum.

   Gunakan mesin berbasis WSL 2 di Pengaturan Docker Desktop

2. Pilih dari distribusi WSL 2 yang telah Anda instal mana yang ingin Anda aktifkan integrasi Docker-nya dengan membuka: Pengaturan > Sumber Daya > Integrasi WSL.

   Memilih distribusi WSL 2 di Pengaturan Docker Desktop

Bagaimana cara mengatasi kesalahan terkait volume yang muncul saat Milvus dimulai dengan pesan “ Read config failed ”?

Pesan kesalahan “Read config failed” saat Milvus dimulai

Untuk mengatasi kesalahan yang muncul saat Milvus dimulai yang berbunyi “Read config failed,” Anda perlu memeriksa apakah volume yang dipasang ke dalam kontainer Milvus sudah benar. Jika volume sudah dipasang dengan benar ke dalam kontainer, Anda dapat menggunakan perintah ` docker exec ` untuk masuk ke dalam kontainer dan menampilkan daftar folder `/milvus/configs ` sebagai berikut:

Menampilkan daftar berkas konfigurasi Milvus

Langkah selanjutnya

Setelah menginstal Milvus di Docker, Anda dapat:

• Lihat Panduan Cepat untuk mengetahui apa saja yang dapat dilakukan Milvus.

• Pelajari operasi dasar Milvus:

  • Mengelola Database
  • Mengelola Koleksi
  • Mengelola Partisi
  • Sisipkan, Upsert, dan Hapus
  • Pencarian Vektor Tunggal
  • Pencarian Hibrida

• Tingkatkan Milvus Menggunakan Helm Chart.

• Skalakan kluster Milvus Anda.

• Terapkan kluster Milvus Anda di cloud:

  • Amazon EKS
  • Google Cloud
  • Microsoft Azure

• Jelajahi Milvus WebUI, antarmuka web yang intuitif untuk pemantauan dan pengelolaan Milvus.

• Jelajahi Milvus Backup, alat sumber terbuka untuk pencadangan data Milvus.

• Jelajahi Birdwatcher, alat sumber terbuka untuk debugging Milvus dan pembaruan konfigurasi dinamis.

• Jelajahi Attu, alat GUI sumber terbuka untuk pengelolaan Milvus yang intuitif.

• Pantau Milvus dengan Prometheus.