Menjalankan Milvus di Docker (Windows)

Halaman ini mendemonstrasikan cara menjalankan Milvus pada 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 pada Microsoft Windows, Anda dapat mengakses Docker CLI dari PowerShell atau Windows Command Prompt dalam mode administrator dan dari WSL 2.

Dari PowerShell atau Windows Command Prompt

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

1. Buka Desktop Docker dalam mode administrator dengan mengeklik kanan dan memilih Jalankan sebagai 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 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.

   • Kontainer docker bernama milvus-standalone telah dimulai pada port 19530.

   • Sebuah embed etcd telah terinstal bersama dengan Milvus di dalam kontainer yang sama dan melayani di port 2379. Berkas konfigurasinya dipetakan ke embedEtcd.yaml di dalam folder saat ini.

   • Volume data Milvus dipetakan ke volume/milvus dalam folder saat ini.

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

   # 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 memulai Milvus menggunakan perintah Linux dan skrip shell pada Windows, pastikan bahwa Anda sudah menginstal perintah WSL 2. Untuk detail tentang cara menginstal perintah WSL 2, Anda dapat merujuk ke artikel Microsoft ini.

1. Mulai 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. Mulai 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 tersimpan.

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

Menjalankan Milvus dengan Docker Compose

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

Dari PowerShell atau Windows Command Prompt

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

2. Jalankan perintah berikut ini di PowerShell atau Windows Command Prompt 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/v2.4.15/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 citra untuk instalasi Milvus mungkin membutuhkan waktu beberapa saat. Setelah kontainer bernama milvus-standalone, milvus-minio, dan milvus-etcd aktif, Anda dapat menyaksikan bahwa

   • Kontainer milvus-etcd tidak mengekspos port apa pun ke hos dan memetakan datanya ke volume/etcd dalam folder saat ini.

   • Kontainer milvus-minio melayani port 9090 dan 9091 secara lokal dengan kredensial autentikasi default dan memetakan datanya ke volume/minio dalam folder saat ini.

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

Anda juga dapat memanggil perintah Docker Compose versi Linux jika Anda telah menginstal WSL 2.

Dari WSL 2

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

1. Mulai WSL 2.

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

2. Unduh berkas konfigurasi Milvus.

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

3. Mulai 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 pada Windows, Anda mungkin mengalami kesalahan Docker Engine stopped jika komputer Anda tidak terkonfigurasi dengan benar. Dalam kasus ini, Anda mungkin perlu melakukan pemeriksaan berikut.

1. Periksa apakah virtualisasi diaktifkan.

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

   Virtualisasi di Task Manager

   Jika virtualisasi dinonaktifkan, Anda mungkin perlu memeriksa pengaturan BIOS pada firmware motherboard. Cara untuk mengaktifkan virtualisasi dalam pengaturan BIOS bervariasi menurut vendor motherboard. Untuk motherboard ASUS, misalnya, Anda dapat merujuk ke artikel ini untuk mengaktifkan virtualisasi.

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

2. Periksa apakah Layanan Desktop Docker telah dimulai.

   Anda dapat menjalankan perintah berikut untuk memulai Layanan Desktop Docker.

   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 perintah 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 telah dimulai.

   Anda harus membuka direktori instalasi Docker Desktop dan menjalankan .\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 memulai Docker Desktop dalam mode administrator.

   Pastikan Anda telah memulai Docker Desktop dalam mode administrator. Untuk melakukannya, klik kanan pada Docker Desktop dan pilih Jalankan sebagai administrator.

   Memulai Docker Desktop sebagai Administrator

Bagaimana cara mengatasi masalah terkait WSL saat men-deploy 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 bahwa "Gunakan mesin berbasis WSL 2" dicentang di Pengaturan > Umum.

   Gunakan mesin berbasis WSL 2 di Pengaturan Desktop Docker

2. Pilih dari distribusi WSL 2 terinstal yang ingin Anda aktifkan integrasi Docker dengan membuka Pengaturan > Sumber Daya > Integrasi WSL.

   Pilih distribusi WSL 2 di Pengaturan Desktop Docker

Bagaimana cara menangani kesalahan terkait volume yang muncul selama startup Milvus yang berbunyi Read config failed?

Prompt kesalahan baca konfigurasi gagal saat pengaktifan Milvus

Untuk menangani kesalahan yang muncul selama pengaktifan Milvus yang berbunyi "Read config failed," Anda perlu memeriksa apakah volume yang dipasang ke dalam kontainer Milvus sudah benar. Jika volume sudah terpasang dengan benar ke dalam kontainer, Anda dapat menggunakan perintah docker exec untuk masuk ke dalam kontainer dan membuat daftar folder /milvus/configs sebagai berikut.

Membuat daftar berkas konfigurasi Milvus

Apa selanjutnya

Setelah menginstal Milvus di Docker, Anda dapat:

• Memeriksa Mulai Cepat untuk melihat apa yang dapat dilakukan Milvus.

• Mempelajari operasi dasar Milvus:

  • Mengelola Basis Data
  • Mengelola Koleksi
  • Mengelola Partisi
  • Menyisipkan, Menambah & Menghapus
  • Pencarian Vektor Tunggal
  • Pencarian Hibrida

• Tingkatkan Milvus Menggunakan Bagan Helm.

• Mengaturskala cluster Milvus Anda.

• Menerapkan cluster Milvu Anda di awan:

  • Amazon EKS
  • Google Cloud
  • Microsoft Azure

• Jelajahi Milvus WebUI, antarmuka web yang intuitif untuk pengamatan dan manajemen Milvus.

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

• Jelajahi Birdwatcher, alat sumber terbuka untuk men-debug Milvus dan pembaruan konfigurasi dinamis.

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

• Memantau Milvus dengan Prometheus.