Installation de Cassandra sur Windows avec Docker

Apache Cassandra est une base de données NoSQL distribuée conçue pour gérer de grandes quantités de données sur plusieurs serveurs, offrant une haute disponibilité sans point de défaillance unique. Dans ce guide, nous allons voir comment installer Cassandra sur Windows en utilisant Docker, en incluant des détails sur les pré-requis, les étapes d'installation, et les solutions aux problèmes courants.

#Pré-requis

Avant de commencer, assurez-vous d'avoir les éléments suivants installés sur votre machine :

1. Docker Desktop : Docker est une plateforme de conteneurisation qui permet de créer, déployer et exécuter des applications dans des conteneurs. Vous pouvez télécharger Docker Desktop pour Windows à partir du site officiel de Docker.

2. Windows 10/11 64-bit : Docker Desktop nécessite une version 64-bit de Windows 10 ou 11 avec la fonctionnalité WSL 2 (Windows Subsystem for Linux 2) activée.

3. WSL 2 : Si ce n'est pas déjà fait, vous pouvez activer WSL 2 en suivant les instructions officielles de Microsoft ici.

4. Git Bash ou PowerShell : Vous aurez besoin d'un terminal pour exécuter les commandes Docker. Git Bash ou PowerShell sont de bonnes options.

#Étape 1 : Installer Docker Desktop

1. Téléchargez Docker Desktop à partir du site officiel.
2. Installez Docker Desktop en suivant les instructions de l'installateur.
3. Une fois l'installation terminée, lancez Docker Desktop. Vous devriez voir l'icône de Docker dans la barre des tâches.

#Étape 2 : Télécharger l'image Docker de Cassandra

1. Ouvrez un terminal (Git Bash ou PowerShell).

2. Exécutez la commande suivante pour télécharger l'image officielle de Cassandra :

   1docker pull cassandra:latest

   Cette commande télécharge la dernière version de Cassandra disponible sur Docker Hub.

#Étape 3 : Lancer un conteneur Cassandra

1. Une fois l'image téléchargée, vous pouvez lancer un conteneur Cassandra avec la commande suivante :

   1docker run --name my-cassandra -d cassandra:latest

   • --name my-cassandra : Donne un nom à votre conteneur (ici my-cassandra).
   • -d : Détache le conteneur et le lance en arrière-plan.

2. Vérifiez que le conteneur est bien lancé avec la commande :

   1docker ps

   Vous devriez voir votre conteneur my-cassandra dans la liste.

#Étape 4 : Attendre que Cassandra soit prêt

Cassandra peut prendre quelques secondes, voire quelques minutes, pour démarrer complètement. Il est important d'attendre que Cassandra soit prêt avant de tenter de vous connecter.

1. Vérifiez les logs du conteneur : Pour surveiller l'état de Cassandra, utilisez la commande suivante :

   1docker logs my-cassandra

   Recherchez des lignes comme Starting listening for CQL clients ou Node /127.0.0.1 state jump to NORMAL dans les logs. Cela indique que Cassandra est prêt à accepter des connexions.

2. Attendez quelques secondes : Si vous ne voyez pas ces messages immédiatement, attendez quelques instants et réessayez.

#Étape 5 : Accéder à Cassandra

1. Pour accéder à l'invite de commande Cassandra (CQLSH), exécutez la commande suivante :

   1docker exec -it my-cassandra cqlsh

   Cela vous connectera à l'instance Cassandra en cours d'exécution dans le conteneur.

2. Vous pouvez maintenant exécuter des commandes CQL (Cassandra Query Language) pour interagir avec la base de données.

#Étape 6 : Résolution des problèmes courants

#Problème : Connexion refusée (ConnectionRefusedError)

Si vous obtenez une erreur de connexion refusée lors de l'exécution de cqlsh, voici quelques étapes pour résoudre le problème :

1. Vérifiez que Cassandra est prêt : Assurez-vous que Cassandra a eu suffisamment de temps pour démarrer. Utilisez docker logs my-cassandra pour vérifier les logs.

2. Vérifiez les ports : Cassandra écoute par défaut sur le port 9042. Assurez-vous que ce port est bien exposé :

   1docker ps

   Vous devriez voir quelque chose comme ceci :

   1CONTAINER ID   IMAGE              COMMAND                  CREATED         STATUS         PORTS                                         NAMES
   257690d51b040   cassandra:latest   "docker-entrypoint.s…"   7 seconds ago   Up 5 seconds   7000-7001/tcp, 7199/tcp, 9042/tcp, 9160/tcp   my-cassandra

   Si le port 9042 n'est pas listé, redémarrez le conteneur en exposant explicitement les ports :

   1docker run --name my-cassandra -d -p 9042:9042 cassandra:latest

3. Utilisez l'adresse IP du conteneur : Au lieu de 127.0.0.1, essayez de vous connecter à l'adresse IP du conteneur. Vous pouvez obtenir l'adresse IP du conteneur avec la commande suivante :

   1docker inspect -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' my-cassandra

   Ensuite, utilisez cette adresse IP pour vous connecter :

   1docker exec -it my-cassandra cqlsh <IP_ADDRESS>

#Étape 7 : Arrêter et redémarrer le conteneur

1. Pour arrêter le conteneur, utilisez la commande :

   1docker stop my-cassandra

2. Pour redémarrer le conteneur, utilisez :

   1docker start my-cassandra

#Étape 8 : Supprimer le conteneur (optionnel)

Si vous souhaitez supprimer le conteneur, vous pouvez utiliser la commande suivante :

1docker rm -f my-cassandra

Cela supprimera le conteneur, mais pas l'image Docker de Cassandra.

#Conclusion

Vous avez maintenant Cassandra installé et fonctionnel sur votre machine Windows via Docker. Cette méthode est simple et permet de rapidement mettre en place un environnement de développement ou de test pour Cassandra. Vous pouvez maintenant explorer les fonctionnalités de Cassandra et commencer à développer des applications qui utilisent cette base de données puissante et scalable.

Pour plus d'informations sur Cassandra, consultez la documentation officielle.

J'espère que ce guide vous a été utile ! Si vous avez des questions ou des commentaires, n'hésitez pas à les partager. Bonne exploration de Cassandra ! 🚀