Se connecter à Cloud SQL pour PostgreSQL depuis votre ordinateur local

Se connecter à Cloud SQL pour PostgreSQL depuis votre ordinateur local

MySQL | PostgreSQL | SQL Server

Découvrez comment déployer un exemple d'application sur votre ordinateur local Linux, macOS ou Windows connecté à 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

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.

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.

   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

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.

   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

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 votre ordinateur local.

   Console

   Cliquez sur le bouton Activer des API 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 IAM

   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 Linux/macOS ou dans Windows PowerShell.

   Ouvrez le terminal et exécutez la commande gcloud suivante :

   gcloud services enable sqladmin.googleapis.com iam.googleapis.com

   Cette commande active les API suivantes :

   • API Cloud SQL Admin
   • API IAM

Configurer Cloud SQL

Créer une instance Cloud SQL

Console

Créer une instance avec une adresse IP publique

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

   Accéder à la page Instances Cloud SQL

2. Cliquez sur Créer une instance.
3. Cliquez sur Choisir PostgreSQL.
4. Dans le champ ID d'instance, saisissez quickstart-instance.
5. Indiquez le mot de passe de l'utilisateur postgres. Enregistrez ce mot de passe pour une utilisation ultérieure.
6. Sous Choisir la disponibilité régionale et zonale, cliquez sur l'option Zone unique.
7. Cliquez et développez la section Afficher les options de configuration.
8. Dans le menu déroulant Type de machine, sélectionnez Configuration légère.

9. Cliquez sur Créer une instance et attendez que l'instance s'initialise et démarre.

gcloud

Créer une instance avec une adresse IP publique

Avant d'exécuter la commande gcloud sql instances create comme suit, remplacez DB_ROOT_PASSWORD par le mot de passe de votre utilisateur de base de données.

Vous pouvez également modifier les valeurs des paramètres suivants :

• --database_version : type et version du moteur de base de données. Si aucune valeur n'est spécifiée, la valeur par défaut de l'API est utilisée. Consultez la documentation de gcloud database versions pour afficher les versions actuellement disponibles.
• --cpu : nombre de cœurs à définir dans la machine.
• --memory : valeur entière indiquant la quantité de mémoire à définir dans la machine. Une unité de taille doit être fournie (par exemple, 3072 Mo ou 9 Go). Si aucune unité n'est spécifiée, la valeur par défaut est Go.
• --region : emplacement régional de l'instance (par exemple, asia-east1, us-east1). Si aucune opération n'est spécifiée, la valeur par défaut us-central est utilisée. Consultez la liste complète des régions.

Exécutez la commande gcloud sql instances create pour créer une instance Cloud SQL.

gcloud sql instances create quickstart-instance --database-version=POSTGRES_13 --cpu=1 --memory=4GB --region=us-central --root-password=DB_ROOT_PASSWORD

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

Remplacez les éléments 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

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.

Accéder à la page "Créer un compte de service"

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

Créer et télécharger le fichier de clé du compte de service

1. Dans Google Cloud Console, accédez à la page Comptes de service.

Accéder à la page "Comptes de service"

2. Sélectionnez un projet.
3. Cliquez sur l'adresse e-mail du compte de service quickstart-service-account pour lequel vous souhaitez créer une clé.
4. Cliquez sur l'onglet Clés.
5. Cliquez sur le menu déroulant Ajouter une clé, puis sélectionnez Créer une clé.
6. Sélectionnez JSON comme JSON et cliquez sur JSON (Créer).

Cliquez sur Créer pour télécharger un fichier de clé de compte de service. Une fois téléchargé, vous ne pouvez plus le télécharger à nouveau.

Veillez à stocker le fichier de clé en toute sécurité, car il peut être utilisé pour s'authentifier en tant que compte de service. Vous pouvez déplacer et renommer ce fichier comme vous le souhaitez.

gcloud

Créer un compte de service

1. Pour créer le compte de service, exécutez la commande gcloud iam service-accounts create :

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.
2. Pour attribuer le rôle Client Cloud SQL à votre compte de service sur votre projet, exécutez la commande gcloud 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"

Créer et télécharger le fichier de clé du compte de service

Pour utiliser le compte de service que vous venez de créer sur votre ordinateur local, vous devez disposer d'un fichier de clé de compte de service pour authentifier l'exemple d'application en tant que compte de service. Pour créer et télécharger le fichier de clé du compte de service, exécutez la commande gcloud iam service-accounts keys create :

gcloud iam service-accounts keys create KEY_FILE --iam-account=quickstart-service-account@PROJECT_ID.iam.gserviceaccount.com

Remplacez les valeurs suivantes :

• KEY_FILE : chemin d'accès à un nouveau fichier de sortie destiné à la clé privée, par exemple ~/sa-private-key.json.
• PROJECT_ID : ID de votre projet Google Cloud.

Le fichier de clé du compte de service est maintenant téléchargé sur votre ordinateur local. Une fois téléchargé, vous ne pouvez plus le télécharger à nouveau.

Veillez à stocker le fichier de clé en toute sécurité, car tout le monde peut l'utiliser pour s'authentifier en tant que compte de service. Vous pouvez déplacer et renommer ce fichier comme vous le souhaitez.

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

Configurez l'environnement de développement de votre ordinateur local pour votre langage de programmation préféré.

Go

Pour configurer votre environnement de développement afin d'exécuter l'exemple d'application Go, procédez comme suit :

1. Accédez au guide de configuration pour un environnement de développement Go.
2. Suivez les instructions de la section Installer Go.

Java

Pour configurer votre environnement de développement afin d'exécuter l'exemple d'application Java, procédez comme suit :

1. Accédez au guide de configuration d'un environnement de développement Java.
2. Suivez les instructions de la section Installer un JDK (kit de développement Java).
3. Suivez les instructions de la section Installer un outil d'automatisation de la compilation pour configurer Apache Maven.

Node.js

Suivez les étapes ci-dessous pour configurer votre environnement de développement et exécuter l'exemple d'application Node.js.

1. Accédez au guide de configuration pour un environnement de développement Node.js.
2. Suivez les instructions de la section Installer Node.js et npm.

Python

Pour configurer votre environnement de développement afin d'exécuter l'exemple d'application Python, procédez comme suit :

1. Accédez au guide de configuration pour un environnement de développement Python.
2. Suivez les instructions de la section Installer Python.

Installer Git

Installez Git, un système de contrôle des versions Open Source.

Linux

Suivez la documentation d'installation de Git officielle pour Linux.

macOS

Suivez la documentation officielle d'installation de Git pour macOS.

Windows

Suivez la documentation d'installation de Git officielle pour Windows.

Cloner une application exemple

Clonez un exemple d'application sur votre ordinateur local à l'aide de la commande git clone.

Go

Exécutez les commandes suivantes pour cloner l'exemple d'application Go sur votre ordinateur local et accéder au répertoire contenant 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

Exécutez les commandes suivantes pour cloner l'exemple d'application Java sur votre ordinateur local et accéder au répertoire contenant 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

Exécutez les commandes suivantes pour cloner l'exemple d'application Node.js sur votre ordinateur local et accéder au répertoire contenant 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

Exécutez les commandes suivantes pour cloner l'exemple d'application Python sur votre ordinateur local et accéder au répertoire contenant 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

Configurez et exécutez l'exemple d'application.

Linux/macOS

Go

Ouvrez le terminal et exécutez les commandes suivantes pour initialiser les variables d'environnement requises pour exécuter l'exemple d'application. Avant d'exécuter les commandes, effectuez les remplacements suivants :

• CREDENTIALS_JSON_FILE par le chemin d'accès du fichier de clé JSON des identifiants de votre compte de service à l'aide d'un format tel que /path/to/service/account/key.json.
• INSTANCE_CONNECTION_NAME par le nom de connexion de votre instance qui apparaît sur la page Présentation de l'instance Cloud SQL.
• YOUR_DB_PASSWORD par le mot de passe du quickstart-user que vous avez créé à l'étape précédente Créer un utilisateur de ce guide de démarrage rapide.

export GOOGLE_APPLICATION_CREDENTIALS=CREDENTIALS_JSON_FILE
export INSTANCE_CONNECTION_NAME='INSTANCE_CONNECTION_NAME'
export DB_PORT='5432'
export DB_NAME='quickstart_db'
export DB_USER='quickstart-user'
export DB_PASS='YOUR_DB_PASSWORD'

Exécutez les commandes suivantes pour obtenir les dépendances de l'exemple d'application Go sur votre ordinateur local et exécuter l'exemple d'application.

1. Obtenez les dépendances requises pour exécuter l'exemple d'application.

   go get ./...
   

2. Exécuter l'application exemple

   go run cmd/app/main.go
   

3. Affichez l'exemple d'application en cours d'exécution. Ouvrez une fenêtre de navigateur et accédez à http://127.0.0.1:8080.

   

4. Pour arrêter l'exemple d'application, appuyez sur Ctrl+C dans la fenêtre de terminal où vous avez démarré l'exemple d'application.

Java

Exécutez les commandes suivantes pour initialiser les variables d'environnement requises pour exécuter l'exemple d'application. Avant d'exécuter les commandes, effectuez les remplacements suivants :

• CREDENTIALS_JSON_FILE par le chemin d'accès du fichier de clé JSON des identifiants de votre compte de service à l'aide d'un format tel que /path/to/service/account/key.json.
• INSTANCE_CONNECTION_NAME par le nom de connexion de votre instance qui apparaît sur la page Présentation de l'instance Cloud SQL.
• YOUR_DB_PASSWORD par le mot de passe du quickstart-user que vous avez créé à l'étape précédente Créer un utilisateur de ce guide de démarrage rapide.

export GOOGLE_APPLICATION_CREDENTIALS=CREDENTIALS_JSON_FILE
export INSTANCE_CONNECTION_NAME='INSTANCE_CONNECTION_NAME'
export DB_PORT='5432'
export DB_NAME='quickstart_db'
export DB_USER='quickstart-user'
export DB_PASS='YOUR_DB_PASSWORD'

1. Exécutez la commande suivante pour obtenir les dépendances de l'exemple d'application Java sur votre ordinateur local et exécuter l'exemple d'application.

   mvn jetty:run
   

2. Affichez l'exemple d'application en cours d'exécution. Ouvrez une fenêtre de navigateur et accédez à http://127.0.0.1:8080.

   

3. Pour arrêter l'exemple d'application, appuyez sur Ctrl+C dans la fenêtre de terminal où vous avez démarré l'exemple d'application.

Node.js

1. Exécutez les commandes suivantes pour initialiser les variables d'environnement requises pour exécuter l'exemple d'application. Avant d'exécuter les commandes, effectuez les remplacements suivants :

   • CREDENTIALS_JSON_FILE par le chemin d'accès du fichier de clé JSON des identifiants de votre compte de service à l'aide d'un format tel que /path/to/service/account/key.json.
   • YOUR_DB_PASSWORD par le mot de passe du quickstart-user que vous avez créé à l'étape précédente Créer un utilisateur de ce guide de démarrage rapide.

   export GOOGLE_APPLICATION_CREDENTIALS=CREDENTIALS_JSON_FILE
   export INSTANCE_HOST='127.0.0.1'
   export DB_PORT='5432'
   export DB_NAME='quickstart_db'
   export DB_USER='quickstart-user'
   export DB_PASS='YOUR_DB_PASSWORD'
   

2. Téléchargez le proxy d'authentification Cloud SQL :

   curl -o cloud-sql-proxy \
   https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.0.0/cloud-sql-proxy.linux.amd64

3. Exécutez le proxy d'authentification Cloud SQL en arrière-plan. Remplacez INSTANCE_CONNECTION_NAME par le nom de connexion de l'instance. Il apparaît sur la page Présentation de l'instance Cloud SQL.

   ./cloud-sql-proxy \
   --credentials-file $GOOGLE_APPLICATION_CREDENTIALS \
   INSTANCE_CONNECTION_NAME &

Remarque : Le processus exécutant le proxy d'authentification Cloud SQL en arrière-plan peut être arrêté à l'aide de la commande fg dans votre fenêtre de terminal où vous avez démarré l'exemple d'application. Cela devrait afficher la tâche de proxy d'authentification Cloud SQL en cours d'exécution au premier plan du terminal. Appuyez ensuite sur les touches Ctrl+C pour arrêter la tâche de proxy.

Exécutez les commandes suivantes pour transférer les packages Node.js requis sur votre ordinateur local et exécuter l'exemple d'application.

1. Installez les packages Node.js nécessaires à l'exécution locale de l'application.

   npm install
   

2. Exécuter l'application exemple

   npm start
   

3. Affichez l'exemple d'application en cours d'exécution. Ouvrez une fenêtre de navigateur et accédez à http://127.0.0.1:8080.

   

4. Pour arrêter l'exemple d'application, appuyez sur Ctrl+C dans la fenêtre de terminal où vous avez démarré l'exemple d'application.

Python

Exécutez les commandes suivantes pour initialiser les variables d'environnement requises pour exécuter l'exemple d'application. Avant d'exécuter les commandes, effectuez les remplacements suivants :

• CREDENTIALS_JSON_FILE par le chemin d'accès du fichier de clé JSON des identifiants de votre compte de service à l'aide d'un format tel que /path/to/service/account/key.json.
• INSTANCE_CONNECTION_NAME par le nom de connexion de votre instance qui apparaît sur la page Présentation de l'instance Cloud SQL.
• YOUR_DB_PASSWORD par le mot de passe du quickstart-user que vous avez créé à l'étape précédente Créer un utilisateur de ce guide de démarrage rapide.

export GOOGLE_APPLICATION_CREDENTIALS=CREDENTIALS_JSON_FILE
export INSTANCE_CONNECTION_NAME='INSTANCE_CONNECTION_NAME'
export DB_PORT='5432'
export DB_NAME='quickstart_db'
export DB_USER='quickstart-user'
export DB_PASS='YOUR_DB_PASSWORD'

Exécutez les commandes suivantes pour obtenir les exigences de l'exemple d'application Python sur votre ordinateur local et exécuter l'exemple d'application.

1. Initialisez un environnement virtuel et installez les conditions requises pour exécuter l'exemple d'application.

   python3 -m venv env
   source env/bin/activate
   pip install -r requirements.txt
   

2. Exécuter l'application exemple

   python app.py
   

3. Affichez l'exemple d'application en cours d'exécution. Ouvrez une fenêtre de navigateur et accédez à http://127.0.0.1:8080.

   

4. Pour arrêter l'exemple d'application, appuyez sur Ctrl+C dans la fenêtre de terminal où vous avez démarré l'exemple d'application.

Windows

Go

Exécutez les commandes suivantes pour initialiser les variables d'environnement requises pour exécuter l'exemple d'application. Avant d'exécuter les commandes, effectuez les remplacements suivants :

• CREDENTIALS_JSON_FILE par le chemin d'accès du fichier de clé JSON des identifiants de votre compte de service à l'aide d'un format tel que C:\Users\Your-Username\Downloads\key.json.
• INSTANCE_CONNECTION_NAME par le nom de connexion de votre instance qui apparaît sur la page Présentation de l'instance Cloud SQL.
• YOUR_DB_PASSWORD par le mot de passe du quickstart-user que vous avez créé à l'étape précédente Créer un utilisateur de ce guide de démarrage rapide.

$env:GOOGLE_APPLICATION_CREDENTIALS="CREDENTIALS_JSON_FILE"
$env:INSTANCE_CONNECTION_NAME="INSTANCE_CONNECTION_NAME"
$env:DB_PORT="5432"
$env:DB_NAME="quickstart_db"
$env:DB_USER="quickstart-user"
$env:DB_PASS="YOUR_DB_PASSWORD"

Exécutez les commandes suivantes pour obtenir les dépendances de l'exemple d'application Go sur votre ordinateur local et exécuter l'exemple d'application.

1. Obtenez les dépendances requises pour exécuter l'exemple d'application.

   go get ./...
   

2. Exécuter l'application exemple

   go run cmd\app\main.go
   

3. Affichez l'exemple d'application en cours d'exécution. Ouvrez une fenêtre de navigateur et accédez à http://127.0.0.1:8080.

   

4. Pour arrêter l'exemple d'application, appuyez sur Ctrl+C dans la fenêtre Powershell dans laquelle vous avez démarré l'exemple d'application.

Java

Exécutez les commandes suivantes pour initialiser les variables d'environnement requises pour exécuter l'exemple d'application. Avant d'exécuter les commandes, effectuez les remplacements suivants :

• CREDENTIALS_JSON_FILE par le chemin d'accès du fichier de clé JSON des identifiants de votre compte de service à l'aide d'un format tel que C:\Users\Your-Username\Downloads\key.json.
• INSTANCE_CONNECTION_NAME par le nom de connexion de votre instance qui apparaît sur la page Présentation de l'instance Cloud SQL.
• YOUR_DB_PASSWORD par le mot de passe du quickstart-user que vous avez créé à l'étape précédente Créer un utilisateur de ce guide de démarrage rapide.

$env:GOOGLE_APPLICATION_CREDENTIALS="CREDENTIALS_JSON_FILE"
$env:INSTANCE_CONNECTION_NAME="INSTANCE_CONNECTION_NAME"
$env:DB_PORT="5432"
$env:DB_NAME="quickstart_db"
$env:DB_USER="quickstart-user"
$env:DB_PASS="YOUR_DB_PASSWORD"

1. Exécutez la commande suivante pour obtenir les dépendances de l'exemple d'application Java sur votre ordinateur local et exécuter l'exemple d'application.

   mvn jetty:run
   

2. Affichez l'exemple d'application en cours d'exécution. Ouvrez une fenêtre de navigateur et accédez à http://127.0.0.1:8080.

   

3. Pour arrêter l'exemple d'application, appuyez sur Ctrl+C dans la fenêtre Powershell dans laquelle vous avez démarré l'exemple d'application.

Node.js

1. Exécutez les commandes suivantes pour initialiser les variables d'environnement requises pour exécuter l'exemple d'application. Avant d'exécuter les commandes, effectuez les remplacements suivants :

   • CREDENTIALS_JSON_FILE par le chemin d'accès du fichier de clé JSON des identifiants de votre compte de service à l'aide d'un format tel que C:\Users\Your-Username\Downloads\key.json.
   • YOUR_DB_PASSWORD par le mot de passe du quickstart-user que vous avez créé à l'étape précédente Créer un utilisateur de ce guide de démarrage rapide.

   $env:GOOGLE_APPLICATION_CREDENTIALS="CREDENTIALS_JSON_FILE"
   $env:INSTANCE_HOST="127.0.0.1"
   $env:DB_PORT="5432"
   $env:DB_NAME="quickstart_db"
   $env:DB_USER="quickstart-user"
   $env:DB_PASS="YOUR_DB_PASSWORD"
   

2. Téléchargez le proxy d'authentification Cloud SQL :

   wget https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.0.0/cloud-sql-proxy.x64.exe 
   -O cloud-sql-proxy.exe

3. Exécutez le proxy d'authentification Cloud SQL en arrière-plan. Remplacez INSTANCE_CONNECTION_NAME par le nom de connexion de l'instance. Il apparaît sur la page Présentation de l'instance Cloud SQL.

   Start-Process -filepath  ".\cloud-sql-proxy.exe" -ArgumentList `
   "--credentials-file $env:GOOGLE_APPLICATION_CREDENTIALS" INSTANCE_CONNECTION_NAME

Remarque : Le processus exécutant le proxy d'authentification Cloud SQL en arrière-plan peut être arrêté en sélectionnant la fenêtre cmd.exe générée par la commande Start-Process. Fermez la fenêtre pour arrêter la tâche de proxy.

Exécutez les commandes suivantes pour obtenir les packages Node.js requis sur votre ordinateur local et exécuter l'exemple d'application.

1. Installez les packages Node.js nécessaires à l'exécution locale de l'application.

   npm install
   

2. Exécuter l'application exemple

   npm start
   

3. Affichez l'exemple d'application en cours d'exécution. Ouvrez une fenêtre de navigateur et accédez à http://127.0.0.1:8080.

   

4. Pour arrêter l'exemple d'application, appuyez sur Ctrl+C dans la fenêtre Powershell dans laquelle vous avez démarré l'exemple d'application.

Python

Exécutez les commandes suivantes pour initialiser les variables d'environnement requises pour exécuter l'exemple d'application. Avant d'exécuter les commandes, effectuez les remplacements suivants :

• CREDENTIALS_JSON_FILE par le chemin d'accès du fichier de clé JSON des identifiants de votre compte de service à l'aide d'un format tel que C:\Users\Your-Username\Downloads\key.json.
• INSTANCE_CONNECTION_NAME par le nom de connexion de votre instance qui apparaît sur la page Présentation de l'instance Cloud SQL.
• YOUR_DB_PASSWORD par le mot de passe du quickstart-user que vous avez créé à l'étape précédente Créer un utilisateur de ce guide de démarrage rapide.

$env:GOOGLE_APPLICATION_CREDENTIALS="CREDENTIALS_JSON_FILE"
$env:INSTANCE_CONNECTION_NAME="INSTANCE_CONNECTION_NAME"
$env:DB_PORT="5432"
$env:DB_NAME="quickstart_db"
$env:DB_USER="quickstart-user"
$env:DB_PASS="YOUR_DB_PASSWORD"

Exécutez les commandes suivantes pour obtenir les exigences de l'exemple d'application Python sur votre ordinateur local et exécuter l'exemple d'application.

1. Initialisez un environnement virtuel et installez les conditions requises pour exécuter l'exemple d'application.

   virtualenv --python python3 env
   .\env\Scripts\activate
   pip install -r requirements.txt
   

2. Exécuter l'application exemple

   python app.py
   

3. Affichez l'exemple d'application en cours d'exécution. Ouvrez une fenêtre de navigateur et accédez à http://127.0.0.1:8080.

   

4. Pour arrêter l'exemple d'application, appuyez sur Ctrl+C dans la fenêtre Powershell dans laquelle vous avez démarré l'exemple d'application.

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.

Étapes de nettoyage facultatives

Si vous n'utilisez pas le rôle Client Cloud SQL que vous avez attribué au compte de service quickstart-service-account, 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é quickstart-service-account.
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 Cloud SQL Admin
  • API Identity and Access Management

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 :

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