Connettiti a Cloud SQL per SQL Server da Cloud Run

Connettiti a Cloud SQL per SQL Server da Cloud Run

MySQL   |  PostgreSQL   |  SQL Server

Scopri come eseguire il deployment di un'app di esempio su Cloud Run connesso a un'istanza SQL Server tramite la console Google Cloud e un client un'applicazione.

Se completi tutti i passaggi in modo tempestivo, le risorse create in questa guida rapida in genere costano meno di un dollaro.

Prima di iniziare

Nota: il nome che utilizzi per il progetto deve essere compreso tra 4 e 30 caratteri. Quando digiti il nome, il modulo suggerisce un ID progetto che puoi modificare. L'ID progetto deve essere compreso tra 6 e 30 caratteri, con una lettera minuscola come primo carattere. Puoi utilizzare un trattino, una lettera minuscola o una cifra per i caratteri rimanenti, ma l'ultimo carattere non può essere un trattino.

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. Abilita le API Cloud necessarie per eseguire un'app di esempio Cloud SQL su Cloud Run.

   Console

   Fai clic su Abilita API per abilitare le API richieste per questa guida introduttiva.

   Abilita le API

   Ciò abilita le seguenti API:

   • API Compute Engine
   • API Cloud SQL Admin
   • API Cloud Run
   • API Container Registry
   • API Cloud Build
   • API Service Networking

   gcloud

   Fai clic sul pulsante seguente per aprire Cloud Shell, l'accesso da riga di comando alle risorse Google Cloud direttamente dal browser. Puoi utilizzare Cloud Shell per eseguire i comandi gcloud presentati in questa guida rapida.

   Apri Cloud Shell

   Esegui il seguente comando gcloud utilizzando Cloud Shell:

   gcloud services enable compute.googleapis.com sqladmin.googleapis.com run.googleapis.com \
   containerregistry.googleapis.com cloudbuild.googleapis.com servicenetworking.googleapis.com

   Questo comando abilita le seguenti API:

   • API Compute Engine
   • API Cloud SQL Admin
   • API Cloud Run
   • API Container Registry
   • API Cloud Build
   • API Service Networking

Configura Cloud SQL

Crea un'istanza Cloud SQL

IP pubblico

Cloud Run non supporta la connessione a Cloud SQL per SQL Server su IP pubblico. Utilizza invece l'IP privato.

IP privato

Console

Alloca un intervallo di indirizzi IP e crea una connessione privata per configurare l'accesso privato ai servizi per Cloud SQL

1. Nella console Google Cloud, vai alla pagina Reti VPC.

   Vai alle reti VPC

2. Seleziona la rete VPC default.
3. Seleziona la scheda Connessione ai servizi privati.
4. Seleziona la scheda Intervalli IP allocati per i servizi.
5. Fai clic su Assegna intervallo IP.
6. Per il Nome dell'intervallo allocato, specifica google-managed-services-default.
7. Seleziona l'opzione Automatico per l'intervallo IP e specifica 16 come lunghezza del prefisso.
8. Fai clic su Alloca per creare l'intervallo allocato.
9. Seleziona la scheda Connessioni private ai servizi per la rete VPC default.
10. Fai clic su Crea connessione per creare una connessione privata tra la tua rete e un producer di servizi.
11. Per Allocazione assegnata, seleziona google-managed-services-default.
12. Fai clic su Connetti per creare la connessione.

Creare un'istanza con indirizzo IP privato e SSL abilitati

1. Nella console Google Cloud, vai alla pagina Istanze Cloud SQL.

   Vai a Istanze Cloud SQL

2. Fai clic su Crea istanza.
3. Fai clic su SQL Server.
4. Inserisci quickstart-instance nel campo ID istanza.
5. Inserisci una password per l'utente SQL Server. Salva questa password per un uso futuro.
6. Fai clic sull'opzione Zona singola per Scegli la disponibilità per regione e zona.
7. Fai clic ed espandi Mostra opzioni di configurazione.
8. Per Tipo di macchina, seleziona Leggera.
9. In Connessioni, seleziona IP privato.
10. Seleziona predefinita nel menu a discesa Rete.
11. Deseleziona la casella di controllo IP pubblico per creare un'istanza solo con un IP privato.
12. Fai clic su Crea istanza, quindi attendi che l'istanza venga inizializzata e avviata.
13. Fai clic su Connections (Connessioni).
14. Nella sezione Sicurezza, seleziona Consenti solo connessioni SSL per attivare le connessioni SSL.
15. Nella finestra di dialogo Consenti solo connessioni SSL, fai clic su Salva e riavvia, quindi attendi il riavvio dell'istanza.

gcloud

Alloca un intervallo di indirizzi IP e crea una connessione privata per configurare l'accesso privato ai servizi per Cloud SQL

1. Esegui il comando gcloud compute addresses create per allocare un intervallo di indirizzi IP.

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

2. Esegui il comando gcloud services vpc-peerings connect per creare una connessione privata all'intervallo di indirizzi IP allocati. Sostituisci YOUR_PROJECT_ID con l'ID progetto del tuo progetto.

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

Crea un'istanza con indirizzo IP privato e SSL abilitato

1. Prima di eseguire il comando come segue, sostituisci DB_ROOT_PASSWORD con la password dell'utente del database.

Se vuoi, modifica i valori dei seguenti parametri:

• --database-version: il tipo e la versione del motore del database. Se questo valore non è specificato, viene utilizzato il valore predefinito dell'API. Consulta la documentazione sulle versioni del database gcloud per conoscere le versioni attualmente disponibili.
• --cpu: il numero di core della macchina.
• --memory: un numero intero che indica come da includere nella macchina. È possibile fornire un'unità di misura (ad esempio 3072 MB o 9 GB). Se non viene specificata alcuna unità, si presume GB.
• --region: la posizione regionale dell'istanza (ad esempio asia-east1, us-east1). Se non specificato, viene utilizzato il valore predefinito us-central1. Consulta l'elenco completo delle regioni.

Esegui il comando gcloud sql instances create per creare un'istanza Cloud SQL con un indirizzo IP privato.

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. Esegui gcloud sql instances patch. per abilitare consenti solo connessioni SSL per l'istanza.

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

Crea un database

Console

1. Nella console Google Cloud, vai alla pagina Istanze Cloud SQL.

   Vai a Istanze Cloud SQL

2. Seleziona quickstart-instance.
3. Nel menu di navigazione SQL, seleziona Database.
4. Fai clic su Crea database.
1. Nel campo Nome database della finestra di dialogo Nuovo database inserisci quickstart-db.
2. Fai clic su Crea.

gcloud

Esegui il comando gcloud sql databases create per creare un database.

gcloud sql databases create quickstart-db --instance=quickstart-instance

Esegui il deployment dell'app di esempio in Cloud Run

Configura un account di servizio Cloud Run

Configura l'account di servizio utilizzato da Cloud Run in modo che disponga del ruolo Client Cloud SQL con le autorizzazioni per connettersi a Cloud SQL.

Console

1. Nella console Google Cloud, vai alla pagina IAM.

   Vai a IAM

2. Per l'account di servizio denominato Account di servizio predefinito Compute Engine, fai clic sull'icona a forma di matita.
3. Fai clic su AGGIUNGI UN ALTRO RUOLO.
4. Aggiungi il ruolo denominato Client Cloud SQL.
5. Fai clic su Salva.

gcloud

1. Esegui questo comando gcloud per ottenere un elenco di gli account di servizio del progetto:

   gcloud iam service-accounts list

2. Copia EMAIL dell'account di servizio Compute Engine.
3. Esegui questo comando per aggiungere il client Cloud SQL il ruolo nell'account di servizio Compute Engine:

   gcloud projects add-iam-policy-binding YOUR_PROJECT_ID \
     --member="serviceAccount:SERVICE_ACCOUNT_EMAIL" \
     --role="roles/cloudsql.client"

Configura un'app di esempio Cloud SQL

Con un'istanza, un database e un account di servizio Cloud SQL con client autorizzazioni, puoi configurare un'applicazione di esempio per connetterti di Cloud SQL.

IP pubblico

Cloud Run non supporta la connessione a Cloud SQL per SQL Server tramite IP pubblico. Utilizza invece l'IP privato.

IP privato

Per i percorsi IP privati, l'applicazione si connette direttamente all'istanza tramite l'accesso VPC serverless. Questo metodo utilizza una socket TCP per connettersi direttamente all'istanza Cloud SQL senza utilizzare il proxy di autenticazione Cloud SQL.

Vai

Crea e scarica il certificato del server SSL

1. Nella console Google Cloud, vai alla pagina Istanze Cloud SQL.

   Vai a Istanze Cloud SQL

2. Fai clic su quickstart-instance per visualizzare la pagina Panoramica.
3. Fai clic sulla scheda Connessioni.
4. Nella sezione Sicurezza, fai clic su Scarica certificati per scaricare il certificato del server SSL.

Crea una connessione VPC serverless per le connessioni all'istanza utilizzando l'IP privato

1. Nella console Google Cloud, vai alla pagina Accesso VPC serverless - Crea connettore.

   Crea un connettore VPC serverless

2. Inserisci quickstart-connector in Nome.
3. Seleziona predefinita dal menu a discesa Rete.
4. Seleziona Intervallo IP personalizzato dal menu a discesa Subnet.
5. Inserisci 10.8.0.0 nella casella di immissione Intervallo IP.
6. Fai clic su Crea.

Crea un'app di esempio con il certificato server SSL

1. Nell'editor di Cloud Shell, apri il codice sorgente dell'app di esempio.

   Apri l'editor di Cloud Shell
2. Nella finestra di dialogo Apri in Cloud Shell, fai clic su Conferma per scaricare il codice dell'app di esempio e aprire la directory dell'app di esempio nell'editor di Cloud Shell.
3. Carica il file del certificato del server SSL nella cartella certs.
   1. Fai clic con il tasto destro del mouse sulla cartella certs nell'editor di Cloud Shell e seleziona Carica file.
   2. Seleziona il seguente file sulla tua macchina locale: server-ca.pem.
   3. Con il file del certificato del server SSL selezionato, fai clic su Apri per completare il processo di caricamento del file nell'editor di Cloud Shell.
4. Esegui il seguente comando in Cloud Shell per creare un container Docker e pubblicarlo in Container Registry. Sostituisci YOUR_PROJECT_ID con l'ID progetto del tuo progetto.

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

Java

Crea e scarica il certificato del server SSL

Per gli utenti Java, il connettore fornisce già una connessione sicura in modo che la creazione e il download del certificato del server SSL non siano necessari.

Crea una connessione VPC serverless per le connessioni all'istanza mediante IP privato

1. Nella console Google Cloud, vai alla pagina Accesso VPC serverless - Crea connettore.

   Crea un connettore VPC serverless

2. Inserisci quickstart-connector in Nome.
3. Seleziona predefinita dal menu a discesa Rete.
4. Seleziona Intervallo IP personalizzato dal menu a discesa Subnet.
5. Inserisci 10.8.0.0 nella casella di immissione Intervallo IP.
6. Fai clic su Crea.

Creare un'app di esempio

1. Nell'editor di Cloud Shell, apri il codice sorgente dell'app di esempio.

   Apri l'editor di Cloud Shell
2. Nella finestra di dialogo Apri in Cloud Shell, fai clic su Conferma per scaricare il codice dell'app di esempio e aprire la directory dell'app di esempio nell'editor di Cloud Shell.
3. Esegui questo comando in Cloud Shell per creare un container Docker e pubblicarlo in Container Registry. Sostituisci YOUR_PROJECT_ID con l'ID progetto del tuo progetto.

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

Python

Crea e scarica il certificato del server SSL

1. Nella console Google Cloud, vai alla pagina Istanze Cloud SQL.

   Vai a Istanze Cloud SQL

2. Fai clic su quickstart-instance per visualizzare la pagina Panoramica.
3. Fai clic sulla scheda Connessioni.
4. Nella sezione Sicurezza, fai clic su Scarica certificati per scaricare il certificato del server SSL.

Crea una connessione VPC serverless per le connessioni all'istanza mediante IP privato

1. Nella console Google Cloud, vai alla pagina Accesso VPC serverless - Crea connettore.

   Crea un connettore VPC serverless

2. Inserisci quickstart-connector in Nome.
3. Seleziona predefinita dal menu a discesa Rete.
4. Seleziona Intervallo IP personalizzato dal menu a discesa Subnet.
5. Inserisci 10.8.0.0 nella casella di immissione Intervallo IP.
6. Fai clic su Crea.

Crea un'app di esempio con il certificato server SSL

1. Nell'editor di Cloud Shell, apri il codice sorgente dell'app di esempio.

   Apri l'editor di Cloud Shell
2. Nella finestra di dialogo Apri in Cloud Shell, fai clic su Conferma per scaricare il codice dell'app di esempio e aprire la directory dell'app di esempio nell'editor di Cloud Shell.
3. Carica il file del certificato del server SSL nella cartella certs.
   1. Fai clic con il tasto destro del mouse sulla cartella certs nell'editor di Cloud Shell e seleziona Carica file
   2. Seleziona il seguente file sulla tua macchina locale: server-ca.pem.
   3. Con il file del certificato del server SSL selezionato, fai clic su Apri per completare la procedura di caricamento del file nell'editor Cloud Shell.
4. Esegui il seguente comando in Cloud Shell per creare un container Docker e pubblicarlo in Container Registry. Sostituisci YOUR_PROJECT_ID con l'ID progetto del tuo progetto.

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

Esegui il deployment dell'app di esempio

I passaggi per eseguire il deployment dell'esempio in Cloud Run dipendono dal tipo di indirizzo IP assegnato all'istanza Cloud SQL.

IP pubblico

Cloud Run non supporta la connessione a Cloud SQL per SQL Server tramite IP pubblico. Utilizza invece l'IP privato.

IP privato

Console

1. Nella console Google Cloud, vai alla pagina Cloud Run.

   Vai a Cloud Run

2. Fai clic su Crea container e seleziona Servizio per visualizzare il Modulo Crea servizio.

3. Mantieni l'opzione di deployment da un'immagine container esistente e fai clic su Seleziona per specificare l'immagine container gcr.io/YOUR_PROJECT_ID/run-sql che hai creato nel passaggio precedente.
4. Inserisci quickstart-service in Nome servizio.
5. Nella sezione Autenticazione, seleziona l'opzione Allow unauthenticated invocations. Se non disponi delle autorizzazioni (ruolo Amministratore Cloud Run) per selezionare questa opzione, il servizio verrà dispiegato e richiederà l'autenticazione.
6. Espandi Container, variabili e Secret, connessioni, sicurezza .
7. Crea le seguenti variabili di ambiente facendo clic su Aggiungi variabile in Variabili di ambiente. Imposta i valori per le variabili di ambiente come segue:
• DB_NAME: impostato su quickstart-db.
• DB_USER: impostata su sqlserver.
• DB_PASS: imposta la password dell'utente sqlserver che hai creato in Creare un'istanza Cloud SQL.
• INSTANCE_CONNECTION_NAME: impostato sul Nome connessione dell'istanza visualizzato nella pagina Istanze Cloud SQL della console Google Cloud.
• DB_PORT: impostata su 1433.
Nota: per gli utenti Java, il connettore già fornisce una connessione sicura, per cui INSTANCE_HOST, Le variabili di ambiente DB_ROOT_CERT e PRIVATE_IP non devono essere impostate.
• INSTANCE_HOST: impostato sull'indirizzo IP privato dell'istanza, come indicato nella pagina Panoramica dell'istanza Cloud SQL.
• DB_ROOT_CERT: impostata su certs/server-ca.pem.
• PRIVATE_IP: impostato su TRUE.

8. Attiva la connessione a Cloud SQL:

   1. Fai clic su Connessioni.
   2. Fai clic su Aggiungi connessione nella sezione Connessioni Cloud SQL.
   3. Seleziona l'istanza Cloud SQL quickstart-instance creata in precedenza.
   4. Seleziona default: Serverless VPC Access Connector "quickstart-connector" dal menu a discesa Rete VPC.
   5. Seleziona l'opzione Instrada tutto il traffico attraverso il connettore VPC.

9. Fai clic su Crea per completare la creazione del servizio Cloud Run.

10. Dopo il deployment del servizio Cloud Run, la pagina Dettagli del servizio mostra l'URL del servizio in esecuzione nella parte superiore della pagina. Fai clic sul link URL per visualizzare l'app di esempio di cui è stato eseguito il deployment in Cloud Run connessa a in Cloud SQL.

    

gcloud

1. Prima di eseguire il comando seguente, effettua le seguenti sostituzioni:

• YOUR_PROJECT_ID con il tuo ID progetto.

• INSTANCE_CONNECTION_NAME con il nome connessione della tua istanza visualizzato nella pagina Istanze Cloud SQL della console Google Cloud.

• DB_PASS con la password dell'utente sqlserver che hai creato in Creare un'istanza Cloud SQL.
• INSTANCE_HOST con l'indirizzo IP privato della tua istanza. Vai alla pagina Panoramica dell'istanza Cloud SQL, dove viene visualizzato l'indirizzo IP privato dell'istanza.

Esegui il comando gcloud run deploy come segue per creare il servizio 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"

Gli utenti Java devono eseguire il comando gcloud run deploy senza i flag INSTANCE_HOST, DB_ROOT_CERT e PRIVATE_IP --set-env-vars, come segue, per creare il servizio Cloud Run poiché il connettore Java fornisce già una connessione sicura:

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"

Inserisci la scelta numerica fornita per us-central1 quando ti viene chiesto di specificare una regione.

2. Quando viene visualizzato un messaggio di conferma che indica che il servizio Cloud Run è stato di cui è stato eseguito il deployment, fai clic sul link URL servizio nel messaggio per visualizzare l'app di esempio su Cloud Run collegata a Cloud SQL.

   

Esegui la pulizia

Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questa pagina, segui questi passaggi.

1. Nella console Google Cloud, vai alla pagina Istanze Cloud SQL.

   Vai a Istanze Cloud SQL

2. Seleziona l'istanza quickstart-instance per aprire la pagina Dettagli istanza.
3. Nella barra delle icone nella parte superiore della pagina, fai clic su Elimina.
4. Nella finestra di dialogo Elimina istanza, digita quickstart-instance e poi fai clic su Elimina per eliminare l'istanza.

5. Nella console Google Cloud, vai alla pagina Cloud Run.

   Vai a Cloud Run

6. Seleziona la casella di controllo accanto al nome del servizio quickstart-service.
7. Fai clic su Elimina nella parte superiore della pagina Cloud Run.

Passaggi facoltativi di pulizia

Se non utilizzi il ruolo Client Cloud SQL che hai assegnato all'account di servizio Compute Engine, puoi rimuoverlo.

1. Nella console Google Cloud, vai alla pagina IAM.

   Vai a IAM

2. Fai clic sull'icona di modifica (a forma di matita) per l'account IAM denominato Account di servizio predefinito Compute Engine.
3. Elimina il ruolo Client Cloud SQL.
4. Fai clic su Salva.

Se non utilizzi le API attivate nell'ambito di questa guida rapida, puoi disattivarle.

• API abilitate in questa guida rapida:
  • API Compute Engine
  • API Cloud SQL Admin
  • API Cloud Run
  • API Container Registry
  • API Cloud Build

1. Nella console Google Cloud, vai alla pagina API.

   Vai alle API

2. Seleziona l'API che vuoi disabilitare e fai clic sul pulsante Disabilita API.

Passaggi successivi

In base alle tue esigenze, puoi scoprire di più sulla creazione di istanze Cloud SQL.

Scopri inoltre come creare utenti SQL Server e database per la tua istanza Cloud SQL.

Per ulteriori informazioni sui prezzi, consulta Prezzi di Cloud SQL per SQL Server.

Scopri di più su:

• Configurare l'istanza Cloud SQL con un indirizzo IP pubblico.
• Configura l'istanza Cloud SQL con un indirizzo IP privato.

Inoltre, puoi scoprire come connetterti a un'istanza Cloud SQL da altre applicazioni Google Cloud:

• Da un'applicazione in esecuzione nell'ambiente standard di App Engine
• Da un'applicazione in esecuzione su Compute Engine
• Da un'applicazione in esecuzione su GKE
• Dalle funzioni di Cloud Run
• Da Cloud Run