Accueil » Formations » Fondamentaux en informatique » Bases de données et SQL avec PostgreSQL » TP01 – Installer PostgreSQL et se connecter avec psql

TP01 – Installer PostgreSQL et se connecter avec psql

← Bases de données et SQL avec PostgreSQL

// travaux pratiques · Fondamentaux en informatique

TP01 - Installer PostgreSQL et se connecter avec psql

  • TP 1 / 7
  • 7 étapes
  • ≈ 40 min
  • Accès libre

Objectif : installer PostgreSQL 17 depuis les dépôts Debian 13, vérifier que l’instance tourne, s’y connecter avec psql et repérer les fichiers de configuration, de données et de journaux que l’on manipulera dans tous les TP suivants.

Contexte

Dans la plupart des organisations, PostgreSQL arrive d’abord « avec » une application : un outil de supervision, une GMAO, un outil de gestion de parc, un ERP ou un logiciel métier. Le technicien qui doit le dépanner un vendredi soir gagne un temps précieux s’il sait où se trouvent la configuration, les données et les journaux, et comment se connecter sans casser l’existant. Dans une petite structure, une seule instance héberge souvent toutes les bases ; dans un grand groupe, les instances sont nombreuses, standardisées et déployées par des outils d’automatisation, mais les repères sont exactement les mêmes.

À la fin de ce TP, vous saurez installer le serveur, identifier son « cluster » (au sens PostgreSQL : une instance et son répertoire de données), vous y connecter en administrateur et lire ses principaux paramètres.

Prérequis : une machine virtuelle Debian 13 « trixie » nommée pg01 (2 vCPU, 2 Go de RAM, 20 Go de disque), à jour, avec un compte disposant de sudo et un accès Internet pour les paquets. Une seconde VM Debian 13 nommée admin01 servira de poste client à partir du TP06 ; dans ce cours, le réseau du laboratoire est 192.168.56.0/24 (pg01 = 192.168.56.10, admin01 = 192.168.56.20).

Durée estimée : 40 minutes.

Actions à réaliser

1. Préparer la machine

Un serveur de bases de données doit avoir un nom stable et un système à jour avant l’installation : les paquets PostgreSQL de Debian reçoivent les correctifs de sécurité par le même canal que le reste du système.

sudo hostnamectl set-hostname pg01
sudo apt update
sudo apt full-upgrade -y

Résultat attendu : la commande hostnamectl affiche pg01 comme nom statique et apt ne propose plus de mise à jour en attente.

2. Installer PostgreSQL depuis les dépôts Debian

Le métapaquet postgresql de Debian 13 installe la version majeure 17 (paquet postgresql-17), ainsi que postgresql-common, qui fournit les outils d’administration propres à Debian (pg_lsclusters, pg_ctlcluster, pg_createcluster…). L’installation crée automatiquement un premier cluster nommé main et le démarre.

sudo apt install -y postgresql
psql --version

Résultat attendu : psql --version indique une version 17.x. Si vous avez besoin d’une version plus récente (la 19 est sortie le 19 novembre 2026), le dépôt officiel du projet, apt.postgresql.org (PGDG), la fournit pour Debian ; restez sur la version 17 pour ce cours, les commandes sont identiques.

3. Identifier le cluster et le service

Debian peut faire cohabiter plusieurs versions et plusieurs clusters sur une même machine, chacun identifié par sa version et son nom. pg_lsclusters en donne la liste, avec le port, l’état, le propriétaire, le répertoire de données et le fichier journal.

pg_lsclusters
systemctl status postgresql@17-main
sudo ss -ltnp | grep 5432

Résultat attendu : une ligne pour le cluster 17 main, port 5432, état online, propriétaire postgres, données dans /var/lib/postgresql/17/main. Le service est active (running). ss montre le port 5432 en écoute uniquement sur 127.0.0.1 et ::1 : par défaut, le paramètre listen_addresses vaut localhost et le serveur n’est pas joignable depuis le réseau.

4. Se connecter en administrateur avec psql

L’installation crée le compte système postgres et le rôle PostgreSQL du même nom, superutilisateur de l’instance. Sous Debian, les connexions locales par socket Unix utilisent la méthode peer : PostgreSQL vérifie que le nom du compte système correspond au nom du rôle, sans mot de passe. On se connecte donc en empruntant l’identité postgres.

sudo -u postgres psql

Une fois l’invite postgres=# affichée (le # signale un superutilisateur), exécutez :

\conninfo
SELECT version();
\l
\du
\q

\conninfo rappelle la base, l’utilisateur et le socket utilisés ; \l liste les bases : postgres (base d’administration par défaut), template1 (modèle copié à chaque CREATE DATABASE) et template0 (modèle vierge, non modifiable) ; \du liste les rôles et leurs attributs.

Résultat attendu : trois bases, un seul rôle (postgres) avec les attributs Superuser, Create role, Create DB, Replication et Bypass RLS.

5. Lire les paramètres essentiels

Plutôt que de chercher les fichiers sur le disque, demandez-les au serveur : c’est la méthode fiable sur n’importe quelle distribution ou image de conteneur.

sudo -u postgres psql -c "SHOW config_file;" -c "SHOW hba_file;" -c "SHOW data_directory;"
sudo -u postgres psql -c "SHOW listen_addresses;" -c "SHOW port;" -c "SHOW password_encryption;"

Résultat attendu : /etc/postgresql/17/main/postgresql.conf, /etc/postgresql/17/main/pg_hba.conf, /var/lib/postgresql/17/main, puis localhost, 5432 et scram-sha-256 (valeur par défaut depuis PostgreSQL 14). Notez la séparation propre à Debian : la configuration est sous /etc, les données sous /var/lib.

6. Lire le fichier pg_hba.conf

Le fichier pg_hba.conf (host-based authentication) décide qui peut se connecter, à quelle base, d’où et avec quelle méthode. Il est lu de haut en bas et la première ligne qui correspond s’applique.

sudo grep -Ev '^\s*(#|$)' /etc/postgresql/17/main/pg_hba.conf

Résultat attendu : des lignes local en méthode peer pour les sockets Unix, des lignes host pour 127.0.0.1/32 et ::1/128 avec une méthode par mot de passe (scram-sha-256, ou md5 sur certaines versions de postgresql-common : avec un mot de passe stocké en SCRAM, la méthode md5 déclenche de toute façon une authentification SCRAM), et des lignes replication. Aucune ligne n’autorise un réseau distant : c’est le TP06 qui l’ouvrira, de façon restreinte.

7. Consulter le journal du serveur

Le journal de PostgreSQL est le premier endroit à lire quand un service refuse de démarrer ou qu’une application signale une erreur de connexion.

sudo tail -n 20 /var/log/postgresql/postgresql-17-main.log

Résultat attendu : des lignes horodatées indiquant le démarrage du serveur, l’écoute sur le port 5432 et le message « database system is ready to accept connections ».

Vérification

Le TP est réussi si : pg_lsclusters affiche 17 main 5432 online ; sudo -u postgres psql -c "SELECT 1;" renvoie une ligne contenant 1 ; ss ne montre le port 5432 que sur les adresses de bouclage ; vous savez retrouver, avec SHOW, le chemin de postgresql.conf, de pg_hba.conf et du répertoire de données.

Problèmes fréquents

  • « psql: error: connection to server on socket … failed: FATAL: role “stagiaire” does not exist » : vous avez lancé psql avec votre compte habituel. Aucun rôle PostgreSQL ne porte ce nom. Utilisez sudo -u postgres psql ; un rôle nominatif sera créé au TP02.
  • « Peer authentication failed for user “postgres” » : vous avez tapé psql -U postgres depuis votre compte. La méthode peer exige que le compte système porte le même nom que le rôle : passez par sudo -u postgres.
  • Le cluster est down : lisez le journal indiqué par pg_lsclusters, corrigez la cause (disque plein, erreur de syntaxe dans postgresql.conf…), puis sudo pg_ctlcluster 17 main start.
  • « could not change directory to “/home/stagiaire”: Permission denied » : simple avertissement de sudo -u postgres, le compte postgres ne peut pas lire votre répertoire personnel. Lancez la commande depuis /tmp ou ignorez le message.

Bonnes pratiques et sécurité

  • Ne donnez pas de mot de passe au rôle postgres tant qu’aucun besoin ne l’impose : l’accès par peer réserve l’administration aux comptes autorisés à utiliser sudo.
  • Laissez listen_addresses sur localhost tant que le serveur n’a pas besoin d’être joint par le réseau.
  • Installez PostgreSQL depuis les dépôts de la distribution ou depuis le dépôt officiel PGDG, jamais depuis une archive téléchargée au hasard : les mises à jour mineures, qui corrigent des failles, arrivent alors avec apt.
  • Planifiez le cycle de vie : chaque version majeure est maintenue cinq ans par le projet (la 14 n’est plus maintenue depuis novembre 2026).

Questions de contrôle

1. Pourquoi sudo -u postgres psql fonctionne-t-il sans mot de passe ?

Voir la réponse

La ligne local de pg_hba.conf utilise la méthode peer : le serveur obtient du noyau le nom du compte système connecté au socket (postgres) et l’accepte car il correspond au rôle demandé.

2. Dans quel fichier et par quel paramètre décide-t-on des adresses IP sur lesquelles le serveur écoute ?

Voir la réponse

Dans postgresql.conf, avec listen_addresses (par défaut localhost). Le changer nécessite un redémarrage de l’instance.

3. À quoi sert la base template1 ?

Voir la réponse

C’est le modèle copié par défaut lors d’un CREATE DATABASE : ce qu’on y ajoute se retrouve dans toutes les nouvelles bases.

Pour aller plus loin

Comparez avec l’installation de MariaDB présentée dans notre article MariaDB, la base de données open source : les notions de service, de port et de comptes se retrouvent, avec un vocabulaire différent. Dans un grand parc, l’installation et le fichier pg_hba.conf sont généralement déployés par un outil comme Ansible plutôt qu’à la main. Conservez la VM pg01 telle quelle : le TP02 y crée la base du laboratoire.

// formation sur mesure

Former votre équipe sur ce sujet ?

Azur Secure anime des sessions intra-entreprise, à distance ou dans vos locaux sur la Côte d'Azur, adaptées au niveau de vos équipes.

Demander un programme
Défiler vers le haut