Rôle Ansible : Apache Solr

Installe Apache Solr 5+ sur Ubuntu LTS.

Qu'est-ce qui rend ce rôle Apache Solr spécial

• Téléchargements rapides : essaie de télécharger Solr depuis le miroir le plus proche (cela fonctionne uniquement pour les dernières versions), possibilité de revenir à l'archive
• Vérification de l'intégrité des fichiers
• Prend en charge uniquement Ubuntu 16.04, 18.04 et 20.04
• Tests avec Molecule 3

Exigences

Hôte local (machine de contrôle)

Ce rôle utilise les modules Ansible suivants, qui ont des exigences spécifiques pour l'hôte local (c'est-à-dire la machine de contrôle) :

• synchronize : copie la configuration principale dans le répertoire de données de Solr. Ce module est un wrapper autour de rsync, donc rsync doit être installé à la fois sur l'hôte local et l'hôte distant.
• xml : analyse la réponse de l'API Admin de Solr. Ce module nécessite lxml >= 2.3.0 sur l'hôte local. Voir les instructions d'installation ici : https://lxml.de/installation.html

Hôte distant (machine cible)

• Java doit être installé sur la machine cible (Solr est une application basée sur Java). Le rôle t2l.java peut être utilisé pour cela.

Ce rôle repose sur un ensemble d'outils/utilitaires/commandes qui doivent être disponibles sur l'hôte distant. Ils seront installés automatiquement :

• curl et sed : déterminent le miroir Apache Solr disponible le plus proche
• gpg : vérifie la signature de l'archive Solr téléchargée
• tar : décompresse l'archive Solr téléchargée
• rsync : synchronise la configuration principale
• lsof : recommandé pour un démarrage/arrêt plus stable de Solr

Variables du rôle

Les variables disponibles sont énumérées ci-dessous, avec leurs valeurs par défaut (voir defaults/main.yml) :

Utilisateur et groupe Solr. Par défaut sur solr:solr.

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

Version de Solr à installer. La version minimale prise en charge est 5.0.0.

solr_version: 7.7.3

Port auquel Solr doit se lier.

solr_port: 8983

Répertoire où l'archive Solr sera téléchargée.

solr_download_dir: /tmp

Répertoire où Solr sera installé.

solr_install_dir: /opt

Répertoire de données pour la configuration et les cœurs de Solr.

solr_data_dir: /var/solr

Si l'on doit supprimer l'archive téléchargée et les fichiers extraits après l'installation.

solr_cleanup_downloads: true

Si l'on doit supprimer le fichier de clés GPG téléchargé et le fichier de signature .asc après l'installation.

solr_cleanup_gpg: true

Liste des cœurs Solr à configurer. Clés possibles :

• name : nom du cœur Solr
• conf_path : (optionnel) chemin système vers un répertoire avec la configuration du cœur sur un hôte distant. Si omis, la configuration par défaut du cœur Solr sera utilisée

solr_cores: []

Exemple (n'oubliez pas de supprimer les crochets) :

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

Exemple de Playbook

- hosts: all
  roles:
    - t2l.solr

Licence

MIT

Informations sur l'auteur

Ce rôle a été créé entre 2017 et 2021 par Roman Paska.

Journal des modifications

Le journal des modifications peut être consulté ici CHANGELOG.md

Mise à niveau

Les instructions de mise à niveau peuvent être consultées ici UPGRADE.md