Memperbarui Milvus Standalone dengan Docker Compose
Panduan ini menjelaskan cara memperbarui deployment Milvus 2.6.x standalone ke v3.0.1 menggunakan Docker Compose.
Prosedur ini telah diverifikasi menggunakan konfigurasi Docker Compose Milvus 2.6.20 standalone resmi. Proses pembaruan ini mempertahankan etcd, MinIO, Woodpecker, dan direktori data yang sudah ada, serta hanya mengganti gambar Milvus menjadi milvusdb/milvus:v3.0.1.
Persyaratan
- Docker Engine dan Docker Compose V2
- Penerapan Milvus 2.6.x standalone yang sudah ada dan dikelola oleh Docker Compose
- Berkas Docker Compose dan konfigurasi yang digunakan untuk deployment yang sudah ada
- Cadangan metadata dan data persisten Milvus yang terbaru
Batasan Antrian Pesan: Saat meningkatkan ke Milvus v3.0.1, Anda harus mempertahankan pilihan antrian pesan yang saat ini digunakan. Pergantian antara sistem antrian pesan yang berbeda selama proses peningkatan tidak didukung. Dukungan untuk mengganti sistem antrian pesan akan tersedia di versi mendatang.
Jangan mengganti berkas Compose Anda saat ini atau mengubah versi dependensi sebagai bagian dari prosedur ini. Pertahankan etcd, penyimpanan objek, antrian pesan, volume, dan konfigurasi yang ada. Perbarui hanya tag gambar Milvus.
Prosedur ini tidak mendukung downgrade atau rollback dengan mengubah tag gambar Milvus kembali ke 2.6.x. Setelah v3.0.1 menulis data, rollback hanya gambar dapat gagal membaca status yang telah diperbarui. Jika peningkatan gagal, hentikan penulisan dan gunakan rencana pemulihan yang memulihkan metadata sebelum peningkatan dan cadangan data persisten. Validasi rencana pemulihan di lingkungan non-produksi terlebih dahulu.
Proses peningkatan versi
Langkah 1: Cadangkan konfigurasi saat ini
Simpan salinan berkas Compose saat ini dan semua berkas konfigurasi Milvus yang terpasang:
cp docker-compose.yml docker-compose-before-upgrade.yml
Pastikan kontainer saat ini dalam kondisi baik sebelum memulai peningkatan:
docker compose ps
Langkah 2: Perbarui gambar Milvus
Di berkas Compose yang ada, perbarui hanya gambar untuk layanan standalone:
services:
standalone:
image: milvusdb/milvus:v3.0.1
Unduh gambar target dan buat ulang hanya kontainer Milvus:
docker compose pull standalone
docker compose up --detach standalone
Docker Compose akan menjaga agar kontainer etcd dan object-storage yang ada tetap berjalan serta menggunakan kembali direktori data yang telah dikonfigurasi.
Verifikasi pembaruan
Periksa status kontainer dan gambar yang digunakan oleh kontainer Milvus:
docker compose ps
docker compose images standalone
docker compose logs --tail 100 standalone
Pastikan bahwa layanan standalone dalam kondisi baik, gambarnya adalah milvusdb/milvus:v3.0.1, dan koleksi yang ada tetap dapat di-query dan dicari. Selesaikan pemeriksaan ini sebelum Anda mengaktifkan fitur apa pun yang spesifik untuk v3.0.1.
