Ansible Роль: Apache Solr

Устанавливает Apache Solr 5+ на Ubuntu LTS.

Что особенного в этой роли Apache Solr

• Быстрая загрузка: пытается скачать Solr с ближайшего зеркала (работает только для последних релизов), в противном случае используется архив
• Проверка целостности файлов
• Поддерживает только Ubuntu 16.04, 18.04 и 20.04
• Тестирование с использованием Molecule 3

Требования

Локальный хост (управляющая машина)

Эта роль использует следующие модули Ansible, которые имеют определенные требования к локальному хосту (т.е. управляющей машине):

• synchronize: копирует основную конфигурацию в директорию данных Solr. Этот модуль является оберткой над rsync, поэтому rsync должен быть установлен как на локальной, так и на удаленной машине
• xml: разбирает ответ от Solr Admin API. Этот модуль требует lxml >= 2.3.0 на локальном хосте. Инструкции по установке можно найти здесь: https://lxml.de/installation.html

Удаленный хост (целевая машина)

• Java должна быть установлена на целевой машине (Solr является приложением на Java). Для этого можно использовать роль t2l.java.

Эта роль зависит от набора инструментов/утилит/команд, которые должны быть доступны на удаленной машине. Они будут установлены автоматически:

• curl и sed: определяют ближайшее доступное зеркало Apache Solr
• gpg: проверяет подпись загруженного архива Solr
• tar: распаковывает загруженный архив Solr
• rsync: синхронизирует основную конфигурацию
• lsof: рекомендуем для более стабильного старта/остановки Solr

Переменные роли

Доступные переменные перечислены ниже вместе с значениями по умолчанию (см. defaults/main.yml):

Пользователь и группа Solr. По умолчанию solr:solr.

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

Версия Solr для установки. Минимально поддерживаемая версия 5.0.0.

solr_version: 7.7.3

Порт, к которому Solr должен привязаться.

solr_port: 8983

Директория, куда будет загружен архив Solr.

solr_download_dir: /tmp

Директория, куда будет установлен Solr.

solr_install_dir: /opt

Директория данных для конфигурации и ядер Solr.

solr_data_dir: /var/solr

Следует ли удалить загруженный архив и извлеченные файлы после установки.

solr_cleanup_downloads: true

Следует ли удалить загруженные файлы ключей GPG и подписи .asc после установки.

solr_cleanup_gpg: true

Список ядер Solr для настройки. Возможные ключи:

• name: имя ядра Solr
• conf_path: (необязательно) Системный путь к директории с конфигурацией ядра на удаленном хосте. Если пропущен, будет использована стандартная конфигурация ядра Solr

solr_cores: []

Пример (не забудьте убрать квадратные скобки):

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

Пример playbook

- hosts: all
  roles:
    - t2l.solr

Лицензия

MIT

Информация об авторе

Эта роль была создана в 2017-2021 годах Романом Пасціка.

Изменения

Список изменений можно найти здесь CHANGELOG.md

Обновление

Инструкции по обновлению можно найти здесь UPGRADE.md