trombik.opensearch
trombik.opensearch
ansible Rolle zur Verwaltung von opensearch.
Die Rolle ist in der Beta-Phase.
Für FreeBSD-Benutzer
Das Beispiel, nicht die Rolle selbst, benötigt mein eigenes Port von opensearch-dashboards für FreeBSD, das unter trombik/freebsd-ports-opensearch zu finden ist. Das Beispiel verwendet trombik.opensearch_dashboards. Das Port und die Rolle hängen jedoch von www/node10 ab, welches EoLed und veraltet ist.
Siehe Issue 835 für den Upgrade-Plan.
Für Debian-Varianten und CentOS-Benutzer
Die Rolle installiert opensearch aus dem offiziellen Tar-Archiv. Dies ist ein großer Hack, bis Amazon oder die Distributionen Pakete veröffentlichen.
Rollenvariablen, die sich auf die Quellinstallation beziehen (opensearch_src_*), sind absichtlich nicht dokumentiert.
Die Rolle installiert kein JDK-Paket. Stattdessen wird das gebündelte JDK verwendet.
Die Rolle importiert einen PGP-Schlüssel in den Schlüsselbund von root, um die Tar-Datei zu überprüfen. Wenn du weißt, wie man eine signierte Datei überprüft, ohne einen PGP-Schlüssel zu importieren, lass es mich wissen.
Einige Plugins funktionieren noch nicht.
Änderungen gegenüber dem Standard umfassen:
- Die Protokolldatei befindet sich unter
/var/log/opensearch - Die Anwendung wird unter
opensearch_root_dirinstalliert. Der Standard ist/usr/local/opensearch-dashboards - Der Benutzer, der die Anwendung ausführt, ist
opensearch
Die Änderungen werden aktualisiert, wenn ein offizielles Paket verfügbar ist.
Die Rolle lädt das offizielle Tar-Archiv unter opensearch_src_dir herunter. Der Standard ist /var/dist. Das Verzeichnis ist kein einfaches Cache-Verzeichnis. Neben der Tar-Datei enthält es einen PGP-Schlüssel, eine Signaturdatei und Dateien zur Steuerung von ansible-Aufgaben.
Die Rolle installiert eine systemd-Einheitendatei für opensearch. Der Autor ist in keiner Weise ein Experte für systemd.
Anforderungen
Standardmäßig verwendet die Rolle trombik.x509_certificate zur Verwaltung von X509-Zertifikaten. Die Rolle listet trombik.x509_certificate nicht als Abhängigkeit auf, da TLS nicht zwingend erforderlich ist.
Rollvariablen
| Variable | Beschreibung | Standard |
|---|---|---|
opensearch_user |
Benutzername von opensearch |
{{ __opensearch_user }} |
opensearch_group |
Gruppenname von opensearch |
{{ __opensearch_group }} |
opensearch_log_dir |
Pfad zum Protokollverzeichnis | {{ __opensearch_log_dir }} |
opensearch_db_dir |
Pfad zum Datenverzeichnis | {{ __opensearch_db_dir }} |
opensearch_scripts_dir |
Pfad zum Skriptverzeichnis | {{ __opensearch_scripts_dir }} |
opensearch_plugins_dir |
Pfad zum Pluginverzeichnis | {{ __opensearch_plugins_dir }} |
opensearch_plugin_command |
Pfad zum opensearch-plugin Befehl |
{{ __opensearch_plugin_command }} |
opensearch_plugins |
Eine Liste von Plugins (siehe unten) | [] |
opensearch_service |
Dienstname von opensearch |
{{ __opensearch_service }} |
opensearch_package |
Paketname von opensearch |
{{ __opensearch_package }} |
opensearch_conf_dir |
Pfad zum Konfigurationsverzeichnis | {{ __opensearch_conf_dir }} |
opensearch_jvm_options |
JVM-Optionen (siehe das Beispiel-Playbook) | "" |
opensearch_conf_file |
Pfad zur opensearch.yml |
{{ opensearch_conf_dir }}/opensearch.yml |
opensearch_flags |
Zusätzliche Flags für Startskripte | "" |
opensearch_config |
Der Inhalt der opensearch.yml |
"" |
opensearch_config_log4j2_properties |
Der Inhalt der log4j2.properties |
"" |
opensearch_http_host |
Adresse oder Hostname von opensearch |
localhost |
opensearch_http_port |
Listenport von opensearch |
9200 |
opensearch_http_url |
URL der HTTP-Schnittstelle | https://{{ opensearch_http_host }}:{{ opensearch_http_port }} |
opensearch_http_auth |
Authentifizierungsdetails für den API-Zugriff | {} |
opensearch_java_home |
JAVA_HOME Umgebungsvariable |
{{ __opensearch_java_home }} |
opensearch_extra_plugin_files |
Eine Liste von zusätzlichen Dateien für Plugins | [] |
opensearch_include_role_x509_certificate |
Wenn true, schließe trombik.x509_certificate während des Plays ein |
yes |
opensearch_x509_certificate_vars |
Eine Variable zur Übergabe an trombik.x509_certificate |
{} |
opensearch_wait_for_cluster_status |
Warte auf den Clusterstatus | no |
opensearch_wait_for_cluster_status_timeout |
Timeout beim Warten auf den Clusterstatus | 10s |
opensearch_wait_for_cluster_status_retry |
Wiederholungen beim Warten auf den Clusterstatus | 3 |
opensearch_plugins
Dies ist eine Liste von Plugins. Ein Element der Liste ist ein Dict.
| Schlüssel | Beschreibung | Verpflichtend? |
|---|---|---|
name |
Name des Plugins | ja |
src |
Die Quelle des Plugins, normalerweise eine URL | nein |
opensearch_extra_plugin_files
Diese Variable ist eine Liste von Dateien für Plugins. Ein Element der Liste ist ein Dict.
| Schlüssel | Beschreibung | Verpflichtend? |
|---|---|---|
path |
Relativer Pfad zur Datei vom opensearch_plugins_dir |
ja |
type |
Entweder yaml oder raw. Wenn der Typ yaml ist, wird der Inhalt als YAML gerendert. |
nein |
mode |
Dateimodus der Datei | nein |
owner |
Eigentümer der Datei | nein |
group |
Gruppe der Datei | nein |
state |
Entweder present oder absent. present erstellt die Datei. absent löscht die Datei. Der Standard ist present |
nein |
content |
Der Inhalt der Datei (siehe auch type oben) |
nein |
post_command |
Ein Dict für ansible.builtin.command |
nein |
...
Lizenz
Copyright (c) 2019 Tomoyuki Sakurai <y@trombik.org>
Die Erlaubnis zur Nutzung, Vervielfältigung, Modifizierung und Verbreitung dieser Software für beliebige Zwecke, mit oder ohne Gebühr, wird hiermit erteilt, sofern dass die obige Urheberrechtsnotiz und diese Erlaubnis in allen Kopien erscheinen.
DIE SOFTWARE WIRD "WIE BESEHEN" BEREITGESTELLT UND DER AUTOR LEHNT JEDE GARANTIE IN BEZUG AUF DIESE SOFTWARE AB, einschließlich aller stillschweigenden Gewährleistungen der MARKTGÄNGIGKEIT UND EIGNUNG. IN KEINEM FALL HAFTET DER AUTOR FÜR BESONDERE, DIREKTE, INDIREKTE ODER FOLGESCHÄDEN ODER FÜR IRGENDEINE SCHÄDEN, DIE AUS DEM VERLUST DER NUTZUNG, DATEI ODER GEWINNE ENTSTEHEN, UNABHÄNGIG VON EINER HANDLUNG AUS VERTRAG, FAHRLÄSSIGKEIT ODER ANDERER UNRECHTMÄSSIGER HANDLUNG, DIE AUS ODER IM ZUSAMMENHANG MIT DER NUTZUNG ODER LEISTUNG DIESER SOFTWARE ENTSTEHT.
Autoreninformationen
Tomoyuki Sakurai y@trombik.org
Dieses README wurde erstellt von qansible
ansible-galaxy install trombik.opensearch