Rola Ansible: Apache Solr

Instaluje Apache Solr 5+ na Ubuntu LTS.

Co jest wyjątkowego w tej roli Apache Solr

• Szybkie pobieranie: próbuje pobrać Solr z najbliższego lustra (działa tylko dla najnowszych wydań), w razie problemów przechodzi do archiwum
• Weryfikacja integralności plików
• Obsługuje tylko Ubuntu 16.04, 18.04 i 20.04
• Testy z Molecule 3

Wymagania

Host lokalny (maszyna zarządzająca)

Ta rola korzysta z następujących modułów Ansible, które mają specyficzne wymagania dla hosta lokalnego (tj. maszyny zarządzającej):

• synchronize: kopiuje główną konfigurację do katalogu danych Solr. Ten moduł jest opakowaniem wokół rsync, więc rsync musi być zainstalowany zarówno na hoście lokalnym, jak i zdalnym.
• xml: analizuje odpowiedź z Solr Admin API. Ten moduł wymaga lxml >= 2.3.0 na hoście lokalnym. Instrukcje instalacji tutaj: https://lxml.de/installation.html

Host zdalny (maszyna docelowa)

• Java musi być zainstalowana na maszynie docelowej (Solr to aplikacja oparta na Javie). Można użyć roli t2l.java do jej zainstalowania.

Ta rola opiera się na zestawie narzędzi/użytków/komend, które muszą być dostępne na hoście zdalnym. Zostaną one automatycznie zainstalowane:

• curl i sed: określają najbliższe dostępne lustro Apache Solr
• gpg: weryfikuje podpis pobranego archiwum Solr
• tar: rozpakowuje pobrane archiwum Solr
• rsync: synchronizuje główną konfigurację
• lsof: zalecane dla bardziej stabilnego uruchamiania/zatrzymywania Solr

Zmienne roli

Dostępne zmienne są wymienione poniżej wraz z wartościami domyślnymi (zobacz defaults/main.yml):

Użytkownik i grupa Solr. Domyślnie to solr:solr.

solr_user: solr
solr_group: "{{ solr_user }}"

Wersja Solr do zainstalowania. Minimalnie wspierana wersja to 5.0.0.

solr_version: 7.7.3

Port, do którego Solr ma się przywiązać.

solr_port: 8983

Katalog, do którego zostanie pobrane archiwum Solr.

solr_download_dir: /tmp

Katalog, w którym zostanie zainstalowane Solr.

solr_install_dir: /opt

Katalog danych dla konfiguracji i rdzeni Solr.

solr_data_dir: /var/solr

Czy po instalacji usunąć pobrane archiwum i wyodrębnione pliki.

solr_cleanup_downloads: true

Czy po instalacji usunąć pobrany plik kluczy GPG i plik podpisu .asc.

solr_cleanup_gpg: true

Lista rdzeni Solr do skonfigurowania. Możliwe klucze:

• name: nazwa rdzenia Solr
• conf_path: (opcjonalnie) Ścieżka systemowa do katalogu z konfiguracją rdzenia na hoście zdalnym. Jeśli pominięta, używana będzie domyślna konfiguracja rdzenia Solr.

solr_cores: []

Przykład (nie zapomnij usunąć nawiasów kwadratowych):

solr_cores:
  - name: main
  - name: extra
    conf_path: /var/www/project/config/solr

Przykładowy Playbook

- hosts: all
  roles:
    - t2l.solr

Licencja

MIT

Informacje o autorze

Ta rola została stworzona w latach 2017-2021 przez Romana Paskę.

Historia zmian

Historia zmian znajduje się tutaj CHANGELOG.md

Uaktualnienie

Instrukcje dotyczące uaktualnienia znajdują się tutaj UPGRADE.md