ansible role solr

Ansible-Rolle: Apache Solr

Installiert Apache Solr auf Linux-Servern.

Anforderungen

Java muss auf dem Server verfügbar sein. Sie können Java einfach mit der Rolle geerlingguy.java installieren. Stellen Sie sicher, dass die installierte Java-Version die Mindestanforderungen von Solr erfüllt (z. B. Java 8 für Solr 6+).

Diese Rolle wird derzeit getestet und funktioniert mit Solr 3.x, 4.x, 5.x, 6.x, 7.x und 8.x.

Rollenvariablen

Die verfügbaren Variablen sind unten zusammen mit den Standardwerten aufgeführt (siehe defaults/main.yml ):

 solr_workspace: /root

Dateien werden in diesen Pfad auf dem Remote-Server heruntergeladen, bevor sie an ihren Platz verschoben werden.

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

Solr wird unter solr_user ausgeführt. Setzen Sie solr_create_user auf false wenn solr_user erstellt wird, bevor diese Rolle ausgeführt wird, oder wenn Sie Solr 5+ verwenden und möchten, dass Solrs eigenes Installationsskript den Benutzer einrichtet. Standardmäßig ist solr_group gleich solr_user , kann jedoch überschrieben werden, um es an Ihre eigene Konfiguration anzupassen.

 solr_version: "8.11.2"

Die zu installierende Apache Solr-Version. Eine vollständige Liste finden Sie unter Verfügbare Apache Solr-Versionen.

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

Der Apache-Projektspiegel, von dem der Solr-Tarball heruntergeladen wird. Bei langsamer Download-Geschwindigkeit oder Zeitüberschreitungen ist es sinnvoll, den Spiegel auf den von der Apache-Spiegel-Download-Site vorgeschlagenen Spiegel einzustellen.

 solr_remove_cruft: false

Ob unnötige Dokumentation und Beispiele aus dem Solr-Verzeichnis entfernt werden sollen.

 solr_service_manage: true
solr_service_name: solr
solr_service_state: started

Standardmäßig verwaltet diese Rolle den solr -Dienst und stellt sicher, dass er beim Systemstart aktiviert ist und ausgeführt wird. Sie können sicherstellen, dass Solr gestoppt wird, indem Sie solr_service_state: stopped festlegen, oder Sie können die Verwaltung des solr -Dienstes durch diese Rolle vollständig deaktivieren, indem Sie solr_service_manage: false festlegen. Möglicherweise möchten Sie in diesem Fall auch solr_restart_handler_enabled: false (später dokumentiert) festlegen.

 solr_install_dir: /opt
solr_install_path: /opt/solr

Der Pfad, in dem Apache Solr installiert wird. Für Solr 5+ wird solr_install_dir vom Solr-Installationsskript verwendet. Für Solr < 5 werden die Solr-Installationsdateien direkt in den solr_install_path kopiert.

 solr_home: /var/solr

Der Pfad, in dem lokale Solr-Daten (Suchsammlungen und Konfiguration) gespeichert werden. Sollte normalerweise außerhalb von solr_path liegen, um Solr-Upgrades zu vereinfachen.

 solr_port: "8983"

Der Port, auf dem Solr ausgeführt wird.

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

Speichereinstellungen für die JVM. Diese sollten so hoch wie möglich eingestellt werden, um die beste Leistung zu erzielen und die Wahrscheinlichkeit zu verringern, dass Solr aufgrund von OOM-Situationen neu startet.

 solr_timezone: "UTC"

Standardzeitzone der JVM, auf der solr ausgeführt wird. Sie können dies bei Bedarf überschreiben, wenn Sie Datenimport- und Delta-Importe verwenden (z. B. beim Vergleich mit einer externen MySQL-Datenquelle). Weitere Hintergrundinformationen finden Sie in der Dokumentation „Arbeiten mit Datumsangaben“ von Apache Solr.

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

Solr-Optionen. Diese Option wurde der Rolle teilweise hinzugefügt, um CVE-2021-44228 abzuschwächen.

 solr_cores:
  - collection1

Eine Liste der Kerne/Sammlungen, die auf dem Server vorhanden sein sollten. Jede davon wird (falls noch nicht vorhanden) unter Verwendung der Standardbeispielkonfiguration erstellt, die im Lieferumfang von Solr enthalten ist. Beachten Sie, dass diese Variable nur bei Verwendung von Solr 5+ gilt.

 solr_connect_host: localhost

Der Hostname oder die IP-Adresse, unter der Solr erreichbar ist. localhost sollte in den meisten Fällen funktionieren, es gibt jedoch Sonderfälle, in denen Sie möglicherweise nur über eine andere IP oder einen anderen Hostnamen auf die lokale Solr-Instanz zugreifen können.

 solr_restart_handler_enabled: true

Ob der restart solr -Handler verwendet werden soll oder nicht. Wenn Sie Container oder AMIs erstellen, müssen Sie möglicherweise den Neustart-Handler für einen Bereitstellungslauf deaktivieren.

Variablen, die nur für Solr < 5 verwendet werden.

Die folgenden Variablen werden derzeit nur auf Installationen von Solr 4 und niedriger angewendet:

 solr_log_file_path: /var/log/solr.log

Pfad, in dem die Solr-Protokolldatei erstellt wird.

 solr_host: "0.0.0.0"

Der Hostname oder die IP-Adresse, an die Solr bindet. Der Standardwert ist 0.0.0.0 , wodurch Solr alle Schnittstellen abhören kann.

Abhängigkeiten

Keiner.

Beispiel-Playbook

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

Lizenz

MIT / BSD

Informationen zum Autor

Diese Rolle wurde 2014 von Jeff Geerling, Autor von Ansible for DevOps, erstellt.