Instalando o Cassandra com Docker 🚀
Este tutorial detalha o processo de instalação e configuração de um ambiente Cassandra de nó único usando Docker, ideal para desenvolvimento e estudos.
Passo 1: Verificar a Instalação do Docker 🧐
Antes de começar, é crucial garantir que o Docker esteja instalado e em execução no seu sistema.
Comando:
docker --version
Este comando exibirá a versão instalada do Docker, confirmando que o ambiente está pronto para os próximos passos.
Passo 2: Baixar a Imagem Oficial do Cassandra 📥
O próximo passo é baixar a imagem mais recente do Apache Cassandra do Docker Hub, que é o registro oficial de imagens de contêineres.
Comando:
docker pull cassandra
Passo 3: Listar Imagens (Verificação) ✅
Para confirmar que a imagem foi baixada com sucesso, você pode listar todas as imagens Docker disponíveis localmente.
Comando:
docker images
Você deverá ver cassandra na lista de repositórios, junto com sua tag (geralmente latest).
Passo 4: Criar um Diretório para Persistência de Dados 📂
Para garantir que os dados do seu banco de dados não sejam perdidos quando o contêiner for parado ou removido, é uma boa prática criar um diretório local e mapeá-lo para o diretório de dados dentro do contêiner.
Comando:
sudo mkdir -p /opt/cassandra
- Observação: O uso de
sudopode ser necessário dependendo das permissões do seu sistema. O-pgarante que o diretório seja criado mesmo que os diretórios pais não existam.
Passo 5: Iniciar o Contêiner Cassandra ▶️
Este é o passo mais importante, onde o contêiner Cassandra é efetivamente criado e executado.
Comando:
docker run --name cassandra -p 9042:9042 -v /opt/cassandra:/var/lib/cassandra -d cassandra
Análise dos parâmetros:
--name cassandra: Define um nome fácil de lembrar para o seu contêiner.-p 9042:9042: Mapeia a porta 9042 do seu computador (host) para a porta 9042 do contêiner. Esta é a porta padrão que o Cassandra usa para a comunicação via CQL (Cassandra Query Language).-v /opt/cassandra:/var/lib/cassandra: Este é o passo crucial para a persistência. Ele “monta” o diretório local/opt/cassandrano diretório/var/lib/cassandradentro do contêiner. O diretório/var/lib/cassandraé o local padrão onde a imagem oficial do Cassandra armazena seus arquivos de dados.-d: Executa o contêiner em modo “detached” (desanexado), ou seja, ele rodará em segundo plano.cassandra: Especifica a imagem a ser usada para criar o contêiner.
Passo 6: Acessar o Contêiner 💻
Uma vez que o contêiner está em execução, você pode acessar seu shell para executar comandos administrativos.
Comando:
docker exec -it cassandra bash
exec: Executa um comando dentro de um contêiner em execução.-it: Aloca um pseudo-TTY interativo, permitindo que você interaja com o shell do contêiner.cassandra: O nome do contêiner a ser acessado.bash: O comando a ser executado (neste caso, o shell Bash).
Passo 7: Utilizar o Console CQL (cqlsh) ⚡
Dentro do contêiner, você pode agora iniciar o cqlsh, o shell de linha de comando para interagir com o Cassandra.
Comando:
cqlsh
Se a conexão for bem-sucedida, o prompt mudará para cqlsh>.
Passo 8: Explorar e Preparar o Banco de Dados 🗺️
Agora você pode executar comandos CQL para gerenciar o banco de dados.
1. Descrever os Keyspaces Existentes: Um keyspace no Cassandra é análogo a um “schema” ou “banco de dados” em sistemas de bancos de dados relacionais.
Comando:
DESC KEYSPACES;
Este comando listará todos os keyspaces padrão que vêm com a instalação do Cassandra, como system_auth, system_schema, entre outros.
2. Criar e Usar um Novo Keyspace: Para organizar seus dados, você deve criar seu próprio keyspace.
Comando para criar:
CREATE KEYSPACE minhakeyspace WITH replication = {'class': 'SimpleStrategy', 'replication_factor': 1};
SimpleStrategy: Adequado para um cluster de um único nó.replication_factor: 1: Indica que haverá apenas uma cópia dos dados, o que é apropriado para um ambiente de desenvolvimento local.
Comando para usar:
USE minhakeyspace;
Após executar este comando, o prompt mudará para cqlsh:minhakeyspace>, indicando que todos os comandos subsequentes (como CREATE TABLE, INSERT, etc.) serão executados dentro deste keyspace.