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 Google Cloud console, 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.

Connectez-vous à votre Google Cloud compte. 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 sans frais 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.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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

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

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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

Verify that billing is enabled for your Google Cloud project.

1. Vérifiez que vous disposez des autorisations requises pour suivre les instructions de ce guide de démarrage rapide.
2. Activez les API nécessaires Google Cloud .

   Console

   Dans la 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 Google Cloud ressources 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.

Rôles requis

Pour obtenir les autorisations nécessaires pour configurer Cloud SQL avec une adresse IP privée, demandez à votre administrateur de vous accorder les rôles IAM suivants sur le projet que vous souhaitez configurer et auquel vous connecter :

• Créer ou supprimer une instance, une base de données et un utilisateur: rôle Administrateur Cloud SQL (roles/cloudsql.admin)
• Créer ou supprimer un compte de service IAM : rôle Administrateur de compte de service IAM (roles/iam.serviceAccountAdmin).
• Créer ou supprimer une instance de calcul :
  • Rôle Administrateur de Compute (roles/compute.admin)
  • Rôle Administrateur d'instance Compute (roles/compute.instanceAdmin.v1)
• Créer une connexion :
  • Administrateur des réseaux de services (roles/servicenetworking.networksAdmin))
  • Administrateur de Service Usage (roles/serviceusage.serviceUsageAdmin)

Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises via des rôles personnalisés ou d'autres rôles prédéfinis.

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 Google Cloud projet, 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 Google Cloud projet 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

Pour créer une instance qui utilise des connexions IP privées, procédez comme suit :

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

   Accéder à la page Instances Cloud SQL

2. Sélectionnez l'onglet MySQL, puis cliquez sur Créer une instance Sandbox dans la zone Sandbox. Vous pouvez également cliquer surCréer une instance et procéder comme suit :
1. Cliquez sur Choisir MySQL.
2. Sélectionnez l'édition Enterprise.
3. Choisissez le préréglage Sandbox.
3. Si vous êtes invité à activer l'API Compute, cliquez sur le bouton Activer l'API.
4. Dans la section Informations sur l'instance, saisissez un nom pour l'ID d'instance.
5. 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.
6. Dans la section Sélectionner la disponibilité régionale et zonale, sélectionnez l'option Zone unique.
7. Développez la section Afficher les options de configuration.
8. Développez Connexions.
9. Désactivez l'option Adresse IP publique.
10. Sélectionnez Adresse IP privée.
11. Sélectionnez Accès aux services privés.
12. Dans la liste déroulante Réseau VPC, sélectionnez Par défaut.
13. Si vous utilisez un nouveau projet, le message La connexion réseau n'est pas configurée s'affiche. Une zone intitulée Confirmation de la configuration réseau requise vous redirige vers la documentation VPC pour configurer l'accès aux services privés.
1. Dans la Google Cloud console, accédez à la page Réseaux VPC :

   Accéder aux réseaux VPC

2. Sélectionnez le réseau VPC default.
3. Définissez une règle de pare-feu qui autorise l'accès au port TCP 22 :
1. Sélectionnez l'onglet Pare-feu.
2. Sous Règles de pare-feu VPC, sélectionnez Créer une règle de pare-feu VPC.
3. Attribuez un nom à la règle de pare-feu.
4. Sous Cibles, sélectionnez Toutes les instances du réseau.
5. Sous Plages d'adresses IPv4 sources, saisissez 0.0.0.0/0.
6. Sous Protocoles et ports, cochez la case TCP, puis dans la zone Ports située juste en dessous, saisissez 22.
7. Sélectionnez Créer.
4. Allouez une plage d'adresses IP :
1. Sélectionnez l'onglet Accès aux services privés.
2. Dans l'onglet Accès aux services privés, sélectionnez l'onglet Plages d'adresses IP allouées pour les services.
3. Cliquez sur Allouer une plage d'adresses IP.
4. Saisissez un nom et, si vous le souhaitez, une description pour la plage allouée.
5. Pour laisser Google sélectionner une plage disponible, sélectionnez Automatique.
6. Saisissez une longueur de préfixe comprise entre 16 et 124 (le nombre d'adresses allouées est égal à 2 à la puissance (32 - longueur du préfixe)).
7. Cliquez sur Allouer pour créer la plage allouée.
5. Créez une connexion privée :
1. Dans l'onglet Accès aux services privés, passez à l'onglet Connexions privées aux services.
2. Cliquez sur le bouton Créer une connexion.
3. Dans la liste déroulante Allocation attribuée de la zone Créer une connexion privée connection box, sélectionnez le nom de la plage d'adresses IP que vous just created.
4. Cliquez sur Se connecter.
6. Une fois la connexion créée, revenez à l'endroit où vous avez créé votre instance Cloud SQL, puis cliquez sur Confirmer la connexion.
14. Une fois la connexion d'accès aux services privés créée, cliquez sur Créer une instance.

Vous êtes redirigé vers la page de présentation de l'instance pendant la création de la nouvelle instance.

Une fois la création de l'instance terminée, faites défiler la page jusqu'à la section Se connecter à cette instance , puis enregistrez le nom de connexion de l'instance. Le connection name est au format projectID:region:instanceID. Vous utiliserez ce connection name lors du démarrage du proxy d'authentification Cloud SQL.

Créer une VM Compute Engine

Pour créer une VM, procédez comme suit :

1. Dans la 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. Sélectionnez Protection des données dans le volet de navigation, puis sélectionnez Aucune sauvegarde.
5. Sélectionnez Sécurité dans le volet de navigation, puis sous Niveaux d'accès, sélectionnez Autoriser l'accès complet à l'ensemble des API Cloud.
6. 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 default-mysql-client
  

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 que l'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 le 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 dans cette démonstration soient facturées sur votre Google Cloud compte pour les ressources utilisées sur cette page, procédez comme suit :

1. Dans la 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 la 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 la 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 MySQL et des bases de données pour votre instance Cloud SQL.

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

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