ansible role solr

Rol de Ansible: Apache Solr

Instala Apache Solr en servidores Linux.

Requisitos

Java debe estar disponible en el servidor. Puede instalar Java fácilmente utilizando la función geerlingguy.java . Asegúrese de que la versión de Java instalada cumpla con los requisitos mínimos de Solr (por ejemplo, Java 8 para Solr 6+).

Esta función está actualmente probada y funciona con Solr 3.x, 4.x, 5.x, 6.x, 7.x y 8.x.

Variables de rol

Las variables disponibles se enumeran a continuación, junto con los valores predeterminados (consulte defaults/main.yml ):

 solr_workspace: /root

Los archivos se descargarán en esta ruta en el servidor remoto antes de trasladarlos a su lugar.

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

Solr se ejecutará bajo solr_user . Establezca solr_create_user en false si solr_user se crea antes de que se ejecute esta función, o si está utilizando Solr 5+ y desea que el propio script de instalación de Solr configure el usuario. De forma predeterminada, solr_group es igual solr_user , pero se puede sobrescribir para adaptarlo a su propia configuración.

 solr_version: "8.11.2"

La versión de Apache Solr a instalar. Para obtener una lista completa, consulte las versiones de Apache Solr disponibles.

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

El espejo del Proyecto Apache desde el cual se descargará el tarball de Solr. En caso de que la velocidad de descarga sea lenta o se agoten los tiempos de espera, es útil configurar el espejo según lo sugerido por el sitio de descarga de espejos de Apache.

 solr_remove_cruft: false

Si se debe eliminar documentación y ejemplos innecesarios del directorio solr.

 solr_service_manage: true
solr_service_name: solr
solr_service_state: started

De forma predeterminada, esta función administrará el servicio solr , asegurándose de que esté habilitado en el inicio del sistema y se esté ejecutando. Puede asegurarse de que Solr se detenga configurando solr_service_state: stopped , o puede deshabilitar completamente la administración del servicio solr de esta función configurando solr_service_manage: false . Es posible que también desee configurar solr_restart_handler_enabled: false (documentado más adelante) en este caso.

 solr_install_dir: /opt
solr_install_path: /opt/solr

La ruta donde se instalará Apache Solr. Para Solr 5+, el script de instalación de Solr utilizará solr_install_dir . Para Solr < 5, los archivos de instalación de Solr se copiarán en su lugar en solr_install_path .

 solr_home: /var/solr

La ruta donde se almacenarán los datos locales de Solr (colecciones de búsqueda y configuración). Por lo general, debería estar fuera de solr_path para facilitar las actualizaciones de Solr.

 solr_port: "8983"

El puerto en el que se ejecutará Solr.

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

Configuración de memoria para la JVM. Estos deben establecerse tan altos como sea posible para lograr el mejor rendimiento y reducir la posibilidad de que Solr se reinicie debido a situaciones de OOM.

 solr_timezone: "UTC"

Zona horaria predeterminada de JVM que ejecuta solr. Puede anular esto si es necesario al utilizar la importación de datos y las importaciones delta (por ejemplo, comparar con una fuente de datos externa de MySQL). Lea la documentación sobre cómo trabajar con fechas de Apache Solr para obtener más información.

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

Opciones de sol. Esta opción se agregó a la función en parte para mitigar CVE-2021-44228.

 solr_cores:
  - collection1

Una lista de núcleos/colecciones que deberían existir en el servidor. Cada uno se creará (si aún no existe) utilizando la configuración de ejemplo predeterminada que se incluye con Solr. Tenga en cuenta que esta variable solo se aplica cuando se usa Solr 5+.

 solr_connect_host: localhost

El nombre de host o la dirección IP en la que se podrá acceder a Solr. localhost debería funcionar en la mayoría de las circunstancias, pero hay casos especiales en los que es posible que solo pueda acceder a la instancia local de Solr a través de otra IP o nombre de host.

 solr_restart_handler_enabled: true

Si se debe utilizar o no el controlador restart solr . Si está creando contenedores o AMI, es posible que necesite deshabilitar el controlador de reinicio para una ejecución de aprovisionamiento.

Variables utilizadas sólo para Solr <5.

Actualmente, las siguientes variables solo se aplican a instalaciones de Solr 4 e inferiores:

 solr_log_file_path: /var/log/solr.log

Ruta donde se creará el archivo de registro de Solr.

 solr_host: "0.0.0.0"

El nombre de host o la dirección IP a la que se vinculará Solr. El valor predeterminado es 0.0.0.0 , lo que permite a Solr escuchar en todas las interfaces.

Dependencias

Ninguno.

Ejemplo de libro de jugadas

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

Licencia

MIT/BSD

Información del autor

Este rol fue creado en 2014 por Jeff Geerling, autor de Ansible para DevOps.