All Products
Search

This Product

    Data Management:Prasyarat untuk menggunakan instans database yang sudah ada

    Document Center

    Data Management:Prasyarat untuk menggunakan instans database yang sudah ada

    Last Updated:Jun 22, 2026

    Topik ini menjelaskan cara men-deploy Dify dengan instans yang sudah ada. Pendekatan opsional ini ditujukan bagi pengguna yang telah memiliki sumber daya instans yang diperlukan dan menginginkan penerapan yang fleksibel. Anda harus membeli dan menyiapkan sumber daya tersebut terlebih dahulu.

    Sumber daya yang diperlukan dan perannya

    Catatan

    • Dalam contoh ini, database metadata adalah ApsaraDB RDS for PostgreSQL, dan database vektor adalah AnalyticDB for PostgreSQL. Petunjuk berikut didasarkan pada konfigurasi ini.

    • Keempat sumber daya tersebut harus berada di wilayah yang sama. Misalnya, jika instans ApsaraDB RDS for PostgreSQL Anda berada di wilayah China (Beijing), semua sumber daya lain juga harus berada di wilayah tersebut.

    • ApsaraDB RDS for PostgreSQL: Menyimpan data terstruktur dan data bisnis inti Dify, seperti konfigurasi izin dan informasi pengguna, serta menyediakan dukungan transaksi.

    • Tair (Redis OSS-compatible): Menangani caching, manajemen session, dan pemrosesan tugas asinkron untuk meningkatkan kinerja real-time dan konkurensi sistem.

    • Vector engine (misalnya, AnalyticDB for PostgreSQL): Menyimpan data vektor, seperti dari basis pengetahuan.

    • OSS: Menyimpan data tidak terstruktur Dify, seperti file basis pengetahuan dan gambar.

    1. Beli ApsaraDB RDS for PostgreSQL dan tambahkan ke DMS

    1.1 Beli ApsaraDB RDS for PostgreSQL

    1. Buka halaman pembelian RDS.

    2. Pilih wilayah untuk instans, lalu konfigurasikan edisinya, jenis penyimpanan, dan tipe instans.

      Pada bagian Engine, pilih PostgreSQL dan atur Version ke 17. Edition mendukung Basic Edition, High-availability Edition, dan Cluster Edition. Storage Type mendukung ESSD PL1 dan General-purpose Cloud Disks. Anda juga dapat mengonfigurasi opsi seperti Enable Babelfish, Cloud Disk Encryption, I/O Burst, dan Data Archiving sesuai kebutuhan. Contoh konfigurasi: Untuk Instance Type, pilih 4 vCPU, Memori 8 GiB, dan atur Storage ke 100 GB. Anda juga dapat memilih opsi dengan spesifikasi yang lebih tinggi.

      Pada tab General-purpose, pilih spesifikasi dengan kode pg.n2.4c.1m (jumlah koneksi maksimum: 800).

    3. Ikuti petunjuk untuk menyelesaikan pembelian.

    1.2 Konfigurasi instans

    1.2.1 Buat akun database

    1. Buka daftar instans RDS.

    2. Klik nama instans target dan buka halaman Account Management untuk membuat akun database. Untuk informasi selengkapnya, lihat Buat database dan akun.

      Klik Create Account. Pada panel yang muncul di sebelah kanan, masukkan Database Account (misalnya, dify_test), pilih Privileged Account untuk Account Type, atur password, lalu klik OK.

    1.2.2 Buat database

    Klik nama instans target dan buka halaman Database Management untuk membuat dua database bernama dify dan dify_plugin. Untuk informasi selengkapnya, lihat Buat database dan akun.

    Pada panel Create Database, atur Supported Character Set ke UTF8, Collate ke C, dan Ctype ke en_US.utf8. Untuk Authorized Account, pilih dify_test(Super), lalu klik Create.

    1.2.3 Konfigurasi daftar putih

    Klik nama instans target dan buka halaman Whitelists and Security Groups. Tambahkan blok CIDR IPv4 dari vSwitch di VPC Dify ke daftar putih instans. Untuk informasi selengkapnya, lihat Atur daftar putih dan Buat dan kelola vSwitch.

    Klik tab Whitelist Settings, lalu klik Add Whitelist Group. Pada kotak dialog yang muncul, masukkan Group Name (misalnya, vpc_whitelist) dan Group Whitelist (blok CIDR IPv4 dari vSwitch), lalu klik OK.

    1.3 Tambahkan instans ke DMS

    1. Masuk ke DMS 5.0.

    2. Arahkan pointer ke ikon 2023-01-28_15-57-17.png di pojok kiri atas konsol DMS dan pilih All Features > Data Assets > Instances.

      Catatan

      Jika Anda menggunakan konsol DMS dalam mode normal, pilih Data Assets > Instances di bilah navigasi atas.

    3. Pada halaman Instance Management, klik Add dan konfigurasikan informasi instans.

      Catatan

      Untuk Access Method, Anda harus memilih Security-managed - Manual.

      Pada formulir Add Instance, atur Database Type ke PostgreSQL. Pilih Instance Region target. Untuk Entry Mode, pilih Instance ID dan masukkan ID instans yang sesuai. Untuk DATABASE, masukkan nama database target (misalnya, dify). Masukkan Database Account dan Database Password. Klik Test Connection untuk memverifikasi koneksi, lalu klik Submit.

    4. Setelah menyelesaikan konfigurasi, klik Submit.

    2. Beli Tair (Redis OSS-compatible) dan tambahkan ke DMS

    2.1 Beli Tair (Redis OSS-compatible)

    1. Buka .

    2. Pilih parameter instans.

      1. Atur Product ke Redis Open-Source Edition dan Deployment Mode ke Cloud-native.

        Atur Billing Method ke Subscription.

      2. Atur Series ke Standard Version.

      3. Atur Major Version ke Redis 6.0 dan Architecture Type ke Non-Cluster.

        Atur Instance Type ke High-availability.

      4. Konfigurasikan parameter lainnya.

    3. Untuk informasi selengkapnya, lihat Langkah 1: Buat instans.

    2.2 Konfigurasi instans

    2.2.1 Buat akun database

    1. Buka daftar instans.

    2. Klik nama instans target dan buka halaman Account Management untuk membuat akun database bernama dify_user. Pastikan password untuk akun dify_user sama dengan password akun default. Untuk informasi selengkapnya, lihat Buat dan kelola akun.

    2.2.2 Konfigurasi daftar putih

    Klik nama instans target dan buka halaman pengaturan daftar putih. Tambahkan alamat IP vSwitch di VPC Dify ke daftar putih instans. Untuk informasi selengkapnya, lihat Atur daftar putih IP dan Buat dan kelola vSwitch.

    Pada panel navigasi kiri, klik Whitelist Settings. Klik Add Whitelist Group, masukkan dify_whitelist untuk Group Name, pilih Manual Add untuk Add Method, dan masukkan alamat IP vSwitch yang sesuai pada bidang Group Whitelist.

    2.3 Tambahkan instans ke DMS

    1. Masuk ke DMS 5.0.

    2. Arahkan pointer ke ikon 2023-01-28_15-57-17.png di pojok kiri atas konsol DMS dan pilih All Features > Data Assets > Instances.

      Catatan

      Jika Anda menggunakan konsol DMS dalam mode normal, pilih Data Assets > Instances di bilah navigasi atas.

    3. Pada halaman Instance Management, klik Add dan konfigurasikan informasi instans.

      Catatan

      Untuk Access Method, Anda harus memilih Security-managed - Manual.

      Pada kotak dialog Add Instance, atur Database Type ke Redis. Pilih Instance Region. Untuk Entry Mode, pilih Instance ID dan pilih instans target. Masukkan Database Account dan Database Password.

    4. Setelah menyelesaikan konfigurasi, klik Submit.

    3. Beli vector engine dan tambahkan ke DMS

    Dify di DMS mendukung beberapa vector engine, termasuk AnalyticDB for PostgreSQL, AnalyticDB for MySQL, PolarDB for PostgreSQL, PG Vector, dan Lindorm. Bagian berikut memberikan contoh pembelian instans AnalyticDB for PostgreSQL dan penambahannya ke DMS.

    3.1 Beli AnalyticDB for PostgreSQL

    1. Buka .

    2. Konfigurasikan tipe sumber daya instans, spesifikasi node, dan optimisasi vector engine.

      Catatan

      Aktifkan optimisasi vector engine untuk instans guna memastikan semua fitur basis pengetahuan tersedia. Untuk informasi selengkapnya tentang vector engine, lihat Aktifkan atau nonaktifkan optimisasi mesin pencarian vektor.

      Parameter lain yang perlu dikonfigurasi meliputi Engine Version (6.0 Standard atau 7.0 Standard), Product Type, Instance Series (High-Performance (Basic) atau High-availability), Master Resources, Number of Nodes (2–512), Storage Disk Type (ESSD PL0, PL1, atau PL2), Encryption Type, dan Node Storage Capacity.

    3. Untuk informasi selengkapnya, lihat Buat instans.

    3.2 Konfigurasi instans

    3.2.1 Buat akun database

    1. Buka daftar instans AnalyticDB for PostgreSQL.

    2. Klik nama instans dan buat akun awal pada halaman Account Management. Untuk informasi selengkapnya, lihat Buat akun awal.

    3.2.2 Konfigurasi daftar putih

    Klik nama instans dan buka halaman Data Security untuk menambahkan alamat IP vSwitch di VPC Dify. Untuk informasi selengkapnya, lihat Atur daftar putih dan Buat dan kelola vSwitch.

    Pada tab Whitelist Settings, klik Add Whitelist Group.

    3.3 Tambahkan instans ke DMS

    1. Masuk ke DMS 5.0.

    2. Arahkan pointer ke ikon 2023-01-28_15-57-17.png di pojok kiri atas konsol DMS dan pilih All Features > Data Assets > Instances.

      Catatan

      Jika Anda menggunakan konsol DMS dalam mode normal, pilih Data Assets > Instances di bilah navigasi atas.

    3. Pada halaman Instance Management, klik Add dan konfigurasikan informasi instans.

      Catatan

      Untuk Access Method, Anda harus memilih Security-managed - Manual.

      Pada kotak dialog Add Instance, atur Database Type ke AnalyticDB for PostgreSQL. Pilih Instance Region. Atur Entry Mode ke Instance ID. Masukkan Instance ID, DATABASE, Database Account, dan Database Password.

    4. Setelah menyelesaikan konfigurasi, klik Submit.

    4. Buat bucket OSS dan tambahkan ke DMS

    4.1 Buat bucket OSS

    1. Buka halaman Bucket List dan klik Create Bucket.

    2. Saat mengonfigurasi informasi bucket, masukkan nama bucket dan pilih wilayah yang sama dengan instans lainnya.

    3. Klik Create. Untuk informasi selengkapnya, lihat Panduan cepat konsol.

    4.2 Tambahkan bucket OSS ke DMS

    1. Masuk ke DMS 5.0.

    2. Arahkan pointer ke ikon 2023-01-28_15-57-17.png di pojok kiri atas konsol DMS dan pilih All Features > Data Assets > Instances.

      Catatan

      Jika Anda menggunakan konsol DMS dalam mode normal, pilih Data Assets > Instances di bilah navigasi atas.

    3. Pada halaman Instance Management, klik Add dan konfigurasikan informasi instans.

      Catatan

      Untuk Access Method, Anda harus memilih Security-managed - Manual.

      Pada kotak dialog yang muncul, atur Data Source ke Alibaba Cloud-OSS dan File and Log Storage ke OSS. Pilih Instance Region target, misalnya China (Beijing). Untuk Entry Mode, pilih Connection String. Masukkan Connection String dan nama Bucket. Masukkan AccessKey ID dan AccessKey Secret.

      Untuk informasi selengkapnya tentang cara mendapatkan Pasangan Kunci Akses, lihat Lihat informasi Pasangan Kunci Akses Pengguna RAM.

    4. Setelah menyelesaikan konfigurasi, klik Submit.

    Aktifkan akses internet untuk Dify di DMS

    Untuk mengizinkan Dify mengakses internet atau terhubung ke layanan publik, ikuti langkah-langkah berikut.

    Dapatkan ID VPC instans Dify Anda

    1. Masuk ke DMS 5.0.

    2. Arahkan pointer ke ikon 2023-01-28_15-57-17.png di pojok kiri atas dan pilih All Features > Data+AI > Dify.

      Catatan

      Jika Anda menggunakan konsol DMS dalam mode normal, pilih Data+AI > Dify di bilah navigasi atas.

    3. Klik nama ruang kerja target.

    4. Di pojok kiri bawah, klik ikon Pengaturan image, pilih Workspace Management, dan dapatkan ID VPC instans Dify.

    Buat gateway NAT untuk VPC Dify

    1. Masuk ke konsol Virtual Private Cloud (VPC).

    2. Temukan dan klik ID VPC instans Dify.

    3. Pada tab Resource Management, di area NAT Gateway, klik Create Now.

    4. Pada halaman pembelian, isi informasi konfigurasi seperti Associated VPC dan Instance Name. Setelah menyelesaikan konfigurasi, klik Buy Now di pojok kanan bawah.

      Tabel berikut menjelaskan beberapa parameter pada halaman pembelian.

      Parameter

      Deskripsi

      Region

      Gateway NAT harus berada di wilayah yang sama dengan instans Dify Anda.

      Associated VPC

      Pilih VPC instans Dify Anda.

      Instance Name

      Masukkan nama untuk instans gateway NAT.

      EIP

      Jika Anda memiliki EIP yang sudah ada di wilayah yang sama dengan Dify, pilih Select Existing EIPs. Jika tidak, Anda harus membeli yang baru.

      Untuk Associate vSwitch, pilih vSwitch di VPC. Untuk Billing Method, pilih Pay-as-you-go. Untuk Billing Cycle, pilih Hourly.

    5. Setelah pembelian, sumber daya akan siap dalam beberapa menit.