Se connecter à Cloud SQL pour SQL Server à partir de Cloud Run

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 Choisir SQL Server.
4. Assurez-vous que l'édition Cloud SQL Enterprise Plus est sélectionnée pour votre instance.
5. Dans le champ ID d'instance, saisissez quickstart-instance.
6. 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.
7. Dans la section Sélectionner la disponibilité régionale et zonale, sélectionnez Zone unique.
8. Cliquez sur le menu Afficher les options de configuration.
9. Développez le nœud Configuration de la machine.
10. Dans la région Configurations de machines, sélectionnez la configuration 4 vCPU, 32 Go.
11. Développez le nœud Connexions.
12. Décochez la case Adresse IP publique pour créer une instance qui dispose uniquement d'une adresse IP privée.
13. Cochez la case Adresse IP privée.
14. Dans le menu Réseau, sélectionnez Par défaut.
15. Cliquez sur Créer une instance, puis attendez que l'instance s'initialise et démarre.
16. Cliquez sur Connexions.
17. Dans la section Sécurité, sélectionnez Autoriser uniquement les connexions SSL pour activer les connexions SSL.
18. 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 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

Go

Créer et télécharger le certificat de serveur SSL

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.

Créer une connexion VPC sans serveur pour les connexions à l'instance via une adresse IP privée

1. Dans la console Google Cloud, accédez à la page Accès au VPC sans serveur - Créer un connecteur.

   Créer un connecteur VPC sans serveur

2. Saisissez quickstart-connector pour le Nom.
3. Sélectionnez Valeur par défaut dans le menu déroulant Réseau.
4. Sélectionnez Plage d'adresses IP personnalisée dans le menu déroulant Sous-réseau.
5. Saisissez 10.8.0.0 dans la zone de saisie Plage d'adresses IP.
6. Cliquez sur Créer.

Créer un exemple d'application avec le certificat de serveur 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. Importez le fichier de certificat du serveur SSL dans le dossier certs.
   1. Faites un clic droit sur le dossier certs dans l'éditeur Cloud Shell, puis sélectionnez Importer des fichiers.
   2. Sélectionnez le fichier suivant sur votre ordinateur local : server-ca.pem.
   3. Une fois le fichier de certificat de serveur SSL sélectionné, cliquez sur Ouvrir pour terminer l'importation du fichier dans l'éditeur Cloud Shell.
4. Exécutez la commande suivante dans Cloud Shell pour créer un conteneur Docker et le publier dans Container Registry. Remplacez YOUR_PROJECT_ID par l'ID de votre projet.

   gcloud builds submit --tag gcr.io/YOUR_PROJECT_ID/run-sql

Java

Créer et télécharger le certificat de serveur SSL

Pour les utilisateurs de 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 le certificat de serveur SSL.

Créer une connexion VPC sans serveur pour les connexions à l'instance via une adresse IP privée

1. Dans la console Google Cloud, accédez à la page Accès au VPC sans serveur - Créer un connecteur.

   Créer un connecteur VPC sans serveur

2. Saisissez quickstart-connector pour le Nom.
3. Sélectionnez Valeur par défaut dans le menu déroulant Réseau.
4. Sélectionnez Plage d'adresses IP personnalisée dans le menu déroulant Sous-réseau.
5. Saisissez 10.8.0.0 dans la zone de saisie Plage d'adresses IP.
6. Cliquez sur Créer.

Créer un 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. Exécutez la commande suivante dans Cloud Shell pour créer un conteneur Docker et le publier dans Container Registry. Remplacez YOUR_PROJECT_ID par l'ID de votre projet.

   mvn clean package com.google.cloud.tools:jib-maven-plugin:2.8.0:build \
    -Dimage=gcr.io/YOUR_PROJECT_ID/run-sql -DskipTests

Python

Créer et télécharger le certificat de serveur SSL

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.

Créer une connexion VPC sans serveur pour les connexions à l'instance via une adresse IP privée

1. Dans la console Google Cloud, accédez à la page Accès au VPC sans serveur - Créer un connecteur.

   Créer un connecteur VPC sans serveur

2. Saisissez quickstart-connector pour le Nom.
3. Sélectionnez Valeur par défaut dans le menu déroulant Réseau.
4. Sélectionnez Plage d'adresses IP personnalisée dans le menu déroulant Sous-réseau.
5. Saisissez 10.8.0.0 dans la zone de saisie Plage d'adresses IP.
6. Cliquez sur Créer.

Créer un exemple d'application avec le certificat de serveur 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. Importez le fichier de certificat du serveur SSL dans le dossier certs.
   1. Faites un clic droit sur le dossier certs dans l'éditeur Cloud Shell, puis sélectionnez Importer des fichiers.
   2. Sélectionnez le fichier suivant sur votre ordinateur local : server-ca.pem.
   3. Une fois le fichier de certificat de serveur SSL sélectionné, cliquez sur Ouvrir pour terminer l'importation du fichier dans l'éditeur Cloud Shell.
4. Exécutez la commande suivante dans Cloud Shell pour créer un conteneur Docker et le publier dans Container Registry. Remplacez YOUR_PROJECT_ID par l'ID de votre projet.

   gcloud builds submit --tag gcr.io/YOUR_PROJECT_ID/run-sql

Console

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

   Accédez à Cloud Run

2. Cliquez sur Create container (Créer un conteneur) et sélectionnez Service (Service) pour afficher le formulaire Create service (Créer un service).

3. Conservez l'option de déploiement à partir d'une image de conteneur existante, puis cliquez sur Sélectionner pour spécifier l'image de conteneur gcr.io/YOUR_PROJECT_ID/run-sql que vous avez créée à l'étape précédente.
4. Saisissez quickstart-service dans le champ Nom du service.
5. Dans la section Authentification, sélectionnez l'option Allow unauthenticated invocations. Si vous ne disposez pas des autorisations nécessaires (rôle d'administrateur Cloud Run) pour sélectionner cette option, le service sera déployé et nécessitera une authentification.
6. Développez la section Conteneur, variables et secrets, connexions, sécurité.
7. Créez les variables d'environnement suivantes en cliquant sur Ajouter une variable sous Variables d'environnement. Définissez les valeurs des variables d'environnement comme suit :
• Définissez DB_NAME sur quickstart-db.
• Définissez DB_USER sur sqlserver.
• Définissez DB_PASS sur le mot de passe de l'utilisateur sqlserver que vous avez créée dans la section Créer une instance Cloud SQL.
• INSTANCE_CONNECTION_NAME : défini sur le nom de connexion de votre instance, qui apparaît sur la page Instances Cloud SQL de la console Google Cloud.
• Définissez DB_PORT sur 1433.
• Définissez INSTANCE_HOST sur l'adresse IP privée de votre instance, comme indiqué sur la page Présentation de l'instance Cloud SQL.
• Définissez DB_ROOT_CERT sur certs/server-ca.pem.
• Définissez PRIVATE_IP sur TRUE.

8. Activez la connexion à Cloud SQL :

   1. Cliquez sur Connexions.
   2. Cliquez sur Ajouter une connexion dans la section Connexions Cloud SQL.
   3. Sélectionnez l'instance Cloud SQL quickstart-instance que vous avez créée précédemment.
   4. Sélectionnez default: Serverless VPC Access Connector "quickstart-connector" dans le menu déroulant Réseau VPC.
   5. Sélectionnez l'option Acheminer tout le trafic via le connecteur VPC.

9. Cliquez sur Créer pour terminer la création du service Cloud Run.

10. Une fois le service Cloud Run déployé, la page Informations sur le service affiche l'URL du service en cours d'exécution en haut de page. Cliquez sur le lien URL pour afficher l'exemple d'application déployé sur Cloud Run et connecté à Cloud SQL.

    

gcloud

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

• YOUR_PROJECT_ID par votre ID de projet.

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

• DB_PASS par le mot de passe de l'utilisateur sqlserver que vous avez créé dans la section Créer une instance Cloud SQL.
• INSTANCE_HOST par l'adresse IP privée de l'instance. Accédez à la page Présentation de l'instance Cloud SQL pour afficher l'adresse IP privée de l'instance.

Exécutez la commande gcloud run deploy comme suit pour créer le service Cloud Run :

gcloud run deploy run-sql --image gcr.io/YOUR_PROJECT_ID/run-sql \
  --add-cloudsql-instances INSTANCE_CONNECTION_NAME \
  --vpc-connector="quickstart-connector" --vpc-egress=all-traffic \
  --set-env-vars DB_NAME="quickstart-db" \
  --set-env-vars DB_USER="sqlserver" \
  --set-env-vars DB_PASS="DB_PASS" \
  --set-env-vars INSTANCE_CONNECTION_NAME="INSTANCE_CONNECTION_NAME" \
  --set-env-vars DB_PORT="1433" \
  --set-env-vars INSTANCE_HOST="INSTANCE_HOST" \
  --set-env-vars DB_ROOT_CERT="certs/server-ca.pem" \
  --set-env-vars PRIVATE_IP="TRUE"

Les utilisateurs Java doivent exécuter la commande gcloud run deploy sans les options INSTANCE_HOST, DB_ROOT_CERT et PRIVATE_IP --set-env-vars, comme suit, pour créer le service Cloud Run, car le connecteur Java fournit déjà une connexion sécurisée :

gcloud run deploy run-sql --image gcr.io/YOUR_PROJECT_ID/run-sql \
  --add-cloudsql-instances INSTANCE_CONNECTION_NAME \
  --vpc-connector="quickstart-connector" --vpc-egress=all-traffic \
  --set-env-vars DB_NAME="quickstart-db" \
  --set-env-vars DB_USER="sqlserver" \
  --set-env-vars DB_PASS="DB_PASS" \
  --set-env-vars INSTANCE_CONNECTION_NAME="INSTANCE_CONNECTION_NAME" \
  --set-env-vars DB_PORT="1433"

Saisissez la valeur numérique fournie pour us-central1 lorsque vous êtes invité à spécifier une région.

2. Lorsque vous voyez un message de confirmation indiquant que le service Cloud Run a été déployé, cliquez sur le lien URL du service dans le message pour afficher l'exemple d'application Cloud Run connecté à Cloud SQL.