Comment installer un cluster CockroachDB sur Debian 11

CockroachDB est une base de données SQL distribuée et évolutive open-source pour les applications cloud. CockroachDB offre une cohérence de niveau supérieur, une base de données SQL répliquée et un magasin de données transactionnelles. CockroachDB stocke vos données à plusieurs emplacements, ce qui rend la livraison des données plus rapide. De plus, il est facile à mettre à l’échelle et offre une haute disponibilité et une tolérance aux pannes pour vos applications.

Dans ce tutoriel, nous allons vous montrer comment installer le cluster CockroachDB sur un serveur Debian 11.

Prérequis

• Deux serveurs Debian 11 ou plus.
• Un mot de passe root est configuré sur les serveurs.

Installation de CockroachDB sur les 3 serveurs

Pour l’installation, cockroachdb est facile à installer. C’est parce que cockroachdb fournit un fichier binaire pour le système Linux que vous pouvez télécharger sur votre système.

Téléchargez le fichier binaire cockroachdb pour Linux en utilisant la commande suivante. Cette commande téléchargera le fichier binaire cockroachdb, extraira le fichier compressé, puis déplacera le fichier binaire de cockroachdb vers le répertoire /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/

Le cockroachdb utilise la bibliothèque GEOS intégrée personnalisée. La bibliothèque GEOS est incluse dans le fichier compressé de cockroachdb et doit être installée dans le répertoire lib.

Créez un nouveau répertoire /usr/local/lib/cockroach en utilisant la commande ci-dessous.

mkdir -p /usr/local/lib/cockroach

Maintenant, copiez la bibliothèque GEOS dans le répertoire /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/

L’installation de base de cockroachdb est installée sur les serveurs Debian.

Exécutez la commande suivante pour vérifier le fichier binaire cockroachdb et la version actuelle de cockroachdb que vous venez d’installer.

which cockroach  
cockroach version

Vous obtiendrez la sortie suivante.

Configuration du pare-feu

Si vous exécutez le pare-feu sur vos serveurs Debian, vous devrez ajouter les ports cockroachdb à la configuration du pare-feu.

Le cockroachdb utilise le port 8080 pour l’administration web de cockroachdb, et le port 26257 pour les connexions utilisateur et la configuration du cluster.

Ajoutez les ports 8080 et 25267 au pare-feu UFW en utilisant la commande suivante.

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

Maintenant, rechargez les règles du pare-feu UFW et vérifiez l’état actuel des règles du pare-feu.

sudo ufw reload  
sudo ufw status

Vous pouvez voir ci-dessous que les ports 8080 et 25267 ont été ajoutés au pare-feu UFW.

Initialisation du cluster CockroachDB

Pour initialiser le cluster cockroachdb, exécutez la commande ci-dessous sur le serveur11.

Vous devrez changer la valeur des options suivantes :

• –store: pour stocker les données du cluster CockroachDB.
• –listen-addr: sur quelle adresse IP le cockroachdb sera exécuté sur le serveur. Le port par défaut pour cockroachdb est le port 25267.
• –http-addr: sur quelle adresse IP l’administration web de cockroachdb sera exécutée. L’administration web par défaut de cockroachdb est le 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

Vous obtiendrez la sortie suivante.

Maintenant, passez à server2 et exécutez la commande suivante pour démarrer le cockroachdb et rejoindre le cluster. Changez l’adresse IP sur –listen-addr et –http-addr pour l’adresse IP de 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

Vous obtiendrez la sortie suivante de server2.

Ensuite, passez à server3 et exécutez la commande suivante pour démarrer le cockroachdb et rejoindre le cluster cockroachdb. Changez également l’adresse IP de –listen-addr et –http-addr pour l’adresse IP de 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

Vous obtiendrez la sortie suivante de server3.

Après que tout soit terminé, revenez au server11 et exécutez la commande ci-dessous pour initialiser le cluster cockroachdb.

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

Vous obtiendrez le message de sortie ‘cluster successfully initialized‘, ce qui signifie que le cluster cockroachdb est initialisé avec succès.

Vous pouvez exécuter la commande grep ci-dessous pour vérifier le journal de l’initialisation de cockroachdb. Changez le répertoire server11 avec votre répertoire cockroachdb –store.

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

Vous pouvez voir ci-dessous les journaux de l’initialisation du cluster cockroachdb de server11.

Enfin, ouvrez votre navigateur web et visitez l’adresse IP du serveur suivie du port 8080.

http://192.168.10.11:8080/

Vous pouvez voir qu’il y a trois nœuds sur le cluster cockroachdb.

Tester la création d’une nouvelle base de données sur CockroachDB

Maintenant que le cluster cockroachdb fonctionne, vous pouvez utiliser n’importe quel serveur comme passerelle SQL pour accéder au cockroachdb.

Exécutez la commande cockroach sur le server11 pour vous connecter au cluster cockroachdb.

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

Après vous être connecté à l’interface SQL, exécutez la requête ci-dessous pour créer une nouvelle base de données.

CREATE DATABASE bank;

Maintenant, créez une nouvelle table dans la base de données en utilisant la requête suivante.

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

Ensuite, importez des données d’exemple dans la table.

INSERT INTO bank.accounts (1, 1000.50);

Vérifiez les données dans la base de données en utilisant la requête suivante.

SELECT * FROM bank.accounts;

Vous obtiendrez la sortie suivante.

Ensuite, passez à server2 ou server3 et connectez-vous à l’interface SQL de cockroachdb en utilisant la commande suivante.

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

Après vous être connecté à l’interface SQL sur server3, exécutez la requête suivante pour vérifier et valider la réplication de la base de données.

SELECT * FROM bank.accounts;

Vous verrez que la base de données et les données de server11 sont automatiquement répliquées sur server2 et server3.

Conclusion

Félicitations ! Vous avez maintenant installé et configuré le cluster cockroachdb sur les serveurs Debian 11. De plus, vous avez appris à vous connecter à l’interface cockroachdb et à utiliser des commandes SQL de base pour créer une base de données et insérer des données.