Memperbarui Milvus Backup ke versi 0.6.xCompatible with Milvus Backup 0.6.x
Gunakan panduan ini saat melakukan pembaruan alat Milvus Backup dari versi 0.5.x ke 0.6.x. Prosedur di bawah ini menggunakan versi 0.6.0 sebagai versi target yang telah diverifikasi. Prosedur ini tidak akan memperbarui server Milvus Anda. Jika Anda tetap menggunakan versi 0.5.x, lanjutkan menggunakan panduan CLI atau API versi 0.5.x. Untuk instalasi baru, gunakan panduan CLI.
Konfigurasi YAML V1 masih dimuat melalui terjemahan otomatis. Namun, flag CLI yang sudah tidak digunakan lagi ditolak di versi 0.6.0, dan format pencadangan default berubah pada Milvus 3.0. Periksa konfigurasi dan perintah sebelum mengganti pekerjaan terjadwal atau layanan.
Periksa titik awal
Catat versi Backup Anda, versi sumber dan tujuan Milvus, berkas konfigurasi, penggantian variabel lingkungan, lokasi cadangan, serta perintah yang digunakan oleh skrip atau layanan API. Periksa informasi kompatibilitas untuk versi server tersebut.
Simpan direktori biner, konfigurasi, dan cadangan yang ada sambil memvalidasi instalasi baru. Unduh 0.6.0 ke direktori terpisah menggunakan Obtain Milvus Backup. Semua perintah di bawah ini dijalankan dari direktori tersebut dan memanggil biner 0.6.0. Tempatkan salinan konfigurasi v1 Anda di configs/backup-v1.yaml.
Migrasi konfigurasi
Konfigurasi v1 masih dapat dimuat di 0.6.0. Milvus Backup menerjemahkannya ke v2 saat startup dan menampilkan peringatan. Untuk menyimpan konfigurasi yang telah diterjemahkan ke dalam berkas terpisah:
./milvus-backup config migrate --config configs/backup-v1.yaml --output configs/backup-v2.yaml --strict
./milvus-backup config show --config configs/backup-v2.yaml
./milvus-backup check --config configs/backup-v2.yaml
--strict menolak konfigurasi yang dimigrasikan yang tidak valid. Tanpa --output, perintah tersebut akan menulis YAML v2 ke output standar. Periksa dan gunakan berkas baru tersebut hanya setelah memastikan pengaturannya telah diselesaikan.
| pengaturan v1 | Pengaturan v2 |
|---|---|
milvus.address, milvus.port | milvus.grpc.address, milvus.grpc.port |
Penyimpanan sumber di bawah minio.* | milvus.storage.* |
Penyimpanan cadangan di bawah minio.backup* | backup.storage.* |
| Kredensial penyimpanan | milvus.storage.auth.* / backup.storage.auth.*, dengan penulisan eksplisit auth.type |
minio.crossStorage | transfer.mode |
backup.gcPause.address | milvus.management.endpoint |
Periksa variabel lingkungan dalam perubahan yang sama dengan berkas konfigurasi. V2 hanya menerima variabel lingkungan terkait kredensial yang didukung, seperti MILVUS_STORAGE_AUTH_SECRET_ACCESS_KEY. Nama-nama v1 lama tidak diterapkan pada berkas v2. Untuk pengaturan non-kredensial seperti nama bucket dan titik akhir, gunakan YAML atau penggantian kunci konfigurasi:
./milvus-backup config show --config configs/backup-v2.yaml --set milvus.storage.bucketName=my-bucket
config migrate melaporkan variabel lingkungan yang terpengaruh tanpa menyalin nilai rahasianya ke dalam berkas keluaran. Lihat variabel lingkungan v2 yang didukung. Perintah ` config show ` menggantikan perintah ` check config ` yang sudah tidak digunakan lagi.
Perbarui perintah CLI
Bendera yang sudah tidak digunakan lagi di versi 0.5 akan ditolak di versi 0.6.0. Perbarui skrip sebelum memutakhirkan biner.
| Perintah | Opsi yang dihapus | Pengganti |
|---|---|---|
create | --colls / -c, --databases / -d, --database_collections / -a | --filter |
create | --force / -f | --strategy skip_flush |
create | --meta_only | --strategy meta_only |
restore | --collections / -c, --databases / -d, --database_collections / -a | --filter, menggunakan nama target |
restore | --restore_index | --rebuild_index |
get | --detail / -d | Hapus tanda centang; get akan menampilkan informasi cadangan |
list | --collection / -c | Tidak ada filter koleksi yang setara |
Misalnya, perintah-perintah 0.5.16 berikut ini memilih nama sumber coll:
./milvus-backup create -c coll -n my_backup
./milvus-backup restore -c coll -n my_backup -s _bak
Penggantinya pada versi 0.6.0 menggunakan nama target untuk pemulihan:
./milvus-backup create --filter coll -n my_backup --config configs/backup-v2.yaml
./milvus-backup restore --filter coll_bak -n my_backup -s _bak --config configs/backup-v2.yaml
Filter pemulihan yang tidak cocok dengan apa pun dapat selesai dengan sukses tanpa membuat koleksi. Selalu periksa koleksi tujuan dan datanya. collection_names pada API HTTP masih memilih nama sumber dalam cadangan; lihat panduan API HTTP.
Pilih perilaku pencadangan
- Pada server Milvus 2.x yang didukung, format `
auto` menggunakan `binlog`. Peningkatan versi pencadangan tidak memerlukan migrasi ke Milvus 3.0. - Pada Milvus 3.0,
automemilih snapshot. Dukungan resmi untuk pencadangan dan pemulihan dimulai pada Milvus 3.0.1. Berikan argumen `--format binlog` untuk mempertahankan perilaku binlog saat membuat cadangan. - Kompatibilitas konfigurasi V1 tidak mempertahankan bendera perintah yang dihapus atau menggantikan pengaturan default format baru.
- Preset tujuan dapat mengatur format dan opsi lainnya. Misalnya, `
--for archive` memaksa penggunaan binlog meskipun `--format snapshot` juga disertakan. Periksa pilihan format dan tujuan. - Koleksi eksternal dilewati selama pencadangan. Periksa metadata pencadangan daripada menganggap keberhasilan tugas sebagai bukti bahwa setiap koleksi telah disertakan.
Lakukan validasi sebelum mengganti pekerjaan
Contoh berikut mempertahankan format binlog dan memulihkan ke koleksi baru. Ganti ` coll ` dengan koleksi yang skema, jumlah, nilai skalar dan vektor, serta hasil pencariannya telah Anda catat. Gunakan nama cadangan baru dan pastikan nama tujuan ` coll_upgrade_check ` tidak ada.
./milvus-backup check --config configs/backup-v2.yaml
./milvus-backup create --filter coll --format binlog -n upgrade_check --config configs/backup-v2.yaml
./milvus-backup get -n upgrade_check --config configs/backup-v2.yaml
./milvus-backup restore --filter coll_upgrade_check -n upgrade_check -s _upgrade_check --config configs/backup-v2.yaml
Pastikan bahwa cadangan tersebut mencantumkan coll dan bahwa coll_upgrade_check sudah ada setelah pemulihan. Buat indeks vektornya jika diperlukan, muat, dan bandingkan data yang dipulihkan serta hasil pencarian dengan baseline yang telah dicatat. Jaga agar data sumber tetap tidak berubah selama pengujian ini.
Uji juga cadangan yang sudah ada dan representatif sebelum mengandalkannya dengan alat baru ini. Untuk cadangan 0.5.16 bernama legacy_backup yang berisi coll, gunakan nama target terpisah:
./milvus-backup get -n legacy_backup --config configs/backup-v2.yaml
./milvus-backup restore --filter coll_legacy_check -n legacy_backup -s _legacy_check --config configs/backup-v2.yaml
Jalur peningkatan ini telah divalidasi dengan Milvus 2.6.11, Cadangan 0.5.16 → 0.6.0, dan cadangan binlog di MinIO. Baik cadangan yang baru dibuat maupun yang sudah ada dipulihkan dengan nilai entitas dan hasil pencarian vektor yang sesuai. Hal ini tidak menjamin kompatibilitas untuk setiap cadangan historis atau untuk pemulihan dari Milvus 2.x ke 3.0. Hal ini juga tidak menjamin bahwa versi 0.5.x dapat membaca cadangan yang dibuat oleh versi 0.6.0.
Setelah validasi berhasil, perbarui tugas untuk menggunakan biner baru, konfigurasi yang telah diperiksa, pengaturan lingkungan, dan bendera penggantian secara bersamaan. Untuk penerapan API, jalankan layanan baru dengan konfigurasi yang telah diperiksa dan verifikasi penyelesaian tugas melalui API HTTP. Untuk mengadopsi snapshot pada Milvus 3.0.1 atau versi yang lebih baru, ikuti panduan “Snapshot Backup and Restore in One Instance”.