Panduan peningkatan komponen Dify di kluster ACK -

Topik ini menjelaskan cara meningkatkan ack-dify dari versi sebelumnya ke 1.0.0 atau yang lebih baru di kluster Container Service for Kubernetes (ACK). Untuk melakukan peningkatan, Anda perlu mencadangkan data ack-dify, menjalankan perintah untuk mengekstrak dan menginstal plugin, memigrasikan data, serta memverifikasi bahwa plugin beroperasi secara normal. Setelah menyelesaikan langkah-langkah tersebut, Anda dapat menggunakan ekosistem plugin baru.

Ruang lingkup yang berlaku

Versi saat ini: lebih awal dari 1.0.0.
Versi target: 1.0.0 atau yang lebih baru.

1. Cadangkan data ack-dify

Gunakan fitur pusat cadangan untuk mencadangkan data aplikasi ack-dify di namespace dify-system. Untuk informasi selengkapnya, lihat Cadangkan segera.

2. Tingkatkan ack-dify

Masuk ke Konsol Manajemen Container Service. Di panel navigasi sebelah kiri, pilih Clusters. Klik nama kluster target. Di halaman detail kluster, pilih Applications > Helm. Di halaman Helm, temukan ack-dify dan klik Update. Lalu, pilih versi terbaru dan klik OK untuk menyelesaikan pembaruan komponen ack-dify.

3. Migrasikan plugin

3.1 Masuk ke kontainer API ack-dify

kubectl exec -it <ack-dify-api-xxxxx-xxxxx> -n dify-system -- bash

3.2 Ekstrak plugin

poetry run flask extract-plugins --workers=20

Catatan

Jika sistem meminta Anda memasukkan konten, tekan Enter untuk melewati prompt tersebut.

3.3 Instal plugin

poetry run flask install-plugins --workers=2

Penting

Pastikan kluster Anda memiliki akses ke Internet dan ke https://marketplace.dify.ai.

4. Migrasikan data

Untuk memastikan kompatibilitas yang lebih baik, pastikan bahwa ack-dify tidak dikembalikan ke versi sebelumnya dan jalankan perintah berikut untuk memigrasi data:

poetry run flask migrate-data-for-plugin

5. Verifikasi peningkatan

Akses platform Dify.
Periksa apakah plugin telah diinstal di platform Dify.
Pilih plugin acak dan uji apakah plugin berfungsi dengan normal untuk memverifikasi migrasi data.

Pengembalian

Jika Anda ingin mengembalikan ack-dify ke versi sebelumnya, ikuti langkah-langkah berikut:

Masuk ke Konsol ACK. Di panel navigasi sebelah kiri, klik Clusters. Klik nama kluster yang ingin Anda kelola. Di halaman detail kluster, pilih Applications > Helm. Di halaman Helm, temukan rilis ack-dify dan klik Delete di kolom Tindakan. Klik OK. Kemudian, hapus secara manual semua klaim volume persisten (PVC) yang digunakan oleh ack-dify.
Pulihkan ack-dify menggunakan fitur pusat cadangan:
- Pilih file cadangan yang Anda buat di vault cadangan yang sesuai.
- Pulihkan data ke namespace dify-system. Setelah pemulihan selesai, Anda dapat mengakses ack-dify.

Penting

Untuk memastikan bahwa migrasi data selesai dan plugin berfungsi dengan normal, jangan langsung mengembalikan ack-dify setelah ditingkatkan.
Jika Anda mengalami masalah selama peningkatan, lihat Migrating Community Edition to v1.0.0.

FAQ

Waktu yang diperlukan untuk memulihkan data dari file cadangan bergantung pada jumlah data dan kondisi jaringan.
Jika migrasi plugin gagal, periksa apakah kluster dapat mengakses https://marketplace.dify.ai.
Jika data gagal dimigrasikan, jalankan perintah migrasi lagi.

Penafian

Dify di ACK adalah solusi penerapan Helm yang menyesuaikan proyek open source Dify untuk lingkungan Alibaba Cloud ACK, sehingga memungkinkan penerapan yang cepat. ACK tidak menjamin operasi aplikasi Dify itu sendiri atau kompatibilitasnya dengan komponen ekosistem lainnya, seperti plugin dan database. ACK tidak memberikan kompensasi atau layanan komersial lainnya atas kerugian bisnis yang disebabkan oleh cacat pada Dify atau komponen ekosistemnya. Kami menyarankan Anda mengikuti pembaruan dari komunitas open source dan secara proaktif memperbaiki masalah pada perangkat lunak open source untuk memastikan stabilitas dan keamanan penerapan Dify Anda.