Ansible-Rolle: Apache Solr

Installiert Apache Solr auf Linux-Servern.

Anforderungen

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

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

Rollenvariablen

Verfügbare Variablen sind unten aufgeführt, zusammen mit den Standardwerten (siehe defaults/main.yml):

solr_workspace: /root

Dateien werden zuerst 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 dem solr_user ausgeführt. Setze solr_create_user auf false, wenn solr_user bereits vor der Ausführung dieser Rolle erstellt wurde oder wenn du Solr 5+ verwendest und möchtest, dass das eigene Installationsskript von Solr den Benutzer einrichtet. Standardmäßig entspricht solr_group solr_user, kann aber überschrieben werden, um deine eigene Konfiguration anzupassen.

solr_version: "8.11.2"

Die zu installierende Version von Apache Solr. Für eine vollständige Liste, siehe verfügbare Versionen von Apache Solr.

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

Der Apache-Projekt-Spiegel, von dem das Solr-Tarball heruntergeladen wird. Bei langsamen Downloadgeschwindigkeiten oder Zeitüberschreitungen ist es nützlich, den Spiegel auf den von Apache empfohlenen Spiegel-Download-Seite 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, stellt sicher, dass er beim Systemstart aktiviert ist und läuft. Du kannst sicherstellen, dass Solr gestoppt ist, indem du solr_service_state: stopped festlegst, oder du kannst die Verwaltung des solr-Dienstes vollständig deaktivieren, indem du solr_service_manage: false setzt. In diesem Fall möchtest du möglicherweise auch solr_restart_handler_enabled: false (weiter unten dokumentiert) festlegen.

solr_install_dir: /opt
solr_install_path: /opt/solr

Der Pfad, wo Apache Solr installiert wird. Für Solr 5+ wird das Installationsverzeichnis solr_install_dir vom Installationsskript von Solr verwendet. Für Solr < 5 werden die Installationsdateien von Solr in den solr_install_path kopiert.

solr_home: /var/solr

Der Pfad, wo lokale Solr-Daten (Suchsammlungen und Konfiguration) gespeichert werden. Dieser sollte typischerweise außerhalb von solr_path liegen, um Solr-Updates zu erleichtern.

solr_port: "8983"

Der Port, auf dem Solr läuft.

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

Speichereinstellungen für die JVM. Diese sollten so hoch wie möglich gesetzt werden, um die beste Leistung zu gewährleisten und die Wahrscheinlichkeit zu verringern, dass Solr aufgrund von OOM-Situationen neu gestartet wird.

solr_timezone: "UTC"

Standardzeitzone der JVM, die Solr ausführt. Du kannst dies bei Bedarf überschreiben, wenn du Datenimporte und Delta-Importe verwendest (z.B. beim Vergleich mit einer externen MySQL-Datenquelle). Lies die Dokumentation zu Datumsangaben von Apache Solr für mehr Hintergrundinformationen.

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

Solr-Optionen. Diese Option wurde teilweise hinzugefügt, um CVE-2021-44228 abzumildern.

solr_cores:
  - collection1

Eine Liste von Kernen / Sammlungen, die auf dem Server existieren sollten. Jede wird erstellt (sofern sie nicht bereits existiert) mit der standardmäßigen Beispielkonfiguration, die mit Solr geliefert wird. Beachte, dass diese Variable nur für Solr 5+ gilt.

solr_connect_host: localhost

Der Hostname oder die IP-Adresse, unter der Solr erreichbar sein wird. localhost sollte in den meisten Fällen funktionieren, aber es gibt besondere Fälle, in denen du möglicherweise nur über eine andere IP oder einen anderen Hostnamen auf die lokale Solr-Instanz zugreifen kannst.

solr_restart_handler_enabled: true

Ob der Handler restart solr verwendet werden soll oder nicht. Wenn du Container oder AMIs erstellst, musst du den Neustart-Handler möglicherweise für einen Bereitstellungsdurchlauf deaktivieren.

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

Die folgenden Variablen gelten derzeit nur für Installationen von Solr 4 und darunter:

solr_log_file_path: /var/log/solr.log

Pfad, wo die Solr-Logdatei erstellt wird.

solr_host: "0.0.0.0"

Der Hostname oder die IP-Adresse, an die Solr gebunden wird. Standardmäßig auf 0.0.0.0, was es Solr erlaubt, auf allen Interfaces zu hören.

Abhängigkeiten

Keine.

Beispiel-Playbook

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

Lizenz

MIT / BSD

Autor Informationen

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