Se connecter à une instance Cloud SQL pour MySQL avec une adresse IP privée

Se connecter à une instance Cloud SQL pour MySQL avec une adresse IP privée

MySQL | PostgreSQL | SQL Server

Cette page vous explique comment créer une instance MySQL et vous y connecter à l'aide d'une adresse IP privée. Les ressources créées dans ce guide de démarrage rapide coûtent généralement moins d'un dollar, en supposant que vous effectuiez les étapes, y compris le nettoyage, en temps opportun.

---

Pour obtenir des instructions détaillées sur cette tâche directement dans la console Google Cloud, cliquez sur Visite guidée :

Visite guidée

---

Avant de commencer

Remarque : Le nom que vous utilisez pour votre projet doit comporter entre 4 et 30 caractères. Lorsque vous saisissez ce nom, le formulaire suggère un ID de projet que vous pouvez modifier. L'ID du projet doit contenir entre 6 et 30 caractères et commencer par une lettre minuscule. Vous pouvez utiliser un tiret, une lettre minuscule ou un chiffre pour chacun des autres caractères, mais le dernier caractère ne peut pas être un tiret.

1. 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.

2. Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.

   Remarque : Si vous ne comptez pas conserver les ressources créées dans cette procédure, créez un projet au lieu de sélectionner un projet existant. Après avoir suivi ces étapes, vous pouvez supprimer le projet. Cela entraîne la suppression de toutes les ressources qui lui sont associées.

   Accéder au sélecteur de projet

3. Vérifiez que la facturation est activée pour votre projet Google Cloud.

4. Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.

   Remarque : Si vous ne comptez pas conserver les ressources créées dans cette procédure, créez un projet au lieu de sélectionner un projet existant. Après avoir suivi ces étapes, vous pouvez supprimer le projet. Cela entraîne la suppression de toutes les ressources qui lui sont associées.

   Accéder au sélecteur de projet

5. Vérifiez que la facturation est activée pour votre projet Google Cloud.

6. Activez les API Google Cloud nécessaires.

   Console

   Dans Google Cloud Console, accédez à la page API.

   Accéder aux API

   Activez l'API Cloud SQL Admin. En activant cette API, vous pouvez exécuter le proxy d'authentification Cloud SQL.

   gcloud

   Cliquez sur le bouton suivant pour ouvrir Cloud Shell, qui fournit un accès en ligne de commande à vos ressources Google Cloud directement depuis le navigateur. Cloud Shell peut être utilisé pour exécuter les commandes gcloud présentées dans ce guide de démarrage rapide.

   Ouvrir Cloud Shell

   Exécutez la commande gcloud services enable comme suit à l'aide de Cloud Shell pour activer les API requises pour ce guide de démarrage rapide :

   gcloud services enable sqladmin.googleapis.com

   Cette commande active les API suivantes :

   • API Cloud SQL Admin En activant cette API, vous pouvez exécuter le proxy d'authentification Cloud SQL.

Présentation

Il existe de nombreuses façons de se connecter à une instance Cloud SQL avec une adresse IP privée, en fonction de l'emplacement de la source. Le facteur clé est que la machine source doit se trouver sur le même réseau VPC que l'instance Cloud SQL. Si la source ne se trouve pas dans Google Cloud ou dans le même projet Google Cloud, vous devez configurer la connectivité différemment de la solution présentée ici.

Dans ce guide de démarrage rapide, nous configurons la connectivité via le chemin le plus direct. La source et la cible se trouvent dans le même projet Google Cloud et sur le même réseau VPC. Nous créons une instance Cloud SQL avec une adresse IP privée (la cible) et une VM Compute Engine (la source). Nous utilisons la VM pour installer et utiliser les outils nécessaires pour se connecter depuis la VM à l'instance Cloud SQL.

Effectuez les actions suivantes :

1. Créez une instance Cloud SQL avec une adresse IP privée.

   Recherchez le connection name de l'instance et enregistrez-le pour une utilisation ultérieure.

2. Créez une VM Compute Engine.
3. Ouvrir deux connexions SSH à la VM Compute Engine.

   Vous utiliserez la première fenêtre pour installer la commande mysql, et installer et démarrer le proxy d'authentification Cloud SQL. Ensuite, vous utiliserez la deuxième fenêtre pour vous connecter à l'instance Cloud SQL en vous connectant au proxy d'authentification Cloud SQL.

4. Dans la fenêtre SSH 1, procédez comme suit :
   1. Installez le client MySQL.
   2. Installez le proxy d'authentification Cloud SQL.

      Le proxy d'authentification Cloud SQL sert de connecteur entre le client mysql et l'instance Cloud SQL.

   3. Démarrez le proxy d'authentification Cloud SQL.

      En cas de réussite, le proxy Cloud SQL Auth écoute les requêtes de connexion.

5. Dans la fenêtre SSH 2, connectez-vous à l'instance Cloud SQL en demandant au client mysql de se connecter au proxy d'authentification Cloud SQL.

   En cas de réussite, votre invite mysql apparaît dans cette fenêtre et un message de connexion réussie dans la fenêtre SSH 1, où le proxy d'authentification Cloud SQL est en cours d'exécution.

6. Effectuez un nettoyage.

Créer une instance Cloud SQL avec une adresse IP privée

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

   Accéder à la page Instances Cloud SQL

2. Cliquez sur Create Instance (Créer une instance).
3. Cliquez sur Choose MySQL (Choisir MySQL).
4. Si vous êtes invité à activer l'API Compute, cliquez sur le bouton Activer l'API.
5. Dans la section Informations sur l'instance, saisissez un nom pour l'ID d'instance.
6. Entrez un mot de passe pour l'utilisateur racine. Notez le mot de passe que vous avez créé, car vous en aurez besoin plus tard.
7. Dans la section Sélectionner la disponibilité régionale et zonale, sélectionnez l'option Zone unique.
8. Développez la section Show configuration options (Afficher les options de configuration).
9. Développez Connexions.
10. Désactivez l'option Adresse IP publique.
11. Sélectionnez Private IP (Adresse IP privée).
12. Dans la liste déroulante Réseau, sélectionnez Par défaut.
13. Si vous utilisez un nouveau projet, le message suivant s'affiche : Connexion au service privé requise. Ensuite, procédez comme suit :
1. Cliquez sur Configurer la connexion.
2. Cliquez sur Activer l'API Service Networking.
3. Dans la section Allouer une plage d'adresses IP, sélectionnez Utiliser une plage d'adresses IP automatiquement allouée.
4. Cliquez sur Continuer.
5. Cliquez sur Créer une connexion et attendez que la création de la connexion soit terminée.

14. Cliquez sur Create instance (Créer une instance).

Vous êtes redirigé vers la page de présentation de l'instance. Cliquez sur la nouvelle instance pour afficher les détails la concernant, y compris son adresse IP privée.

Dans la section Se connecter à cette instance, copiez et enregistrez le nom de connexion de l'instance. Le connection name est au format projectID:region:instanceID.

Vous utiliserez le connection name lors du démarrage du proxy d'authentification Cloud SQL.

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. Cliquez sur Create instance (Créer une instance).
3. Entrez un nom pour l'instance.
4. Dans la section Niveaux d'accès, sélectionnez Autoriser l'accès complet à toutes les API Cloud.
5. Cliquez sur Créer, puis patientez jusqu'à la fin de la création de la VM.

Ouvrir deux connexions SSH à la VM Compute Engine

Nous utilisons deux fenêtres dans la VM. La première fenêtre permet d'installer le client MySQL et le proxy Cloud SQL Auth, d'obtenir le nom de connexion de l'instance et de l'utiliser pour démarrer le proxy. La deuxième fenêtre permet de se connecter à l'instance Cloud SQL via le proxy.

1. Développez le menu SSH dans la colonne Connecter de votre instance de VM Compute Engine.
2. Sélectionnez Ouvrir dans une fenêtre du navigateur pour ouvrir la fenêtre SSH 1.

   L'affichage de l'invite dans la fenêtre peut prendre quelques secondes.

3. Lorsque l'invite s'affiche, saisissez pwd pour vérifier que vous êtes bien dans le répertoire /home/$USER.

   Vous allez installer le client mysql et le proxy d'authentification Cloud SQL, puis démarrer le proxy dans cette fenêtre.

4. Sélectionnez à nouveau Ouvrir dans la fenêtre du navigateur pour ouvrir la fenêtre SSH 2.

   Vous allez utiliser cette fenêtre pour vous connecter à votre instance Cloud SQL.

Installer le client mysql

Utilisez la fenêtre SSH 1 pour cette étape.

Installez le client MySQL depuis le gestionnaire de packages et arrêtez le serveur mysqld :

sudo apt-get update
sudo apt-get install mariadb-client-10.6
  

Installer le proxy d'authentification Cloud SQL

Utilisez la fenêtre SSH 1 pour cette étape.

1. Installez wget :

   sudo apt-get install wget
       

2. Téléchargez le proxy d'authentification Cloud SQL :

   wget https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.8.2/cloud-sql-proxy.linux.amd64 \
   -O cloud-sql-proxy
     

3. Rendez le proxy d'authentification Cloud SQL exécutable :

   chmod +x cloud-sql-proxy
     

Démarrer le proxy d'authentification Cloud SQL

Utilisez la fenêtre SSH 1 pour cette étape.

Démarrez le proxy d'authentification Cloud SQL pour pouvoir surveiller sa sortie. Remplacez INSTANCE_CONNECTION_NAME par le connection name que vous avez copié lors de la création de l'instance Cloud SQL.

./cloud-sql-proxy --private-ip INSTANCE_CONNECTION_NAME

Remarque : Par défaut, le proxy d'authentification Cloud SQL tente de se connecter à votre instance Cloud SQL à l'aide d'une adresse IPv4 publique. Si l'instance n'a qu'une adresse IP privée ou si l'instance est configurée à la fois avec une adresse IP publique et une adresse IP privée, et que vous souhaitez que le proxy d'authentification Cloud SQL utilise l'adresse IP privée, vous devez indiquer l'option --private-ip au démarrage du proxy d'authentification Cloud SQL.

Si une erreur indique que l'adresse est déjà utilisée, cela signifie qu'une instance locale de la base de données est en cours d'exécution et que vous devez l'arrêter. Recherchez SERVICE_NAME en exécutant la commande ps -ef | grep mysql, puis exécutez la commande suivante :

sudo service SERVICE_NAME stop
  

Lorsque le proxy d'authentification Cloud SQL démarre correctement, un message semblable au suivant s'affiche dans la fenêtre SSH :

Listening on 127.0.0.1:3306 for myInstance
Ready for new connections

Vous connecter à l'instance Cloud SQL

Utilisez la fenêtre SSH 2 pour cette étape.

Exécutez la commande suivante :

mysql -u root -p --host 127.0.0.1 --port 3306

Lorsque l'invite Enter password: s'affiche, saisissez le mot de passe de votre compte utilisateur racine MySQL.

Vérifiez que l'invite MySQL s'affiche. Vous vous êtes connecté à votre base de données à l'aide du client mysql.

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

Pour éviter que les ressources utilisées sur cette page soient facturées sur votre compte Google Cloud, procédez comme suit :

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

   Accéder à la page Instances Cloud SQL

2. Sélectionnez l'instance myinstance pour ouvrir la page Détails de l'instance.
3. Dans la barre d'icônes en haut de la page, cliquez sur Supprimer.
4. Dans la fenêtre Supprimer l'instance, saisissez le nom de l'instance, puis cliquez sur Supprimer.

Étapes de nettoyage facultatives

Si vous n'utilisez pas les API activées dans le cadre de ce démarrage rapide, vous pouvez les désactiver.

• API activées dans ce guide de démarrage rapide :
  • API Cloud SQL Admin

1. Dans Google Cloud Console, accédez à la page API.

   Accéder aux API

2. Sélectionnez l'API Cloud SQL Admin, puis cliquez sur le bouton Désactiver l'API.

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

   Accéder à la page Instances de VM

4. Sélectionnez le nom de votre instance.

5. Sélectionnez Supprimer dans le menu Autres actions.

Étape suivante

En fonction de vos besoins, vous pouvez en apprendre plus sur la création d'instances Cloud SQL.

Vous pouvez également découvrir comment créer des utilisateurs et des bases de données MySQL pour votre instance Cloud SQL.

Vous pouvez également en savoir plus sur la connexion à une instance Cloud SQL à partir d'autres applications Google Cloud :

• depuis une application s'exécutant dans l'environnement standard App Engine ;
• Depuis une application s'exécutant sur GKE ;
• Depuis Cloud Functions
• Depuis Cloud Run