Elasticsearch auf vServer installieren

0. Überblick

• Verwendetes System: Debian 11 64 bit  (vServer XXL 2.0)
• Genutzter User: Ich nehme alles als «root» vor
• Zeitdauer: ca. 5 Minuten
• Schwierigkeit: Einfach. Nur Code kopieren 😉
• Besonderheiten: Die Installation von Docker / Docker Compose wird hier vorausgesetzt.

1. Elasticsearch Installieren

1.1 Einleitung

Elasticsearch (https://www.elastic.co/de/elasticsearch) ist eine RESTful-Suchmaschine und Analytics Engine. Das Kernstück ist der Elastic Stack, welche die Daten speichert und eine schnelle Suche ermöglicht.

1.2 Infos zu yml Dateien

Bei yml Dateien ist es sehr wichtig, dass die Zeilen alle richtig eingerückt sind. Die Zeilen MÜSSEN immer mit der Leertaste eingerückt werden. Es dürfen KEINE Tabs enthalten sein. Sie können den nachfolgenden Code immer online «überprüfen» lassen. Die meisten Fehler entstehen nämlich durch die falsche Formatierung. Ein Dienst zum Überprüfen ist zum Beispiel: https://codebeautify.org/yaml-validator

1.3 Vorbereitung

Diese Anleitung basiert auf dem aktuellen Debian 10 Betriebssystem. Elasticsearch werden wir unter Docker realisieren. Dies ermöglicht uns später sehr schnelle Updates und eine schnelle Installation.

1.3.1 Verzeichnis erstellen

Wir erstellen uns ein neues Verzeichnis, in welchem wir später alle Daten von Elasticsearch abspeichen. Dazu geben Sie folgendes in der Konsole ein:

mkdir -p /opt/containers/elasticsearch/data
chmod 777 -R /opt/containers/elasticsearch/data

Sie können hier auch ein anderes Verzeichnis verwenden. Müssen dann aber die gesamte Anleitung entsprechend anpassen.

1.3.2 docker-compose.yml erstellen

Nun können wir mit der eigentlichen «Installation» von Elasticsearch beginnen. Dazu öffnen Sie folgende Datei:

nano /opt/containers/elasticsearch/docker-compose.yml

Nun kopieren Sie folgenden Code in die Datei. Dieser Code ist unser Bauplan für unseren Elasticsearch Container.

version: '3.3' 

services: 

  elasticsearch: 

    image: elasticsearch:7.14.0 

    container_name: elasticsearch 

    restart: unless-stopped 

    environment: 

      - discovery.type=single-node 

    ulimits: 

      memlock: 

        soft: -1 

        hard: -1 

    volumes: 

      - /opt/containers/elasticsearch/data:/usr/share/elasticsearch/data 

    ports: 

      - "9200:9200" 

      - "9300:9300"

2. Elasticsearch starten

Geben Sie nun folgendes ein, um Ihren Elasticsearch Container zu starten:

docker compose -f /opt/containers/elasticsearch/docker-compose.yml up -d 

3. Elasticsearch testen

Führen Sie nun auf Ihrem Server folgenden Befehl aus:

curl -X GET 'http://localhost:9200'

Hier sehen Sie meine Ausgabe:

Wenn Sie auch so etwas sehen, dann haben Sie Elasticsearch korrekt installiert.

4. Elasticsearch nutzen

4.1 Daten hinzufügen

Hier zeige ich Ihnen, wie Sie neue Daten zu Elasticsearch hinzufügen. Dazu geben Sie folgendes ein:

curl -XPOST -H "Content-Type: application/json" 'http://localhost:9200/dogado/ersterCode/1' -d '{ "message": "Hallo Dogado!" }'

Wenn alles korrekt funktioniert hat, sollten Sie so eine Ausgabe sehen:

{"_index":"dogado","_type":"ersterCode","_id":"1","_version":1,"result":"created","_shards":{"total":2,"successful":1,"failed":0},"_seq_no":0,"_primary_term":1}

Erklärung des Befehls: Das Programm curl hat für uns eine POST Anfrage an den Server geschickt. Dabei haben wir folgende Parameter mitgegeben.

Dogado: Index der Daten

ersterCode: Typ

1: die ID

4.2 Daten auslesen

Mit folgendem Code können wir unsere Daten wieder auslesen:

curl -X GET -H "Content-Type: application/json" 'http://localhost:9200/dogado/ersterCode/1'

Nun sollten Sie folgende Ausgabe sehen:

{"_index":"dogado","_type":"ersterCode","_id":"1","_version":1,"_seq_no":0,"_primary_term":1,"found":true,"_source":{ "message": "Hallo Dogado!" }}