Ansible Роль: Apache Solr

Устанавливает Apache Solr на серверах под управлением Linux.

Требования

На сервере должна быть установлена Java. Вы можете легко установить Java, используя роль geerlingguy.java. Убедитесь, что установленная версия Java соответствует минимальным требованиям Solr (например, Java 8 для Solr 6+).

В настоящее время эта роль протестирована и работает с версиями Solr 3.x, 4.x, 5.x, 6.x, 7.x и 8.x.

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

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

solr_workspace: /root

Файлы будут скачаны по этому пути на удаленном сервере перед перемещением на нужное место.

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

Solr будет запускаться от имени solr_user. Установите solr_create_user в false, если solr_user создан до выполнения этой роли, или если вы используете Solr 5+ и хотите, чтобы собственный скрипт установки Solr создал пользователя. По умолчанию solr_group равен solr_user, но это можно изменить для вашей конфигурации.

solr_version: "8.11.2"

Версия Apache Solr для установки. Полный список доступных версий можно найти на странице доступных версий Apache Solr.

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

Зеркало проекта Apache, с которого будет скачан архив Solr. В случае медленной скорости загрузки или таймаутов полезно установить зеркало, рекомендованное сайтом зеркал Apache.

solr_remove_cruft: false

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

solr_service_manage: true
solr_service_name: solr
solr_service_state: started

По умолчанию эта роль управляет службой solr, обеспечивая ее автоматический запуск и работу. Вы можете остановить Solr, установив solr_service_state: stopped, или полностью отключить управление службой solr, установив solr_service_manage: false. В этом случае вам также может понадобиться установить solr_restart_handler_enabled: false (документировано позже).

solr_install_dir: /opt
solr_install_path: /opt/solr

Путь, по которому будет установлено Apache Solr. Для Solr 5+ директория solr_install_dir будет использоваться скриптом установки Solr. Для Solr < 5 файлы установки Solr будут скопированы по пути solr_install_path.

solr_home: /var/solr

Путь, где будут храниться локальные данные Solr (поисковые коллекции и конфигурация). Обычно он должен находиться вне solr_path, чтобы упростить обновления Solr.

solr_port: "8983"

Порт, на котором будет работать Solr.

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

Настройки памяти для JVM. Эти параметры нужно установить как можно выше для лучшей производительности и уменьшения шансов на перезапуск Solr из-за нехватки памяти.

solr_timezone: "UTC"

Часовой пояс для JVM, в которой работает Solr. Вы можете переопределить его, если это необходимо при использовании импорта данных и дельта-импортов (например, сравнение с внешним источником данных MySQL). Ознакомьтесь с документацией Apache Solr Работа с датами для получения дополнительной информации.

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

Опции Solr. Эта опция была добавлена в роль, чтобы снизить риски, связанные с CVE-2021-44228.

solr_cores:
  - collection1

Список ядер / коллекций, которые должны существовать на сервере. Каждое из них будет создано (если оно еще не существует) с использованием конфигурации по умолчанию, которая входит в состав Solr. Обратите внимание, что эта переменная применяется только при использовании Solr 5+.

solr_connect_host: localhost

Имя хоста или IP-адрес, по которому будет доступен Solr. localhost должен работать в большинстве случаев, но есть особые случаи, когда вы сможете получить доступ к локальному экземпляру Solr только через другой IP или имя хоста.

solr_restart_handler_enabled: true

Указывать, следует ли использовать обработчик перезапуск solr. Если вы создаете контейнеры или образы AMI, вам может понадобиться отключить обработчик перезапуска для выполнения настройки.

Переменные, используемые только для Solr < 5.

Следующие переменные в настоящее время применяются только для установок Solr 4 и ниже:

solr_log_file_path: /var/log/solr.log

Путь, по которому будет создан файл журнала Solr.

solr_host: "0.0.0.0"

Имя хоста или IP-адрес, к которому будет привязан Solr. По умолчанию 0.0.0.0, что позволяет Solr слушать на всех интерфейсах.

Зависимости

Нет.

Пример Playbook

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

Лицензия

MIT / BSD

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

Эта роль была создана в 2014 году Джеффом Гирлингом, автором книги Ansible for DevOps.