ansible role solr

Rôle Ansible : Apache Solr

Installe Apache Solr sur les serveurs Linux.

Exigences

Java doit être disponible sur le serveur. Vous pouvez facilement installer Java en utilisant le rôle geerlingguy.java . Assurez-vous que la version Java installée répond à la configuration minimale requise de Solr (par exemple Java 8 pour Solr 6+).

Ce rôle est actuellement testé et fonctionne avec Solr 3.x, 4.x, 5.x, 6.x, 7.x et 8.x.

Variables de rôle

Les variables disponibles sont répertoriées ci-dessous, ainsi que les valeurs par défaut (voir defaults/main.yml ) :

 solr_workspace: /root

Les fichiers seront téléchargés sur ce chemin sur le serveur distant avant d'être mis en place.

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

Solr sera exécuté sous solr_user . Définissez solr_create_user sur false si solr_user est créé avant l'exécution de ce rôle, ou si vous utilisez Solr 5+ et souhaitez que le propre script d'installation de Solr configure l'utilisateur. Par défaut, solr_group est égal à solr_user , mais il peut être écrasé pour s'adapter à votre propre configuration.

 solr_version: "8.11.2"

La version d'Apache Solr à installer. Pour une liste complète, consultez les versions Apache Solr disponibles.

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

Le miroir du projet Apache à partir duquel l'archive tar Solr sera téléchargée. En cas de vitesse de téléchargement lente ou de délais d'attente, il est utile de définir le miroir sur celui suggéré par le site de téléchargement de miroir d'Apache.

 solr_remove_cruft: false

S'il faut supprimer la documentation et les exemples inutiles du répertoire solr.

 solr_service_manage: true
solr_service_name: solr
solr_service_state: started

Par défaut, ce rôle gérera le service solr , en s'assurant qu'il est activé au démarrage du système et qu'il est en cours d'exécution. Vous pouvez vous assurer que Solr est arrêté en définissant solr_service_state: stopped , ou vous pouvez désactiver entièrement la gestion du service solr par ce rôle en définissant solr_service_manage: false . Vous souhaiterez peut-être également définir solr_restart_handler_enabled: false (documenté plus tard) dans ce cas.

 solr_install_dir: /opt
solr_install_path: /opt/solr

Le chemin où Apache Solr sera installé. Pour Solr 5+, le solr_install_dir sera utilisé par le script d'installation de Solr. Pour Solr < 5, les fichiers d'installation de Solr seront copiés sur place dans solr_install_path .

 solr_home: /var/solr

Le chemin où les données Solr locales (collections de recherche et configuration) seront stockées. Doit généralement être en dehors du solr_path , pour faciliter les mises à niveau de Solr.

 solr_port: "8983"

Le port sur lequel Solr fonctionnera.

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

Paramètres de mémoire pour la JVM. Ceux-ci doivent être définis aussi haut que possible pour obtenir les meilleures performances et réduire les risques de redémarrage de Solr en raison de situations de MOO.

 solr_timezone: "UTC"

Fuseau horaire par défaut de la JVM exécutant Solr. Vous pouvez remplacer cela si nécessaire lors de l'utilisation de l'importation de données et des importations delta (ex : comparaison avec une source de données externe MySQL). Lisez la documentation Travailler avec les dates d'Apache Solr pour plus d'informations.

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

Options de résolution. Cette option a été ajoutée au rôle en partie pour atténuer CVE-2021-44228.

 solr_cores:
  - collection1

Une liste des cœurs/collections qui doivent exister sur le serveur. Chacun sera créé (s'il n'existe pas déjà) à l'aide de l'exemple de configuration par défaut fourni avec Solr. Notez que cette variable ne s'applique que lors de l'utilisation de Solr 5+.

 solr_connect_host: localhost

Le nom d'hôte ou l'adresse IP sur laquelle Solr sera joignable. localhost devrait fonctionner dans la plupart des cas, mais il existe des cas particuliers où vous ne pourrez accéder à l'instance Solr locale que via une autre adresse IP ou un autre nom d'hôte.

 solr_restart_handler_enabled: true

Si le gestionnaire restart solr doit être utilisé ou non. Si vous créez des conteneurs ou des AMI, vous devrez peut-être désactiver le gestionnaire de redémarrage pour une exécution de provisionnement.

Variables utilisées uniquement pour Solr < 5.

Les variables suivantes ne sont actuellement appliquées qu'aux installations de Solr 4 et versions antérieures :

 solr_log_file_path: /var/log/solr.log

Chemin où le fichier journal Solr sera créé.

 solr_host: "0.0.0.0"

Le nom d'hôte ou l'adresse IP à laquelle Solr se liera. La valeur par défaut est 0.0.0.0 ce qui permet à Solr d'écouter sur toutes les interfaces.

Dépendances

Aucun.

Exemple de manuel de jeu

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

Licence

MIT/BSD

Informations sur l'auteur

Ce rôle a été créé en 2014 par Jeff Geerling, auteur d'Ansible for DevOps.