Elasticsearch：Unggah dan Instal Plugin Kustom

Prasyarat

• Plugin yang ingin Anda unggah sudah disiapkan. Pastikan bahwa plugin tersebut dapat digunakan dan aman.

  Nama file plugin yang ingin Anda unggah harus memiliki panjang 8 hingga 128 karakter dan hanya boleh berisi huruf, angka, tanda hubung (-), serta titik (.). Ekstensi file harus .zip.

  Penting

  Sebelum mengunggah plugin, kami sarankan Anda melakukan pengujian pada kluster Elasticsearch mandiri dengan versi yang sama seperti kluster Elasticsearch Alibaba Cloud Anda. Jika pengujian berhasil, unggah plugin tersebut. Untuk informasi lebih lanjut, lihat Menginstal Plugin.

• Jika Anda ingin mengunggah plugin SQL kustom, pastikan parameter xpack.sql.enabled dalam file konfigurasi YML kluster Elasticsearch Anda diatur ke false.

  Untuk informasi lebih lanjut, lihat Konfigurasikan File YML.

Batasan

Anda tidak diizinkan mengunggah plugin yang kebijakan keamanannya mendefinisikan izin operasi, seperti elasticsearch-analysis-hanlp.

Peringatan

• Jika terjadi masalah seperti kesalahan yang dilaporkan konsol, penangguhan pembaruan kluster, atau kegagalan verifikasi saat mengunggah dan menginstal plugin kustom, Anda dapat mengikuti petunjuk yang diberikan di Kesalahan Instalasi Plugin Kustom untuk menemukan dan menyelesaikan masalah.

• Saat kluster Elasticsearch diperbarui, plugin yang diinstal untuk kluster tersebut tidak diperbarui secara otomatis. Untuk memperbarui plugin, Anda harus mengunggah versi baru plugin secara manual.

• Secara default, plugin kustom tidak dapat mengakses Internet. Jika kluster Anda diterapkan dalam arsitektur jaringan baru, Anda dapat menggunakan layanan PrivateLink untuk membuat koneksi pribadi untuk kluster dan mengaktifkan plugin kustom yang diinstal agar dapat mengakses Internet. Untuk informasi lebih lanjut, lihat Konfigurasikan Koneksi Pribadi untuk Kluster Elasticsearch. Jika kluster Anda diterapkan dalam arsitektur jaringan lama, plugin kustom hanya dapat mengakses virtual private cloud (VPC) tempat kluster berada.

• Plugin kustom dapat memengaruhi stabilitas kluster Elasticsearch Anda. Pastikan bahwa plugin kustom yang ingin Anda unggah dapat digunakan dan aman.

Prosedur

1. Masuk ke Konsol Elasticsearch Alibaba Cloud.

2. Di bilah navigasi di sebelah kiri, klik Elasticsearch Clusters.

3. Arahkan ke kluster yang diinginkan.

   1. Di bilah navigasi atas, pilih grup sumber daya tempat kluster berada dan wilayah tempat kluster berada.

   2. Di halaman Elasticsearch Clusters, temukan kluster dan klik ID-nya.

4. Di bilah navigasi di sebelah kiri halaman yang muncul, pilih Configuration and Management > Plug-ins.

5. Di halaman Plug-ins, klik tab Custom Plug-ins. Lalu, klik Upload.

6. Unggah dan instal plugin kustom.

   1. Di panel Upload Plug-in, klik Select files, or drag and drop files to this area. Lalu, pilih file plugin kustom yang ingin Anda unggah dan klik Buka.

      Anda juga dapat menyeret file plugin kustom ke area ini dan mengunggah file tersebut. Gambar berikut menunjukkan bahwa file plugin elasticsearch-sql-6.7.0.0.zip telah ditambahkan.

      File plugin kustom yang Anda unggah harus memenuhi kondisi berikut. Jika file tidak memenuhi kondisi, validasi file mungkin gagal.

      • Nama file:

        Nama file harus memiliki panjang 8 hingga 128 karakter dan hanya boleh berisi huruf, angka, tanda hubung (-), dan titik (.). Ekstensi file harus .zip.

        Penting

        Plugin kustom dengan karakteristik berikut tidak dapat diunggah atau diinstal: Nama plugin kustom sama dengan plugin bawaan yang disediakan oleh Alibaba Cloud Elasticsearch, nama dan versi plugin kustom sama dengan nama dan versi plugin kustom yang sudah diunggah, versi kluster Elasticsearch tempat Anda ingin menginstal plugin kustom salah, dan versi plugin kustom tidak kompatibel dengan versi kluster Elasticsearch tempat Anda ingin menginstal plugin.

      • Ukuran file: Ukuran file tidak boleh melebihi 100 MB.

      • Jumlah total file yang diunggah: Maksimal 50 file dapat diunggah untuk satu kluster Elasticsearch.

   2. Baca peringatan, pilih kotak centang, lalu klik OK.

      Sistem kemudian akan merestart kluster. Kami sarankan Anda mengunggah plugin selama jam-jam sepi. Setelah kluster direstart, Anda dapat memeriksa plugin di tab Custom Plug-ins. Jika state plugin adalah Installed, plugin berhasil diunggah dan diinstal.

      Jika Anda tidak lagi memerlukan plugin, temukan di tab Plugin Kustom dan klik Remove di kolom Tindakan. Untuk informasi lebih lanjut, lihat Instal dan Hapus Plugin Bawaan. Selain itu, pastikan bahwa plugin yang akan dihapus tidak dirujuk oleh indeks. Jika tidak, restart kluster mungkin macet.