Cette page a été traduite par l'API Cloud Translation.

Connecter un client psql à une instance

Cette page explique comment connecter l'outil client psql à une instance AlloyDB.

La procédure de connexion de psql à une instance AlloyDB implique les tâches suivantes :

Créez une VM Compute Engine pouvant se connecter aux instances AlloyDB à l'aide de l'accès aux services privés.
Installez le client psql sur la VM Compute Engine.
Obtenez l'adresse IP de l'instance AlloyDB à laquelle vous souhaitez vous connecter.
Exécutez le client psql.

Les deux premières tâches sont des opérations ponctuelles. Une fois que vous avez créé une VM Compute Engine et installé le client psql dessus, vous pouvez continuer à utiliser la VM pour connecter psql aux instances AlloyDB en effectuant les tâches restantes.

Avant de commencer

Le projet Google Cloud que vous utilisez doit avoir été activé pour accéder à AlloyDB.
Un réseau VPC dans le projet Google Cloud que vous utilisez doit déjà être configuré pour l'accès aux services privés à AlloyDB.
Vous devez disposer de l'un des rôles IAM suivants dans le projet Google Cloud que vous utilisez :
- roles/alloydb.admin (rôle IAM prédéfini "Administrateur AlloyDB")
- roles/owner (rôle IAM de base "Propriétaire")
- roles/editor (rôle IAM de base Éditeur)
Si vous ne disposez d'aucun de ces rôles, contactez l'administrateur de votre organisation pour demander l'accès.
Si l'hôte client dispose d'un pare-feu, il doit autoriser les connexions sortantes au port 5432 sur les adresses IP de vos instances AlloyDB.

Créer une VM Compute Engine

Dans la console Google Cloud , accédez à la page Instances de VM.

Accéder à la page Instances de VM
Sélectionnez le projet contenant l'instance AlloyDB à laquelle vous souhaitez vous connecter.
Cliquez sur Créer une instance.
Cliquez sur la section Configuration de la machine.
Entrez un nom pour l'instance.
Configurez la région et la zone dans lesquelles vous souhaitez créer l'instance.
Sélectionnez une série de machines et le type de machine correspondant.
Conservez les valeurs par défaut dans la section OS et stockage.
Cliquez sur la section Mise en réseau, puis définissez Interfaces réseau sur le réseau VPC configuré pour l'accès aux services privés à AlloyDB.
Si Interfaces réseau n'est pas défini sur le réseau VPC configuré pour l'accès aux services privés, développez-le, puis définissez Réseau sur le réseau VPC.
Conservez les valeurs par défaut dans la section Observabilité.
Cliquez sur la section Sécurité.
Dans Identité et accès à l'API, définissez Niveaux d'accès sur Autoriser l'accès complet à l'ensemble des API Cloud.
Conservez les valeurs par défaut dans la section Avancé.
Cliquez sur Créer.

Une fois la VM créée, connectez-vous à la VM Compute Engine que vous avez créée à l'aide de SSH.

Installer l'outil client psql

Connectez-vous à la VM Compute Engine que vous avez créée à l'aide de SSH.
Par défaut, les connexions SSH aux VM Compute Engine utilisent Identity-Aware Proxy. En fonction des règles de mise en réseau de votre organisation, vous devrez peut-être créer une règle de pare-feu d'entrée pour autoriser le trafic vers vos VM.
Console
1. Dans la console Google Cloud , accédez à la page Instances de VM.
  Accéder à la page Instances de VM
2. Dans la liste des instances de machine virtuelle, cliquez sur SSH sur la ligne de l'instance que vous avez créée.
gcloud

Utilisez la commande gcloud compute ssh pour vous connecter à l'instance que vous avez créée.
```
gcloud compute ssh --project=PROJECT_ID --zone=ZONE VM_NAME
```
Remplacez les éléments suivants :
- PROJECT_ID : identifiant du projet contenant l'instance
- ZONE : nom de la zone dans laquelle se trouve l'instance
- VM_NAME : nom de l'instance
Installez le client psql à partir du gestionnaire de packages :
```
sudo apt-get update
sudo apt-get install postgresql-client
```

Obtenir l'adresse IP de l'instance AlloyDB

Pour obtenir l'adresse IP de l'instance AlloyDB à laquelle vous souhaitez vous connecter, affichez les paramètres de cette instance.

Exécuter le client psql

Connectez-vous à la VM que vous avez créée à l'aide de SSH.
Console
1. Dans la console Google Cloud , accédez à la page Instances de VM.
  Accéder à la page Instances de VM
2. Dans la liste des instances de machine virtuelle, cliquez sur SSH sur la ligne de l'instance que vous avez créée.
gcloud

Utilisez la commande gcloud compute ssh pour vous connecter à l'instance que vous avez créée.
```
gcloud compute ssh --project=PROJECT_ID --zone=ZONE VM_NAME
```
Remplacez les éléments suivants :
- PROJECT_ID : ID du projet contenant l'instance.
- ZONE : nom de la zone dans laquelle se trouve l'instance.
- VM_NAME : nom de l'instance.
Exécutez l'outil client psql :
```
psql -h IP_ADDRESS -U USERNAME -d postgres
```
Vous êtes invité à saisir le mot de passe de l'utilisateur USERNAME.

Si vous vous connectez pour la première fois, spécifiez postgres pour USERNAME et la base de données. Votre commande se présente comme suit :
```
psql -h IP_ADDRESS -U postgres -d postgres
```
Utilisez le mot de passe que vous avez défini lors de la création du cluster.