So installieren Sie Apache Couch DB auf AlmaLinux 9

Apache CouchDB ist eine Open-Source NoSQL- und dokumentenorientierte Datenbank, die mehrere Formate und Protokolle zur Speicherung ihrer Daten unterstützt. Sie ist in Erlang geschrieben und kann als hochleistungsfähige Einzelknoten-Datenbank betrieben werden.

Apache CouchDB ermöglicht es Ihnen, JSON zur Speicherung von Daten zu verwenden, und bietet auch eine Web-Benutzeroberfläche zur Verwaltung des CouchDB-Systems sowie eine HTTP-API, die es Ihnen ermöglicht, Daten einfach abzufragen.

In diesem Leitfaden führen wir Sie durch die Installation von Apache CouchDB auf dem AlmaLinux 9-Server. Sie werden Apache CouchDB in einem Einzelknoten-Cluster installieren und einen Administrationsbenutzer sowie firewalld für CouchDB einrichten. Darüber hinaus lernen Sie, wie Sie eine Datenbank und ein Dokument in Apache CouchDB über die Web-Benutzeroberfläche und die HTTP-API mit Curl erstellen.

Voraussetzungen

Um diesen Leitfaden abzuschließen, müssen Sie Folgendes haben:

• Einen AlmaLinux 9-Server.
• Einen Nicht-Root-Benutzer mit Administratorrechten.
• Ein SELinux im permissiven Modus.

Einrichten des Apache CouchDB-Repositorys

Apache CouchDB ist eine plattformübergreifende NoSQL-Datenbank, die auf Linux, Windows, macOS und FreeBSD sowie Containertechnologien wie Docker und Kubernetes installiert werden kann. Für RHEL-basierte Distributionen installieren Sie CouchDB aus dem offiziellen Repository über DNF.

Zuerst führen Sie den folgenden Befehl aus, um die dnf-plugins-core auf Ihrem AlmaLinux-Server zu installieren.

sudo dnf install dnf-plugins-core -y

Fügen Sie das Apache CouchDB-Repository mit dem folgenden Befehl zu Ihrem System hinzu

sudo dnf config-manager --add-repo https://couchdb.apache.org/repo/couchdb.repo

Führen Sie nun den dnf-Befehl unten aus und überprüfen Sie die verfügbaren Repositories auf Ihrem System. Stellen Sie sicher, dass das Apache CouchDB-Repository hinzugefügt wurde.

sudo dnf repolist

Nachdem Sie das Repository hinzugefügt haben, installieren Sie das Apache CouchDB-Paket mit dem folgenden dnf-Befehl.

sudo dnf install couchdb

Geben Sie y ein und drücken Sie ENTER, um fortzufahren.

Wenn Sie nach dem Apache CouchDB GPG-Schlüssel gefragt werden, geben Sie y ein, um den Schlüssel zu Ihrem System hinzuzufügen.

Sobald die Installation abgeschlossen ist, fahren Sie fort.

Installation von Apache CouchDB über das Repository

Nachdem Sie CouchDB über DNF installiert haben, werden Sie die Standardkonfiguration von CouchDB ändern, das Einzelknoten-Cluster einrichten, den Administrationsbenutzer und das Passwort konfigurieren und dann die HTTP-Adresse mit einer lokalen Server-IP-Adresse einrichten.

Öffnen Sie die Standardkonfiguration /opt/couchdb/etc/local.ini mit dem nano-Editor-Befehl.

sudo nano /opt/couchdb/etc/local.ini

Fügen Sie im Abschnitt ‘[couchdb]‘ die folgende Zeile hinzu, um den Apache CouchDB-Einzelknoten einzurichten.

[couchdb]  
single_node=true

Speichern Sie die Datei und schließen Sie sie, wenn Sie fertig sind.

Erstellen Sie als Nächstes eine neue Konfiguration /opt/couchdb/etc/local.d/10-admins.ini mit dem folgenden nano-Editor-Befehl.

sudo nano /opt/couchdb/etc/local.d/10-admins.ini

Fügen Sie die folgende Konfiguration in die Datei ein und stellen Sie sicher, dass Sie den Administrationsbenutzer und das Passwort mit Ihren Daten ändern. Dieses Klartextpasswort wird automatisch verschlüsselt, wenn Apache CouchDB ausgeführt wird.

[admins]  
admin = password

Speichern Sie die Datei und schließen Sie sie, wenn Sie fertig sind.

Öffnen Sie nun die Standardkonfiguration /opt/couchdb/etc/default.ini mit dem folgenden nano-Editor-Befehl.

sudo nano /opt/couchdb/etc/default.ini

Ändern Sie im Abschnitt ‘[chttpd]‘ die Standard-‘bind_address‘ auf Ihre lokale IP-Adresse. Dadurch können Sie von Ihrem lokalen Computer aus zugreifen.

[chttpd]  
bind_address = 192.168.5.50

Speichern Sie die Datei und schließen Sie sie, wenn Sie fertig sind.

Führen Sie anschließend den systemctl-Befehl unten aus, um den couchdb-Dienst zu starten und zu aktivieren.

sudo systemctl start couchdb  
sudo systemctl enable couchdb

Überprüfen Sie zuletzt den couchdb-Dienst mit dem folgenden Befehl, um sicherzustellen, dass der Dienst läuft.

sudo systemctl status couchdb

Wenn CouchDB läuft, sollten Sie eine Ausgabe wie ‘active (running)‘ erhalten.

Konfigurieren von Firewalld

Jetzt, da CouchDB läuft, werden Sie firewalld einrichten, um die Ports 5984/tcp und 4369/tcp zu öffnen und den Zugriff auf Ihre Apache CouchDB-Installation zu ermöglichen.

Führen Sie den folgenden Befehl aus, um die Ports 5984/tcp und 4369/tcp für Apache CouchDB zu öffnen.

sudo firewall-cmd --permanent --add-port={5984/tcp,4369/tcp}

Laden Sie firewalld neu, um Ihre Änderungen anzuwenden.

sudo firewall-cmd --reload

Überprüfen Sie dann die Liste der verfügbaren Ports auf firewalld mit dem folgenden Befehl. Stellen Sie sicher, dass die Ports 5984/tcp und 4369/tcp verfügbar sind.

sudo firewall-cmd --list-all

Führen Sie zuletzt den curl-Befehl unten aus, um Apache CouchDB zu überprüfen.

curl http://192.168.5.50:5984/

Oder Sie können ‘jq‘ über DNF installieren und die JSON-Ausgabe analysieren, um sie lesbar zu machen.

sudo dnf install -y

Analysieren Sie die JSON-Ausgabe mit einem Befehl wie diesem:

curl http://192.168.5.50:5984/ | jq .

Wenn Ihre CouchDB-Installation erfolgreich ist, sollten Sie Folgendes erhalten.

Zugriff auf die Apache CouchDB-Webadministration

An diesem Punkt haben Sie Apache CouchDB und firewalld konfiguriert, und Sie sind bereit, auf die CouchDB-Installation zuzugreifen.

Um auf Apache CouchDB zuzugreifen, besuchen Sie Ihre Server-IP-Adresse, gefolgt von Port 5984 (d.h.: http://192.168.5.50:5984/_utils#setup) mit Ihrem bevorzugten Webbrowser. Sie sollten die Anmeldeseite von Apache CouchDB erhalten.

Geben Sie Ihren Administrationsbenutzer und Ihr Passwort ein und klicken Sie auf Login.

Wenn Sie den richtigen Benutzernamen und das richtige Passwort haben, sollten Sie das Administrations-Dashboard von Apache CouchDB erhalten.

Verwalten von Datenbanken in Apache CouchDB

Jetzt, da Sie sich im Administrations-Dashboard von Apache CouchDB angemeldet haben, ist der nächste Schritt, zu lernen, wie man eine Datenbank erstellt und Daten in CouchDB über die Web-Benutzeroberfläche und die HTTP-API mit Curl einfügt.

Grundlegende Verwaltungsoperationen über die Web-Benutzeroberfläche

Stellen Sie vor dem Start sicher, dass Sie sich im Administrations-Dashboard von Apache CouchDB angemeldet haben.

Zuerst werden Sie eine neue Datenbank über die Apache CouchDB-Weboberfläche erstellen:

Klicken Sie auf das Menü Datenbanken und klicken Sie auf die Schaltfläche Datenbank erstellen.

Geben Sie den neuen Datenbanknamen ein und klicken Sie auf Erstellen.

Jetzt, da Sie eine Datenbank in Apache CouchDB erstellt haben, klicken Sie auf den Namen Ihrer Datenbank.

Um ein neues Dokument zu erstellen, klicken Sie auf die Schaltfläche Dokument erstellen.

Geben Sie Ihre JSON-Daten ein und klicken Sie dann auf Dokument erstellen, um zu bestätigen.

{  
   "item": "apple",  
   "prices": {  
       "Fresh Mart": 1.59,  
       "Price Max": 5.99,  
       "Apples Express": 0.79  
   }  
}

Sobald das Dokument erstellt ist, sollten Sie das Ergebnis ‘Dokument speichern‘ erhalten.

In den Details Ihrer Datenbank klicken Sie auf die Registerkarte Tabelle, und Sie sollten das JSON-Dokument sehen, das Sie erstellt haben.

Wenn Sie das Dokument ändern müssen, klicken Sie auf den Dokumentnamen, bearbeiten Sie Ihr Dokument und klicken Sie dann auf Änderungen speichern. Außerdem können Sie Dokumente von dort mit der Schaltfläche zum Löschen im rechten Menü löschen.

Grundlegende Datenbankoperationen mit Curl

Im folgenden Abschnitt lernen Sie, wie Sie eine Datenbank erstellen und Daten über die HTTP-API mit Curl in Apache CouchDB einfügen.

Führen Sie zuerst den folgenden Befehl aus, um sich bei Apache CouchDB zu authentifizieren und verfügbare Datenbanken über curl aufzulisten. Stellen Sie sicher, dass Sie den Administrationsbenutzer und das Passwort mit Ihren Daten ändern.

curl -X GET http://admin:[email protected]:5984/_all_dbs | jq .

Wenn erfolgreich, sollten Sie die Datenbank fruits sehen, die Sie über die verfügbare Weboberfläche erstellt haben.

Erstellen Sie nun eine neue CouchDB-Datenbank mit der PUT-Option in einem curl wie folgt.

curl -X PUT http://admin:[email protected]:5984/players | jq .

Sobald die Datenbank erstellt ist, sollten Sie eine Ausgabe wie folgt erhalten:

Überprüfen Sie nach der Erstellung der Datenbank die Details der Datenbank players mit dem folgenden Befehl.

curl -X GET http://admin:[email protected]:5984/players | jq .

Die folgende Ausgabe wird angezeigt:

Um ein neues Dokument zu erstellen und Daten in CouchDB einzufügen, verwenden Sie den folgenden curl-Befehl.

curl -X PUT http://admin:[email protected]:5984/players/documents \  
-d '{"Name": "Nikola Jokic", "Team": "Denver Nuggets"}' | jq .

Wenn erfolgreich, sollten Sie die Ausgabe ‘“ ok“: true’ erhalten.

Überprüfen Sie die Details Ihres Dokuments mit dem folgenden Befehl. Sie sollten sehen, dass Ihr Dokument in Apache CouchDB verfügbar ist.

curl -X GET http://admin:[email protected]:5984/players/documents

Sie sollten die Daten sehen, die Sie hinzugefügt haben, wie folgt.

Fazit

Herzlichen Glückwunsch! Sie haben Apache CouchDB erfolgreich auf dem AlmaLinux 9-Server installiert. Sie haben auch ein Einzelknoten-Cluster konfiguriert, einen Administrationsbenutzer und ein Passwort hinzugefügt und CouchDB so konfiguriert, dass sie unter der internen IP-Adresse läuft.

Darüber hinaus haben Sie auch gelernt, wie man eine neue Datenbank erstellt und Daten in CouchDB über die Web-Benutzeroberfläche und die HTTP-API mit Curl einfügt. Jetzt können Sie weitere Knoten hinzufügen und ein Apache CouchDB-Cluster einrichten, um Ihre Leistung zu maximieren.