Cómo instalar un clúster de CockroachDB en Debian 11

CockroachDB es una base de datos SQL distribuida y escalable de código abierto para aplicaciones en la nube. CockroachDB proporciona consistencia de siguiente nivel, base de datos SQL replicada y un almacén de datos transaccional. CockroachDB almacena tus datos en múltiples ubicaciones, lo que hace que la entrega de datos sea más rápida. Además, es fácil de escalar y proporciona alta disponibilidad y tolerancia a fallos para tus aplicaciones.

En este tutorial, te mostraremos cómo instalar el clúster de CockroachDB en un servidor Debian 11.

Requisitos previos

• Dos o más servidores Debian 11.
• Una contraseña de root configurada en los servidores.

Instalando CockroachDB en los 3 Servidores

Para la instalación, cockroachdb es fácil de instalar. Esto se debe a que cockroachdb proporciona un archivo binario para el sistema Linux que puedes descargar en tu sistema.

Descarga el archivo binario de cockroachdb para Linux usando el siguiente comando. Este comando descargará el archivo binario de cockroachdb, extraerá el archivo comprimido y luego moverá el archivo binario de cockroachdb al directorio /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/

El cockroachdb utiliza la biblioteca GEOS incorporada personalizada. La biblioteca GEOS está incluida en el archivo comprimido de cockroachdb y debe instalarse en el directorio lib.

Crea un nuevo directorio /usr/local/lib/cockroach usando el siguiente comando.

mkdir -p /usr/local/lib/cockroach

Ahora copia la biblioteca GEOS al directorio /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/

La instalación básica de cockroachdb está instalada en los servidores Debian.

Ejecuta el siguiente comando para verificar el archivo binario de cockroachdb y la versión actual de cockroachdb que acabas de instalar.

which cockroach  
cockroach version

Obtendrás la siguiente salida.

Configurando el Firewall

Si estás ejecutando el Firewall en tus servidores Debian, necesitarás agregar los puertos de cockroachdb a la configuración del firewall.

El cockroachdb utiliza el puerto 8080 para la administración basada en web de cockroachdb, y el puerto 26257 para las conexiones de usuario y la configuración del clúster.

Agrega los puertos 8080 y 25267 al firewall UFW usando el siguiente comando.

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

Ahora recarga las reglas del firewall UFW y verifica el estado actual de las reglas del firewall.

sudo ufw reload  
sudo ufw status

A continuación, puedes ver que los puertos 8080 y 25267 se han agregado al firewall UFW.

Inicializando el Clúster de CockroachDB

Para inicializar el clúster de cockroachdb, ejecuta el siguiente comando en el servidor11.

Necesitarás cambiar el valor de las siguientes opciones:

• –store: para almacenar los datos del clúster de CockroachDB.
• –listen-addr: en qué dirección IP se ejecutará cockroachdb en el servidor. El puerto predeterminado para cockroachdb es el puerto 25267.
• –http-addr: en qué dirección IP se ejecutará la administración basada en web de cockroachdb. La administración basada en web predeterminada de cockroachdb es el puerto 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

Obtendrás la siguiente salida.

Ahora muévete a server2 y ejecuta el siguiente comando para iniciar el cockroachdb y unirte al clúster. Cambia la dirección IP en –listen-addr y –http-addr a la dirección 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

Obtendrás la siguiente salida desde server2.

A continuación, muévete a server3 y ejecuta el siguiente comando para iniciar el cockroachdb y unirte al clúster de cockroachdb. Además, cambia la dirección IP de –listen-addr y –http-addr a la dirección 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

Obtendrás la siguiente salida desde server3.

Después de que todo esté completo, regresa al server11 y ejecuta el siguiente comando para inicializar el clúster de cockroachdb.

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

Obtendrás el mensaje de salida ‘clúster inicializado con éxito‘, lo que significa que el clúster de cockroachdb se ha inicializado con éxito.

Puedes ejecutar el comando grep a continuación para verificar el registro de la inicialización de cockroachdb. Cambia el directorio server11 con tu directorio de cockroachdb –store.

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

A continuación, puedes ver los registros de la inicialización del clúster de cockroachdb en server11.

Por último, abre tu navegador web y visita la dirección IP del servidor seguida del puerto 8080.

http://192.168.10.11:8080/

A continuación, puedes ver que hay tres nodos en el clúster de cockroachdb.

Probando Crear Nueva Base de Datos en CockroachDB

Ahora que tienes el clúster de cockroachdb en funcionamiento, puedes usar cualquier servidor como puerta de enlace SQL para acceder a cockroachdb.

Ejecuta el comando cockroach en el server11 para conectarte al clúster de cockroachdb.

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

Después de conectarte a la consola SQL, ejecuta la siguiente consulta para crear una nueva base de datos.

CREATE DATABASE bank;

Ahora crea una nueva tabla en la base de datos usando la siguiente consulta.

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

A continuación, importa datos de muestra a la tabla.

INSERT INTO bank.accounts (1, 1000.50);

Verifica los datos en la base de datos usando la siguiente consulta.

SELECT * FROM bank.accounts;

Obtendrás la siguiente salida.

A continuación, muévete a server2 o server3 e inicia sesión en la consola SQL de cockroachdb usando el siguiente comando.

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

Después de conectarte a la consola SQL en server3, ejecuta la siguiente consulta para verificar la replicación de la base de datos.

SELECT * FROM bank.accounts;

Verás que la base de datos y los datos de server11 se replican automáticamente en server2 y server3.

Conclusión

¡Felicidades! Ahora has instalado y configurado el clúster de cockroachdb en los servidores Debian 11. También has aprendido cómo conectarte a la consola de cockroachdb y los comandos SQL básicos para crear una base de datos e insertar datos.