Come installare un cluster CockroachDB su Debian 11

CockroachDB è un database SQL distribuito e scalabile open-source per applicazioni cloud. CockroachDB fornisce coerenza di livello superiore, un database SQL replicato e un archivio dati transazionale. CockroachDB memorizza i tuoi dati in più posizioni rendendo la consegna dei dati più veloce. Inoltre, è facile da scalare e offre alta disponibilità e tolleranza ai guasti per le tue applicazioni.

In questo tutorial, ti mostreremo come installare il cluster CockroachDB su un server Debian 11.

Requisiti

• Due o più server Debian 11.
• Una password di root configurata sui server.

Installazione di CockroachDB su tutti e 3 i server

Per l’installazione, cockroachdb è facile da installare. Questo perché cockroachdb fornisce un file binario per il sistema Linux che puoi scaricare sul tuo sistema.

Scarica il file binario di cockroachdb per Linux utilizzando il seguente comando. Questo comando scaricherà il file binario di cockroachdb, estrarrà il file compresso e poi sposterà il file binario di cockroachdb nella directory /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/

Il cockroachdb utilizza la libreria GEOS integrata personalizzata. La libreria GEOS è inclusa nel file compresso di cockroachdb e deve essere installata nella directory lib.

Crea una nuova directory /usr/local/lib/cockroach utilizzando il comando qui sotto.

mkdir -p /usr/local/lib/cockroach

Ora copia la libreria GEOS nella directory /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’installazione di base di cockroachdb è installata sui server Debian.

Esegui il seguente comando per controllare il file binario di cockroachdb e la versione attuale di cockroachdb che hai appena installato.

which cockroach  
cockroach version

Otterrai il seguente output.

Configurazione del Firewall

Se stai eseguendo il Firewall sui tuoi server Debian, dovrai aggiungere le porte di cockroachdb alla configurazione del firewall.

Il cockroachdb utilizza la porta 8080 per l’amministrazione web di cockroachdb e la porta 26257 per le connessioni degli utenti e la configurazione del cluster.

Aggiungi le porte 8080 e 25267 al firewall UFW utilizzando il seguente comando.

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

Ora ricarica le regole del firewall UFW e verifica lo stato attuale delle regole del firewall.

sudo ufw reload  
sudo ufw status

Di seguito puoi vedere che le porte 8080 e 25267 sono state aggiunte al firewall UFW.

Inizializzazione del Cluster CockroachDB

Per inizializzare il cluster cockroachdb, esegui il comando qui sotto sul server11.

Dovrai cambiare il valore delle seguenti opzioni:

• –store: per memorizzare i dati del cluster CockroachDB.
• –listen-addr: su quale indirizzo IP il cockroachdb verrà eseguito sul server. La porta predefinita per cockroachdb è la porta 25267.
• –http-addr: su quale indirizzo IP l’amministrazione web di cockroachdb verrà eseguita. L’amministrazione web predefinita di cockroachdb è la porta 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

Otterrai il seguente output.

Ora spostati su server2 e esegui il seguente comando per avviare il cockroachdb e unirti al cluster. Cambia l’indirizzo IP su –listen-addr e –http-addr con l’indirizzo IP di 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

Otterrai il seguente output da server2.

Successivamente, spostati su server3 e esegui il seguente comando per avviare il cockroachdb e unirti al cluster cockroachdb. Cambia anche l’indirizzo IP di –listen-addr e –http-addr con l’indirizzo IP di 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

Otterrai il seguente output da server3.

Dopo che tutto è completato, torna a server11 e esegui il comando qui sotto per inizializzare il cluster cockroachdb.

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

Otterrai il messaggio di output ‘cluster inizializzato con successo‘, il che significa che il cluster cockroachdb è stato inizializzato con successo.

Puoi eseguire il comando grep qui sotto per controllare il log dell’inizializzazione di cockroachdb. Cambia la directory di server11 con la tua directory cockroachdb –store.

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

Di seguito puoi vedere i log dall’inizializzazione del cluster cockroachdb di server11.

Infine, apri il tuo browser web e visita l’indirizzo IP del server seguito dalla porta 8080.

http://192.168.10.11:8080/

Di seguito puoi vedere che ci sono tre nodi nel cluster cockroachdb.

Testare la creazione di un nuovo database su CockroachDB

Ora che il cluster cockroachdb è in esecuzione, puoi utilizzare qualsiasi server come gateway SQL per accedere al cockroachdb.

Esegui il comando cockroach su server11 per connetterti al cluster cockroachdb.

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

Dopo esserti connesso alla shell SQL, esegui la query qui sotto per creare un nuovo database.

CREATE DATABASE bank;

Ora crea una nuova tabella nel database utilizzando la seguente query.

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

Successivamente, importa dati di esempio nella tabella.

INSERT INTO bank.accounts (1, 1000.50);

Verifica i dati nel database utilizzando la seguente query.

SELECT * FROM bank.accounts;

Otterrai il seguente output.

Successivamente, spostati su server2 o server3 e accedi alla shell SQL di cockroachdb utilizzando il seguente comando.

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

Dopo esserti connesso alla shell SQL su server3, esegui la seguente query per controllare e verificare la replica del database.

SELECT * FROM bank.accounts;

Vedrai che il database e i dati da server11 sono automaticamente replicati su server2 e server3.

Conclusione

Congratulazioni! Hai ora installato e configurato il cluster cockroachdb sui server Debian 11. Inoltre, hai imparato come connetterti alla shell cockroachdb e i comandi SQL di base per creare un database e inserire dati.