HOWTO · MongoDB

So installieren und verwenden Sie Elasticsearch mit MongoDB unter Windows und Ubuntu

Installieren Sie Elasticsearch unter Windows 10 oder Ubuntu 20.04, überprüfen Sie es lokal und verstehen Sie, wie Sie es für die Suche mit MongoDB kombinieren.

Auf dieser Seite

Elasticsearch kann neben MongoDB laufen, um eine Volltextsuche über ausgewählte Anwendungsdaten bereitzustellen. MongoDB bleibt die maßgebliche Datenquelle; eine Anwendung oder ein anderer Integrationsprozess muss Änderungen in einen Elasticsearch-Index kopieren. Diese Anleitung behandelt das Starten von Elasticsearch unter Windows 10 oder Ubuntu 20.04, das Überprüfen seines lokalen Endpunkts und die Entscheidungen, die bei einer Node.js-Integration eine Rolle spielen.

Was ist Elasticsearch

Elasticsearch ist eine verteilte Such- und Analysemaschine, die auf Apache Lucene aufbaut. Sie indiziert JSON-Dokumente, damit Anwendungen Text durchsuchen und strukturierte Felder filtern können. MongoDB speichert Anwendungsdokumente und unterstützt Allzweckabfragen; Elasticsearch verwaltet einen separaten, für das Abrufen optimierten Suchindex. Es ist kein Ersatz für MongoDB, und die beiden Speicher synchronisieren sich nicht automatisch.

Der Index ist abgeleitete Daten. Planen Sie, wie Sie ihn anfänglich befüllen, spätere Einfügungen, Aktualisierungen und Löschungen weitergeben und ihn neu aufbauen, wenn er zurückfällt oder sich seine Zuordnung ändert.

Elasticsearch unter Windows 10 installieren

  1. Wählen Sie eine Elasticsearch-Distribution, die die Windows-Version und die für diese Version angegebenen Anforderungen an die Java-Laufzeitumgebung unterstützt. Das offizielle Archiv kann ein mitgeliefertes JDK enthalten; prüfen Sie die Installationshinweise der Version, bevor Sie Java separat installieren. Verlassen Sie sich nicht auf die alten Mindestanforderungen Java 7 oder Java 8 als allgemeine Anforderungen.
  2. Laden Sie das Windows-Archiv von der offiziellen Elasticsearch-Downloadseite von Elastic herunter und extrahieren Sie es in ein Verzeichnis, in das Ihr Konto schreiben kann. Der Archivaufbau und die Sicherheitsvorgaben variieren je nach Version.
  3. Öffnen Sie die Eingabeaufforderung oder PowerShell im extrahierten bin-Verzeichnis von Elasticsearch und starten Sie elasticsearch.bat. Lassen Sie dieses Fenster geöffnet, solange der Vordergrundprozess läuft. Verwenden Sie für einen dauerhaften Dienst die für die gewählte Version dokumentierte Diensteinrichtung, anstatt das Vordergrundfenster als Dienstinstallation zu behandeln.
  4. Lassen Sie die Sicherheitsfunktionen der Version aktiviert. Elasticsearch 8 und neuer aktivieren die Sicherheit standardmäßig; verwenden Sie die generierten Anmeldedaten oder konfigurieren Sie einen geeigneten Benutzer und TLS-Einstellungen. Setzen Sie xpack.security.enabled: false nicht bei einer über das Netzwerk erreichbaren Instanz. Das Deaktivieren der Sicherheit eignet sich nur für ein isoliertes lokales Experiment ohne unvertrauenswürdigen Netzwerkzugriff.
  5. Überprüfen Sie http://localhost:9200 in einem Browser oder fordern Sie es mit curl an. Ein fehlerfreier gesicherter Knoten kann nach Anmeldedaten fragen oder eine Authentifizierungsantwort zurückgeben; das zeigt dennoch, dass der Endpunkt erreichbar ist. Verwenden Sie die Anmeldedaten und HTTPS-Details, die während der Einrichtung ausgegeben oder konfiguriert wurden.

Wenn der Endpunkt nicht antwortet, prüfen Sie das Startfenster auf Bootstrap- oder Konfigurationsfehler, bestätigen Sie, dass der Prozess noch läuft, und vergewissern Sie sich, dass kein anderer Prozess Port 9200 verwendet.

Elasticsearch unter Ubuntu 20.04 installieren

  1. Wählen Sie eine Version, deren Unterstützung und Paketanforderungen Ubuntu 20.04 umfassen. Öffnen Sie die offizielle APT-Installationsanleitung von Elastic und befolgen Sie die Schritte für Repository und Signaturschlüssel für die von Ihnen gewählte Version. Diese Schritte konfigurieren APT so, dass es dem Paketsignaturschlüssel von Elastic vertraut und Pakete aus dem Repository von Elastic abruft. Ältere Anweisungen auf Basis von apt-key sind veraltet; verwenden Sie die in der Anleitung gezeigte Keyring-Methode. Elasticsearch-Pakete enthalten üblicherweise ein geeignetes mitgeliefertes JDK, installieren Sie also nur dann ein separates Java-Paket, wenn die Anweisungen der gewählten Version dies erfordern.
  2. Nachdem Sie das Repository für die gewählte Version konfiguriert haben, aktualisieren Sie den Paketindex von APT mit sudo apt-get update und installieren Sie dann Elasticsearch mit sudo apt-get install elasticsearch. Wenn Sie wiederholbare Bereitstellungen benötigen, prüfen Sie die aus diesem Repository verfügbaren Versionen mit apt-cache madison elasticsearch und installieren Sie die genaue Paketversion mit sudo apt-get install elasticsearch=<package-version>. Verwenden Sie den von APT gemeldeten Versionsstring; die Repository-Zeile und die verfügbaren Versionen hängen von der in der Anleitung von Elastic gewählten Version ab.
  3. Starten und aktivieren Sie den Dienst mit sudo systemctl enable --now elasticsearch.service. Überprüfen Sie ihn mit sudo systemctl status elasticsearch.service; sehen Sie sich das Dienstjournal oder /var/log/elasticsearch/ an, wenn der Start fehlschlägt.
  4. Die Hauptkonfiguration ist normalerweise /etc/elasticsearch/elasticsearch.yml. Lassen Sie Authentifizierung und Transportsicherheit aktiviert und konfigurieren Sie die Netzwerkfreigabe bewusst. Eine Einzelknoten-Einrichtung ist nicht automatisch sicher für eine öffentliche Freigabe.
  5. Überprüfen Sie https://localhost:9200 mit den Anmeldedaten und der Zertifikatseinrichtung für Ihre Version. Eine Zertifikatswarnung kann bedeuten, dass der Client der lokalen CA nicht vertraut; überprüfen Sie das Zertifikat oder konfigurieren Sie den Client so, dass er der generierten CA vertraut, anstatt die Überprüfung zu deaktivieren.

Eine erfolgreiche lokale Antwort bestätigt, dass Elasticsearch läuft. Sie bestätigt nicht, dass MongoDB-Datensätze indiziert werden.

Warum Elasticsearch mit MongoDB verwenden

MongoDB ist im Allgemeinen der maßgebliche Speicher für Anwendungsdatensätze, während Elasticsearch Suchen über einen separat verwalteten Index bedient. Diese Kombination kann eine Volltextsuche bereitstellen, ohne den Suchindex zur einzigen Kopie der Daten zu machen. Suchergebnisse können hinter MongoDB zurückbleiben, daher sollten Anwendungen, die sofortige Konsistenz benötigen, diese Verzögerung berücksichtigen.

Eine Node.js-Integration benötigt eine MongoDB-Änderungsquelle, einen Elasticsearch-Client, der mit der gewählten Serverversion kompatibel ist, und eine explizite Indizierungsstrategie. Ein typischer Ablauf liest vorhandene Datensätze für den anfänglichen Index, schreibt jeden Datensatz mit einer stabilen Dokument-ID, die von seiner MongoDB-_id abgeleitet ist, nach Elasticsearch und wendet dann Einfügungen, Aktualisierungen und Löschungen an, sobald sie auftreten. Machen Sie Schreibvorgänge wiederholbar und idempotent, zeichnen Sie Fehler für eine Wiedergabe auf und stellen Sie eine Möglichkeit bereit, den Index abzugleichen oder neu aufzubauen. Überprüfen Sie ein Beispieldokument in MongoDB und fragen Sie das entsprechende Elasticsearch-Dokument ab, um beide Seiten zu verifizieren.

Das folgende Node.js-Beispiel zeigt die deterministische Zuordnung von einem MongoDB-Datensatz zu einer Elasticsearch-Dokument-ID und einem JSON-Body. Es läuft ohne einen der beiden Dienste; es zeigt nur die Form der Nutzlast, nicht ein Schreiben in eine Datenbank oder eine Synchronisierung.

const mongoRecord = {
  _id: "product-42",
  name: "Trail shoes",
  category: "footwear"
};

const elasticsearchDocument = {
  id: String(mongoRecord._id),
  document: {
    name: mongoRecord.name,
    category: mongoRecord.category
  }
};

console.log(JSON.stringify(elasticsearchDocument, null, 2));
{
  "id": "product-42",
  "document": {
    "name": "Trail shoes",
    "category": "footwear"
  }
}

Um diese Form in einer Anwendung zu verwenden, senden Sie id als Elasticsearch-Dokument-ID und document als dessen Quelle über einen gewarteten Elasticsearch-Client. Verbinden Sie dieses Schreiben mit der MongoDB-Änderungsbehandlung der Anwendung und behandeln Sie Wiederholungen und Löschungen explizit. Das Beispiel belegt nicht, dass ein bestimmter Client, ein bestimmtes Plugin oder eine bestimmte Elasticsearch-Version kompatibel ist.

Das ursprüngliche mongoosastic-Beispiel hängt von einem veralteten Mongoose-Plugin und einem kompatiblen Elasticsearch-Client ab. Seine Kompatibilität mit einer aktuellen Elasticsearch-Version ist hier nicht belegt, behandeln Sie dieses Snippet oder seine Erfolgsmeldungen also nicht als verifizierte Integration. Bevor Sie es übernehmen, bestätigen Sie, dass das Plugin die genauen Mongoose- und Elasticsearch-Versionen in Ihrem Projekt unterstützt. Verwenden Sie für eine neue Integration einen gewarteten Client und befolgen Sie dessen versionsspezifische Anleitung zu Indizierung und Change-Streams; ein bloßer Save-Callback allein beweist nicht, dass die Indizierung abgeschlossen wurde.