So installieren Sie einen CockroachDB-Cluster auf Debian 11

CockroachDB ist eine Open-Source, verteilte und skalierbare SQL-Datenbank für Cloud-Anwendungen. CockroachDB bietet Konsistenz auf einem neuen Niveau, replizierte SQL-Datenbanken und einen transaktionalen Datenspeicher. CockroachDB speichert Ihre Daten an mehreren Standorten, was die Datenbereitstellung schneller macht. Außerdem ist es einfach zu skalieren und bietet hohe Verfügbarkeit und Fehlertoleranz für Ihre Anwendungen.

In diesem Tutorial zeigen wir Ihnen, wie Sie den CockroachDB-Cluster auf einem Debian 11-Server installieren.

Voraussetzungen

• Zwei oder mehr Debian 11-Server.
• Ein Root-Passwort ist auf den Servern konfiguriert.

Installation von CockroachDB auf allen 3 Servern

Für die Installation ist CockroachDB einfach zu installieren. Das liegt daran, dass CockroachDB eine Binärdatei für das Linux-System bereitstellt, die Sie auf Ihr System herunterladen können.

Laden Sie die CockroachDB-Binärdatei für Linux mit dem folgenden Befehl herunter. Dieser Befehl lädt die CockroachDB-Binärdatei herunter, entpackt die komprimierte Datei und verschiebt dann die Binärdatei von CockroachDB in das Verzeichnis /usr/local/bin.

curl https://binaries.cockroachdb.com/cockroach-v21.2.8.linux-amd64.tgz | tar -xz && sudo cp -i cockroach-v21.2.8.linux-amd64/cockroach /usr/local/bin/

Die CockroachDB verwendet die benutzerdefinierte integrierte GEOS-Bibliothek. Die GEOS-Bibliothek ist in der komprimierten Datei von CockroachDB enthalten und muss im Verzeichnis lib installiert werden.

Erstellen Sie ein neues Verzeichnis /usr/local/lib/cockroach mit dem folgenden Befehl.

mkdir -p /usr/local/lib/cockroach

Kopieren Sie nun die GEOS-Bibliothek in das Verzeichnis /usr/local/lib/cockroach.

cp -i cockroach-v21.2.8.linux-amd64/lib/libgeos.so /usr/local/lib/cockroach/  
cp -i cockroach-v21.2.8.linux-amd64/lib/libgeos_c.so /usr/local/lib/cockroach/

Die grundlegende Installation von CockroachDB ist auf den Debian-Servern installiert.

Führen Sie den folgenden Befehl aus, um die CockroachDB-Binärdatei und die aktuelle Version von CockroachDB zu überprüfen, die Sie gerade installiert haben.

which cockroach  
cockroach version

Sie erhalten die folgende Ausgabe.

Firewall einrichten

Wenn Sie die Firewall auf Ihren Debian-Servern ausführen, müssen Sie die CockroachDB-Ports zur Firewall-Konfiguration hinzufügen.

Die CockroachDB verwendet den Port 8080 für die webbasierte Verwaltung von CockroachDB und den Port 26257 für die Benutzerverbindungen und die Clusterkonfiguration.

Fügen Sie die Ports 8080 und 25267 zur UFW-Firewall mit dem folgenden Befehl hinzu.

sudo ufw allow 8080/tcp  
sudo ufw allow 26257/tcp

Laden Sie nun die UFW-Firewall-Regeln neu und überprüfen Sie den aktuellen Status der Firewall-Regeln.

sudo ufw reload  
sudo ufw status

Unten sehen Sie, dass die Ports 8080 und 25267 zur UFW-Firewall hinzugefügt wurden.

Initialisierung des CockroachDB-Clusters

Um den CockroachDB-Cluster zu initialisieren, führen Sie den folgenden Befehl auf server11 aus.

Sie müssen den Wert der folgenden Optionen ändern:

• –store: zum Speichern der Daten des CockroachDB-Clusters.
• –listen-addr: auf welcher IP-Adresse die CockroachDB auf dem Server ausgeführt wird. Der Standardport für CockroachDB ist Port 25267.
• –http-addr: auf welcher IP-Adresse die webbasierte Verwaltung von CockroachDB ausgeführt wird. Die Standard-Webverwaltung von CockroachDB ist Port 8080.

cockroach start \  
--insecure \  
--store=server11 \  
--listen-addr=192.168.10.11:26257 \  
--http-addr=192.168.10.11:8080 \  
--join=192.168.10.11:26257,192.168.10.13:26258,192.168.10.14:26259 \  
--background

Sie erhalten die folgende Ausgabe.

Wechseln Sie nun zu server2 und führen Sie den folgenden Befehl aus, um die CockroachDB zu starten und dem Cluster beizutreten. Ändern Sie die IP-Adresse bei –listen-addr und –http-addr auf die IP-Adresse von server2.

cockroach start \  
--insecure \  
--store=server2 \  
--listen-addr=192.168.10.13:26257 \  
--http-addr=192.168.10.13:8080 \  
--join=192.168.10.11:26257,192.168.10.13:26258,192.168.10.14:26259 \  
--background

Sie erhalten die folgende Ausgabe von server2.

Wechseln Sie als Nächstes zu server3 und führen Sie den folgenden Befehl aus, um die CockroachDB zu starten und dem CockroachDB-Cluster beizutreten. Ändern Sie auch die IP-Adresse von –listen-addr und –http-addr auf die IP-Adresse von server3.

cockroach start \  
--insecure \  
--store=server3 \  
--listen-addr=192.168.10.14:26257 \  
--http-addr=192.168.10.14:8080 \  
--join=192.168.10.11:26257,192.168.10.13:26258,192.168.10.14:26259 \  
--background

Sie erhalten die folgende Ausgabe von server3.

Nachdem alles abgeschlossen ist, kehren Sie zu server11 zurück und führen Sie den folgenden Befehl aus, um den CockroachDB-Cluster zu initialisieren.

cockroach init --insecure --host=192.168.10.11:26257

Sie erhalten die Ausgabemeldung ‘Cluster erfolgreich initialisiert‘, was bedeutet, dass der CockroachDB-Cluster erfolgreich initialisiert wurde.

Sie können den folgenden grep-Befehl ausführen, um das Protokoll der CockroachDB-Initialisierung zu überprüfen. Ändern Sie das Verzeichnis von server11 mit Ihrem –store CockroachDB-Verzeichnis.

grep 'node starting' server11/logs/cockroach.log -A 11

Unten sehen Sie die Protokolle von der Initialisierung des CockroachDB-Clusters auf server11.

Öffnen Sie schließlich Ihren Webbrowser und besuchen Sie die Server-IP-Adresse gefolgt von Port 8080.

http://192.168.10.11:8080/

Unten sehen Sie, dass es drei Knoten im CockroachDB-Cluster gibt.

Testen Sie die Erstellung einer neuen Datenbank in CockroachDB

Jetzt, wo der CockroachDB-Cluster läuft, können Sie jeden Server als SQL-Gateway verwenden, um auf die CockroachDB zuzugreifen.

Führen Sie den Cockroach-Befehl auf server11 aus, um eine Verbindung zum CockroachDB-Cluster herzustellen.

cockroach sql --insecure --host=192.168.10.11:26257

Nachdem Sie mit der SQL-Shell verbunden sind, führen Sie die folgende Abfrage aus, um eine neue Datenbank zu erstellen.

CREATE DATABASE bank;

Erstellen Sie nun eine neue Tabelle in der Datenbank mit der folgenden Abfrage.

CREATE TABLE bank.accounts (id INT PRIMARY KEY, balance DECIMAL);

Importieren Sie als Nächstes Beispieldaten in die Tabelle.

INSERT INTO bank.accounts (1, 1000.50);

Überprüfen Sie die Daten in der Datenbank mit der folgenden Abfrage.

SELECT * FROM bank.accounts;

Sie erhalten die folgende Ausgabe.

Wechseln Sie als Nächstes zu server2 oder server3 und melden Sie sich mit dem folgenden Befehl an der CockroachDB SQL-Shell an.

cockroach sql --insecure --host=192.168.10.14:26257

Nachdem Sie mit der SQL-Shell auf server3 verbunden sind, führen Sie die folgende Abfrage aus, um die Datenbankreplikation zu überprüfen und zu verifizieren.

SELECT * FROM bank.accounts;

Sie werden sehen, dass die Datenbank und die Daten von server11 automatisch auf server2 und server3 repliziert werden.

Fazit

Herzlichen Glückwunsch! Sie haben jetzt den CockroachDB-Cluster auf Debian 11-Servern installiert und konfiguriert. Außerdem haben Sie gelernt, wie Sie sich mit der CockroachDB-Shell verbinden und grundlegende SQL-Befehle zum Erstellen einer Datenbank und Einfügen von Daten verwenden.