ansible role solr

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 из-за ситуаций OOM.

 solr_timezone: "UTC"

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

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

Варианты Солра. Эта опция была добавлена ​​к этой роли частично для устранения уязвимости CVE 2021-44228.

 solr_cores:
  - collection1

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

 solr_connect_host: localhost

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

 solr_restart_handler_enabled: true

Следует ли использовать обработчик restart 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 прослушивать все интерфейсы.

Зависимости

Никто.

Пример книги действий

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

Лицензия

Массачусетский технологический институт / БСД

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

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