L'objectif de cet article est d'expliquer pas à pas l'installation du client PostgreSQL version 17 (`postgres-client-17`) sur une distribution Linux basée sur Debian ou Ubuntu. Ce guide s'adresse aux développeurs et administrateurs système souhaitant interagir avec une base de données PostgreSQL en utilisant uniquement le client.

---

## Pré-requis
Avant de commencer, assurez-vous que :
1. Vous avez les privilèges administrateur (accès `sudo`).
1. Votre système est à jour avec les derniers correctifs de sécurité.

---

## Étapes d'installation
### 1. Créer le répertoire pour le dépôt PostgreSQL
Le premier pas consiste à créer le répertoire qui contiendra la clé de signature du dépôt PostgreSQL. Cela garantit la vérification de l'authenticité des paquets téléchargés.

```bash
sudo install -d /usr/share/postgresql-common/pgdg
```

### 2. Télécharger et ajouter la clé GPG
La clé GPG du dépôt PostgreSQL doit être téléchargée et installée pour valider les paquets téléchargés. Utilisez la commande suivante :

```bash
sudo curl -o /usr/share/postgresql-common/pgdg/apt.postgresql.org.asc --fail https:*www.postgresql.org/media/keys/ACCC4CF8.asc
```

> ⚠️ **Astuce** : Assurez-vous que la connexion Internet est active pour télécharger la clé depuis le site officiel de PostgreSQL.

### 3. Ajouter le dépôt PostgreSQL au gestionnaire de paquets
Ajoutez le dépôt PostgreSQL approprié à votre fichier de sources APT. La commande suivante le fait automatiquement, en détectant la version de votre système (`source /etc/os-release && echo $VERSION_CODENAME`) :

```bash
sudo sh -c 'echo "deb [signed-by=/usr/share/postgresql-common/pgdg/apt.postgresql.org.asc] https:*apt.postgresql.org/pub/repos/apt $(source /etc/os-release && echo $VERSION_CODENAME)-pgdg main" > /etc/apt/sources.list.d/pgdg.list'
```

Cette ligne configure le fichier de sources pour qu'il utilise le dépôt officiel PostgreSQL.

### 4. Mettre à jour la liste des paquets
Mettez à jour la liste des paquets disponibles sur votre système avec la commande suivante :

```bash
sudo apt update
```

### 5. Installer le client PostgreSQL version 17
Pour installer le client PostgreSQL version 17, exécutez simplement :

```bash
sudo apt install -y postgresql-client-17
```

> **Note** : Le `-y` permet d'automatiser l'acceptation des invites lors de l'installation.

---

## Vérification de l'installation
Pour vérifier que le client PostgreSQL 17 est correctement installé, utilisez la commande suivante :

```bash
psql --version
```

La sortie doit indiquer la version 17. Par exemple :

```
psql (PostgreSQL) 17.x
```

---

## Conclusion
Vous avez maintenant installé avec succès `postgres-client-17` sur votre système. Vous pouvez l'utiliser pour interagir avec n'importe quel serveur PostgreSQL. Pour des commandes comme la connexion à une base de données distante, utilisez :

```bash
psql -h <adresse_du_serveur> -U <utilisateur> -d <nom_de_la_base>
```

N'hésitez pas à consulter la [documentation officielle de PostgreSQL](https://www.postgresql.org/docs/) pour approfondir vos connaissances.