Se connecter à Cloud SQL pour SQL Server depuis Google Kubernetes Engine

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 Create Instance (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 et développez la section Afficher les configurations.
8. Dans le menu déroulant Type de machine, sélectionnez Configuration légère.

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

gcloud

Créer une instance avec une adresse IP publique

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

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

• --database_version : type et version du moteur de base de données. Si aucune valeur n'est spécifiée, la valeur par défaut de l'API est utilisée. Consultez la documentation de gcloud database versions pour afficher les versions actuellement disponibles.
• --cpu : nombre de cœurs 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

Console

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. Si une boîte de dialogue indiquant Connexion d'accès aux services privés requise s'affiche, cliquez sur le bouton Configurer la connexion.
• Dans la boîte de dialogue Activer l'API Service Networking, cliquez sur le bouton Activer l'API.
• Dans la boîte de dialogue Allouer une plage d'adresses IP, sélectionnez Utiliser une plage d'adresses IP automatiquement allouée et cliquez sur Continuer.
• Dans la boîte de dialogue Créer une connexion, cliquez sur Créer une connexion.
12. Décochez la case Adresse IP publique pour créer une instance qui dispose uniquement d'une adresse IP privée.
13. Cliquez sur Créer une instance, puis attendez que l'instance s'initialise et démarre.
14. Cliquez sur Connexions.
15. Dans la section Sécurité, sélectionnez Autoriser uniquement les connexions SSL pour activer les connexions SSL.
16. 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

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

Pour créer une instance avec une adresse IP privée, il vous suffit de configurer l'accès aux services privés afin d'activer les connexions à partir d'autres services Google Cloud, tels que GKE.

1. Exécutez la commande gcloud compute addresses create pour allouer une plage d'adresses IP à une connexion d'accès aux services privés :

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 la connexion d'accès aux services privés :

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

3. Avant d'exécuter la commande gcloud sql instances create pour créer une instance 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 répertorier les versions actuellement disponibles.
• --cpu : nombre de cœurs dans la machine.
• --memory : nombre entier 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

4. Exécutez la commande gcloud sql instances patch afin d'autoriser uniquement les connexions SSL pour l'instance.

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

Go

L'exemple d'application déployé se connecte à votre instance Cloud SQL à l'aide du proxy Cloud SQL exécuté dans un modèle side-car Kubernetes. Le modèle side-car est réalisé en déployant une charge de travail avec un conteneur supplémentaire qui partage le même pod Kubernetes que celui de l'exemple d'application.

1. Obtenez le nom de connexion de l'instance Cloud SQL en exécutant la commande gcloud sql instances describe :

   gcloud sql instances describe quickstart-instance --format='value(connectionName)'

2. Mettez à jour le fichier deployment.yaml dans l'éditeur Cloud Shell. Apportez les modifications et remplacements suivants :
   • Remplacez <YOUR_KSA_NAME> par ksa-cloud-sql.
   • Remplacez <LOCATION> par us-central1.
   • Remplacez <YOUR_PROJECT_ID> par l'ID du projet.
   • Remplacez <YOUR-DB-SECRET> par gke-cloud-sql-secrets.
   • Remplacez <INSTANCE_CONNECTION_NAME> par le nom de connexion de l'instance Cloud SQL récupéré à l'aide de la commande gcloud à l'étape précédente. Le format est project_id:region:instance_name. Le nom de connexion de l'instance est également visible sur la page Présentation de l'instance Cloud SQL.
   • Autorisez le proxy d'authentification Cloud SQL à se connecter à l'instance Cloud SQL à l'aide de son adresse IP privée. Annulez la mise en commentaire de l'option "-ip_address_types=PRIVATE" en supprimant le symbole de commentaire # et l'espace blanc final. L'indicateur sans commentaire doit ressembler à ceci :

     - "-ip_address_types=PRIVATE"

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: gke-cloud-sql-quickstart
   spec:
     selector:
       matchLabels:
         app: gke-cloud-sql-app
     template:
       metadata:
         labels:
           app: gke-cloud-sql-app
       spec:
         serviceAccountName: <YOUR-KSA-NAME>
         containers:
         - name: gke-cloud-sql-app
           # Replace <LOCATION> with your Artifact Registry location (e.g., us-central1).
           # Replace <YOUR_PROJECT_ID> with your project ID.
           image: <LOCATION>-docker.pkg.dev/<YOUR_PROJECT_ID>/gke-cloud-sql-repo/gke-sql:latest
           # This app listens on port 8080 for web traffic by default.
           ports:
           - containerPort: 8080
           env:
           - name: PORT
             value: "8080"
           - name: INSTANCE_HOST
             value: "127.0.0.1"
           - name: DB_PORT
             value: "1433"
           - name: DB_USER
             valueFrom:
               secretKeyRef:
                 name: <YOUR-DB-SECRET>
                 key: username
           - name: DB_PASS
             valueFrom:
               secretKeyRef:
                 name: <YOUR-DB-SECRET>
                 key: password
           - name: DB_NAME
             valueFrom:
               secretKeyRef:
                 name: <YOUR-DB-SECRET>
                 key: database
         - name: cloud-sql-proxy
           # This uses the latest version of the Cloud SQL Proxy
           # It is recommended to use a specific version for production environments.
           # See: https://github.com/GoogleCloudPlatform/cloudsql-proxy
           image: gcr.io/cloud-sql-connectors/cloud-sql-proxy:latest
           args:
             # If connecting from a VPC-native GKE cluster, you can use the
             # following flag to have the proxy connect over private IP
             # - "--private-ip"
   
             # tcp should be set to the port the proxy should listen on
             # and should match the DB_PORT value set above.
             # Defaults: MySQL: 3306, Postgres: 5432, SQLServer: 1433
             - "--port=1433"
             - "<INSTANCE_CONNECTION_NAME>"
           securityContext:
             # The default Cloud SQL proxy image runs as the
             # "nonroot" user and group (uid: 65532) by default.
             runAsNonRoot: true
   

3. Exécutez la commande kubectl apply comme suit dans Cloud Shell pour déployer l'exemple d'application :

   kubectl apply -f deployment.yaml

4. Exécutez la commande kubectl apply comme suit pour ajouter un équilibreur de charge devant le déploiement, afin de pouvoir y accéder via Internet :

   kubectl apply -f service.yaml

5. Exécutez la commande kubectl get comme suit pour obtenir les détails du service :

   kubectl get services

6. Copiez l'adresse IP externe une fois qu'elle devient disponible dans les détails du service. Cette opération peut prendre quelques minutes.
7. Afficher l'exemple d'application déployé. Ouvrez une fenêtre de navigateur et accédez à l'adresse IP externe du service.

   

Java

L'exemple d'application déployé se connecte à votre instance Cloud SQL à l'aide du connecteur Java Cloud SQL.

1. Obtenez le nom de connexion de l'instance Cloud SQL en exécutant la commande gcloud sql instances describe :

   gcloud sql instances describe quickstart-instance --format='value(connectionName)'

2. Mettez à jour le fichier deployment.yaml dans l'éditeur Cloud Shell. Effectuez les remplacements suivants :
   • <YOUR_KSA_NAME> correspond à ksa-cloud-sql.
   • <LOCATION> correspond à us-central1.
   • <YOUR_PROJECT_ID> par l'ID du projet.
   • <YOUR-DB-SECRET> correspond à gke-cloud-sql-secrets.
   • <INSTANCE_CONNECTION_NAME> par le nom de connexion de l'instance Cloud SQL récupéré à l'aide de la commande gcloud à l'étape précédente. Le format est project_id:region:instance_name. Le nom de connexion de l'instance est également visible sur la page Présentation de l'instance Cloud SQL.
   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: gke-cloud-sql-quickstart
   spec:
     selector:
       matchLabels:
         app: gke-cloud-sql-app
     template:
       metadata:
         labels:
           app: gke-cloud-sql-app
       spec:
         # For more information about using Kubernetes service accounts see: 
         # https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts
         serviceAccountName: <YOUR-KSA-NAME> # TODO(developer): replace this value.
         containers:
         - name: gke-cloud-sql-app
           # Replace <LOCATION> with your Artifact Registry location (e.g., us-central1).
           # Replace <YOUR_PROJECT_ID> with your project ID.
           image: <LOCATION>-docker.pkg.dev/<YOUR_PROJECT_ID>/gke-cloud-sql-repo/gke-sql:latest
           # This app listens on port 8080 for web traffic by default.
           ports:
           - containerPort: 8080
           env:
           - name: PORT
             value: "8080"
           - name: INSTANCE_CONNECTION_NAME
             value: <INSTANCE_CONNECTION_NAME>
           - name: DB_HOST
             value: "127.0.0.1"
           - name: DB_PORT
             value: "1433"  
           - name: DB_USER
             valueFrom:
               secretKeyRef:
                 name: <YOUR-DB-SECRET>
                 key: username
           - name: DB_PASS
             valueFrom:
               secretKeyRef:
                 name: <YOUR-DB-SECRET>
                 key: password
           - name: DB_NAME
             valueFrom:
               secretKeyRef:
                 name: <YOUR-DB-SECRET>
                 key: database
   

3. Exécutez la commande kubectl apply comme suit dans Cloud Shell pour déployer l'exemple d'application :

   kubectl apply -f deployment.yaml

4. Exécutez la commande kubectl apply comme suit pour ajouter un équilibreur de charge devant le déploiement, afin de pouvoir y accéder via Internet :

   kubectl apply -f service.yaml

5. Exécutez la commande kubectl get comme suit pour obtenir les détails du service :

   kubectl get services

6. Copiez l'adresse IP externe une fois qu'elle devient disponible dans les détails du service. Cette opération peut prendre quelques minutes.
7. Afficher l'exemple d'application déployé. Ouvrez une fenêtre de navigateur et accédez à l'adresse IP externe du service.

   

Node.js

L'exemple d'application déployé se connecte à votre instance Cloud SQL à l'aide du proxy Cloud SQL exécuté dans un modèle side-car Kubernetes. Le modèle side-car est réalisé en déployant une charge de travail avec un conteneur supplémentaire qui partage le même pod Kubernetes que celui de l'exemple d'application.

1. Obtenez le nom de connexion de l'instance Cloud SQL en exécutant la commande gcloud sql instances describe :

   gcloud sql instances describe quickstart-instance --format='value(connectionName)'

2. Mettez à jour le fichier deployment.yaml dans l'éditeur Cloud Shell. Apportez les modifications et remplacements suivants :
   • Remplacez <YOUR_KSA_NAME> par ksa-cloud-sql.
   • Remplacez <LOCATION> par us-central1.
   • Remplacez <YOUR_PROJECT_ID> par l'ID du projet.
   • Remplacez <YOUR-DB-SECRET> par gke-cloud-sql-secrets.
   • Remplacez <INSTANCE_CONNECTION_NAME> par le nom de connexion de l'instance Cloud SQL récupéré à l'aide de la commande gcloud à l'étape précédente. Le format est project_id:region:instance_name. Le nom de connexion de l'instance est également visible sur la page Présentation de l'instance Cloud SQL.
   • Autorisez le proxy d'authentification Cloud SQL à se connecter à l'instance Cloud SQL à l'aide de son adresse IP privée. Annulez la mise en commentaire de l'option "-ip_address_types=PRIVATE" en supprimant le symbole de commentaire # et l'espace blanc final. L'indicateur sans commentaire doit ressembler à ceci :

     - "-ip_address_types=PRIVATE"

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: gke-cloud-sql-quickstart
   spec:
     selector:
       matchLabels:
         app: gke-cloud-sql-app
     template:
       metadata:
         labels:
           app: gke-cloud-sql-app
       spec:
         serviceAccountName: <YOUR-KSA-NAME>
         containers:
         - name: gke-cloud-sql-app
           # Replace <LOCATION> with your Artifact Registry location (e.g., us-central1).
           # Replace <YOUR_PROJECT_ID> with your project ID.
           image: <LOCATION>-docker.pkg.dev/<YOUR_PROJECT_ID>/gke-cloud-sql-repo/gke-sql:latest
           # This app listens on port 8080 for web traffic by default.
           ports:
           - containerPort: 8080
           env:
           - name: PORT
             value: "8080"
           - name: INSTANCE_HOST
             value: "127.0.0.1"
           - name: DB_PORT
             value: "1433"  
           - name: DB_USER
             valueFrom:
               secretKeyRef:
                 name: <YOUR-DB-SECRET>
                 key: username
           - name: DB_PASS
             valueFrom:
               secretKeyRef:
                 name: <YOUR-DB-SECRET>
                 key: password
           - name: DB_NAME
             valueFrom:
               secretKeyRef:
                 name: <YOUR-DB-SECRET>
                 key: database
         - name: cloud-sql-proxy
           # This uses the latest version of the Cloud SQL proxy
           # It is recommended to use a specific version for production environments.
           # See: https://github.com/GoogleCloudPlatform/cloudsql-proxy 
           image: gcr.io/cloud-sql-connectors/cloud-sql-proxy:latest
           args:
             # If connecting from a VPC-native GKE cluster, you can use the
             # following flag to have the proxy connect over private IP
             # - "--private-ip"
   
             # tcp should be set to the port the proxy should listen on
             # and should match the DB_PORT value set above.
             # Defaults: MySQL: 3306, Postgres: 5432, SQLServer: 1433
             - "--port=1433"
             - "<INSTANCE_CONNECTION_NAME>"
           securityContext:
             # The default Cloud SQL proxy image runs as the
             # "nonroot" user and group (uid: 65532) by default.
             runAsNonRoot: true
   

3. Exécutez la commande kubectl apply comme suit dans Cloud Shell pour déployer l'exemple d'application :

   kubectl apply -f deployment.yaml

4. Exécutez la commande kubectl apply comme suit pour ajouter un équilibreur de charge devant le déploiement, afin de pouvoir y accéder via Internet :

   kubectl apply -f service.yaml

5. Exécutez la commande kubectl get comme suit pour obtenir les détails du service :

   kubectl get services

6. Copiez l'adresse IP externe une fois qu'elle devient disponible dans les détails du service. Cette opération peut prendre quelques minutes.
7. Afficher l'exemple d'application déployé. Ouvrez une fenêtre de navigateur et accédez à l'adresse IP externe du service.

   

Python

L'exemple d'application déployé se connecte à votre instance Cloud SQL à l'aide du proxy Cloud SQL exécuté dans un modèle side-car Kubernetes. Le modèle side-car est réalisé en déployant une charge de travail avec un conteneur supplémentaire qui partage le même pod Kubernetes que celui de l'exemple d'application.

1. Obtenez le nom de connexion de l'instance Cloud SQL en exécutant la commande gcloud sql instances describe :

   gcloud sql instances describe quickstart-instance --format='value(connectionName)'

2. Mettez à jour le fichier deployment.yaml dans l'éditeur Cloud Shell. Apportez les modifications et remplacements suivants :
   • Remplacez <YOUR_KSA_NAME> par ksa-cloud-sql.
   • Remplacez <LOCATION> par us-central1.
   • Remplacez <YOUR_PROJECT_ID> par l'ID du projet.
   • Remplacez <YOUR-DB-SECRET> par gke-cloud-sql-secrets.
   • Remplacez <INSTANCE_CONNECTION_NAME> par le nom de connexion de l'instance Cloud SQL récupéré à l'aide de la commande gcloud à l'étape précédente. Le format est project_id:region:instance_name. Le nom de connexion de l'instance est également visible sur la page Présentation de l'instance Cloud SQL.
   • Autorisez le proxy d'authentification Cloud SQL à se connecter à l'instance Cloud SQL à l'aide de son adresse IP privée. Annulez la mise en commentaire de l'option "-ip_address_types=PRIVATE" en supprimant le symbole de commentaire # et l'espace blanc final. L'indicateur sans commentaire doit ressembler à ceci :

     - "-ip_address_types=PRIVATE"

   • Annulez la mise en commentaire de la variable d'environnement - name: CLOUD_SQL_AUTH_PROXY_IP_ADDRESS_TYPE et sa valeur en supprimant les symboles de commentaire # et l'espace blanc final. La variable d'environnement sans commentaire et sa valeur devraient se présenter comme suit :

      - name: CLOUD_SQL_AUTH_PROXY_IP_ADDRESS_TYPE
        value: "PRIVATE"

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: gke-cloud-sql-quickstart
   spec:
     selector:
       matchLabels:
         app: gke-cloud-sql-app
     template:
       metadata:
         labels:
           app: gke-cloud-sql-app
       spec:
         serviceAccountName: <YOUR-KSA-NAME>
         containers:
         - name: gke-cloud-sql-app
           # Replace <LOCATION> with your Artifact Registry location (e.g., us-central1).
           # Replace <YOUR_PROJECT_ID> with your project ID.
           image: <LOCATION>-docker.pkg.dev/<YOUR_PROJECT_ID>/gke-cloud-sql-repo/gke-sql:latest
           # This app listens on port 8080 for web traffic by default.
           ports:
           - containerPort: 8080
           env:
           - name: PORT
             value: "8080"
           # This project uses environment variables to determine
           # how you would like to run your application
           # To use the Python connector (recommended) - use INSTANCE_CONNECTION_NAME (proj:region:instance)
           # To use TCP - Setting INSTANCE_HOST will use TCP (e.g., 127.0.0.1)
           - name: INSTANCE_HOST
             value: "127.0.0.1"
           - name: DB_PORT
             value: "1433"
           # If connecting from a VPC-native GKE cluster, you can use the
           # following environment variable to have the proxy connect over private IP
           # - name: CLOUD_SQL_AUTH_PROXY_IP_ADDRESS_TYPE
           #   value: "PRIVATE"
           - name: DB_USER
             valueFrom:
               secretKeyRef:
                 name: <YOUR-DB-SECRET>
                 key: username
           - name: DB_PASS
             valueFrom:
               secretKeyRef:
                 name: <YOUR-DB-SECRET>
                 key: password
           - name: DB_NAME
             valueFrom:
               secretKeyRef:
                 name: <YOUR-DB-SECRET>
                 key: database
         # If you are using the Python Connector (recommended), you can
         # remove cloud-sql-proxy (everything below this line)
         - name: cloud-sql-proxy
           # This uses the latest version of the Cloud SQL proxy
           # It is recommended to use a specific version for production environments.
           # See: https://github.com/GoogleCloudPlatform/cloudsql-proxy 
           image: gcr.io/cloud-sql-connectors/cloud-sql-proxy:latest
           args:
             # If connecting from a VPC-native GKE cluster, you can use the
             # following flag to have the proxy connect over private IP
             # - "--private-ip"
   
             # tcp should be set to the port the proxy should listen on
             # and should match the DB_PORT value set above.
             # Defaults: MySQL: 3306, Postgres: 5432, SQLServer: 1433
             - "--port=1433"
             - "<INSTANCE_CONNECTION_NAME>"
           securityContext:
             # The default Cloud SQL proxy image runs as the
             # "nonroot" user and group (uid: 65532) by default.
             runAsNonRoot: true
   

3. Exécutez la commande kubectl apply comme suit dans Cloud Shell pour déployer l'exemple d'application :

   kubectl apply -f deployment.yaml

4. Exécutez la commande kubectl apply comme suit pour ajouter un équilibreur de charge devant le déploiement, afin de pouvoir y accéder via Internet :

   kubectl apply -f service.yaml

5. Exécutez la commande kubectl get comme suit pour obtenir les détails du service :

   kubectl get services

6. Copiez l'adresse IP externe une fois qu'elle devient disponible dans les détails du service. Cette opération peut prendre quelques minutes.
7. Afficher l'exemple d'application déployé. Ouvrez une fenêtre de navigateur et accédez à l'adresse IP externe du service.