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

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

MySQL | PostgreSQL | SQL Server

Découvrez comment déployer un exemple d'application dans un environnement flexible App Engine 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. 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.

   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 APIs Cloud nécessaires à l'exécution d'un exemple d'application Cloud SQL dans l'environnement flexible 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

   En cliquant sur le bouton, vous activez également l'environnement flexible Google App Engine.

   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 appengineflex.googleapis.com 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

   En exécutant la commande ci-dessus, vous activez également l'environnement flexible Google App Engine.

Configurer Cloud SQL

Créer une instance Cloud SQL

Adresse IP publique

Console

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. Dans le champ Mot de passe, entrez le mot de passe de l'utilisateur Postgres. Enregistrez ce mot de passe pour une utilisation ultérieure.
6. Dans la section Sélectionner la disponibilité régionale et zonale, sélectionnez Zone unique.
7. Cliquez sur le menu Afficher les options de configuration.
8. Dans la liste déroulante Type de machine, sélectionnez Légère.
9. Cliquez sur Créer une instance, puis attendez que l'instance s'initialise et démarre.

gcloud

Avant d'exécuter la commande 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 souhaités dans la machine.
• --memory : nombre entier indiquant la quantité de mémoire souhaitée sur 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.

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

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

Adresse IP privée

Console

Allouer une plage d'adresses IP et créer une connexion privée pour configurer l'accès aux services privés pour Cloud SQL

1. Dans la console Google Cloud, accédez à la page Réseaux VPC.

   Accéder aux réseaux VPC

2. Sélectionnez le réseau VPC default.
3. Sélectionnez l'onglet Connexion au service privé.
4. Sélectionnez l'onglet Plages d'adresses IP allouées pour les services.
5. Cliquez sur Allouer une plage d'adresses IP.
6. Dans le champ Nom de la plage allouée, spécifiez google-managed-services-default.
7. Sélectionnez l'option Automatique pour la plage d'adresses IP, puis définissez la longueur du préfixe sur 16.
8. Cliquez sur Allouer pour créer la plage allouée.
9. Sélectionnez l'onglet Connexions privées aux services pour le réseau VPC default.
10. Cliquez sur Créer une connexion pour créer une connexion privée entre votre réseau et un producteur de services.
11. Pour Allocation attribuée, sélectionnez google-managed-services-default.
12. Cliquez sur Connecter pour créer la connexion.

Créer une instance avec une adresse IP privée et SSL activé

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 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 pour développer la section Afficher les options de configuration.
8. Dans le champ Type de machine, sélectionnez Léger.
9. Dans Connexions, sélectionnez Adresse IP privée.
10. Sélectionnez Par défaut dans le menu déroulant Réseau.
11. Décochez la case Adresse IP publique pour créer une instance qui dispose uniquement d'une adresse IP privée.
12. Cliquez sur Créer une instance, puis attendez que l'instance s'initialise et démarre.
13. Cliquez sur Connexions.
14. Dans la section Sécurité, sélectionnez Autoriser uniquement les connexions SSL pour activer les connexions SSL.
15. Dans la boîte de dialogue Autoriser uniquement les connexions SSL, cliquez sur Enregistrer, puis attendez que l'instance redémarre.

gcloud

Allouer une plage d'adresses IP et créer une connexion privée pour configurer l'accès aux services privés pour Cloud SQL

1. Exécutez la commande gcloud compute addresses create pour allouer une plage d'adresses IP.

   gcloud compute addresses create google-managed-services-default \
   --global --purpose=VPC_PEERING --prefix-length=16 \
   --description="peering range for Google" --network=default

2. Exécutez la commande gcloud services vpc-peerings connect pour créer une connexion privée à la plage d'adresses IP allouée. Remplacez YOUR_PROJECT_ID par l'ID de votre projet.

   gcloud services vpc-peerings connect --service=servicenetworking.googleapis.com \
   --ranges=google-managed-services-default --network=default \
   --project=YOUR_PROJECT_ID

Créer une instance avec une adresse IP privée et SSL activé

1. Avant d'exécuter la commande 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 dans la machine.
• --memory : valeur entière indiquant la quantité de mémoire souhaitée sur la machine. Une unité de taille peut ê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-central1) 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 avec une adresse IP privée.

gcloud sql instances create quickstart-instance \
--database-version=POSTGRES_14 \
 --cpu=1 \
 --memory=4GB \
 --region=us-central \
 --root-password=DB_ROOT_PASSWORD \
 --no-assign-ip \
--network=default

2. Exécutez la commande gcloud sql instances patch pour activer l'option Autoriser uniquement les connexions SSL pour l'instance.

gcloud sql instances patch quickstart-instance --require-ssl

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 Nouvelle base de données, saisissez quickstart-db.
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. Sélectionnez l'instance PostgreSQL quickstart-instance que vous avez créée.
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 quickstart-instance, 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 PostgreSQL sur site.

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

Créer une application App Engine

Créez une application App Engine dans votre projet Google Cloud. Cela active le service App Engine, et crée une application App Engine par défaut ainsi qu'un compte de service App Engine, que vous allez utiliser pour vous connecter à Cloud SQL.

Remarque : Vous n'avez à créer une application App Engine qu'une seule fois par projet Google Cloud.

Console

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

   Accéder à App Engine

2. Cliquez sur Créer une application.
3. Dans le menu déroulant Sélectionner une région, sélectionnez us-central.
4. Cliquez sur Suivant.
5. La page Premiers pas s'affiche ; faites-la défiler jusqu'en bas.
6. Cliquez sur le lien Je le ferai plus tard.

gcloud

1. Exécutez la commande gcloud app create suivante pour créer une application App Engine :

gcloud app create

2. Lorsque vous êtes invité à choisir la région dans laquelle vous souhaitez que votre application App Engine réside, saisissez la valeur numérique correspondant à 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. L'attribution de ce rôle au compte de service lui donne les autorisations nécessaires pour se connecter à Cloud SQL.

Console

1. Dans la console Google Cloud, 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.
   Remarque : Le nom du compte de service apparaît à côté du compte principal du compte. Le nom du compte principal est [e-mail].
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 pour Cloud SQL

Maintenant que vous avez créé une instance et une base de données Cloud SQL, et que vous avez configuré le compte de service App Engine afin qu'il dispose des autorisations nécessaires pour se connecter à Cloud SQL, vous pouvez configurer et déployer un exemple d'application pour qu'il se connecte à votre instance Cloud SQL.

Adresse IP publique

Pour les chemins d'accès des adresses IP publiques, l'environnement flexible App Engine assure le chiffrement. Cette méthode utilise un socket Unix et le proxy d'authentification Cloud SQL pour se connecter à votre instance Cloud SQL.

Go

1. Dans l'éditeur Cloud Shell, ouvrez le code source de l'exemple d'application.

   Ouvrir l'éditeur Cloud Shell
2. Dans la boîte de dialogue Ouvrir dans Cloud Shell, cliquez sur Confirmer pour télécharger le code de l'exemple d'application et ouvrir le répertoire de l'exemple d'application dans l'éditeur Cloud Shell.
3. Lorsque vous y êtes invité, exécutez la commande suivante pour activer votre projet :

   gcloud config set project YOUR-PROJECT-ID

   Remarque : Remplacez YOUR-PROJECT-ID par votre ID de projet.
4. Si une boîte de dialogue Autoriser Cloud Shell s'affiche, cliquez sur Autoriser.
5. Dans le menu de navigation Explorer de l'éditeur Cloud Shell, cliquez sur le nœud correspondant au nom d'utilisateur de votre compte Google Cloud.
6. Accédez au fichier cloudshell_open/golang-samples/cloudsql/postgres/database-sql/app.flexible.yaml et ouvrez-le.
7. Remplacez les espaces réservés pour les variables d'environnement dans le fichier app.flexible.yaml par les valeurs suivantes :
• <PROJECT-ID> par l'ID de votre projet.
• <INSTANCE-REGION> par us-central1.
• <INSTANCE-NAME> par quickstart-instance.
• <YOUR_DB_USER_NAME> par quickstart-user.
• <YOUR_DB_PASSWORD> par le mot de passe du compte quickstart-user que vous avez créé à l'étape Créer un utilisateur.
• <YOUR_DB_NAME> par quickstart-db.
8. Depuis l'invite de commande Cloud Shell, accédez au répertoire cloudshell_open/golang-samples/cloudsql/postgres/database-sql et exécutez la commande gcloud app deploy suivante pour déployer l'exemple d'application dans l'environnement flexible App Engine.

gcloud app deploy app.flexible.yaml

9. Lorsque la question Voulez-vous continuer ? s'affiche, saisissez Y.
10. Une fois que les actions lancées via la commande gcloud app deploy sont terminées, exécutez la commande gcloud app browse :

gcloud app browse

11. Cliquez sur le lien généré pour afficher l'exemple d'application s'exécutant dans l'environnement flexible App Engine. Cet environnement est connecté à Cloud SQL.

Java

1. Dans l'éditeur Cloud Shell, ouvrez le code source de l'exemple d'application.

   Ouvrir l'éditeur Cloud Shell
2. Dans la boîte de dialogue Ouvrir dans Cloud Shell, cliquez sur Confirmer pour télécharger le code de l'exemple d'application et ouvrir le répertoire de l'exemple d'application dans l'éditeur Cloud Shell.
3. Lorsque vous y êtes invité, exécutez la commande suivante pour activer votre projet :

   gcloud config set project YOUR-PROJECT-ID

   Remarque : Remplacez YOUR-PROJECT-ID par votre ID de projet.
4. Si une boîte de dialogue Autoriser Cloud Shell s'affiche, cliquez sur Autoriser.
5. Dans le menu de navigation Explorer de l'éditeur Cloud Shell, cliquez sur le nœud correspondant au nom d'utilisateur de votre compte Google Cloud.
6. Accédez au fichier cloudshell_open/java-docs-samples/cloud-sql/postgres/servlet/src/main/webapp/WEB-INF/appengine-web.xml et ouvrez-le.
7. Remplacez les espaces réservés pour les variables d'environnement dans le fichier appengine-web.xml par les valeurs suivantes :
• my-project:region:instance par le nom de connexion de votre instance qui apparaît sur la page Instances Cloud SQL de la console Google Cloud.
• my-db-user par quickstart-user.
• my-db-password par le mot de passe de quickstart-user que vous avez créé dans la section Créer un utilisateur.
• my_db par quickstart-db.
8. Depuis l'invite de commande Cloud Shell, accédez au répertoire cloudshell_open/java-docs-samples/cloud-sql/postgres/servlet et exécutez la commande Apache Maven mvn clean package suivante pour déployer l'exemple d'application dans l'environnement flexible App Engine.

mvn clean package appengine:deploy -DskipTests

9. Lorsque la question Voulez-vous continuer ? s'affiche, saisissez Y.
10. Une fois que les actions lancées via la commande gcloud app deploy sont terminées, exécutez la commande gcloud app browse :

gcloud app browse

11. Cliquez sur le lien généré pour afficher l'exemple d'application s'exécutant dans l'environnement flexible App Engine. Cet environnement est connecté à Cloud SQL.

Node.js

1. Dans l'éditeur Cloud Shell, ouvrez le code source de l'exemple d'application.

   Ouvrir l'éditeur Cloud Shell
2. Dans la boîte de dialogue Ouvrir dans Cloud Shell, cliquez sur Confirmer pour télécharger le code de l'exemple d'application et ouvrir le répertoire de l'exemple d'application dans l'éditeur Cloud Shell.
3. Lorsque vous y êtes invité, exécutez la commande suivante pour activer votre projet :

   gcloud config set project YOUR-PROJECT-ID

   Remarque : Remplacez YOUR-PROJECT-ID par votre ID de projet.
4. Si une boîte de dialogue Autoriser Cloud Shell s'affiche, cliquez sur Autoriser.
5. Dans le menu de navigation Explorer de l'éditeur Cloud Shell, cliquez sur le nœud correspondant au nom d'utilisateur de votre compte Google Cloud.
6. Accédez au fichier cloudshell_open/nodejs-docs-samples/cloud-sql/postgres/knex/app.flexible.yaml et ouvrez-le.
7. Remplacez les espaces réservés pour les variables d'environnement dans le fichier app.flexible.yaml par les valeurs suivantes :
• <MY-PROJECT> par l'ID de votre projet.
• <INSTANCE-REGION> par us-central1.
• <INSTANCE-NAME> par quickstart-instance.
• MY_DB_USER par quickstart-user.
• MY_DB_PASSWORD par le mot de passe de quickstart-user que vous avez créé dans la section Créer un utilisateur.
• MY_DATABASE par quickstart-db.
8. Depuis l'invite de commande Cloud Shell, accédez au répertoire cloudshell_open/nodejs-docs-samples/cloud-sql/postgres/knex et exécutez la commande gcloud app deploy suivante pour déployer l'exemple d'application dans l'environnement flexible App Engine.

gcloud app deploy app.flexible.yaml

9. Lorsque la question Voulez-vous continuer ? s'affiche, saisissez Y.
10. Une fois que les actions lancées via la commande gcloud app deploy sont terminées, exécutez la commande gcloud app browse :

gcloud app browse

11. Cliquez sur le lien généré pour afficher l'exemple d'application s'exécutant dans l'environnement flexible App Engine. Cet environnement est connecté à Cloud SQL.

Python

1. Dans l'éditeur Cloud Shell, ouvrez le code source de l'exemple d'application.

   Ouvrir l'éditeur Cloud Shell
2. Dans la boîte de dialogue Ouvrir dans Cloud Shell, cliquez sur Confirmer pour télécharger le code de l'exemple d'application et ouvrir le répertoire de l'exemple d'application dans l'éditeur Cloud Shell.
3. Lorsque vous y êtes invité, exécutez la commande suivante pour activer votre projet :

   gcloud config set project YOUR-PROJECT-ID

   Remarque : Remplacez YOUR-PROJECT-ID par votre ID de projet.
4. Si une boîte de dialogue Autoriser Cloud Shell s'affiche, cliquez sur Autoriser.
5. Dans le menu de navigation Explorer de l'éditeur Cloud Shell, cliquez sur le nœud correspondant au nom d'utilisateur de votre compte Google Cloud.
6. Accédez au fichier cloudshell_open/python-docs-samples/cloud-sql/postgres/sqlalchemy/app.flexible.yaml et ouvrez-le.
7. Remplacez les espaces réservés pour les variables d'environnement dans le fichier app.flexible.yaml par les valeurs suivantes :
• <PROJECT-ID> par l'ID de votre projet.
• <INSTANCE-REGION> par us-central1.
• <INSTANCE-NAME> par quickstart-instance.
• <YOUR_DB_USER_NAME> par quickstart-user.
• <YOUR_DB_PASSWORD> par le mot de passe du compte quickstart-user que vous avez créé à l'étape Créer un utilisateur.
• <YOUR_DB_NAME> par quickstart-db.
8. Depuis l'invite de commande Cloud Shell, accédez au répertoire cloudshell_open/python-docs-samples/cloud-sql/postgres/sqlalchemy et exécutez la commande gcloud app deploy suivante pour déployer l'exemple d'application dans l'environnement flexible App Engine.

gcloud app deploy app.flexible.yaml

9. Lorsque la question Voulez-vous continuer ? s'affiche, saisissez Y.
10. Une fois que les actions lancées via la commande gcloud app deploy sont terminées, exécutez la commande gcloud app browse :

gcloud app browse

11. Cliquez sur le lien généré pour afficher l'exemple d'application s'exécutant dans l'environnement flexible App Engine. Cet environnement est connecté à Cloud SQL.

Adresse IP privée

Pour les chemins d'accès des adresses IP privées, assurez-vous que la VM de l'environnement flexible App Engine et l'instance Cloud SQL sont hébergées sur le même réseau de cloud privé virtuel (VPC). Lorsqu'elle est située sur le même réseau VPC, votre application d'environnement flexible App Engine peut se connecter directement à l'instance Cloud SQL sans utiliser le proxy d'authentification Cloud SQL.

Go

Créer et télécharger des certificats SSL de serveur et de client

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

   Accéder à la page Instances Cloud SQL

2. Cliquez sur quickstart-instance pour afficher la page Présentation.
3. Cliquez sur l'onglet Connexions.
4. Dans la section Sécurité, cliquez sur Créer un certificat client.
5. Dans la boîte de dialogue Créer un certificat client, saisissez quickstart-key comme nom, puis cliquez sur Créer.

6. Dans la boîte de dialogue Nouveau certificat SSL créé, cliquez sur chaque lien de téléchargement pour télécharger les certificats. Ensuite, cliquez sur Fermer.

   Important : Conservez cette clé privée à un endroit sécurisé. Si vous la perdez, vous devrez créer un nouveau certificat client.

Créer un exemple d'application avec les certificats SSL

1. Dans l'éditeur Cloud Shell, ouvrez le code source de l'exemple d'application.
   Ouvrir l'éditeur Cloud Shell
2. Dans la boîte de dialogue Ouvrir dans Cloud Shell, cliquez sur Confirmer pour télécharger le code de l'exemple d'application et ouvrir le répertoire de l'exemple d'application dans l'éditeur Cloud Shell.
3. Lorsque vous y êtes invité, exécutez la commande suivante pour activer votre projet :

   gcloud config set project YOUR-PROJECT-ID

   Remarque : Remplacez YOUR-PROJECT-ID par votre ID de projet.
4. Si une boîte de dialogue Autoriser Cloud Shell s'affiche, cliquez sur Autoriser.
5. Importez les fichiers de certificats SSL dans le dossier certs.
   1. Dans le menu de navigation de l'explorateur de l'éditeur Cloud Shell, accédez au dossier golang-samples/cloudsql/postgres/database-sql/certs.
   2. Faites un clic droit sur le dossier certs dans l'éditeur Cloud Shell, puis sélectionnez Importer des fichiers.
   3. Sélectionnez les fichiers suivants sur votre ordinateur local :
   • client-key.pem
   • client-cert.pem
   • server-ca.pem
   4. Après avoir sélectionné les trois fichiers de certificat SSL, cliquez sur Ouvrir pour terminer l'importation des fichiers dans l'éditeur Cloud Shell.
6. Dans le menu de navigation Explorer de l'éditeur Cloud Shell, cliquez sur le nœud correspondant au nom d'utilisateur de votre compte Google Cloud.
7. Accédez au fichier cloudshell_open/golang-samples/cloudsql/postgres/database-sql/app.flexible.yaml et ouvrez-le.
8. Copiez et collez le code suivant dans le fichier pour remplacer le contenu existant du fichier :

runtime: custom
env: flex

env_variables:
  DB_USER: quickstart-user
  DB_PASS: YOUR_DB_PASSWORD
  DB_NAME: quickstart-db
  DB_PORT: 3306
  INSTANCE_HOST: INSTANCE_HOST
  DB_ROOT_CERT: certs/server-ca.pem
  DB_CERT: certs/client-cert.pem
  DB_KEY: certs/client-key.pem
  PRIVATE_IP: TRUE

vpc_access_connector:
  name: projects/PROJECT_ID/locations/us-central1/connectors/quickstart-connector

9. Effectuez les remplacements de variables suivants :
• YOUR_DB_PASSWORD par le mot de passe de quickstart-user que vous avez créé dans la section Créer un utilisateur.
• INSTANCE_HOST par l'adresse IP privée de votre instance qui apparaît sur la page Instances Cloud SQL de la console Google Cloud.
• PROJECT_ID par l'ID de votre projet.
10. Depuis l'invite de commande Cloud Shell, accédez au répertoire cloudshell_open/golang-samples/cloudsql/postgres/database-sql et exécutez la commande gcloud app deploy suivante pour déployer l'exemple d'application dans l'environnement flexible App Engine.

gcloud app deploy app.flexible.yaml

11. Lorsque la question Voulez-vous continuer ? s'affiche, saisissez Y.
12. Une fois que les actions lancées via la commande gcloud app deploy sont terminées, exécutez la commande gcloud app browse :

gcloud app browse

13. Cliquez sur le lien généré pour afficher l'exemple d'application s'exécutant dans l'environnement flexible App Engine. Cet environnement est connecté à Cloud SQL.

Java

Créer et télécharger des certificats SSL de serveur et de client

Pour les utilisateurs Java, le connecteur fournit déjà une connexion sécurisée. Il n'est donc pas nécessaire de créer et de télécharger les certificats SSL client et de serveur.

Exemple d'application

1. Dans l'éditeur Cloud Shell, ouvrez le code source de l'exemple d'application.
   Ouvrir l'éditeur Cloud Shell
2. Dans la boîte de dialogue Ouvrir dans Cloud Shell, cliquez sur Confirmer pour télécharger le code de l'exemple d'application et ouvrir le répertoire de l'exemple d'application dans l'éditeur Cloud Shell.
3. Lorsque vous y êtes invité, exécutez la commande suivante pour activer votre projet :

   gcloud config set project YOUR-PROJECT-ID

   Remarque : Remplacez YOUR-PROJECT-ID par votre ID de projet.
4. Si une boîte de dialogue Autoriser Cloud Shell s'affiche, cliquez sur Autoriser.
5. Dans le menu de navigation Explorer de l'éditeur Cloud Shell, cliquez sur le nœud correspondant au nom d'utilisateur de votre compte Google Cloud.
6. Accédez au fichier cloudshell_open/java-docs-samples/cloud-sql/postgres/servlet/src/main/webapp/WEB-INF/appengine-web.xml et ouvrez-le.
7. Copiez et collez le code suivant dans le fichier appengine-web.xml, en remplaçant le contenu existant :

<runtime>java17</runtime>
  <env-variables>
    <env-var name="INSTANCE_CONNECTION_NAME" value="project-name:region-name:instance-name" />
    <env-var name="DB_PORT" value="5432" />
    <env-var name="DB_USER" value="quickstart-user" />
    <env-var name="DB_PASS" value="my-db-password" />
    <env-var name="DB_NAME" value="quickstart-db" />
  </env-variables>
<vpc-access-connector>
  <name>projects/PROJECT_ID/locations/us-central1/connectors/quickstart-connector</name>
  <egress-setting>all-traffic</egress-setting>
</vpc-access-connector>

8. Effectuez les remplacements de variables suivants :
• project-name:region-name:instance-name par le nom de connexion de votre instance qui apparaît sur la page instances Cloud SQL de la console Google Cloud.
• my-db-password par le mot de passe de quickstart-user que vous avez créé dans la section Créer un utilisateur.
• PROJECT_ID par l'ID de votre projet.
9. Depuis l'invite de commande Cloud Shell, accédez au répertoire cloudshell_open/java-docs-samples/cloud-sql/postgres/servlet et exécutez la commande Apache Maven mvn clean package suivante pour déployer l'exemple d'application dans l'environnement flexible App Engine.

mvn clean package appengine:deploy -DskipTests

10. Lorsque la question Voulez-vous continuer ? s'affiche, saisissez Y.
11. Une fois que les actions lancées via la commande gcloud app deploy sont terminées, exécutez la commande gcloud app browse :

gcloud app browse

12. Cliquez sur le lien généré pour afficher l'exemple d'application s'exécutant dans l'environnement flexible App Engine. Cet environnement est connecté à Cloud SQL.

Node.js

Créer et télécharger des certificats SSL de serveur et de client

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

   Accéder à la page Instances Cloud SQL

2. Cliquez sur quickstart-instance pour afficher la page Présentation.
3. Cliquez sur l'onglet Connexions.
4. Dans la section Sécurité, cliquez sur Créer un certificat client.
5. Dans la boîte de dialogue Créer un certificat client, saisissez quickstart-key comme nom, puis cliquez sur Créer.

6. Dans la boîte de dialogue Nouveau certificat SSL créé, cliquez sur chaque lien de téléchargement pour télécharger les certificats. Ensuite, cliquez sur Fermer.

   Important : Conservez cette clé privée à un endroit sécurisé. Si vous la perdez, vous devrez créer un nouveau certificat client.

Créer un exemple d'application avec les certificats SSL

1. Dans l'éditeur Cloud Shell, ouvrez le code source de l'exemple d'application.
   Ouvrir l'éditeur Cloud Shell
2. Dans la boîte de dialogue Ouvrir dans Cloud Shell, cliquez sur Confirmer pour télécharger le code de l'exemple d'application et ouvrir le répertoire de l'exemple d'application dans l'éditeur Cloud Shell.
3. Lorsque vous y êtes invité, exécutez la commande suivante pour activer votre projet :

   gcloud config set project YOUR-PROJECT-ID

   Remarque : Remplacez YOUR-PROJECT-ID par votre ID de projet.
4. Si une boîte de dialogue Autoriser Cloud Shell s'affiche, cliquez sur Autoriser.
5. Importez les fichiers de certificats SSL dans le dossier certs.
   1. Dans le menu de navigation de l'explorateur de l'éditeur Cloud Shell, accédez au dossier nodejs-docs-samples/cloud-sql/postgres/knex/certs.
   2. Faites un clic droit sur le dossier certs dans l'éditeur Cloud Shell, puis sélectionnez Importer des fichiers.
   3. Sélectionnez les fichiers suivants sur votre ordinateur local :
   • client-key.pem
   • client-cert.pem
   • server-ca.pem
   4. Après avoir sélectionné les trois fichiers de certificat SSL, cliquez sur Ouvrir pour terminer l'importation des fichiers dans l'éditeur Cloud Shell.
6. Dans le menu de navigation Explorer de l'éditeur Cloud Shell, cliquez sur le nœud correspondant au nom d'utilisateur de votre compte Google Cloud.
7. Accédez au fichier cloudshell_open/nodejs-docs-samples/cloud-sql/postgres/knex/app.flexible.yaml et ouvrez-le.
8. Copiez et collez le code suivant dans le fichier pour remplacer le contenu existant du fichier :

runtime: nodejs
env: flex

env_variables:
  DB_USER: quickstart-user
  DB_PASS: MY_DB_PASSWORD
  DB_NAME: quickstart-db
  DB_PORT: 5432
  INSTANCE_HOST: INSTANCE_HOST
  DB_ROOT_CERT: certs/server-ca.pem
  DB_CERT: certs/client-cert.pem
  DB_KEY: certs/client-key.pem
  PRIVATE_IP: TRUE

vpc_access_connector:
  name: projects/PROJECT_ID/locations/us-central1/connectors/quickstart-connector

9. Effectuez les remplacements de variables suivants :
• MY_DB_PASSWORD par le mot de passe de quickstart-user que vous avez créé dans la section Créer un utilisateur.
• INSTANCE_HOST par l'adresse IP privée de votre instance qui apparaît sur la page Instances Cloud SQL de la console Google Cloud.
• PROJECT_ID par l'ID de votre projet.
10. Depuis l'invite de commande Cloud Shell, accédez au répertoire cloudshell_open/nodejs-docs-samples/cloud-sql/postgres/knex et exécutez la commande gcloud app deploy suivante pour déployer l'exemple d'application dans l'environnement flexible App Engine.

gcloud app deploy app.flexible.yaml

11. Lorsque la question Voulez-vous continuer ? s'affiche, saisissez Y.
12. Une fois que les actions lancées via la commande gcloud app deploy sont terminées, exécutez la commande gcloud app browse :

gcloud app browse

13. Cliquez sur le lien généré pour afficher l'exemple d'application s'exécutant dans l'environnement flexible App Engine. Cet environnement est connecté à Cloud SQL.

Python

Créer et télécharger des certificats SSL de serveur et de client

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

   Accéder à la page Instances Cloud SQL

2. Cliquez sur quickstart-instance pour afficher la page Présentation.
3. Cliquez sur l'onglet Connexions.
4. Dans la section Sécurité, cliquez sur Créer un certificat client.
5. Dans la boîte de dialogue Créer un certificat client, saisissez quickstart-key comme nom, puis cliquez sur Créer.

6. Dans la boîte de dialogue Nouveau certificat SSL créé, cliquez sur chaque lien de téléchargement pour télécharger les certificats. Ensuite, cliquez sur Fermer.

   Important : Conservez cette clé privée à un endroit sécurisé. Si vous la perdez, vous devrez créer un nouveau certificat client.

Créer un exemple d'application avec les certificats SSL

1. Dans l'éditeur Cloud Shell, ouvrez le code source de l'exemple d'application.
   Ouvrir l'éditeur Cloud Shell
2. Dans la boîte de dialogue Ouvrir dans Cloud Shell, cliquez sur Confirmer pour télécharger le code de l'exemple d'application et ouvrir le répertoire de l'exemple d'application dans l'éditeur Cloud Shell.
3. Lorsque vous y êtes invité, exécutez la commande suivante pour activer votre projet :

   gcloud config set project YOUR-PROJECT-ID

   Remarque : Remplacez YOUR-PROJECT-ID par votre ID de projet.
4. Si une boîte de dialogue Autoriser Cloud Shell s'affiche, cliquez sur Autoriser.
5. Importez les fichiers de certificats SSL dans le dossier certs.
   1. Dans le menu de navigation de l'explorateur de l'éditeur Cloud Shell, accédez au dossier python-docs-samples/cloud-sql/postgres/sqlalchemy/certs.
   2. Faites un clic droit sur le dossier certs dans l'éditeur Cloud Shell, puis sélectionnez Importer des fichiers.
   3. Sélectionnez les fichiers suivants sur votre ordinateur local :
   • client-key.pem
   • client-cert.pem
   • server-ca.pem
   4. Après avoir sélectionné les trois fichiers de certificat SSL, cliquez sur Ouvrir pour terminer l'importation des fichiers dans l'éditeur Cloud Shell.
6. Dans le menu de navigation Explorer de l'éditeur Cloud Shell, cliquez sur le nœud correspondant au nom d'utilisateur de votre compte Google Cloud.
7. Accédez au fichier cloudshell_open/python-docs-samples/cloud-sql/postgres/sqlalchemy/app.flexible.yaml et ouvrez-le.
8. Copiez et collez le code suivant dans le fichier pour remplacer le contenu existant du fichier :

runtime: custom
env: flex
entrypoint: gunicorn -b :$PORT app:appentrypoint: gunicorn -b :$PORT app:app

env_variables:
  DB_USER: quickstart-user
  DB_PASS: YOUR_DB_PASSWORD
  DB_NAME: quickstart-db
  DB_PORT: 5432
  INSTANCE_HOST: INSTANCE_HOST
  DB_ROOT_CERT: certs/server-ca.pem
  DB_CERT: certs/client-cert.pem
  DB_KEY: certs/client-key.pem
  PRIVATE_IP: TRUE

vpc_access_connector:
  name: projects/PROJECT_ID/locations/us-central1/connectors/quickstart-connector

9. Effectuez les remplacements de variables suivants :
• YOUR_DB_PASSWORD par le mot de passe de quickstart-user que vous avez créé dans la section Créer un utilisateur.
• INSTANCE_HOST par l'adresse IP privée de votre instance qui apparaît sur la page Instances Cloud SQL de la console Google Cloud.
• PROJECT_ID par l'ID de votre projet.
10. Depuis l'invite de commande Cloud Shell, accédez au répertoire cloudshell_open/python-docs-samples/cloud-sql/postgres/sqlalchemy et exécutez la commande gcloud app deploy suivante pour déployer l'exemple d'application dans l'environnement flexible App Engine.

gcloud app deploy app.flexible.yaml

11. Lorsque la question Voulez-vous continuer ? s'affiche, saisissez Y.
12. Une fois que les actions lancées via la commande gcloud app deploy sont terminées, exécutez la commande gcloud app browse :

gcloud app browse

13. Cliquez sur le lien généré pour afficher l'exemple d'application s'exécutant dans l'environnement flexible App Engine. Cet environnement est connecté à 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 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 découvrir comment vous connecter à une instance Cloud SQL à partir d'autres produits 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