ansible role solr

Peran yang Mungkin: Apache Solr

Menginstal Apache Solr di server Linux.

Persyaratan

Java harus tersedia di server. Anda dapat dengan mudah menginstal Java menggunakan peran geerlingguy.java . Pastikan versi Java yang diinstal memenuhi persyaratan minimum Solr (misalnya Java 8 untuk Solr 6+).

Peran ini sedang diuji dan berfungsi dengan Solr 3.x, 4.x, 5.x, 6.x, 7.x, dan 8.x.

Variabel Peran

Variabel yang tersedia tercantum di bawah, bersama dengan nilai default (lihat defaults/main.yml ):

 solr_workspace: /root

File akan diunduh ke jalur ini di server jauh sebelum dipindahkan ke tempatnya.

 solr_create_user: true
solr_user: solr
solr_group: "{{ solr_user }}"

Solr akan dijalankan di bawah solr_user . Setel solr_create_user ke false jika solr_user dibuat sebelum peran ini dijalankan, atau jika Anda menggunakan Solr 5+ dan ingin skrip instalasi Solr sendiri menyiapkan pengguna. Secara default, solr_group sama dengan solr_user , namun dapat ditimpa agar sesuai dengan konfigurasi Anda.

 solr_version: "8.11.2"

Versi Apache Solr yang akan diinstal. Untuk daftar lengkap, lihat versi Apache Solr yang tersedia.

 solr_mirror: "https://archive.apache.org/dist"

Cermin Proyek Apache tempat tarball Solr akan diunduh. Jika kecepatan pengunduhan lambat atau batas waktu habis, sebaiknya atur mirror ke yang disarankan oleh situs pengunduhan mirror Apache.

 solr_remove_cruft: false

Apakah akan menghapus dokumentasi dan contoh yang tidak diperlukan dari direktori solr.

 solr_service_manage: true
solr_service_name: solr
solr_service_state: started

Secara default, peran ini akan mengelola layanan solr , memastikan layanan tersebut diaktifkan saat boot sistem dan berjalan. Anda dapat memastikan Solr dihentikan dengan menyetel solr_service_state: stopped , atau Anda dapat menonaktifkan pengelolaan peran layanan solr ini sepenuhnya dengan menyetel solr_service_manage: false . Anda mungkin juga ingin menyetel solr_restart_handler_enabled: false (didokumentasikan nanti) dalam kasus ini.

 solr_install_dir: /opt
solr_install_path: /opt/solr

Jalur dimana Apache Solr akan diinstal. Untuk Solr 5+, solr_install_dir akan digunakan oleh skrip instalasi Solr. Untuk Solr <5, file instalasi Solr akan disalin ke tempatnya di solr_install_path .

 solr_home: /var/solr

Jalur dimana data Solr lokal (koleksi pencarian dan konfigurasi) akan disimpan. Biasanya harus berada di luar solr_path , untuk membuat peningkatan Solr lebih mudah.

 solr_port: "8983"

Port tempat Solr akan dijalankan.

 solr_xms: "256M"
solr_xmx: "512M"

Pengaturan memori untuk JVM. Ini harus disetel setinggi mungkin untuk menghasilkan kinerja terbaik dan untuk mengurangi kemungkinan Solr memulai ulang sendiri karena situasi OOM.

 solr_timezone: "UTC"

Zona waktu default JVM yang menjalankan solr. Anda dapat menggantinya jika diperlukan saat menggunakan impor data dan impor delta (misal: membandingkan dengan sumber data eksternal MySQL). Baca dokumentasi Bekerja dengan Tanggal Apache Solr untuk latar belakang lebih lanjut.

 solr_opts: "$SOLR_OPTS -Dlog4j2.formatMsgNoLookups=true"

Pilihan terbaik. Opsi ini ditambahkan ke peran untuk memitigasi CVE-2021-44228.

 solr_cores:
  - collection1

Daftar core/koleksi yang seharusnya ada di server. Masing-masing akan dibuat (jika belum ada) menggunakan contoh konfigurasi default yang dikirimkan bersama Solr. Perhatikan bahwa variabel ini hanya berlaku saat menggunakan Solr 5+.

 solr_connect_host: localhost

Nama host atau alamat IP yang dapat dijangkau Solr. localhost seharusnya berfungsi di sebagian besar situasi, namun ada kasus khusus di mana Anda mungkin hanya dapat mengakses instance Solr lokal melalui IP atau nama host lain.

 solr_restart_handler_enabled: true

Apakah handler restart solr harus digunakan atau tidak. Jika Anda membuat kontainer atau AMI, Anda mungkin perlu menonaktifkan pengendali mulai ulang untuk menjalankan provisi.

Variabel yang digunakan hanya untuk Solr <5.

Variabel berikut saat ini hanya diterapkan pada instalasi Solr 4 dan di bawahnya:

 solr_log_file_path: /var/log/solr.log

Jalur dimana file log Solr akan dibuat.

 solr_host: "0.0.0.0"

Nama host atau alamat IP yang akan diikat oleh Solr. Defaultnya adalah 0.0.0.0 yang memungkinkan Solr mendengarkan di semua antarmuka.

Ketergantungan

Tidak ada.

Contoh Buku Pedoman

 - hosts: solr-servers
  roles:
    - geerlingguy.java
    - geerlingguy.solr

Lisensi

MIT/BSD

Informasi Penulis

Peran ini dibuat pada tahun 2014 oleh Jeff Geerling, penulis Ansible for DevOps.