solr_standalone
Установка Solr
Описание
Эта роль:
- Устанавливает Solr в режиме standalone на CentOS 7, Ubuntu или Windows.
- Настраивает SSL для Solr 7.x и 8.x.
- Настраивает аутентификацию для Solr 7.x и 8.x.
- Настраивает Solr.
- Поддерживаемые версии Solr: 6.x - 8.x. Последняя протестированная версия - 8.0.0.
Для дополнительной настройки, такой как мастер или слейв режим, используйте роли:
- solr-master (lean-delivery.ansible-role-solr-master)
- solr-slave (lean-delivery.ansible-role-solr-slave)
- solr-cloud (lean-delivery.ansible-role-solr-cloud)
- для интеграции SAP-Hybris и Solr с Hybris extras (lean-delivery.ansible-role-solr-hybris-config)
Требования
- Минимальная версия ansible для установки: 2.7.
- Java 8
- Поддерживаемые ОС:
- CentOS
- 7
- Ubuntu
- Debian
- Windows
- "Windows Server 2008"
- "Windows Server 2008 R2"
- "Windows Server 2012"
- "Windows Server 2012 R2"
- "Windows Server 2016"
- "Windows Server 2019"
- "Windows 7"
- "Windows 8.1"
- "Windows 10"
- CentOS
Подготовленная система Windows
Переменные роли
solr_version
- версия, доступная на https://archive.apache.org/dist/lucene/solr/. Протестированные версии 6.x-8.xпо умолчанию:
8.0.0
solr_use_java_version_8
- если True, Solr установлен на Java версии 8 и ранее. Если используется более поздняя версия - установите в False.по умолчанию:
True
solr_url
- корневой URL для загрузки Solrпо умолчанию:
http://archive.apache.org/dist/lucene/solr
solr_distr_url
- URL файла zipпо умолчанию:
{{ solr_url }}/{{ solr_version }}/solr-{{ solr_version }}.zip
solr_host
- имя сервера Solrпо умолчанию:
{{ ansible_fqdn }}
solr_dest_main_path
- корневая директория для хранения папки Solrпо умолчанию:
/opt
для Linuxпо умолчанию:
C:\Solr
для Windowssolr_dest_path
- путь к папке Solrпо умолчанию:
{{ solr_dest_main_path }}/solr-{{ solr_version }}
solr_change_default_password
- изменить пароль по умолчанию для пользователя Solr (будет solr_auth_pass)по умолчанию:
True
solr_auth_configure
- включить аутентификациюпо умолчанию:
True
solr_auth_type
- тип аутентификациипо умолчанию:
basic
solr_auth_user
- пользователь Solr по умолчаниюпо умолчанию:
solrserver
solr_auth_pass
- пароль пользователя Solr по умолчаниюпо умолчанию:
server123
solr_default_auth_user
- пользователь Solr по умолчаниюпо умолчанию:
solr
solr_default_auth_pass
- пароль пользователя Solr по умолчаниюпо умолчанию:
SolrRocks
solr_authentication_opts
- параметры аутентификации Solrпо умолчанию:
-Dbasicauth={{ solr_auth_user }}:{{ solr_auth_pass }}
solr_insh_default
- папка in.sh Solrпо умолчанию:
/etc/default/solr.in.sh
solr_java_xms
- размер кучипо умолчанию:
512m
solr_java_xmx
- размер кучипо умолчанию:
512m
solr_master_enable_jmx
- включить jmx на Solrпо умолчанию:
false
solr_additional_opts
- параметры Solrпо умолчанию:
-Xss256k
solr_user
- пользователь ОС для запуска службы Solrпо умолчанию:
solr
solr_group
- группа ОС для пользователяпо умолчанию:
solr
solr_port
- порт для запуска Solrпо умолчанию:
8983
solr_service_name
- имя службы Solrпо умолчанию:
solr
solr_base_path
- путь к базовой директории Solrпо умолчанию:
/var/solr
solr_home
- путь к SOLR_HOMEпо умолчанию:
{{ solr_base_path }}/data
solr_with_systemd
- запуск Solr как службыпо умолчанию:
True
solr_logs_dir
- путь для хранения логовпо умолчанию:
{{ solr_base_path }}/logs
solr_wait_for_zk
- тайм-аут для повторного подключения к ZooKeeper (в секундах)по умолчанию:
30
solr_client_timeout
- тайм-аут клиента ZooKeeper (для режима SolrCloud)по умолчанию:
15000
solr_timezone
- часовой пояс для сервера Solrпо умолчанию:
UTC
solr_service_restart
- опция перезапуска службы Solrпо умолчанию:
always
solr_service_start
- запуск службы Solr в конце роли/Playbookпо умолчанию:
True
solr_service_autostart
- добавление службы Solr для автоматического запуска.по умолчанию:
True
solr_copy_default_configsets
- копирование OOTB (из коробки) конфигураций в папку {{ solr_home }}/configsetsпо умолчанию: False
https://lucene.apache.org/solr/guide/7_1/enabling-ssl.html
solr_local_keystore
- если True - искать хранилище ключей на хосте ansible по {{ solr_local_keystore_path }}. Если False - проверять хранилище ключей на удаленном хосте.по умолчанию:
True
solr_local_keystore_path
- путь к локальному файлу хранилища ключей (чтобы не создавать самоподписанный)по умолчанию:
{{ role_path }}/files/{{ solr_ssl_key_store_name }}
solr_ssl_configure
- настройка SSLпо умолчанию:
True
solr_ssl_key_size
- размер ключа сертификатапо умолчанию: 4096
solr_ssl_key_store_path
- директория для хранения хранилища ключейпо умолчанию:
{{ solr_dest_path }}/server/solr
solr_ssl_key_store_name
- имя хранилища ключей. Если файл с таким именем существует в папке роли/files - он будет использован как хранилище ключей.по умолчанию:
solr-ssl.keystore.jks
solr_ssl_key_store
- путь к хранилищу ключей Solr.по умолчанию:
{{ solr_ssl_key_store_path }}/{{ solr_ssl_key_store_name }}
solr_ssl_key_store_password
- пароль для хранилища ключейпо умолчанию:
123456
solr_ssl_trust_store
- путь к хранилищу доверенных сертификатовпо умолчанию:
{{ solr_ssl_key_store_path }}/{{ solr_ssl_key_store_name }}
solr_ssl_trust_store_password
- пароль для доверенного хранилища ключейпо умолчанию:
123456
solr_ssl_need_client_auth
- параметры аутентификации клиентапо умолчанию:
false
solr_ssl_want_client_auth
- параметры аутентификации клиентапо умолчанию:
false
solr_ssl_key_store_type
- тип хранилища ключейпо умолчанию:
JKS
solr_ssl_trust_store_type
- тип хранилища доверительных сертификатовпо умолчанию:
JKS
solr_ssl_check_peer_name
- Установка этого параметра в false может быть полезна для отключения этих проверок при повторном использовании сертификата на многих хостахпо умолчанию:
true
solr_ssl_certificate_provider
- только для ОС Linux. https://docs.ansible.com/ansible/latest/openssl_certificate_module.htmlпо умолчанию:
selfsigned
solr_ca_domain
- доменное имя сертификатапо умолчанию:
example.com
local_cert_file_path
- путь к приватному сертификатупо умолчанию:
/etc/pki/tls/private
для RHELпо умолчанию:
/etc/ssl/private
для Debiansolr_local_pkey_file_name
- имя приватного сертификатапо умолчанию:
{{ ansible_hostname }}.ca-pkey.pem
local_cert_file_path
- путь к публичному сертификатупо умолчанию:
/etc/pki/tls/certs
для RHELпо умолчанию:
/etc/ssl/certs
для Debiansolr_local_cert_file_name
- имя публичного сертификатапо умолчанию:
{{ ansible_hostname }}.ca-cert.pem
solr_set_limits
- установка лимитовпо умолчанию:
True
solr_open_files_limit
- значение лимита открытых файлов в Linuxпо умолчанию:
65000
solr_max_processes_limit
- значение лимита максимальных процессов в Linuxпо умолчанию:
65000
Переменные для Windows
solr_win_temp_dir
- временная директорияпо умолчанию:
C:\Windows\Temp
solr_win_ssl_subj
- субъект CSRпо умолчанию:
/C=BY/ST=Minsk/L=Minsk/O=O/OU=IT/CN={{ solr_ca_domain }}
Пример инвентаря
[solr]
solr.example.com
[solrwin]
solrwin.example.com
[solrwin:vars]
ansible_user=admin
ansible_password=password
ansible_connection=winrm
ansible_winrm_server_cert_validation=ignore
Пример плейбука
- name: Установить и настроить Solr
hosts: solr
vars:
solr_change_default_password: False
roles:
- role: lean_delivery.java
- role: lean_delivery.solr_standalone
Лицензия
Apache
Информация об авторе
авторы:
- Команда Lean Delivery team@lean-delivery.com
Lean Delivery Solr installation and configurationn
ansible-galaxy install lean-delivery/ansible-role-solr-standalone