Se connecter à Cloud SQL pour MySQL depuis l'environnement standard App Engine

Découvrez comment déployer un exemple d'application dans un environnement standard App Engine connecté à une instance MySQL à l'aide de la console Google Cloud et d'une application cliente.

En supposant que vous réalisiez toutes les étapes dans un délai raisonnable, les ressources créées dans ce guide de démarrage rapide coûtent généralement moins d'un dollar (USD).

Avant de commencer

  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. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

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

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

    Go to project selector

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

  6. Activez les API Cloud nécessaires à l'exécution d'un exemple d'application Cloud SQL dans l'environnement standard App Engine.

    Console

    Cliquez sur le bouton ci-dessous pour activer les API requises pour ce guide de démarrage rapide.

    Activer les API

    Cela aura pour effet d'activer les API suivantes :

    • API Cloud SQL Admin
    • API Compute Engine
    • API Cloud Build
    • API Cloud Logging

    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 suivante à l'aide de Cloud Shell :

    gcloud services enable sqladmin.googleapis.com compute.googleapis.com \
    cloudbuild.googleapis.com logging.googleapis.com

    Cette commande active les API suivantes :

    • API Cloud SQL Admin
    • API Compute Engine
    • API Cloud Build
    • API Cloud Logging

Configurer Cloud SQL

Créer une instance Cloud SQL

Créer une base de données

Console

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

    Accéder à la page Instances Cloud SQL

  2. Sélectionnez quickstart-instance.
  3. Dans le menu de navigation SQL, sélectionnez Bases de données.
  4. Cliquez sur Créer une base de données.
    1. Dans le champ Nom de la base de données de la boîte de dialogue Créer une base de données, saisissez quickstart-db. Conservez les valeurs du jeu de caractères et du classement.
    2. Cliquez sur Créer.

gcloud

Exécutez la commande gcloud sql databases create pour créer une base de données.

gcloud sql databases create quickstart-db --instance=quickstart-instance

Créer un compte utilisateur

Console

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

    Accéder à la page Instances Cloud SQL

  2. Pour ouvrir la page Présentation d'une instance, cliquez sur son nom.
  3. Dans le menu de navigation SQL, sélectionnez Utilisateurs.
  4. Cliquez sur Ajouter un compte utilisateur.
  5. Sur la page Ajouter un compte utilisateur à l'instance instance_name, ajoutez les informations suivantes :
    1. Dans le champ Nom d'utilisateur, saisissez quickstart-user.
    2. Dans le champ Mot de passe, indiquez un mot de passe pour votre utilisateur de base de données. Notez le mot de passe pour l'utiliser dans une étape ultérieure de ce guide de démarrage rapide.
  6. Cliquez sur Ajouter.

gcloud

Avant d'exécuter la commande suivante, effectuez les remplacements suivants :

  1. PASSWORD par le mot de passe de l'utilisateur de base de données. Notez-le pour l'utiliser dans une étape ultérieure de ce guide de démarrage rapide.

Exécutez la commande gcloud sql users create pour créer l'utilisateur.

gcloud sql users create quickstart-user \
--instance=quickstart-instance \
--password=PASSWORD

Les limites de longueur des noms d'utilisateur sont identiques pour Cloud SQL et pour MySQL sur site : 32 caractères pour MySQL 8.0, 16 caractères pour les versions antérieures.

Déployer un exemple d'application dans l'environnement standard App Engine

Créer l'application App Engine

Créez l'application App Engine dans votre projet Google Cloud. Cela active le service App Engine, crée une application App Engine par défaut, ainsi qu'un compte de service App Engine qui sera utilisé pour se connecter à Cloud SQL.

Console

  1. Dans la console Google Cloud, accédez à la page App Engine.

    Accéder à App Engine

  2. Cliquez sur le bouton Créer une application.
  3. Sélectionnez us-central dans le menu déroulant Sélectionner une région.
  4. Cliquez sur Suivant.
  5. Cliquez sur le lien Je le ferai plus tard une fois qu'il apparaîtra sur la page Premiers pas.

gcloud

  1. Exécutez la commande gcloud app create suivante pour créer une application App Engine :
  2. gcloud app create
  3. Lorsque vous êtes invité à choisir la région dans laquelle vous souhaitez que votre application App Engine réside, saisissez la valeur numérique de l'option us-central.

Configurer le compte de service App Engine

Configurez le compte de service utilisé par App Engine afin de lui attribuer le rôle Client Cloud SQL qui inclut les autorisations nécessaires pour se connecter à Cloud SQL.

Console

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

    Accéder à IAM

  2. Pour le compte de service nommé Compte de service Compute Engine par défaut, cliquez sur l'icône en forme de crayon.
  3. Cliquez sur Ajouter un autre rôle.
  4. Ajoutez le rôle nommé Client Cloud SQL.
  5. Cliquez sur Enregistrer.

gcloud

  1. Exécutez la commande gcloud suivante pour obtenir la liste des comptes de service de votre projet :
    gcloud iam service-accounts list
  2. Copiez l'adresse e-mail associée au compte de service App Engine.
  3. Exécutez la commande suivante pour attribuer le rôle Client Cloud SQL au compte de service App Engine :
    gcloud projects add-iam-policy-binding YOUR_PROJECT_ID \
      --member="serviceAccount:SERVICE_ACCOUNT_EMAIL" \
      --role="roles/cloudsql.client"

Configurer et déployer un exemple d'application Cloud SQL

Avec une instance, une base de données et un compte de service Cloud SQL disposant d'autorisations client, vous pouvez maintenant configurer et déployer un exemple d'application pour qu'il se connecte à votre instance Cloud SQL.

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 quickstart-instance 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 boîte de dialogue Supprimer l'instance, saisissez quickstart-instance puis cliquez sur Supprimer pour supprimer l'instance. La désactivation de votre application l'empêche d'exécuter des instances et de diffuser des requêtes. Si votre application est en train de traiter une requête, elle exécute la requête avant d'être désactivée.

Pour désactiver une application App Engine et conserver ses données, procédez comme suit :

  1. Accédez à la page Paramètres dans la console Google Cloud :

    Accéder aux paramètres

  2. Dans l'onglet Paramètres des applications, cliquez sur Désactiver l'application.

  3. Dans le champ ID de l'application, saisissez l'ID de l'application que vous souhaitez désactiver, puis cliquez sur Désactiver.

Étapes de nettoyage facultatives

Si vous n'utilisez pas le rôle Client Cloud SQL que vous avez attribué au compte de service Compute Engine, vous pouvez le supprimer.

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

    Accéder à IAM

  2. Cliquez sur l'icône de modification (en forme de crayon) pour le compte IAM nommé Compte de service Compute Engine par défaut.
  3. Supprimez le rôle Client Cloud SQL.
  4. Cliquez sur Enregistrer.

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 Compute Engine
    • API Cloud SQL Admin
    • API Cloud Run
    • API Container Registry
    • API Cloud Build
  1. Dans Google Cloud Console, accédez à la page API.

    Accéder aux API

  2. Sélectionnez l'API que vous souhaitez désactiver, puis cliquez sur le bouton Désactiver l'API.

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

Pour en savoir plus sur la tarification, consultez la page Tarifs de Cloud SQL pour MySQL.

En savoir plus :

  • Configurez votre instance Cloud SQL avec une adresse IP publique.
  • Configurez votre instance Cloud SQL avec une adresse IP privée.

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