Comment installer et configurer PostgreSQL sur Ubuntu : guide complet pour débutants

1. Introduction

PostgreSQL est un système de base de données relationnelle très fiable et haute performance, largement utilisé dans de nombreuses applications et systèmes sous Ubuntu. Cet article explique comment installer PostgreSQL sur Ubuntu et effectuer les configurations de base. Chaque étape est clairement expliquée pour les débutants, incluant les vérifications d’installation et le dépannage des problèmes de connexion, afin que vous puissiez configurer votre environnement en toute confiance.

2. Prérequis et préparation

Tout d’abord, assurez-vous que votre version d’Ubuntu est soit 20.04, soit 22.04. Avant d’installer PostgreSQL, mettez à jour la liste des paquets pour récupérer les dernières informations sur les paquets.

sudo apt update

Cela garantit que le processus d’installation se déroule sans problème.

3. Étapes d’installation de PostgreSQL

3.1 Ajouter le dépôt PostgreSQL

Le dépôt Ubuntu par défaut peut ne pas contenir la dernière version de PostgreSQL. Ajoutez le dépôt officiel de PostgreSQL pour installer la version la plus récente.

sudo sh -c 'echo "deb http://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" > /etc/apt/sources.list.d/pgdg.list'
sudo wget -qO- https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo tee /etc/apt/trusted.gpg.d/pgdg.asc

3.2 Installer PostgreSQL

Une fois le dépôt ajouté, installez PostgreSQL et les outils supplémentaires avec les commandes suivantes :

sudo apt update
sudo apt install postgresql postgresql-contrib

3.3 Vérifier l’installation

Après l’installation, vérifiez que PostgreSQL est correctement installé en vérifiant sa version.

postgres --version

4. Configuration initiale

4.1 Configurer l’utilisateur PostgreSQL

Lors de l’installation, un utilisateur système nommé « postgres » est créé. Passez à cet utilisateur pour effectuer les opérations de base de données.

sudo -i -u postgres

4.2 Modifier les paramètres de connexion locale

Modifiez le fichier pg_hba.conf pour définir les méthodes d’authentification. Par défaut, seules les connexions locales sont autorisées. Pour activer l’accès à distance, modifiez le fichier suivant :

sudo nano /etc/postgresql/14/main/pg_hba.conf

Par exemple, vous pouvez imposer l’authentification « md5 » pour renforcer la sécurité :

local   all             postgres                                md5
host    all             all             127.0.0.1/32            md5

Après modification, redémarrez le service PostgreSQL pour appliquer les changements.

sudo systemctl restart postgresql

5. Vérifications des opérations de base

5.1 Démarrer et arrêter PostgreSQL

PostgreSQL démarre automatiquement après l’installation, mais vous pouvez le démarrer, l’arrêter et vérifier son statut manuellement à l’aide des commandes suivantes :

sudo systemctl status postgresql
sudo systemctl start postgresql
sudo systemctl stop postgresql

5.2 Vérifier les bases de données

Utilisez la commande psql pour vous connecter à PostgreSQL et afficher les bases de données existantes.

sudo -u postgres psql

À l’invite de commande, saisissez \l pour lister les bases de données actuelles.

6. Installer et configurer pgAdmin (optionnel)

pgAdmin est un outil graphique qui simplifie l’administration de PostgreSQL. Installez-le avec la commande suivante et gérez PostgreSQL via votre navigateur :

sudo apt install pgadmin4

Après l’installation, accédez à l’interface via http://localhost/pgadmin.

7. Dépannage des erreurs courantes

7.1 Erreurs d’installation et de dépôt

Si vous rencontrez des erreurs de dépendances ou de dépôt lors de l’installation, vérifiez l’URL du dépôt et mettez à jour à nouveau la liste des paquets.

sudo apt update

7.2 Erreurs de connexion

Si vous recevez des erreurs telles que « Échec de l’authentification par mot de passe », vérifiez votre fichier pg_hba.conf, confirmez votre mot de passe et redémarrez le service.

sudo systemctl restart postgresql

7.3 Résolution des erreurs réseau

Si les connexions à distance échouent, le fichier postgresql.conf peut avoir listen_addresses réglé sur « localhost ». Modifiez-le comme suit pour autoriser les connexions à distance :

sudo nano /etc/postgresql/14/main/postgresql.conf

Modifiez le paramètre comme indiqué ci-dessous :

listen_addresses = '*'

Redémarrez le service pour appliquer les modifications.

sudo systemctl restart postgresql

8. Conclusion

Ce guide a expliqué comment installer PostgreSQL sur Ubuntu, le configurer et effectuer des vérifications d’opérations de base. Avec pgAdmin, les configurations d’accès à distance et les conseils de dépannage inclus, même les utilisateurs novices devraient pouvoir configurer l’environnement sans problème.