Se connecter depuis votre ordinateur portable

Pour explorer AlloyDB pour PostgreSQL ou travailler dans un environnement de développement local, vous pouvez établir une connexion sécurisée entre votre ordinateur portable ou votre poste de travail local et une instance AlloyDB à l'aide du proxy d'authentification AlloyDB via une adresse IP publique.

Avant de commencer

Avant de vous connecter depuis votre ordinateur portable, assurez-vous de remplir les conditions préalables suivantes :

Rôles requis

Pour vous connecter depuis votre ordinateur portable, attribuez à votre compte principal Identity and Access Management (IAM) (compte utilisateur ou compte de service) les rôles prédéfinis suivants :

  • Client AlloyDB (roles/alloydb.client)
  • Consommateur Service Usage (roles/serviceusage.serviceUsageConsumer)

Activer l'adresse IP publique sur votre instance AlloyDB

Le moyen le plus simple de vous connecter depuis votre ordinateur portable consiste à activer l'adresse IP publique sur votre instance AlloyDB. Vous pouvez activer l'adresse IP publique lorsque vous créez une instance ou que vous mettez à jour une instance existante pour l'activer.

Console

  1. Accédez à la page Clusters de la console Google Cloud .

    accéder aux clusters

  2. Pour afficher les détails d'un cluster, cliquez sur un cluster dans la colonne Nom de la ressource.

  3. Dans Instances dans votre cluster, recherchez l'instance à laquelle vous souhaitez vous connecter.

  4. Cliquez sur Actions sur l'instance, puis sur Modifier.

  5. Dans Connectivité, sélectionnez Activer l'adresse IP publique.

  6. Pour enregistrer vos modifications, cliquez sur Mettre à jour l'instance.

gcloud

Utilisez la commande gcloud alloydb instances update pour activer l'adresse IP publique sur votre instance :

gcloud alloydb instances update INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --assign-inbound-public-ip=ASSIGN_IPV4

Remplacez les éléments suivants :

  • INSTANCE_ID : ID de l'instance AlloyDB.
  • CLUSTER_ID : ID du cluster.
  • REGION_ID : région dans laquelle se trouve le cluster.

Récupérer l'URI de connexion de l'instance

Lorsque vous démarrez le client du proxy d'authentification, vous devez identifier votre instance à l'aide de son URI de connexion unique. Récupérez l'URI de connexion à l'aide de la commande gcloud CLI alloydb instances describe dans le terminal de votre ordinateur portable.

gcloud alloydb instances describe INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --format="value(name)"

La commande renvoie l'URI de connexion, qui se présente comme suit :

projects/myproject/locations/us-central1/clusters/mycluster/instances/myprimary

Démarrer le proxy d'authentification AlloyDB avec une adresse IP publique

Maintenant que vous disposez de l'URI de connexion de l'instance, démarrez le client du proxy d'authentification à l'aide du terminal de votre ordinateur portable. Utilisez l'option --public-ip pour indiquer au proxy d'authentification AlloyDB de se connecter via le chemin d'accès réseau de l'adresse IP publique.

./alloydb-auth-proxy CONNECTION_URI --public-ip

Remplacez CONNECTION_URI par l'URI de connexion de l'instance que vous avez obtenu dans Récupérer l'URI de connexion de l'instance.

Lorsque le proxy d'authentification AlloyDB démarre correctement, le terminal indique que le proxy d'authentification AlloyDB écoute les connexions TCP locales sur le port 5432 :

Authorizing with Application Default Credentials
Listening on 127.0.0.1:5432
The proxy has started successfully and is ready for new connections!

Se connecter à la base de données à l'aide de psql

Pendant que le proxy d'authentification AlloyDB est en cours d'exécution, ouvrez une autre fenêtre de terminal sur votre ordinateur portable pour vous connecter à la base de données.

Exécutez l'outil client psql en ciblant l'adresse de l'écouteur local 127.0.0.1 et le port 5432 :

psql -h 127.0.0.1 -U postgres -d postgres

Lorsque vous y êtes invité, saisissez le mot de passe de l'utilisateur de base de données postgres.

La commande psql se connecte au client proxy d'authentification, qui transfère votre connexion via un tunnel sécurisé vers votre instance AlloyDB. La commande psql affiche une invite confirmant que votre ordinateur portable est connecté de manière sécurisée à l'instance AlloyDB :

psql (18.2 (Debian 18.2-1), server 16.11)
Type "help" for help.

postgres=>

Étapes suivantes