Se connecter à l'aide d'un client de base de données à partir d'une machine locale ou de Compute Engine

Cette page décrit comment connecter un client mysql à votre instance Cloud SQL, qu'elle s'exécute localement sur votre machine cliente, sur une VM Compute Engine ou dans Cloud Shell.

Avant de commencer

Pour pouvoir utiliser un client, vous devez avoir :

Utiliser un client sur une machine locale ou une VM Compute Engine

L'utilisation d'un client mysql pour se connecter à votre instance Cloud SQL implique trois tâches de haut niveau :

  1. Installer le client
  2. Configurer l'accès à l'instance Cloud SQL
  3. Se connecter à l'instance Cloud SQL

Installer le client

Pour installer le client, procédez comme suit :

Debian/Ubuntu

Installez le client MySQL depuis le gestionnaire de packages :

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

CentOS/RHEL

Installez le client MySQL depuis le gestionnaire de packages :

sudo yum install mysql

openSUSE

Installez le client MySQL depuis le gestionnaire de packages :

sudo zypper install mysql-server

Autres plates-formes

  1. Téléchargez le serveur MySQL Community Server destiné à votre plate-forme sur la page de téléchargement de MySQL Community Server.
    Ce serveur inclut le client MySQL.
  2. Installez le serveur Community Server conformément aux instructions indiquées sur la page de téléchargement.

Pour en savoir plus sur l'installation de MySQL, consultez la section Installer et mettre à niveau MySQL.

Configurer l'accès à l'instance Cloud SQL

Pour configurer l'accès à l'instance :

  1. À partir de la machine cliente ou de l'instance de VM Compute Engine, accédez à la page d'identification d'adresse IP pour afficher l'adresse IP de la machine cliente.
  2. Copiez cette adresse IP.
  3. Dans Google Cloud Console, accédez à la page Instances Cloud SQL.

    Accéder à la page Instances Cloud SQL

  4. Cliquez sur le nom de l'instance pour ouvrir la page Présentation.
  5. Dans le menu de navigation SQL, sélectionnez Connexions.
  6. Dans la section Réseaux autorisés, cliquez sur Ajouter un réseau puis saisissez l'adresse IP de la machine sur laquelle le client est installé.
  7. Cliquez sur OK, puis sur Enregistrer en bas de la page pour enregistrer les modifications.
  8. Connectez-vous à l'instance, avec SSL ou sans SSL.

Se connecter à l'instance Cloud SQL sans chiffrement

Pour vous connecter à l'instance, procédez comme suit :

  1. Vérifiez que vous avez installé le client et configuré l'accès à votre instance.
  2. Lancez le client mysql :
    mysql --host=INSTANCE_IP --user=root --password
    
  3. Saisissez votre mot de passe.
  4. L'invite mysql s'affiche.

Se connecter à l'instance Cloud SQL à l'aide de SSL

Pour vous connecter avec SSL, vous avez besoin des éléments suivants :

  • Un certificat d'autorité de certification dans un fichier server-ca.pem
  • Un certificat de clé publique du client dans un fichier client-cert.pem
  • Une clé privée du client dans un fichier client-key.pem

Si vous ne disposez pas d'un certificat client et d'une clé privée correspondante, créez un certificat client.

Avant de commencer, vérifiez que vous avez installé le client et configuré l'accès à votre instance.

Pour vous connecter en SSL à l'instance :

  1. Lancez le client mysql :

    mysql --ssl-ca=server-ca.pem --ssl-cert=client-cert.pem --ssl-key=client-key.pem \
                 --host=INSTANCE_IP --user=root --password
    

  2. Saisissez le mot de passe.
  3. Lorsque MySQL vous y invite, saisissez la commande \s pour vérifier que votre connexion utilise SSL.
  4. Recherchez la ligne de sortie comprenant SSL:.
    ...
    SSL:                     Cipher in use is DHE-RSA-AES256-SHA
    ...
    

    Pour en savoir plus sur la résolution des problèmes de connexion via IP, consultez la page Diagnostiquer les problèmes liés aux instances Cloud SQL.

Utiliser le client dans Cloud Shell

Pour vous connecter à une instance Cloud SQL (adresse IP publique uniquement), procédez comme suit :

  1. Accédez à Google Cloud Console.

    Accéder à Google Cloud Console

  2. Cliquez sur l'icône Cloud Shell  située à droite dans la barre d'outils.

    L'initialisation de Cloud Shell prend quelques instants.

  3. Lorsque Cloud Shell vous y invite, connectez-vous à l'instance Cloud SQL à l'aide du client intégré.
    gcloud sql connect INSTANCE_ID \
    --user=root
    
  4. Saisissez votre mot de passe.

La commande gcloud sql connect ne permet pas de se connecter à une instance Cloud SQL à l'aide d'une adresse IP privée, ni de SSL/TLS. Pour vous connecter avec un chiffrement, installez et utilisez le proxy dans Cloud Shell :

  1. Installez le proxy (Linux 64 bits) dans le répertoire /home/USER.
  2. Démarrez le proxy en utilisant l'authentification via le SDK Cloud :

    ./cloud_sql_proxy -instances=INSTANCE_CONNECTION_NAME=tcp:3306 &

  3. Connectez-vous à la base de données à l'aide de la connexion TCP :

    mysql -u=USERNAME -p --host=127.0.0.1

Étape suivante

Faites l'essai

Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de Cloud SQL 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.

Profiter d'un essai gratuit de Cloud SQL