Cette page vous explique comment vous connecter à Cloud SQL depuis un environnement de test local à l'aide du proxy d'authentification Cloud SQL. Le proxy d'authentification Cloud SQL fournit un accès sécurisé à votre instance Cloud SQL, sans nécessiter de réseaux autorisés ni de configuration SSL. Vous pouvez vous connecter en toute sécurité à votre instance Cloud SQL à l'aide de ce proxy.
Si vous souhaitez configurer le proxy d'authentification Cloud SQL pour un environnement de production, ne suivez pas ces instructions. Pour connaître les autres options de connexion permettant d'authentifier et d'utiliser le proxy, consultez la page Se connecter à l'aide du proxy d'authentification Cloud SQL.
Configurer votre projet
Avant de suivre les étapes de ce guide de démarrage rapide, réalisez les tâches suivantes :
- Connectez-vous à votre compte Google Cloud. Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits gratuits pour exécuter, tester et déployer des charges de travail.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
- Assurez-vous que vous disposez du rôle d'administrateur Cloud SQL sur votre compte utilisateur.
- Accédez à la page IAM.
Accéder à la page IAM - Cliquez sur Ajouter.
- Dans Nouveaux comptes principaux, ajoutez le nom de votre compte utilisateur.
- Dans Sélectionner un rôle, recherchez le filtre Administrateur Cloud SQL et sélectionnez-le dans la liste.
- Cliquez sur Enregistrer.
- Accédez à la page IAM.
-
Activez l'API Cloud SQL Admin et l'API Compute Engine.
Activez les API
Créer une instance Cloud SQL
Dans ce guide de démarrage rapide, vous utilisez Google Cloud Console. Pour utiliser gcloud, cURL ou PowerShell, consultez la section Créer des instances.
-
Dans Google Cloud Console, accédez à la page Instances Cloud SQL.
- Cliquez sur Create Instance (Créer une instance).
- Cliquez sur Choisir PostgreSQL.
- Dans le champ ID d'instance, saisissez
myinstance
. - Saisissez un mot de passe pour l'utilisateur
postgres
. Cliquez sur Create (Créer).
Vous êtes redirigé vers la liste des instances. Vous pouvez cliquer directement sur la nouvelle instance pour en afficher les détails, mais elle ne sera disponible pour les autres opérations qu'une fois initialisée et démarrée.
Remarque : Dans cet exemple, l'instance est créée à l'aide des paramètres par défaut, y compris une adresse IP publique.
Installer un client psql
Debian/Ubuntu
Installez le client psql à partir du gestionnaire de packages :
sudo apt-get update sudo apt-get install postgresql-client
CentOS/RHEL
Installez le client psql à partir du gestionnaire de packages :
sudo yum install postgresql
openSUSE
Installez le client psql à partir du gestionnaire de packages :
sudo zypper install postgresql
Autres plates-formes
- Téléchargez PostgreSQL Core Distribution sur votre plate-forme depuis la page des téléchargements PostgreSQL.
Core Distribution inclut le client psql. - Installez la base de données PostgreSQL en suivant les instructions de la page de téléchargement.
Installer le client proxy d'authentification Cloud SQL
Le binaire du proxy d'authentification Cloud SQL à télécharger dépend du système d'exploitation et de l'utilisation d'un noyau 32 bits ou 64 bits.
Dans la plupart des cas, le matériel récent possède un noyau 64 bits. Si vous ne savez pas si votre machine exécute un noyau 32 bits ou 64 bits, utilisez la commande uname -a
pour Linux ou macOS. Pour Windows, consultez la documentation Windows.
Linux 64 bits
- Téléchargez le proxy d'authentification Cloud SQL :
wget https://dl.google.com/cloudsql/cloud_sql_proxy.linux.amd64 -O cloud_sql_proxy
- Rendez le proxy d'authentification Cloud SQL exécutable :
chmod +x cloud_sql_proxy
Linux 32 bits
- Téléchargez le proxy d'authentification Cloud SQL :
wget https://dl.google.com/cloudsql/cloud_sql_proxy.linux.386 -O cloud_sql_proxy
- Si la commande
wget
est introuvable, exécutezsudo apt-get install wget
puis répétez la commande de téléchargement. - Rendez le proxy d'authentification Cloud SQL exécutable :
chmod +x cloud_sql_proxy
macOS 64 bits
- Téléchargez le proxy d'authentification Cloud SQL :
curl -o cloud_sql_proxy https://dl.google.com/cloudsql/cloud_sql_proxy.darwin.amd64
- Rendez le proxy d'authentification Cloud SQL exécutable :
chmod +x cloud_sql_proxy
macOS 32 bits
- Téléchargez le proxy d'authentification Cloud SQL :
curl -o cloud_sql_proxy https://dl.google.com/cloudsql/cloud_sql_proxy.darwin.386
- Rendez le proxy d'authentification Cloud SQL exécutable :
chmod +x cloud_sql_proxy
Mac M1
- Téléchargez le proxy d'authentification Cloud SQL :
curl -o cloud_sql_proxy https://dl.google.com/cloudsql/cloud_sql_proxy.darwin.arm64
- Rendez le proxy d'authentification Cloud SQL exécutable :
chmod +x cloud_sql_proxy
Windows 64 bits
Pour télécharger le proxy d'authentification Cloud SQL, effectuez un clic droit sur le lien https://dl.google.com/cloudsql/cloud_sql_proxy_x64.exe, puis sélectionnez Enregistrer le lien sous. Renommez le fichier encloud_sql_proxy.exe
.
Windows 32 bits
Pour télécharger le proxy d'authentification Cloud SQL, effectuez un clic droit sur le lien https://dl.google.com/cloudsql/cloud_sql_proxy_x86.exe, puis sélectionnez Enregistrer le lien sous. Renommez le fichier encloud_sql_proxy.exe
.
Image Docker du proxy d'authentification Cloud SQL
Pour plus de commodité, plusieurs images de conteneur contenant le proxy d'authentification Cloud SQL sont disponibles sur GitHub dans le dépôt du proxy d'authentification Cloud SQL. Vous pouvez extraire la dernière image sur votre ordinateur local en utilisant Docker avec la commande suivante :docker pull gcr.io/cloudsql-docker/gce-proxy:1.19.1
Autres systèmes d'exploitation
Pour les autres systèmes d'exploitation non inclus ici, vous pouvez compiler le proxy d'authentification Cloud SQL à partir de la source.Obtenir le nom de connexion de l'instance
-
Dans Google Cloud Console, accédez à la page Instances Cloud SQL.
- Cliquez sur le nom de l'instance pour ouvrir la page Présentation.
- Dans la section Se connecter à cette instance, copiez le nom de la connexion. Le nom de la connexion est au format
projectID:region:instanceID
.
Démarrer le proxy d'authentification Cloud SQL
Démarrez le proxy d'authentification Cloud SQL dans son propre terminal afin de pouvoir surveiller sa sortie. Remplacez INSTANCE_CONNECTION_NAME
par le nom de connexion de l'instance que vous avez copié à l'étape précédente.
Pour les environnements Linux, lancez le proxy d'authentification Cloud SQL à l'aide de la commande suivante :
./cloud_sql_proxy -instances=INSTANCE_CONNECTION_NAME=tcp:5432
Dans PowerShell sous Windows, lancez le proxy d'authentification Cloud SQL à l'aide de la commande suivante :
.\cloud_sql_proxy.exe -instances=INSTANCE_CONNECTION_NAME=tcp:5432
Un message de ce type s'affiche :
Listening on 127.0.0.1:5432 for INSTANCE_CONNECTION_NAME Ready for new connections
Exécutez la commande suivante en remplaçant INSTANCE_ID par le nom de l'instance Cloud SQL :
psql "host=127.0.0.1 port=5432 sslmode=disable dbname=INSTANCE_ID user=postgres"
Dans l'invite de saisie de mot de passe, saisissez le mot de passe de votre compte PostgreSQL.
Vérifiez que l'invite PostgreSQL s'affiche. Vous vous êtes connecté à votre base de données à l'aide du client psql.
Revenez à la fenêtre de terminal dans laquelle vous avez démarré le proxy d'authentification Cloud SQL. Un message semblable au suivant doit s'afficher :
New connection for myInstance
Effectuer un nettoyage
-
Dans Google Cloud Console, accédez à la page Instances Cloud SQL.
- Sélectionnez le nom de l'instance pour ouvrir la page Présentation.
- Dans la barre d'icônes en haut de la page, cliquez sur Supprimer.
- Dans la fenêtre Supprimer l'instance, saisissez le nom de l'instance, puis cliquez sur Supprimer.
Vous ne pouvez pas réutiliser le nom d'une instance pendant environ sept jours après la suppression de cette instance.
Étape suivante
- Consultez les informations de dépannage concernant le proxy d'authentification Cloud SQL.
- Apprenez-en plus sur le proxy d'authentification Cloud SQL.
- Obtenez des informations supplémentaires sur les autres options de connexion.