Guide de démarrage rapide avec Cloud SQL et 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.

Configurer votre projet

Avant de suivre les étapes de ce guide de démarrage rapide, réalisez les tâches suivantes :

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

5. Make sure that billing is enabled for your Google Cloud project.

6. Assurez-vous que vous disposez du rôle d'administrateur Cloud SQL sur votre compte utilisateur.
   1. Accédez à la page IAM.
      Accéder à la page IAM
   2. Cliquez sur Ajouter.
   3. Dans Nouveaux comptes principaux, ajoutez le nom de votre compte utilisateur.
   4. Dans Sélectionner un rôle, recherchez le filtre Administrateur Cloud SQL et sélectionnez-le dans la liste.
   5. Cliquez sur Enregistrer.

7. Activez l'API Cloud SQL Admin et l'API Compute Engine.
   Activez les API

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. Ouvrez deux fenêtres SSH dans la VM.

   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. Installez un client mysql dans la fenêtre SSH 1.
5. Installez le proxy d'authentification Cloud SQL dans la fenêtre SSH 1.

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

6. Démarrez le proxy d'authentification Cloud SQL dans la fenêtre SSH 1.

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

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

8. Effectuez un nettoyage.

   Supprimez l'instance Cloud SQL et la VM Compute Engine.

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-server-10.3
sudo service mysqld stop
  

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://dl.google.com/cloudsql/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 -instances=INSTANCE_CONNECTION_NAME=tcp:3306

Remarque  : 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

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

   Accéder à la page Instances Cloud SQL

2. Sélectionnez le nom de l'instance pour ouvrir la page Présentation.
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.

Vous ne pouvez pas réutiliser le nom d'une instance pendant environ sept jours après la suppression de cette instance.

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

   Accéder à la page Instances de VM

2. Sélectionnez le nom de votre instance.
3. 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