Apache Solr を Linux サーバーにインストールします。
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_install_dir
Solr のインストール スクリプトによって使用されます。 Solr < 5 の場合、Solr インストール ファイルはsolr_install_path
の所定の場所にコピーされます。
solr_home: /var/solr
ローカル Solr データ (検索コレクションと構成) が保存されるパス。 Solr のアップグレードを容易にするために、通常はsolr_path
の外側に置く必要があります。
solr_port: "8983"
Solr が実行されるポート。
solr_xms: "256M"
solr_xmx: "512M"
JVM のメモリ設定。これらは、最高のパフォーマンスを実現し、OOM 状況による Solr 自体の再起動の可能性を減らすために、可能な限り高く設定する必要があります。
solr_timezone: "UTC"
solr を実行する JVM のデフォルトのタイムゾーン。 dataimport およびデルタ インポートを使用する場合 (例: 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 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
MIT / BSD
このロールは、Ansible for DevOps の著者である Jeff Geerling によって 2014 年に作成されました。