Memperbarui Milvus Standalone dengan Docker Compose
Panduan ini menjelaskan cara meng-upgrade deployment Milvus 2.6.x standalone ke v3.0.0 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 ada, serta hanya mengganti gambar Milvus menjadi milvusdb/milvus:v3.0.0.
Prasyarat
- 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 terbaru dari metadata Milvus dan data persisten
Batasan Antrian Pesan: Saat melakukan upgrade ke Milvus v3.0.0, Anda harus mempertahankan pilihan antrian pesan yang saat ini digunakan. Beralih antara sistem antrian pesan yang berbeda selama proses upgrade tidak didukung. Dukungan untuk mengganti sistem antrian pesan akan tersedia pada 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 penurunan versi atau rollback dengan mengubah gambar Milvus kembali ke 2.6.x. Setelah v3.0.0 menulis data, rollback yang hanya melibatkan gambar mungkin gagal membaca status yang telah diperbarui. Jika peningkatan gagal, hentikan penulisan dan gunakan rencana pemulihan yang mengembalikan metadata sebelum peningkatan serta cadangan data persisten. Validasi rencana pemulihan tersebut terlebih dahulu di lingkungan non-produksi.
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 bahwa kontainer saat ini dalam kondisi baik sebelum memulai peningkatan versi:
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.0
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 proses upgrade
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.0, dan koleksi yang ada tetap dapat di-query dan dicari. Selesaikan pemeriksaan ini sebelum Anda mengaktifkan fitur apa pun yang spesifik untuk v3.0.0.