Menjalankan Milvus dengan Docker Compose (Linux)

Halaman ini menjelaskan cara menjalankan instance Milvus di Docker menggunakan Docker Compose.

Persyaratan

• Instal Docker.
• Periksa persyaratan perangkat keras dan perangkat lunak sebelum melakukan instalasi.

Instal Milvus

Milvus menyediakan berkas konfigurasi Docker Compose di repositori Milvus. Untuk menginstal Milvus menggunakan Docker Compose, cukup jalankan

# Download the configuration file
$ wget https://github.com/milvus-io/milvus/releases/download/v3.0.3/milvus-standalone-docker-compose.yaml -O docker-compose.yaml

# Start Milvus
$ sudo docker compose up -d

Creating milvus-etcd  ... done
Creating milvus-minio ... done
Creating milvus-standalone ... done

Setelah Milvus dimulai,

• kontainer bernama milvus-standalone, milvus-minio, dan milvus-etcd sudah aktif.
  • 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 dapat memeriksa apakah kontainer-kontainer tersebut aktif dan berjalan menggunakan perintah berikut:

$ docker compose ps

NAME                IMAGE   COMMAND                  SERVICE      CREATED         STATUS                   PORTS
milvus-etcd         …       "etcd -advertise-cli…"   etcd         2 minutes ago   Up 2 minutes (healthy)   2379-2380/tcp
milvus-minio        …       "/usr/bin/docker-ent…"   minio        2 minutes ago   Up 2 minutes (healthy)   9000-9001/tcp
milvus-standalone   …       "/tini -- milvus run…"   standalone   2 minutes ago   Up 2 minutes (healthy)   0.0.0.0:9091->9091/tcp, 0.0.0.0:19530->19530/tcp

Anda juga dapat mengakses Milvus WebUI di http://127.0.0.1:9091/webui/ untuk mempelajari lebih lanjut tentang instance Milvus Anda. Untuk detailnya, lihat Milvus WebUI.

(Opsional) Perbarui konfigurasi Milvus

Untuk memperbarui konfigurasi Milvus agar sesuai dengan kebutuhan Anda, Anda perlu memodifikasi berkas ` /milvus/configs/user.yaml ` di dalam kontainer ` milvus-standalone `.

1. Akses kontainer milvus-standalone.

   docker exec -it milvus-standalone bash
   

2. Tambahkan konfigurasi tambahan untuk menggantikan konfigurasi default. Berikut ini mengasumsikan bahwa Anda perlu menggantikan konfigurasi default proxy.healthCheckTimeout. Untuk item konfigurasi yang berlaku, lihat Konfigurasi Sistem.

   cat << EOF > /milvus/configs/user.yaml
   # Extra config to override default milvus.yaml
   proxy:
     healthCheckTimeout: 1000 # ms, the interval that to do component healthy check
   EOF
   

3. Mulai ulang kontainer milvus-standalone untuk menerapkan perubahan.

   docker restart milvus-standalone
   

Hentikan dan hapus Milvus

Anda dapat menghentikan dan menghapus kontainer ini sebagai berikut

# Stop Milvus
$ sudo docker compose down

# Delete service data
$ sudo rm -rf volumes

Memperbarui dari Milvus 2.5.x ke 2.6.x

Batasan Antrian Pesan: Saat melakukan pembaruan ke Milvus v3.0.3, Anda harus mempertahankan pilihan antrian pesan saat ini. Beralih antara sistem antrian pesan yang berbeda selama proses pembaruan tidak didukung. Dukungan untuk mengganti sistem antrian pesan akan tersedia di versi mendatang.

Karena versi 2.6.x mengubah antrian pesan default menjadi Woodpecker, sebuah instance yang menjalankan RocksMQ pada versi 2.5.x harus secara eksplisit mengunci (pin) RocksMQ sebelum melakukan pembaruan — jika tidak, proses pembaruan akan mencoba mengubah antrian pesan, yang tidak didukung. Setelah mengunduh berkas Docker Compose versi 2.6.x, atur kembali jenis antrian pesan menjadi ` rocksmq ` dalam file ` user.yaml ` Anda, lalu lakukan pembaruan:

# user.yaml — keep RocksMQ across the 2.5.x → 2.6.x upgrade
mq:
  type: rocksmq

Untuk mengganti antrian pesan setelah melakukan pembaruan, lihat Mengganti Antrian Pesan.

Ketergantungan opsional

Penerapan ini menjalankan Woodpecker (terintegrasi, backend MinIO WAL) untuk pengiriman pesan, etcd untuk metadata, dan MinIO untuk penyimpanan objek. Untuk menggunakan antrian pesan yang berbeda atau menghubungkan penyimpanan objek/metadata eksternal, lihat:

• Antrian pesan: Woodpecker (default) · Pulsar · Kafka · RocksMQ
• Penyimpanan objek: MinIO (default) · AWS S3 · Azure Blob · GCP Cloud Storage · Aliyun OSS · Tencent COS · Huawei OBS · Kompatibel dengan S3
• Metadata: etcd

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 Basis Data
  • Mengelola Koleksi
  • Mengelola Partisi
  • Sisipkan, Upsert, & 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 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.