Comment configurer une base de données PostgreSQL avec Docker#

Dans ce tutoriel, nous allons apprendre à configurer une base de données PostgreSQL à l’aide de Docker. Docker permet de créer des environnements isolés et reproductibles, ce qui est idéal pour le développement et le déploiement.

Avant de commencer#

Assurez-vous d’avoir les éléments suivants installés sur votre machine :

• Docker
• Un éditeur de texte ou un IDE (comme VS Code)

Étape 1 : Créer un fichier docker-compose.yml#

Créez un fichier nommé docker-compose.yml dans votre projet. Ajoutez le contenu suivant :

version: '3.8'

services:
  db:
    image: postgres:15
    container_name: postgres_db
    environment:
      POSTGRES_DB: myapp
      POSTGRES_USER: myuser
      POSTGRES_PASSWORD: mypassword
    ports:
      - "5432:5432"
    volumes:
      - postgres_data:/var/lib/postgresql/data
    restart: unless-stopped

volumes:
  postgres_data:

Étape 2 : Lancer le conteneur PostgreSQL#

Ouvrez un terminal dans le répertoire contenant le fichier docker-compose.yml et exécutez la commande suivante :

docker-compose up -d

Cette commande lance PostgreSQL en arrière-plan. Vous pouvez vérifier que le conteneur est en cours d’exécution avec :

docker-compose ps

Étape 3 : Se connecter à la base de données#

Vous pouvez vous connecter à la base de données PostgreSQL à l’aide de l’outil psql ou d’un client graphique comme DBeaver.

Utilisation de psql#

Exécutez la commande suivante dans votre terminal :

docker exec -it postgres_db psql -U myuser -d myapp

Vous devriez voir un prompt myapp=>, indiquant que vous êtes connecté.

Utilisation d’un client graphique#

1. Ouvrez DBeaver.
2. Cliquez sur New Database Connection.
3. Sélectionnez PostgreSQL comme type de base de données.
4. Remplissez les champs :
   • Host: localhost
   • Port: 5432
   • Database: myapp
   • Username: myuser
   • Password: mypassword
5. Cliquez sur Test Connection pour vérifier que la connexion fonctionne.
6. Cliquez sur Finish pour enregistrer la connexion.

Étape 4 : Créer une table de test#

Une fois connecté, exécutez la commande SQL suivante pour créer une table de test :

CREATE TABLE test_table (
  id SERIAL PRIMARY KEY,
  name VARCHAR(100) NOT NULL,
  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

Ajoutez quelques données :

INSERT INTO test_table (name) VALUES ('Alice'), ('Bob');

Vérifiez que les données ont été insérées :

SELECT * FROM test_table;

Nettoyage#

Pour arrêter le conteneur PostgreSQL, exécutez :

docker-compose down

Pour supprimer les volumes persistants (attention, cela supprime toutes les données), utilisez :

docker-compose down -v

Conclusion#

Vous avez maintenant configuré une base de données PostgreSQL avec Docker. Cette méthode est rapide, reproductible et idéale pour les projets de développement. Vous pouvez facilement partager ce fichier docker-compose.yml avec votre équipe pour garantir une configuration identique sur tous les environnements.

Pour en savoir plus, consultez la documentation officielle de PostgreSQL.

Publié le 15 mai 2024