Elasticsearch:Unggah dan instal plug-in kustom

Prasyarat

• Siapkan plug-in yang akan diunggah dan pastikan ketersediaan serta keamanannya.

  Plug-in harus berupa file .zip. Nama file tersebut harus terdiri dari 8 hingga 128 karakter dan hanya boleh berisi huruf, angka, tanda hubung (-), atau titik (.). File plugin-descriptor.properties milik plug-in harus berada di direktori root paket ZIP.

• Jika Anda ingin mengunggah plug-in SQL kustom, atur parameter xpack.sql.enabled ke false dalam file YAML kluster Alibaba Cloud Elasticsearch Anda.

  Untuk informasi lebih lanjut, lihat Konfigurasi parameter YML.

Batasan

• Kluster ES menggunakan salah satu dari dua arsitektur kontrol: Basic Control Architecture (v2) atau Cloud-native Control Architecture (v3). Untuk memeriksa arsitektur yang digunakan oleh kluster ES Anda, masuk ke Konsol Elasticsearch dan buka halaman Basic Information. Bidang Control Architecture Type akan menampilkan salah satu dari Cloud-native Control Architecture (v3) atau Basic Control Architecture (v2).

• Anda tidak dapat mengunggah plug-in yang mendefinisikan kelas izin apa pun, seperti plug-in elasticsearch-analysis-hanlp.

Pertimbangan

• Untuk bantuan mengatasi error selama pengunggahan dan instalasi (seperti error konsol, perubahan tertahan, atau kegagalan verifikasi), lihat Pemecahan masalah dan penyelesaian error instalasi plug-in kustom.

• Peningkatan kluster tidak secara otomatis meningkatkan plug-in. Anda harus mengunggah ulang dan menginstalnya kembali.

• Secara default, plug-in kustom tidak dapat mengakses Internet. Untuk mengaktifkan akses tersebut, konfigurasikan NAT Gateway. Untuk mengakses layanan privat lintas VPC pada arsitektur jaringan baru, Anda dapat menggunakan PrivateLink. Untuk informasi lebih lanjut, lihat Konfigurasi koneksi privat untuk kluster. Pada arsitektur jaringan asli, plug-in hanya dapat mengakses lingkungan jaringan dalam VPC yang sama.

• Plug-in dapat memengaruhi stabilitas kluster. Pastikan plug-in kustom Anda tersedia dan aman.

Prosedur

1. Masuk ke Konsol Alibaba Cloud Elasticsearch.

2. Pada panel navigasi kiri, klik Elasticsearch Clusters.

3. 1. Pada bilah menu atas, pilih kelompok sumber daya dan wilayah tempat kluster Anda berada.

   2. Klik ID kluster target.

4. Pada panel navigasi kiri, pilih Configuration and Management > Plug-in Configuration.

5. Pada halaman Plug-in Configuration, klik tab Custom Plug-ins, lalu klik Upload.

6. Unggah dan instal plug-in kustom.

   Untuk kluster yang menggunakan arsitektur cloud-native, langkah pengunggahan dan instalasi dipisahkan. Anda dapat membatalkan instalasi yang sedang berlangsung. Prosedur dan pemeriksaan validasi berbeda tergantung pada arsitektur kontrol kluster.

   Cloud-native new control architecture (v3)

   1. Pada kotak dialog Upload Plug-in, pilih Plug-in Source, yang dapat berupa Local File atau OSS Object. Jika Anda memilih Local File, klik Select files, or drag and drop files to this area dan pilih plug-in yang akan diunggah.

      File plug-in Anda harus memenuhi kondisi berikut agar lolos verifikasi:

      • Nama file .zip plug-in harus terdiri dari 8 hingga 128 karakter dan hanya boleh berisi huruf, angka, tanda hubung (-), dan titik (.).

      • Ukuran setiap file tidak boleh melebihi 100 MB, dan Anda dapat mengunggah maksimal 50 file plug-in per kluster.

      • Plug-in harus kompatibel dengan kluster Anda. Namanya tidak boleh bentrok dengan plug-in bawaan atau kustom yang telah terinstal, termasuk plug-in lain dalam unggahan batch yang sama.

   2. Pilih pesan The uploaded file does not take effect immediately. Go to the plug-in list to install the plug-in. di bagian bawah halaman, lalu klik OK.

   3. Pada tab Custom Plug-ins, temukan plug-in Anda dan klik ikon untuk memperluas detailnya.

      Pengunggahan berhasil jika plug-in muncul dalam daftar dengan Status Not Installed. Jika Anda tidak lagi membutuhkan plug-in yang sudah diunggah tetapi belum diinstal, Anda dapat mengklik Delete pada kolom Actions untuk menghapusnya.

   4. Pada kolom Actions untuk plug-in yang ingin Anda instal, klik Install.

      Sistem akan memverifikasi bahwa plug-in kompatibel dengan versi Elasticsearch Anda. Instalasi gagal jika versinya tidak sesuai.

      Anda juga dapat memilih beberapa plug-in dan mengklik Batch Install di bagian bawah halaman untuk menginstal beberapa plug-in sekaligus.

   5. Pada kotak dialog Install Plug-in, baca peringatan restart kluster dan klik Continue.

      Instalasi ini memicu restart kluster. Kami menyarankan Anda melakukan operasi ini pada jam sepi. Setelah kluster direstart, instalasi berhasil jika Status plug-in pada tab Custom Plug-ins berubah menjadi Installed. Setelah terinstal, Anda dapat memperbarui atau menguninstall plug-in tersebut:

      • Perbarui plug-in

        Untuk memperbarui plug-in, unggah versi baru dengan nama yang sama, lalu instal.

      • Uninstall plug-in

        Klik Uninstall pada kolom Actions untuk plug-in yang ingin Anda uninstall. Untuk operasi dan catatan detail, lihat Install atau uninstall plug-in bawaan.

      Catatan

      Selama proses instalasi, Anda dapat mengklik Cancel Installation pada kolom Actions. Ini berguna jika instalasi gagal karena ketidakcocokan dengan kluster ES, karena pembatalan akan mengembalikan perubahan tersebut.

   Basic Control Architecture (v2)

   1. Pada kotak dialog Upload Plug-in, klik Select files, or drag and drop files to this area, pilih plug-in yang akan diunggah, lalu klik Open.

      File plug-in Anda harus memenuhi kondisi berikut agar lolos verifikasi:

      • Nama file .zip plug-in harus terdiri dari 8 hingga 128 karakter dan hanya boleh berisi huruf, angka, tanda hubung (-), dan titik (.).

      • Ukuran setiap file tidak boleh melebihi 100 MB, dan Anda dapat mengunggah maksimal 50 file plug-in per kluster.

      • Plug-in harus kompatibel dengan kluster Anda. Namanya tidak boleh bentrok dengan plug-in bawaan atau kustom yang telah terinstal, termasuk plug-in lain dalam unggahan batch yang sama.

   2. Tinjau peringatan yang diberikan, centang kotak yang sesuai, lalu klik Upload.

      Setelah kluster direstart, proses berhasil jika plug-in muncul pada tab Custom Plug-ins dengan Status Installed.

      Jika Anda tidak lagi membutuhkan plug-in tersebut, klik Remove pada kolom Actions-nya. Untuk operasi dan catatan detail, lihat Install atau uninstall plug-in bawaan. Sebelum meng-uninstall, pastikan tidak ada indeks yang mereferensikan plug-in tersebut untuk mencegah kluster hang saat restart.