Se connecter à Cloud SQL pour PostgreSQL depuis Compute Engine

Découvrez comment déployer un exemple d'application sur votre instance de VM Compute Engine basée sur Linux ou Windows connectée à une instance PostgreSQL à 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. 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.

    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.

    Go to project selector

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

  6. Activez les API Cloud nécessaires à l'exécution d'un exemple d'application Cloud SQL sur une instance de VM Compute Engine.

    Console

    Cliquez sur le bouton Activer des API pour activer les API requises pour ce guide de démarrage rapide.

    Activer les API

    Cette action active l'API suivante :

    • API Cloud SQL Admin

    gcloud

    Installez gcloud CLI qui fournit un accès en ligne de commande à vos ressources Google Cloud. gcloud CLI permet d'exécuter les commandes gcloud CLI présentées tout au long de ce guide de démarrage rapide. Toutes les commandes sont formatées pour être exécutées dans un terminal ou une fenêtre PowerShell.

    Exécutez la commande gcloud suivante :

    gcloud services enable sqladmin.googleapis.com

    Cette commande active l'API suivante :

    • API Cloud SQL Admin

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. Ouvrez l'onglet Bases de données.
  4. Cliquez sur Créer une base de données.
    1. Dans la boîte de dialogue Nouvelle base de données, saisissez quickstart_db comme nom de la base de données.
    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 :
    • Dans le champ Nom d'utilisateur, saisissez quickstart-user.
    • Dans le champ Mot de passe, indiquez un mot de passe pour votre utilisateur de base de données. Notez-le 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 PostgreSQL sur site.

Configurer un compte de service Compute Engine

Créez et configurez un compte de service Google Cloud doté du rôle Client Cloud SQL avec les autorisations nécessaires pour se connecter à Cloud SQL. Une fois le compte de service créé, vous devrez peut-être attendre au moins 60 secondes avant de l'utiliser.

Console

Créer un compte de service

  1. Dans la console Google Cloud, accédez à la page Créer un compte de service.
  2. Accéder à la page "Créer un compte de service"

  3. Sélectionnez un projet Google Cloud.
  4. Saisissez quickstart-service-account comme nom de compte de service.
  5. Facultatif : saisissez la description du compte de service.
  6. Cliquez sur Créer et continuer, puis passez à l'étape suivante.
  7. Choisissez le rôle Client Cloud SQL à attribuer au compte de service du projet.
  8. Cliquez sur Ajouter un autre rôle, puis choisissez le rôle Lecteur des objets Storage à attribuer au compte de service du projet.
  9. Cliquez sur Continuer.
  10. Cliquez sur OK pour terminer la création du compte de service.

gcloud

Créer un compte de service

  1. Pour créer le compte de service, exécutez la commande gcloud iam service-accounts create :
  2. gcloud iam service-accounts create quickstart-service-account --description="DESCRIPTION" --display-name="quickstart-service-account"

    Remplacez la valeur suivante :

    • DESCRIPTION : description facultative du compte de service.
  3. Pour attribuer à votre compte de service le rôle Client Cloud SQL et Lecteur des objets Storage sur votre projet, exécutez la commandegcloud projects add-iam-policy-binding. Remplacez PROJECT_ID par l'ID de votre projet Google Cloud.
    gcloud projects add-iam-policy-binding PROJECT_ID --member="serviceAccount:quickstart-service-account@PROJECT_ID.iam.gserviceaccount.com" --role="roles/cloudsql.client" --role="roles/storage.objectViewer"

Créer une instance de VM Compute Engine

Créez une instance de VM Compute Engine afin d'héberger un exemple d'application Web connectée à Cloud SQL.

Accéder à une instance de VM Compute Engine

Configurer l'environnement de développement pour le langage de programmation

Configurez l'environnement de développement de l'instance de VM Compute Engine pour le langage de programmation de votre choix.

Installer Git

Installez Git, un système de contrôle des versions Open Source sur votre instance de VM Compute Engine.

Cloner l'exemple d'application

Clonez un exemple d'application sur votre instance de VM Compute Engine à l'aide de la commande git clone.

Go

Sur votre instance de VM Compute Engine, ouvrez un nouveau terminal ou une nouvelle fenêtre Powershell. Exécutez les commandes suivantes pour cloner l'exemple d'application Go et remplacer le répertoire par celui qui contient l'exemple d'application.

  1. Clonez l'exemple d'application
    git clone https://github.com/GoogleCloudPlatform/golang-samples
  2. Remplacez le répertoire actuel par celui qui contient l'exemple d'application.
    cd golang-samples/cloudsql/postgres/database-sql

Java

Sur votre instance de VM Compute Engine, ouvrez un nouveau terminal ou une nouvelle fenêtre Powershell. Exécutez les commandes suivantes pour cloner l'exemple d'application Java et remplacer le répertoire par celui qui contient l'exemple d'application.

  1. Clonez l'exemple d'application
    git clone https://github.com/GoogleCloudPlatform/java-docs-samples
  2. Remplacez le répertoire actuel par celui qui contient l'exemple d'application.
    cd java-docs-samples/cloud-sql/postgres/servlet

Node.js

Sur votre instance de VM Compute Engine, ouvrez un nouveau terminal ou une nouvelle fenêtre Powershell. Exécutez les commandes suivantes pour cloner l'exemple d'application Node.js et remplacer le répertoire par celui qui contient l'exemple d'application.

  1. Clonez l'exemple d'application
    git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples
  2. Remplacez le répertoire actuel par celui qui contient l'exemple d'application.
    cd nodejs-docs-samples/cloud-sql/postgres/knex

Python

Sur votre instance de VM Compute Engine, ouvrez un nouveau terminal ou une nouvelle fenêtre Powershell. Exécutez les commandes suivantes pour cloner l'exemple d'application Python et remplacer le répertoire par celui qui contient l'exemple d'application.

  1. Clonez l'exemple d'application
    git clone https://github.com/GoogleCloudPlatform/python-docs-samples
  2. Remplacez le répertoire actuel par celui qui contient l'exemple d'application.
    cd python-docs-samples/cloud-sql/postgres/sqlalchemy

Configurer et exécuter un exemple d'application Cloud SQL

Avec une instance, une base de données et un compte de service Cloud SQL disposant des autorisations client, vous pouvez maintenant configurer un exemple d'application s'exécutant sur votre instance de VM Compute Engine pour vous connecter à 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 :

Supprimer une instance Cloud SQL

  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.

Supprimer une instance de VM Compute Engine

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

    Accéder à la page Instances de VM

  2. Sélectionnez l'instance quickstart-vm-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. Cliquez sur Supprimer pour supprimer l'instance.

É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 default, vous pouvez le supprimer.

  1. Dans la console Google Cloud, 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 l'API activée dans le cadre de ce guide de démarrage rapide, vous pouvez la désactiver.

  • API activée dans ce guide de démarrage rapide :
    • API Cloud SQL Admin
  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 PostgreSQL pour votre instance Cloud SQL.

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

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 :