Como Instalar um Cluster CockroachDB no Debian 11

CockroachDB é um banco de dados SQL distribuído e escalável de código aberto para aplicações em nuvem. O CockroachDB fornece consistência de nível superior, banco de dados SQL replicado e um armazenamento de dados transacional. O CockroachDB armazena seus dados em múltiplos locais, tornando a entrega de dados mais rápida. Além disso, é fácil de escalar e oferece alta disponibilidade e tolerância a falhas para suas aplicações.

Neste tutorial, mostraremos como instalar o cluster CockroachDB no servidor Debian 11.

Pré-requisitos

• Dois ou mais servidores Debian 11.
• Uma senha de root configurada nos servidores.

Instalando o CockroachDB em Todos os 3 Servidores

Para a instalação, o cockroachdb é fácil de instalar. Isso porque o cockroachdb fornece um arquivo binário para o sistema Linux que você pode baixar para seu sistema.

Baixe o arquivo binário do cockroachdb para Linux usando o seguinte comando. Este comando irá baixar o arquivo binário do cockroachdb, extrair o arquivo compactado e, em seguida, mover o arquivo binário do cockroachdb para o diretório /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/

O cockroachdb usou a biblioteca GEOS embutida personalizada. A biblioteca GEOS está incluída no arquivo compactado do cockroachdb e deve ser instalada no diretório lib.

Crie um novo diretório /usr/local/lib/cockroach usando o comando abaixo.

mkdir -p /usr/local/lib/cockroach

Agora copie a biblioteca GEOS para o diretório /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/

A instalação básica do cockroachdb está instalada nos servidores Debian.

Execute o seguinte comando para verificar o arquivo binário do cockroachdb e a versão atual do cockroachdb que você acabou de instalar.

which cockroach  
cockroach version

Você obterá a seguinte saída.

Configurando o Firewall

Se você estiver executando o Firewall em seus servidores Debian, precisará adicionar as portas do cockroachdb à configuração do firewall.

O cockroachdb usou a porta 8080 para a administração baseada na web do cockroachdb, e a porta 26257 para as conexões de usuários e configuração do cluster.

Adicione as portas 8080 e 25267 ao firewall UFW usando o seguinte comando.

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

Agora recarregue as regras do firewall UFW e verifique o status atual das regras do firewall.

sudo ufw reload  
sudo ufw status

Abaixo você pode ver que as portas 8080 e 25267 foram adicionadas ao firewall UFW.

Inicializando o Cluster CockroachDB

Para inicializar o cluster cockroachdb, execute o comando abaixo no server11.

Você precisará alterar o valor das seguintes opções:

• –store: para armazenar os dados do cluster CockroachDB.
• –listen-addr: em qual endereço IP o cockroachdb estará rodando no servidor. A porta padrão para o cockroachdb é a porta 25267.
• –http-addr: em qual endereço IP a administração baseada na web do cockroachdb estará rodando. A administração baseada na web padrão do cockroachdb é a 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

Você obterá a seguinte saída.

Agora mude para server2 e execute o seguinte comando para iniciar o cockroachdb e entrar no cluster. Altere o endereço IP em –listen-addr e –http-addr para o endereço IP do 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

Você obterá a seguinte saída do server2.

Em seguida, mude para server3 e execute o seguinte comando para iniciar o cockroachdb e entrar no cluster cockroachdb. Além disso, altere o endereço IP de –listen-addr e –http-addr para o endereço IP do 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

Você obterá a seguinte saída do server3.

Depois que tudo estiver concluído, volte ao server11 e execute o comando abaixo para inicializar o cluster cockroachdb.

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

Você receberá a mensagem de saída ‘cluster inicializado com sucesso‘, o que significa que o cluster cockroachdb foi inicializado com sucesso.

Você pode executar o comando grep abaixo para verificar o log da inicialização do cockroachdb. Altere o diretório do server11 com seu diretório –store do cockroachdb.

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

Abaixo você pode ver os logs da inicialização do cluster cockroachdb do server11.

Por fim, abra seu navegador e visite o endereço IP do servidor seguido pela porta 8080.

http://192.168.10.11:8080/

Abaixo você pode ver que há três nós no cluster cockroachdb.

Testando Criar Novo Banco de Dados no CockroachDB

Agora que o cluster cockroachdb está em execução, você pode usar qualquer servidor como o gateway SQL para acessar o cockroachdb.

Execute o comando cockroach no server11 para se conectar ao cluster cockroachdb.

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

Depois de se conectar ao shell SQL, execute a consulta abaixo para criar um novo banco de dados.

CREATE DATABASE bank;

Agora crie uma nova tabela no banco de dados usando a seguinte consulta.

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

Em seguida, importe dados de exemplo para a tabela.

INSERT INTO bank.accounts (1, 1000.50);

Verifique os dados no banco de dados usando a seguinte consulta.

SELECT * FROM bank.accounts;

Você obterá a seguinte saída.

Em seguida, mude para server2 ou server3 e faça login no shell SQL do cockroachdb usando o seguinte comando.

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

Depois de se conectar ao shell SQL no server3, execute a seguinte consulta para verificar e validar a replicação do banco de dados.

SELECT * FROM bank.accounts;

Você verá que o banco de dados e os dados do server11 são automaticamente replicados para o server2 e server3.

Conclusão

Parabéns! Você agora instalou e configurou o cluster cockroachdb nos servidores Debian 11. Além disso, você aprendeu como se conectar ao shell cockroachdb e comandos SQL básicos para criar um banco de dados e inserir dados.