Se connecter à Cloud SQL pour SQL Server à partir de Compute Engine

Se connecter à Cloud SQL pour SQL Server à partir de Compute Engine

MySQL | PostgreSQL | SQL Server

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 SQL Server à 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 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

Adresse IP publique

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 SQL Server.
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 sqlserver. 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. Développez la section Afficher les configurations.
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

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 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. 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=SQLSERVER_2019_STANDARD --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 Google Cloud Console, 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 Créer une instance.
3. Cliquez sur SQL Server.
4. Dans le champ ID d'instance, saisissez quickstart-instance.
5. Saisissez un mot de passe pour l'utilisateur sqlserver. 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 et redémarrer, 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 beta sql instances create quickstart-instance --database-version=SQLSERVER_2017_STANDARD --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. 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

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.

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 Ajouter un autre rôle, puis choisissez le rôle Lecteur des objets Storage à attribuer au compte de service du projet.
8. Cliquez sur Continuer.
9. 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 :

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

Créer une instance de VM Linux

Console

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

   Accéder à la page Instances de VM

2. Cliquez sur le bouton Create instance (Créer une instance).
3. Dans le champ Nom de l'instance de VM, saisissez quickstart-vm-instance.
4. Pour Comptes de service, sélectionnez quickstart-service-account.
5. Pour Pare-feu, sélectionnez l'option Autoriser le trafic HTTP.
6. Cliquez sur Créer pour créer l'instance de VM.

gcloud

Avant d'exécuter la commande suivante, remplacez YOUR_PROJECT_ID par l'ID de votre projet.

Exécutez la commande gcloud compute instances create suivante.

gcloud compute instances create quickstart-vm-instance --image-family=debian-10 --image-project=debian-cloud  --machine-type=e2-medium --service-account=quickstart-service-account@YOUR_PROJECT_ID.iam.gserviceaccount.com --scopes=https://www.googleapis.com/auth/cloud-platform --tags=http-server --zone=us-central1-a

Créer une instance de VM Windows

Console

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

   Accéder à la page Instances de VM

2. Cliquez sur le bouton Create instance (Créer une instance).
3. Dans le champ Nom de l'instance de VM, saisissez quickstart-vm-instance.
4. Dans la section Disque de démarrage, cliquez sur le bouton Modifier.
1. Pour Système d'exploitation, sélectionnez Windows Server.
2. Pour Version, sélectionnez Windows Server 2022 Datacenter.
3. Cliquez sur le bouton Sélectionner.
5. Pour Comptes de service, sélectionnez quickstart-service-account.
6. Pour Pare-feu, sélectionnez l'option Autoriser le trafic HTTP.
7. Cliquez sur Créer pour créer l'instance de VM.
8. Après deux à trois minutes suivant le démarrage de l'instance de VM, cliquez sur le bouton Définir un mot de passe Windows sur la page des détails de l'instance de VM.
9. Copiez et enregistrez ce mot de passe dans un emplacement sécurisé, car vous l'utiliserez pour accéder à votre instance de VM à l'étape suivante de ce guide de démarrage rapide.

gcloud

Avant d'exécuter la commande suivante, remplacez YOUR_PROJECT_ID par l'ID de votre projet.

Exécutez la commande gcloud compute instances create suivante dans une fenêtre de terminal.

gcloud compute instances create quickstart-vm-instance --image-project=windows-cloud --image-family=windows-2022 --machine-type=e2-medium --service-account=quickstart-service-account@YOUR_PROJECT_ID.iam.gserviceaccount.com --scopes=https://www.googleapis.com/auth/cloud-platform --tags=http-server --zone=us-central1-a

Après deux à trois minutes suivant le démarrage de l'instance de VM, exécutez la commande suivante pour définir le mot de passe Windows sur l'instance de VM.

gcloud compute reset-windows-password quickstart-vm-instance

Copiez et enregistrez ce mot de passe dans un emplacement sécurisé, car vous l'utiliserez pour accéder à votre instance de VM à l'étape suivante de ce guide de démarrage rapide.

Accéder à une instance de VM Compute Engine

Accéder à une instance de VM Linux

Console

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

Accéder à la page Instances de VM

Dans la liste des instances de machine virtuelle, cliquez sur SSH sur la ligne de l'instance à laquelle vous souhaitez vous connecter.

Remarque : Lorsque vous vous connectez à des VM à l'aide de la console Google Cloud, Compute Engine crée une clé SSH éphémère. Pour en savoir plus sur les clés SSH, consultez la section Connexions SSH aux VM Linux.

gcloud

Utilisez la commande gcloud compute ssh pour vous connecter à une instance de VM Linux. Remplacez YOUR_PROJECT_ID par l'ID du projet :

gcloud compute ssh --project=YOUR_PROJECT_ID --zone=us-central1-a quickstart-vm-instance

Accéder à une instance de VM Windows

Plug-in Chrome RDP

Chrome RDP pour Google Cloud est un plug-in tiers qui vous permet de vous connecter à des instances Windows à l'aide du navigateur Chrome. Le plug-in est intégré à la console Google Cloud. Après avoir installé le plug-in, connectez-vous à une instance Windows Server à l'aide du bouton RDP de la console Google Cloud.

Pour vous connecter à l'aide du plug-in Chrome RDP, procédez comme suit :

1. Installez l'extension Chrome RDP for Google Cloud.
2. Dans la console Google Cloud, accédez à la page Instances de VM et recherchez l'instance Windows à laquelle vous souhaitez vous connecter.

Accéder à la page Instances de VM

3. Cliquez sur le bouton RDP correspondant à l'instance à laquelle vous souhaitez vous connecter. L'extension Chrome RDP s'ouvre.
4. Aucun domaine n'étant configuré pour votre instance de VM, vous pouvez laisser le champ Domain (Domaine) vide.
5. Saisissez votre nom d'utilisateur et votre mot de passe, puis cliquez sur OK pour vous connecter.

6. Si vous y êtes invité, appuyez sur Continuer pour accepter le certificat.

Autre

Consultez la section Se connecter à des VM Windows à l'aide de RDP pour d'autres options d'accès à une instance de VM Windows 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.

Configurer l'environnement de développement d'instances de VM Linux

Go

Suivez les étapes ci-dessous pour configurer l'environnement de développement de l'instance de VM Compute Engine afin d'exécuter l'exemple d'application Go.

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

Java

Suivez les étapes ci-dessous pour configurer l'environnement de développement de l'instance de VM Compute Engine et exécuter l'exemple d'application Java.

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 l'environnement de développement de l'instance de VM Compute Engine afin d'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

Suivez les étapes ci-dessous pour configurer l'environnement de développement de l'instance de VM Compute Engine afin d'exécuter l'exemple d'application Python.

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

Configurer l'environnement de développement d'instances de VM Windows

Go

Suivez les étapes ci-dessous pour configurer l'environnement de développement de l'instance de VM Compute Engine afin d'exécuter l'exemple d'application Go.

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

Java

Suivez les étapes ci-dessous pour configurer l'environnement de développement de l'instance de VM Compute Engine et exécuter l'exemple d'application Java.

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 l'environnement de développement de l'instance de VM Compute Engine afin d'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

Suivez les étapes ci-dessous pour configurer l'environnement de développement de l'instance de VM Compute Engine afin d'exécuter l'exemple d'application Python.

1. Installez Python et le gestionnaire de packages PIP pour Python.
1. Accédez au guide de configuration pour un environnement de développement Python.
2. Suivez les instructions de la section Installer Python.
1. Les instructions ci-dessus vous invitent à consulter la page de téléchargement des versions de Python pour Windows. Sur cette page, cliquez sur le lien Dernière version de Python 3.
2. Sur la page Python 3.X.X, cliquez sur le lien Programme d'installation Windows 64 bits pour télécharger le fichier d'installation sur votre instance de VM Compute Engine exécutant Windows.
3. Une fois que vous avez téléchargé le programme d'installation de Python sur l'instance de VM, ouvrez le dossier contenant le fichier téléchargé. Effectuez ensuite un clic droit sur le fichier d'installation et sélectionnez Exécuter en tant qu'administrateur.
4. Dans la boîte de dialogue Installer Python qui s'affiche, sélectionnez l'option Ajouter Python 3.X.X au PATH et cliquez sur → Installer maintenant.
2. Installez virtualenv à l'aide de PIP.
1. Ouvrez Powershell sur l'instance de VM Compute Engine sous Windows et exécutez la commande pip install suivante.

pip install virtualenv

Installer Git

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

Instance de VM Linux Compute Engine

Sur votre instance de VM Compute Engine exécutant Linux, suivez la documentation officielle d'installation de Git pour Linux.

• Exécutez la commande Debian/Ubuntu suggérée install git en utilisant le préfixe de commande sudo pour exécuter celle-ci en tant qu'administrateur. La commande d'installation complète à exécuter dans le terminal doit respecter le format suivant :

sudo apt-get install git

Instance de VM Windows Compute Engine

Sur votre instance de VM Compute Engine exécutant Windows, suivez la documentation officielle d'installation de Git pour Windows pour télécharger le programme d'installation autonome 64 bits, puis exécutez-le pour installer Git.

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/sqlserver/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/sqlserver/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/sqlserver/mssql

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/sql-server/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.

Instance Cloud SQL avec adresse IP publique et VM Compute Engine basée sur Linux

Go

Sur l'instance de VM Compute Engine dans le terminal ouvert, exécutez les commandes suivantes pour initialiser les variables d'environnement requises afin d'exécuter l'exemple d'application. Avant d'exécuter les commandes, effectuez les remplacements suivants :

• INSTANCE_CONNECTION_NAME par le nom de connexion de votre instance qui apparaît sur la page Instances Cloud SQL de la console Google Cloud.
• 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 INSTANCE_CONNECTION_NAME='INSTANCE_CONNECTION_NAME'
export DB_PORT='1433'
export DB_NAME='quickstart_db'
export DB_USER='sqlserver'
export DB_PASS='YOUR_DB_PASSWORD'

Sur l'instance de VM Compute Engine dans le terminal ouvert, exécutez les commandes suivantes pour obtenir les dépendances de l'exemple d'application Go sur votre instance de VM Compute Engine 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
   

Sur l'ordinateur local, obtenez l'adresse IP externe de l'instance de VM Compute Engine sur laquelle l'exemple d'application s'exécute et affichez-la dans un navigateur.

Remarque : Cette étape de démarrage rapide nécessite gcloud CLI, qui fournit un accès en ligne de commande à vos ressources Google Cloud à l'aide des commandes gcloud CLI. Si gcloud CLI n'est pas installé sur votre ordinateur local, installez gcloud CLI pour continuer.

1. Dans un terminal ou dans Powershell sur votre ordinateur local, obtenez l'adresse IP externe de l'instance de VM Compute Engine en exécutant la commande gcloud compute instances describe suivante :

gcloud compute instances describe quickstart-vm-instance --format="value(networkInterfaces[0].accessConfigs[].natIP)"

2. Affichez l'exemple d'application en cours d'exécution. Ouvrez un navigateur sur votre ordinateur local et accédez à l'adresse IP externe et au port :8080 de l'instance de VM Compute Engine.

   http://COMPUTE_ENGINE_VM_EXTERNAL_IP_ADDRESS:8080
   

   

Pour arrêter l'exemple d'application, appuyez sur Ctrl+C dans le terminal de l'instance de VM Compute Engine où vous avez démarré l'exemple d'application.

Java

Sur l'instance de VM Compute Engine dans le terminal ouvert, exécutez les commandes suivantes pour initialiser les variables d'environnement requises afin d'exécuter l'exemple d'application. Avant d'exécuter les commandes, effectuez les remplacements suivants :

• INSTANCE_CONNECTION_NAME par le nom de connexion de votre instance qui apparaît sur la page Instances Cloud SQL de la console Google Cloud.
• 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 INSTANCE_CONNECTION_NAME='INSTANCE_CONNECTION_NAME'
export DB_PORT='1433'
export DB_NAME='quickstart_db'
export DB_USER='sqlserver'
export DB_PASS='YOUR_DB_PASSWORD'

Sur l'instance de VM Compute Engine dans le terminal ouvert, exécutez la commande suivante pour obtenir les dépendances de l'exemple d'application Java sur votre instance de VM Compute Engine et exécuter l'exemple d'application.

mvn jetty:run

Sur l'ordinateur local, obtenez l'adresse IP externe de l'instance de VM Compute Engine sur laquelle l'exemple d'application s'exécute et affichez-la dans un navigateur.

Remarque : Cette étape de démarrage rapide nécessite gcloud CLI, qui fournit un accès en ligne de commande à vos ressources Google Cloud à l'aide des commandes gcloud CLI. Si gcloud CLI n'est pas installé sur votre ordinateur local, installez gcloud CLI pour continuer.

1. Dans un terminal ou dans Powershell sur votre ordinateur local, obtenez l'adresse IP externe de l'instance de VM Compute Engine en exécutant la commande gcloud compute instances describe suivante :

gcloud compute instances describe quickstart-vm-instance --format="value(networkInterfaces[0].accessConfigs[].natIP)"

2. Affichez l'exemple d'application en cours d'exécution. Ouvrez un navigateur sur votre ordinateur local et accédez à l'adresse IP externe et au port :8080 de l'instance de VM Compute Engine.

   http://COMPUTE_ENGINE_VM_EXTERNAL_IP_ADDRESS:8080
   

   

Pour arrêter l'exemple d'application, appuyez sur Ctrl+C dans le terminal de l'instance de VM Compute Engine où vous avez démarré l'exemple d'application.

Node.js

1. Dans le terminal ouvert de l'instance de VM Compute Engine, exécutez les commandes suivantes pour initialiser les variables d'environnement requises afin d'exécuter l'exemple d'application. Avant d'exécuter les commandes, effectuez les remplacements suivants :

   • 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 INSTANCE_HOST='127.0.0.1'
   export DB_PORT='1433'
   export DB_NAME='quickstart_db'
   export DB_USER='sqlserver'
   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. Définissez les autorisations pour rendre le fichier de proxy d'authentification Cloud SQL exécutable.

   chmod +x cloud-sql-proxy

4. Exécutez le proxy d'authentification Cloud SQL en arrière-plan. Remplacez INSTANCE_CONNECTION_NAME par le nom de connexion de l'instance qui apparaît sur la page Instances Cloud SQL de la console Google Cloud.

   ./cloud-sql-proxy 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+Ctrl pour arrêter la tâche de proxy.

Sur l'instance de VM Compute Engine dans le terminal ouvert, exécutez les commandes suivantes pour obtenir les packages Node.js requis pour votre instance de VM Compute Engine 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
   

Sur l'ordinateur local, obtenez l'adresse IP externe de l'instance de VM Compute Engine sur laquelle l'exemple d'application s'exécute et affichez-la dans un navigateur.

Remarque : Cette étape de démarrage rapide nécessite gcloud CLI, qui fournit un accès en ligne de commande à vos ressources Google Cloud à l'aide des commandes gcloud CLI. Si gcloud CLI n'est pas installé sur votre ordinateur local, installez gcloud CLI pour continuer.

1. Dans un terminal ou dans Powershell sur votre ordinateur local, obtenez l'adresse IP externe de l'instance de VM Compute Engine en exécutant la commande gcloud compute instances describe suivante :

gcloud compute instances describe quickstart-vm-instance --format="value(networkInterfaces[0].accessConfigs[].natIP)"

2. Affichez l'exemple d'application en cours d'exécution. Ouvrez un navigateur sur votre ordinateur local et accédez à l'adresse IP externe et au port :8080 de l'instance de VM Compute Engine.

   http://COMPUTE_ENGINE_VM_EXTERNAL_IP_ADDRESS:8080
   

   

Pour arrêter l'exemple d'application, appuyez sur Ctrl+C dans le terminal de l'instance de VM Compute Engine où vous avez démarré l'exemple d'application.

Python

Sur l'instance de VM Compute Engine dans le terminal ouvert, exécutez les commandes suivantes pour initialiser les variables d'environnement requises afin d'exécuter l'exemple d'application. Avant d'exécuter les commandes, effectuez les remplacements suivants :

• INSTANCE_CONNECTION_NAME par le nom de connexion de votre instance qui apparaît sur la page Instances Cloud SQL de la console Google Cloud.
• 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 INSTANCE_CONNECTION_NAME='INSTANCE_CONNECTION_NAME'
export DB_PORT='1433'
export DB_NAME='quickstart_db'
export DB_USER='sqlserver'
export DB_PASS='YOUR_DB_PASSWORD'

Sur l'instance de VM Compute Engine dans le terminal ouvert, exécutez les commandes suivantes pour obtenir les conditions requises de l'exemple d'application Python sur votre instance de VM Compute Engine, puis exécutez 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
   

Sur votre ordinateur local, configurez le transfert de port sur SSH en suivant les instructions de l'étape de démarrage rapide suivante. Cela vous permet d'utiliser un navigateur sur votre ordinateur local pour afficher l'application s'exécutant sur votre instance de VM Compute Engine.

Remarque : Cette étape de démarrage rapide nécessite gcloud CLI, qui fournit un accès en ligne de commande à vos ressources Google Cloud à l'aide des commandes gcloud CLI. Si gcloud CLI n'est pas installé sur votre ordinateur local, installez gcloud CLI pour continuer.

1. Dans un terminal ou dans Powershell sur votre ordinateur local, exécutez la commande gcloud compute ssh suivante pour configurer le transfert de port sur SSH. Avant d'exécuter la commande, remplacez YOUR_PROJECT_ID par l'ID de votre projet.

gcloud compute ssh quickstart-vm-instance --project=YOUR_PROJECT_ID --zone=us-central1-a --ssh-flag='-L 8000:127.0.0.1:8080'

2. Affichez l'exemple d'application en cours d'exécution. Une fois le transfert de port en cours d'exécution, ouvrez un navigateur sur votre ordinateur local et saisissez http://127.0.0.1:8000 dans la barre d'adresse.

   

Pour arrêter l'exemple d'application, appuyez sur Ctrl+C dans le terminal de l'instance de VM Compute Engine où vous avez démarré l'exemple d'application.

Instance Cloud SQL avec adresse IP publique et VM Compute Engine basée sur Windows

Go

Sur l'instance de VM Compute Engine dans la fenêtre Powershell ouverte, exécutez les commandes suivantes pour initialiser les variables d'environnement requises afin d'exécuter l'exemple d'application. Avant d'exécuter ces commandes, effectuez les remplacements suivants :

• INSTANCE_CONNECTION_NAME par le nom de connexion de votre instance qui apparaît sur la page Instances Cloud SQL de la console Google Cloud.
• 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:INSTANCE_CONNECTION_NAME="INSTANCE_CONNECTION_NAME"
$env:DB_PORT="1433"
$env:DB_NAME="quickstart_db"
$env:DB_USER="sqlserver"
$env:DB_PASS="YOUR_DB_PASSWORD"

Sur l'instance de VM Compute Engine dans la fenêtre Powershell ouverte, exécutez les commandes suivantes pour obtenir les dépendances de l'exemple d'application Go sur votre instance de VM Compute Engine 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 un navigateur sur l'instance de VM Compute Engine et accédez à http://127.0.0.1:8080.

   

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

Java

Sur l'instance de VM Compute Engine dans la fenêtre Powershell ouverte, exécutez les commandes suivantes pour initialiser les variables d'environnement requises afin d'exécuter l'exemple d'application. Avant d'exécuter ces commandes, effectuez les remplacements suivants :

• INSTANCE_CONNECTION_NAME par le nom de connexion de votre instance qui apparaît sur la page Instances Cloud SQL de la console Google Cloud.
• 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:INSTANCE_CONNECTION_NAME="INSTANCE_CONNECTION_NAME"
$env:DB_PORT="1433"
$env:DB_NAME="quickstart_db"
$env:DB_USER="sqlserver"
$env:DB_PASS="YOUR_DB_PASSWORD"

1. Sur l'instance de VM Compute Engine dans la fenêtre Powershell ouverte, exécutez la commande suivante pour obtenir les dépendances de l'exemple d'application Java sur votre instance de VM Compute Engine et exécuter l'exemple d'application.

   mvn jetty:run
   

2. Affichez l'exemple d'application en cours d'exécution. Ouvrez un navigateur sur l'instance de VM Compute Engine et accédez à http://127.0.0.1:8080.

   

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

Node.js

1. Sur l'instance de VM Compute Engine dans la fenêtre Powershell ouverte, exécutez les commandes suivantes pour initialiser les variables d'environnement requises afin d'exécuter l'exemple d'application. Avant d'exécuter ces commandes, effectuez le remplacement suivant :

   • 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:INSTANCE_HOST="127.0.0.1"
   $env:DB_PORT="1433"
   $env:DB_NAME="quickstart_db"
   $env:DB_USER="sqlserver"
   $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 qui apparaît sur la page Instances Cloud SQL de la console Google Cloud.

   Start-Process -filepath  ".\cloud-sql-proxy.exe" -ArgumentList `
   "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.

Sur l'instance de VM Compute Engine dans la fenêtre Powershell ouverte, exécutez les commandes suivantes pour obtenir les packages Node.js requis pour votre instance de VM Compute Engine 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 un navigateur sur l'instance de VM Compute Engine et accédez à http://127.0.0.1:8080.

   

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

Python

Sur l'instance de VM Compute Engine dans la fenêtre Powershell ouverte, exécutez les commandes suivantes pour initialiser les variables d'environnement requises afin d'exécuter l'exemple d'application. Avant d'exécuter ces commandes, effectuez les remplacements suivants :

• INSTANCE_CONNECTION_NAME par le nom de connexion de votre instance qui apparaît sur la page Instances Cloud SQL de la console Google Cloud.
• 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:INSTANCE_CONNECTION_NAME="INSTANCE_CONNECTION_NAME"
$env:DB_PORT="1433"
$env:DB_NAME="quickstart_db"
$env:DB_USER="sqlserver"
$env:DB_PASS="YOUR_DB_PASSWORD"

Sur l'instance de VM Compute Engine dans la fenêtre Powershell ouverte, exécutez les commandes suivantes pour obtenir les conditions requises de l'exemple d'application Python sur votre instance de VM Compute Engine 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 un navigateur sur l'instance de VM Compute Engine et accédez à http://127.0.0.1:8080.

   

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

Instance Cloud SQL avec adresse IP privée et VM Compute Engine basée sur Linux

Créer et télécharger le certificat de serveur SSL sur votre ordinateur local

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 Télécharger les certificats pour télécharger le certificat de serveur SSL.

Importer le certificat SSL dans un bucket Cloud Storage

Console

Dans un navigateur sur votre ordinateur local, créez un bucket Cloud Storage et importez le certificat SSL dans le bucket où il est ensuite accessible depuis l'instance de VM Compute Engine.

1. Créez un bucket Cloud Storage.
1. Dans le champ Nom de votre bucket, saisissez le nom suivant : Remplacez YOUR_PROJECT_ID par l'ID de votre projet :

   YOUR_PROJECT_ID-quickstart-certs

2. Cliquez sur le bouton Créer pour créer le bucket.
2. Cliquez sur le bouton Importer des fichiers pour importer des fichiers dans le bucket Cloud Storage que vous venez de créer.
3. Sélectionnez le fichier suivant à importer depuis votre ordinateur local dans Cloud Storage :
• server-ca.pem

gcloud

Sur un ordinateur local ou dans une fenêtre Powershell ouverte dans le répertoire où vous avez téléchargé le certificat SSL, vous pouvez maintenant créer un bucket Cloud Storage et importer le certificat SSL dans le bucket où il sera ensuite accessible depuis l'instance de VM Compute Engine. La gcloud CLI sera utilisée pour importer le fichier.

1. Exécutez la commande gcloud storage buckts create suivante pour créer un bucket Cloud Storage :

gcloud storage buckets create gs://YOUR_PROJECT_ID-quickstart-certs --location=us-central1

2. Dans le répertoire dans lequel vous avez téléchargé le certificat sur votre ordinateur local, exécutez la commande gcloud storage cp suivante pour copier les certificats SSL dans le bucket Cloud Storage que vous venez de créer :

gcloud storage cp server-ca.pem gs://YOUR_PROJECT_ID-quickstart-certs/

Go

Télécharger le certificat SSL à l'aide de gcloud CLI sur l'instance de VM Compute Engine

Sur l'instance de VM Compute Engine dans un terminal ouvert dans le répertoire golang-samples/cloudsql/sqlserver/database-sql, exécutez la commande gcloud storage cp suivante pour télécharger les certificats SSL de Cloud Storage vers certs.

gcloud storage cp gs://YOUR_PROJECT_ID-quickstart-certs/server-ca.pem certs/.

Définir des variables d'environnement sur l'instance de VM Compute Engine

Sur l'instance de VM Compute Engine dans le terminal ouvert, exécutez les commandes suivantes pour initialiser les variables d'environnement requises afin d'exécuter l'exemple d'application. Avant d'exécuter les commandes, effectuez les remplacements suivants :

• INSTANCE_HOST défini sur l'adresse IP privée de votre instance affichée sur la page Instances Cloud SQL de la console Google Cloud.
Remarque : Les connexions à une instance Cloud SQL à l'aide d'une adresse IP privée sont automatiquement autorisées pour les plages d'adresses RFC 1918. Pour les plages d'adresses non-RFC 1918, consultez la page En savoir plus sur l'utilisation des adresses IP privées.
• 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 INSTANCE_HOST='INSTANCE_HOST'
export DB_PORT='1433'
export DB_NAME='quickstart_db'
export DB_USER='sqlserver'
export DB_PASS='YOUR_DB_PASSWORD'
export DB_ROOT_CERT='certs/server-ca.pem'
export PRIVATE_IP='TRUE'

Sur l'instance de VM Compute Engine dans le terminal ouvert, exécutez les commandes suivantes pour obtenir les dépendances de l'exemple d'application Go sur votre instance de VM Compute Engine 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
   

Sur l'ordinateur local, obtenez l'adresse IP externe de l'instance de VM Compute Engine sur laquelle l'exemple d'application s'exécute et affichez-la dans un navigateur.

Remarque : Cette étape de démarrage rapide nécessite gcloud CLI, qui fournit un accès en ligne de commande à vos ressources Google Cloud à l'aide des commandes gcloud CLI. Si gcloud CLI n'est pas installé sur votre ordinateur local, installez gcloud CLI pour continuer.

1. Dans un terminal ou dans Powershell sur votre ordinateur local, obtenez l'adresse IP externe de l'instance de VM Compute Engine en exécutant la commande gcloud compute instances describe suivante :

gcloud compute instances describe quickstart-vm-instance --format="value(networkInterfaces[0].accessConfigs[].natIP)"

2. Affichez l'exemple d'application en cours d'exécution. Ouvrez un navigateur sur votre ordinateur local et accédez à l'adresse IP externe et au port :8080 de l'instance de VM Compute Engine.

   http://COMPUTE_ENGINE_VM_EXTERNAL_IP_ADDRESS:8080
   

   

Pour arrêter l'exemple d'application, appuyez sur Ctrl+C dans le terminal de l'instance de VM Compute Engine où vous avez démarré l'exemple d'application.

Java

Télécharger le certificat SSL à l'aide de gcloud CLI sur l'instance de VM Compute Engine

Sur l'instance de VM Compute Engine dans un terminal ouvert dans le répertoire java-docs-samples/cloud-sql/sqlserver/servlet/, exécutez la commande gcloud storage cp suivante pour télécharger les certificats SSL de Cloud Storage vers le répertoire actuel.

gcloud storage cp gs://YOUR_PROJECT_ID-quickstart-certs/server-ca.pem .

Configurer les certificats SSL à utiliser en Java sur l'instance de VM Compute Engine

Dans le terminal de l'instance de VM Compute Engine, exécutez la commande suivante pour importer le certificat de serveur dans un truststore Java personnalisé à l'aide de keytool. Avant d'exécuter la commande suivante, remplacez TRUST_CERT_KEYSTORE_PASSWD par votre propre mot de passe keystore personnalisé à utiliser pour créer le truststore Java.

keytool -importcert -alias MySQLCACert -file server-ca.pem \
-keystore quickstart-truststore -storepass TRUST_CERT_KEYSTORE_PASSWD

Définir des variables d'environnement sur l'instance de VM Compute Engine

Sur l'instance de VM Compute Engine dans le terminal ouvert, exécutez les commandes suivantes pour initialiser les variables d'environnement requises afin d'exécuter l'exemple d'application. Avant d'exécuter les commandes, effectuez les remplacements suivants :

• INSTANCE_HOST défini sur l'adresse IP privée de votre instance affichée sur la page Instances Cloud SQL de la console Google Cloud.
Remarque : Les connexions à une instance Cloud SQL à l'aide d'une adresse IP privée sont automatiquement autorisées pour les plages d'adresses RFC 1918. Pour les plages d'adresses non-RFC 1918, consultez la page En savoir plus sur l'utilisation des adresses IP privées.
• 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 INSTANCE_HOST='INSTANCE_HOST'
export DB_PORT='1433'
export DB_NAME='quickstart_db'
export DB_USER='sqlserver'
export DB_PASS='YOUR_DB_PASSWORD'
export TRUST_CERT_KEYSTORE_PATH='quickstart-truststore'
export TRUST_CERT_KEYSTORE_PASSWD='TRUST_CERT_KEYSTORE_PASSWD'
export PRIVATE_IP='TRUE'

Sur l'instance de VM Compute Engine dans le terminal ouvert, exécutez la commande suivante pour obtenir les dépendances de l'exemple d'application Java sur votre instance de VM Compute Engine et exécuter l'exemple d'application.

mvn jetty:run

Sur l'ordinateur local, obtenez l'adresse IP externe de l'instance de VM Compute Engine sur laquelle l'exemple d'application s'exécute et affichez-la dans un navigateur.

Remarque : Cette étape de démarrage rapide nécessite gcloud CLI, qui fournit un accès en ligne de commande à vos ressources Google Cloud à l'aide des commandes gcloud CLI. Si gcloud CLI n'est pas installé sur votre ordinateur local, installez gcloud CLI pour continuer.

1. Dans un terminal ou dans Powershell sur votre ordinateur local, obtenez l'adresse IP externe de l'instance de VM Compute Engine en exécutant la commande gcloud compute instances describe suivante :

gcloud compute instances describe quickstart-vm-instance --format="value(networkInterfaces[0].accessConfigs[].natIP)"

2. Affichez l'exemple d'application en cours d'exécution. Ouvrez un navigateur sur votre ordinateur local et accédez à l'adresse IP externe et au port :8080 de l'instance de VM Compute Engine.

   http://COMPUTE_ENGINE_VM_EXTERNAL_IP_ADDRESS:8080
   

   

Pour arrêter l'exemple d'application, appuyez sur Ctrl+C dans le terminal de l'instance de VM Compute Engine où vous avez démarré l'exemple d'application.

Python

Télécharger le certificat SSL à l'aide de gcloud CLI sur l'instance de VM Compute Engine

Sur l'instance de VM Compute Engine dans un terminal ouvert dans le répertoire python-docs-samples/cloud-sql/sql-server/sqlalchemy, exécutez la commande gcloud storage cp suivante pour télécharger les certificats SSL de Cloud Storage vers certs.

gcloud storage cp gs://YOUR_PROJECT_ID-quickstart-certs/server-ca.pem certs/.

Définir des variables d'environnement sur l'instance de VM Compute Engine

Sur l'instance de VM Compute Engine dans le terminal ouvert, exécutez les commandes suivantes pour initialiser les variables d'environnement requises afin d'exécuter l'exemple d'application. Avant d'exécuter les commandes, effectuez les remplacements suivants :

• INSTANCE_HOST défini sur l'adresse IP privée de votre instance affichée sur la page Instances Cloud SQL de la console Google Cloud.
Remarque : Les connexions à une instance Cloud SQL à l'aide d'une adresse IP privée sont automatiquement autorisées pour les plages d'adresses RFC 1918. Pour les plages d'adresses non-RFC 1918, consultez la page En savoir plus sur l'utilisation des adresses IP privées.
• 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 INSTANCE_HOST='INSTANCE_HOST'
export DB_PORT='1433'
export DB_NAME='quickstart_db'
export DB_USER='sqlserver'
export DB_PASS='YOUR_DB_PASSWORD'
export DB_ROOT_CERT='certs/server-ca.pem'
export PRIVATE_IP='TRUE'

Sur l'instance de VM Compute Engine dans le terminal ouvert, exécutez les commandes suivantes pour obtenir les conditions requises de l'exemple d'application Python sur votre instance de VM Compute Engine, puis exécutez 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
   

Sur votre ordinateur local, configurez le transfert de port sur SSH en suivant les instructions de l'étape de démarrage rapide suivante. Cela vous permet d'utiliser un navigateur sur votre ordinateur local pour afficher l'application s'exécutant sur votre instance de VM Compute Engine.

Remarque : Cette étape de démarrage rapide nécessite gcloud CLI, qui fournit un accès en ligne de commande à vos ressources Google Cloud à l'aide des commandes gcloud CLI. Si gcloud CLI n'est pas installé sur votre ordinateur local, installez gcloud CLI pour continuer.

1. Dans un terminal ou dans Powershell sur votre ordinateur local, exécutez la commande gcloud compute ssh suivante pour configurer le transfert de port sur SSH. Avant d'exécuter la commande, remplacez YOUR_PROJECT_ID par l'ID de votre projet.

gcloud compute ssh quickstart-vm-instance --project=YOUR_PROJECT_ID --zone=us-central1-a --ssh-flag='-L 8000:127.0.0.1:8080'

2. Affichez l'exemple d'application en cours d'exécution. Une fois le transfert de port en cours d'exécution, ouvrez un navigateur sur votre ordinateur local et saisissez http://127.0.0.1:8000 dans la barre d'adresse.

   

Pour arrêter l'exemple d'application, appuyez sur Ctrl+C dans le terminal de l'instance de VM Compute Engine où vous avez démarré l'exemple d'application.

Instance Cloud SQL avec adresse IP privée et VM Compute Engine basée sur Windows

Créer et télécharger le certificat de serveur SSL sur votre ordinateur local

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 Télécharger les certificats pour télécharger le certificat de serveur SSL.

Importer le certificat SSL dans un bucket Cloud Storage

Console

Dans un navigateur sur votre ordinateur local, créez un bucket Cloud Storage et importez le certificat SSL dans le bucket où il est ensuite accessible depuis l'instance de VM Compute Engine.

1. Créez un bucket Cloud Storage.
1. Dans le champ Nom de votre bucket, saisissez le nom suivant : Remplacez YOUR_PROJECT_ID par l'ID de votre projet :

   YOUR_PROJECT_ID-quickstart-certs

2. Cliquez sur le bouton Créer pour créer le bucket.
2. Cliquez sur le bouton Importer des fichiers pour importer des fichiers dans le bucket Cloud Storage que vous venez de créer.
3. Sélectionnez le fichier suivant à importer depuis votre ordinateur local dans Cloud Storage :
• server-ca.pem

gcloud

Sur un ordinateur local ou dans une fenêtre Powershell ouverte dans le répertoire où vous avez téléchargé le certificat SSL, vous pouvez maintenant créer un bucket Cloud Storage et importer le certificat SSL dans le bucket où il sera ensuite accessible depuis l'instance de VM Compute Engine. La gcloud CLI sera utilisée pour importer le fichier.

1. Exécutez la commande gcloud storage buckts create suivante pour créer un bucket Cloud Storage :

gcloud storage buckets create gs://YOUR_PROJECT_ID-quickstart-certs --location=us-central1

2. Dans le répertoire dans lequel vous avez téléchargé le certificat sur votre ordinateur local, exécutez la commande gcloud storage cp suivante pour copier les certificats SSL dans le bucket Cloud Storage que vous venez de créer :

gcloud storage cp server-ca.pem gs://YOUR_PROJECT_ID-quickstart-certs/

Go

Télécharger le certificat SSL à l'aide de gcloud CLI sur l'instance de VM Compute Engine

Sur l'instance de VM Compute Engine dans une fenêtre Powershell ouverte dans le répertoire golang-samples/cloudsql/sqlserver/database-sql, exécutez la commande gcloud storage cp suivante pour télécharger le certificat SSL depuis Cloud Storage vers le répertoire certs.

gcloud storage cp gs://YOUR_PROJECT_ID-quickstart-certs/server-ca.pem certs/.

Définir des variables d'environnement sur l'instance de VM Compute Engine

Sur l'instance de VM Compute Engine dans la fenêtre Powershell, 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 :

• INSTANCE_HOST défini sur l'adresse IP privée de votre instance affichée sur la page Instances Cloud SQL de la console Google Cloud.
Remarque : Les connexions à une instance Cloud SQL à l'aide d'une adresse IP privée sont automatiquement autorisées pour les plages d'adresses RFC 1918. Pour les plages d'adresses non-RFC 1918, consultez la page En savoir plus sur l'utilisation des adresses IP privées.
• 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:INSTANCE_HOST="INSTANCE_HOST"
$env:DB_PORT="1433"
$env:DB_NAME="quickstart_db"
$env:DB_USER="sqlserver"
$env:DB_PASS="YOUR_DB_PASSWORD"
$env:DB_ROOT_CERT="certs/server-ca.pem"
$env:PRIVATE_IP="TRUE"

Sur l'instance de VM Compute Engine dans la fenêtre Powershell ouverte, exécutez les commandes suivantes pour obtenir les dépendances de l'exemple d'application Go sur votre instance de VM Compute Engine 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 un navigateur sur l'instance de VM Compute Engine et accédez à http://127.0.0.1:8080.

   

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

Java

Télécharger le certificat SSL à l'aide de gcloud CLI sur l'instance de VM Compute Engine

Sur l'instance de VM Compute Engine dans une fenêtre Powershell ouverte dans le répertoire java-docs-samples/cloud-sql/sqlserver/servlet/, exécutez la commande gcloud storage cp suivante pour télécharger les certificats SSL depuis Cloud Storage vers le répertoire actuel.

gcloud storage cp gs://YOUR_PROJECT_ID-quickstart-certs/server-ca.pem .

Configurer les certificats SSL à utiliser en Java sur l'instance de VM Compute Engine

Dans le terminal de l'instance de VM Compute Engine, exécutez la commande suivante pour importer le certificat de serveur dans un truststore Java personnalisé à l'aide de keytool. Avant d'exécuter la commande suivante, remplacez TRUST_CERT_KEYSTORE_PASSWD par votre propre mot de passe keystore personnalisé à utiliser pour créer le truststore Java.

keytool -importcert -alias SQLServerCACert -file server-ca.pem `
-keystore quickstart-truststore -storepass TRUST_CERT_KEYSTORE_PASSWD

Définir des variables d'environnement sur l'instance de VM Compute Engine

Sur l'instance de VM Compute Engine dans la fenêtre Powershell, 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 :

• INSTANCE_HOST défini sur l'adresse IP privée de votre instance affichée sur la page Instances Cloud SQL de la console Google Cloud.
Remarque : Les connexions à une instance Cloud SQL à l'aide d'une adresse IP privée sont automatiquement autorisées pour les plages d'adresses RFC 1918. Pour les plages d'adresses non-RFC 1918, consultez la page En savoir plus sur l'utilisation des adresses IP privées.
• 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.
• TRUST_CERT_KEYSTORE_PASSWD par le mot de passe que vous avez spécifié pour --storepass à l'étape précédente.

$env:INSTANCE_HOST="INSTANCE_HOST"
$env:DB_PORT="1433"
$env:DB_NAME="quickstart_db"
$env:DB_USER="sqlserver"
$env:DB_PASS="YOUR_DB_PASSWORD"
$env:TRUST_CERT_KEYSTORE_PATH="quickstart-truststore"
$env:TRUST_CERT_KEYSTORE_PASSWD="TRUST_CERT_KEYSTORE_PASSWD"
$env:PRIVATE_IP="TRUE"

1. Sur l'instance de VM Compute Engine dans la fenêtre Powershell ouverte, exécutez la commande suivante pour obtenir les dépendances de l'exemple d'application Java sur votre instance de VM Compute Engine et exécuter l'exemple d'application.

   mvn jetty:run
   

2. Affichez l'exemple d'application en cours d'exécution. Ouvrez un navigateur sur l'instance de VM Compute Engine et accédez à http://127.0.0.1:8080.

   

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

Python

Télécharger le certificat SSL à l'aide de gcloud CLI sur l'instance de VM Compute Engine

Sur l'instance de VM Compute Engine dans une fenêtre Powershell ouverte dans le répertoire python-docs-samples/cloud-sql/sql-server/sqlalchemy, exécutez la commande gcloud storage cp suivante pour télécharger le certificat SSL depuis Cloud Storage vers le répertoire certs.

gcloud storage cp gs://YOUR_PROJECT_ID-quickstart-certs/server-ca.pem certs/.

Définir des variables d'environnement sur l'instance de VM Compute Engine

Sur l'instance de VM Compute Engine dans la fenêtre Powershell, 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 :

• INSTANCE_HOST défini sur l'adresse IP privée de votre instance affichée sur la page Instances Cloud SQL de la console Google Cloud.
Remarque : Les connexions à une instance Cloud SQL à l'aide d'une adresse IP privée sont automatiquement autorisées pour les plages d'adresses RFC 1918. Pour les plages d'adresses non-RFC 1918, consultez la page En savoir plus sur l'utilisation des adresses IP privées.
• 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:INSTANCE_HOST="INSTANCE_HOST"
$env:DB_PORT="1433"
$env:DB_NAME="quickstart_db"
$env:DB_USER="sqlserver"
$env:DB_PASS="YOUR_DB_PASSWORD"
$env:DB_ROOT_CERT="certs/server-ca.pem"
$env:PRIVATE_IP="TRUE"

Sur l'instance de VM Compute Engine dans la fenêtre Powershell ouverte, exécutez les commandes suivantes pour obtenir les conditions requises de l'exemple d'application Python sur votre instance de VM Compute Engine 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 un navigateur sur l'instance de VM Compute Engine et accédez à http://127.0.0.1:8080.

   

Pour arrêter l'exemple d'application, appuyez sur Ctrl+C dans la fenêtre Powershell de l'instance de VM Compute Engine 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 :

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 SQL Server pour votre instance Cloud SQL.

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

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