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:

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

Les deux premières de ces 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é autorisé à accéder à AlloyDB.
  • Un réseau VPC du 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 "AlloyDB Admin")
    • 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 sur le port 5432 sur les adresses IP de vos instances AlloyDB.

Créer une VM Compute Engine

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

    Accéder à la page Instances de VM

  2. Sélectionnez le projet contenant l'instance AlloyDB à laquelle vous souhaitez vous connecter.
  3. Cliquez sur Créer une instance.
  4. Cliquez sur la section Configuration de la machine.
  5. Entrez un nom pour l'instance.
  6. Configurez la région et la zone dans lesquelles vous souhaitez créer l'instance.
  7. Sélectionnez une série de machines et le type de machine correspondant.
  8. Conservez les valeurs par défaut dans la section OS et stockage.
  9. Cliquez sur la section Networking (Mise en réseau), puis définissez Network interfaces (Interfaces réseau) sur le réseau VPC configuré pour l'accès des 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.
  10. Conservez les valeurs par défaut dans la section Observabilité.
  11. Cliquez sur la section Sécurité.
  12. Dans Identité et accès aux API, définissez Champs d'application sur Autoriser l'accès complet à l'ensemble des API Cloud.
  13. Conservez les valeurs par défaut dans la section Avancé.
  14. 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

  1. Connectez-vous à la VM Compute Engine 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
  2. 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, consultez les paramètres de cette instance.

Exécuter le client psql

  1. 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
  2. Exécutez l'outil client psql: 
    psql -h IP_ADDRESS -U USERNAME

    Vous êtes invité à saisir le mot de passe de l'utilisateur USERNAME.

    Si vous vous connectez pour la première fois, utilisez la valeur par défaut postgres pour USERNAME et le mot de passe que vous avez utilisé lors de la création du cluster pour PASSWORD.