ansible role solr

Ansible 角色：Apache Solr

在 Linux 伺服器上安裝 Apache Solr。

要求

Java 必須在伺服器上可用。您可以使用geerlingguy.java角色輕鬆安裝 Java。確保安裝的 Java 版本符合 Solr 的最低要求（例如 Solr 6+ 的 Java 8）。

該角色目前已測試並可與 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_user是在此角色運行之前建立的，或者如果您使用 Solr 5+ 並且希望 Solr 自己的安裝腳本來設定用戶，請將solr_create_user設定為false 。預設情況下， solr_group等於solr_user ，但可以覆寫它以適合您自己的配置。

 solr_version: "8.11.2"

要安裝的 Apache Solr 版本。有關完整列表，請參閱可用的 Apache Solr 版本。

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

從中下載 Solr tarball 的 Apache 專案鏡像。如果下載速度慢或逾時，將映像設定為 Apache 映像下載網站建議的映像會很有用。

 solr_remove_cruft: false

是否從solr目錄中刪除不需要的文件和範例。

 solr_service_manage: true
solr_service_name: solr
solr_service_state: started

預設情況下，此角色將管理solr服務，確保它在系統啟動時啟用並正在運行。您可以透過設定solr_service_state: stopped來確保 Solr 停止，或者您可以透過設定solr_service_manage: false來完全停用此角色對solr服務的管理。在這種情況下，您可能還需要設定solr_restart_handler_enabled: false （稍後記錄）。

 solr_install_dir: /opt
solr_install_path: /opt/solr

Apache Solr 將安裝的路徑。對於 Solr 5+，Solr 的安裝腳本將使用solr_install_dir 。對於 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"

運行 solr 的 JVM 的預設時區。當使用資料匯入和增量匯入（例如：與 MySQL 外部資料來源進行比較）時，您可以根據需要覆寫此設定。閱讀 Apache Solr 的「使用日期」文件以了解更多背景資訊。

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

索爾選項。將此選項新增至該角色的部分原因是為了緩解 CVE-2021-44228。

 solr_cores:
  - collection1

伺服器上應存在的核心/集合的清單。將使用 Solr 附帶的預設範例配置來建立每一個（如果尚不存在）。請注意，此變數僅在使用 Solr 5+ 時適用。

 solr_connect_host: localhost

可存取 Solr 的主機名稱或 IP 位址。 localhost在大多數情況下應該可以工作，但在某些特殊情況下，您可能只能透過其他 IP 或主機名稱存取本機 Solr 實例。

 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"

Solr 將綁定到的主機名稱或 IP 位址。預設為0.0.0.0 ，允許 Solr 監聽所有介面。

依賴關係

沒有任何。

範例手冊

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

執照

麻省理工學院/BSD

作者資訊

該角色由 Ansible for DevOps 的作者 Jeff Geerling 於 2014 年創建。