Connettersi a Cloud SQL per SQL Server da funzioni di Cloud Run

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 privata ai servizi.
4. Seleziona la scheda Intervalli IP allocati per i servizi.
5. Fai clic su Alloca intervallo IP.
6. Come 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 Assegna 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. In Allocazione assegnata, seleziona google-managed-services-default.
12. Fai clic su Connetti per creare la connessione.

Crea un'istanza con indirizzo IP privato e SSL abilitato

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 sqlserver. Salva questa password per 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 e attenderemo 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 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 gcloud services vpc-peerings connect. per creare una connessione privata all'intervallo di indirizzi IP allocato. 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.

Facoltativamente, 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 le versioni del database gcloud documentazione per conoscere le versioni attualmente disponibili.
• --cpu: il numero di core nella macchina.
• --memory: un numero intero che indica come da includere nella macchina. Un'unità di misura può essere forniti (ad esempio, 3072 MB o 9 GB). Se non viene specificata alcuna unità, si presume GB.
• --region: la località regionale dell'istanza (ad es. asia-east1, us-east1). Se non specificato, il valore predefinito È in uso 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

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 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 nel campo 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 scarica il codice dell'app di esempio e apri la directory dell'app di esempio nell'editor di Cloud Shell.
3. Nel prompt dei comandi di Cloud Shell, nella metà inferiore dello schermo sotto l'editor di Cloud Shell, esegui questo comando per attivare del progetto. Sostituisci YOUR_PROJECT_ID con l'ID progetto.

   gcloud config set project YOUR_PROJECT_ID
   

4. Se viene visualizzata la finestra di dialogo Autorizza Cloud Shell, fai clic su Autorizza.
5. 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.
6. Esegui questo comando gcloud artifacts repositories create in Cloud Shell per creare un repository in Artifact Registry denominato quickstart-repo della tua istanza Cloud SQL. Sostituisci YOUR_PROJECT_ID con l'ID progetto e YOUR_REGION_NAME con il nome della tua regione.

   gcloud artifacts repositories create quickstart-repo \
     --project=YOUR_PROJECT_ID \
     --repository-format=docker \
     --location=YOUR_REGION_NAME \
     --description="Cloud Function Quickstart Cloud SQL sample app"
   

7. Esegui gcloud builds submit. come segue in Cloud Shell per creare un container Docker e pubblicarlo in Artifact Registry. Sostituisci YOUR_PROJECT_ID con l'ID progetto e YOUR_REGION_NAME con il nome della tua regione.

   gcloud builds submit \
     --tag YOUR_REGION_NAME-docker.pkg.dev/YOUR_PROJECT_ID/quickstart-repo/function-sql .
   

8. In gen2 delle funzioni di Cloud Run, la configurazione e l'esecuzione automatica del proxy di autenticazione Cloud SQL non sono supportate. Questa funzionalità è supportata tramite Cloud Run. Devi rivedere manualmente il servizio Cloud Run sottostante per configurare ed eseguire il proxy di autenticazione Cloud SQL con il servizio utilizzando il flag --add-cloudsql-instances. Sostituisci INSTANCE_CONNECTION_NAME con il nome della connessione dell'istanza.

   gcloud run deploy quickstart-function --source . \
     --region YOUR_REGION_NAME \
     --add-cloudsql-instances INSTANCE_CONNECTION_NAME
   

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 nel campo 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 scarica il codice dell'app di esempio e apri la directory dell'app di esempio nell'editor di Cloud Shell.
3. Nel prompt dei comandi di Cloud Shell, nella metà inferiore dello schermo sotto l'editor di Cloud Shell, esegui questo comando per attivare del progetto. Sostituisci YOUR_PROJECT_ID con l'ID progetto.

   gcloud config set project YOUR_PROJECT_ID
   

4. 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.
5. Esegui questo comando gcloud artifacts repositories create in Cloud Shell per creare un repository in Artifact Registry denominato quickstart-repo della tua istanza Cloud SQL. Sostituisci YOUR_PROJECT_ID con l'ID progetto e YOUR_REGION_NAME con il nome della tua regione.

   gcloud artifacts repositories create quickstart-repo \
     --project=YOUR_PROJECT_ID \
     --repository-format=docker \
     --location=YOUR_REGION_NAME \
     --description="Cloud Function Quickstart Cloud SQL sample app"
   

6. Esegui gcloud builds submit. come segue in Cloud Shell per creare un container Docker e pubblicarlo in Artifact Registry. Sostituisci YOUR_PROJECT_ID con l'ID progetto e YOUR_REGION_NAME con il nome della tua regione.

   gcloud builds submit \
     --tag YOUR_REGION_NAME-docker.pkg.dev/YOUR_PROJECT_ID/quickstart-repo/function-sql .
   

7. In gen2 delle funzioni di Cloud Run, la configurazione e l'esecuzione automatica del proxy di autenticazione Cloud SQL non sono supportate. Questa funzionalità è supportata tramite Cloud Run. Devi rivedere manualmente il servizio Cloud Run sottostante per configurare ed eseguire il proxy di autenticazione Cloud SQL con il servizio utilizzando il flag --add-cloudsql-instances. Sostituisci INSTANCE_CONNECTION_NAME con il nome della connessione dell'istanza.

   gcloud run deploy quickstart-function --source . \
     --region YOUR_REGION_NAME \
     --add-cloudsql-instances INSTANCE_CONNECTION_NAME
   

Console

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

   Vai alle funzioni Cloud Run

2. Seleziona il quickstart-function che hai creato in un passaggio precedente di questa guida rapida.
3. Nella pagina Dettagli funzione, fai clic sul link nel riquadro Basato su Cloud Run per accedere al servizio Functions di Cloud Run sottostante.
4. Fai clic su Modifica e il deployment di una nuova revisione.
5. Nel campo Container image URL, fai clic su Seleziona.
1. Seleziona la scheda Artifact Registry ed espandi il nodo quickstart-repo.
2. Espandi il contenitore function-sql e seleziona il contenitore. che hai creato nel passaggio precedente.
3. Fai clic su Seleziona.
6. Crea le seguenti variabili di ambiente facendo clic su Aggiungi la variabile nella sezione Variabili di ambiente:
• DB_NAME: impostata 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.
• INSTANCE_HOST: imposta l'IP privato dell'istanza visualizzato nelle istanze Cloud SQL nella console Google Cloud.
• DB_ROOT_CERT: impostata su certs/server-ca.pem.
• PRIVATE_IP: impostata su TRUE.

7. Abilita la connessione a Cloud SQL:

   1. Nella sezione Connessioni Cloud SQL, fai clic su Aggiungi connessione.
   2. Seleziona il nome della connessione dell'istanza.
   3. Seleziona default: Serverless VPC Access Connector "quickstart-connector" dal menu a discesa Rete VPC.
   4. Seleziona l'opzione Instrada tutto il traffico tramite il connettore VPC.
8. Nella parte inferiore della pagina, fai clic su Esegui il deployment.
9. Una volta eseguito il deployment della funzione quickstart-function, accedi alla pagina Dettagli servizio. e visualizza un URL al servizio in esecuzione. Fai clic sul link URL per vedere l'app di esempio delle funzioni Cloud Run di cui è stato eseguito il deployment connessa a Cloud SQL. L'app dovrebbe essere simile alla seguente:

   

gcloud