Guide de démarrage rapide pour l'utilisation d'une adresse IP privée pour le client de ligne de commande Cloud SQL pour MySQL

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

    Accéder au sélecteur de projet

  3. Assurez-vous que la facturation est activée pour votre projet Cloud. Découvrez comment vérifier que la facturation est activée pour votre projet.

  4. Assurez-vous de disposer du rôle Client Cloud SQL sur votre compte utilisateur.

    Accéder à la page IAM

  5. Activez l'API Cloud SQL Admin.

    Activer l'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 celle 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 la 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 champ connection name de l'instance et enregistrez-le pour un utilisateur ultérieur.

  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 vue de la nouvelle instance, y compris sur son adresse IP privée.

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

Vous allez l'utiliserconnection 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 l'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 :

sudo apt-get update
sudo apt-get install mariadb-server-10.3
  

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 nom du fichier 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

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

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 pour supprimer l'instance.

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

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

    Accéder à la page Instances de VM

  6. Sélectionnez le nom de votre instance.

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