Connettersi a Cloud SQL per MySQL da Cloud Functions

MySQL | PostgreSQL | SQL Server

Scopri come eseguire il deployment di un'app di esempio su Cloud Functions connessa a un'istanza MySQL utilizzando la console Google Cloud e un'applicazione client.

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

Prima di iniziare

Accedi al tuo account Google Cloud. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.

Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.

Vai al selettore progetti

Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.

Vai al selettore progetti

Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

Abilita le API Cloud necessarie per eseguire un'app Cloud SQL di esempio su Cloud Functions.
Console

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

Abilita le API

Ciò consente le seguenti API:
- API Cloud Functions
- API Cloud SQL Admin
- API Cloud Run Admin
- API Cloud Build
- API Artifact Registry
- API Eventarc
- API Compute Engine
- API Service Networking
- API Cloud Logging
gcloud

Fai clic sul pulsante seguente per aprire Cloud Shell, che fornisce l'accesso tramite 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 questo comando gcloud utilizzando Cloud Shell:
```
gcloud services enable cloudfunctions.googleapis.com sqladmin.googleapis.com run.googleapis.com cloudbuild.googleapis.com artifactregistry.googleapis.com eventarc.googleapis.com compute.googleapis.com servicenetworking.googleapis.com pubsub.googleapis.com logging.googleapis.com
```
Questo comando abilita le API seguenti:
- API Cloud Functions
- API Cloud SQL Admin
- API Cloud Run
- API Cloud Build
- API Artifact Registry
- API Eventarc
- API Compute Engine
- API Service Networking
- API Cloud Logging
Aggiungi il ruolo IAM Invoker di Cloud Functions all'utente.

Aggiungere il ruolo

Configura Cloud SQL

crea un'istanza Cloud SQL

IP pubblico

Console

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

Vai a Istanze Cloud SQL
Fai clic su Crea istanza.
Fai clic su Scegli MySQL.
Nel campo ID istanza, inserisci quickstart-instance.
Nel campo Password, inserisci una password per l'utente root. Salva questa password per usarla in futuro.
Nella sezione Scegli la disponibilità a livello di regione e zona, seleziona Zona singola.
Fai clic sul menu Mostra opzioni di configurazione.
Nell'elenco a discesa Tipo di macchina, seleziona Leggera.
Fai clic su Crea istanza, quindi attendi che l'istanza venga inizializzata e avviata.

gcloud

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 non specificato, viene utilizzato il valore predefinito dell'API. Consulta la documentazione relativa alle versioni di database gcloud per vedere le versioni attuali disponibili.
--cpu: il numero di core desiderati nella macchina.
--memory: valore di un numero intero che indica la quantità di memoria desiderata per la macchina. È necessario fornire un'unità di dimensione (ad esempio, 3072 MB o 9 GB). Se non vengono specificate unità, vengono utilizzati i GB.
--region: località regionale dell'istanza (ad esempio asia-east1, us-east1). Se non specificato, viene utilizzato il valore predefinito us-central.

Esegui il comando gcloud sql instances create per creare un'istanza Cloud SQL.

 gcloud sql instances create quickstart-instance \
--database-version=MYSQL_8_0 \
--cpu=1 \
--memory=4GB \
--region=us-central1 \
--root-password=DB_ROOT_PASSWORD

IP privato

Console

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

Nella console Google Cloud, vai alla pagina Reti VPC.

Vai a Reti VPC
Seleziona la rete VPC default.
Seleziona la scheda Connessione a servizio privato.
Seleziona la scheda Intervalli IP allocati per i servizi.
Fai clic su Assegna intervallo IP.
Per Nome dell'intervallo allocato, specifica google-managed-services-default.
Seleziona l'opzione Automatico per l'intervallo IP e specifica la lunghezza del prefisso come 16.
Fai clic su Assegna per creare l'intervallo allocato.
Seleziona la scheda Connessioni private ai servizi per la rete VPC default.
Fai clic su Crea connessione per creare una connessione privata tra la tua rete e un producer di servizi.
Per Allocazione assegnata, seleziona google-managed-services-default.
Fai clic su Connetti per creare la connessione.

Crea un'istanza con indirizzo IP privato e SSL abilitati

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

Vai a Istanze Cloud SQL
Fai clic su Crea istanza.
Fai clic su MySQL.
Inserisci quickstart-instance in ID istanza.
Inserisci una password per l'utente root. Salva questa password per uso futuro.
Fai clic sull'opzione Zona singola per Scegli la disponibilità per regione e zona.
Fai clic ed espandi Mostra opzioni di configurazione.
Per Tipo di macchina, seleziona Leggera.
In Connessioni, seleziona IP privato.
Seleziona predefinita nel menu a discesa Rete.
Deseleziona la casella di controllo IP pubblico per creare un'istanza solo con un IP privato.
Fai clic su Crea istanza, quindi attendi l'inizializzazione e l'avvio dell'istanza.
Fai clic su Connessioni.
Nella sezione Sicurezza, seleziona Consenti solo connessioni SSL per attivare le connessioni SSL.
Nella finestra di dialogo Abilita SSL, fai clic su Abilita 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

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

Esegui il comando gcloud services vpc-peerings connect per creare una connessione privata all'intervallo di indirizzi IP allocato. Sostituisci YOUR_PROJECT_ID con l'ID del 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 abilitati

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 non specificato, viene utilizzato il valore predefinito dell'API. Consulta la documentazione relativa alle versioni di database gcloud per vedere le versioni attuali disponibili.
--cpu: il numero di core nella macchina.
--memory: un valore numerico intero che indica la quantità di memoria da includere nella macchina. È possibile fornire un'unità di dimensione (ad esempio, 3072 MB o 9 GB). Se non vengono specificate unità, vengono utilizzati i GB.
--region: la località 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=MYSQL_8_0 \
--cpu=1 \
--memory=4GB \
--region=us-central1 \
--root-password=DB_ROOT_PASSWORD \
--no-assign-ip \
--network=default

Esegui il comando 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

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

Vai a Istanze Cloud SQL
Seleziona quickstart-instance.
Dal menu di navigazione SQL, seleziona Database.
Fai clic su Crea database.

Nel campo Nome database della finestra di dialogo Crea un database, inserisci quickstart-db. Lascia i valori per il set di caratteri e le regole di confronto.
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

Crea un utente

Console

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

Vai a Istanze Cloud SQL
Per aprire la pagina Panoramica di un'istanza, fai clic sul nome dell'istanza.
Dal menu di navigazione SQL, seleziona Utenti.
Fai clic su Aggiungi account utente.

Nella pagina Aggiungi un account utente per quickstart-instance, aggiungi le seguenti informazioni:
- Nel campo Nome utente, inserisci quickstart-user.
- Nel campo Password, specifica una password per l'utente del database. Annotalo per utilizzarlo in un passaggio successivo di questa guida rapida.

Fai clic su Aggiungi.

gcloud

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

DB_PASS con una password per l'utente del database. Annotalo per utilizzarlo in un passaggio successivo di questa guida rapida.

Esegui il comando gcloud sql users create per creare l'utente.

gcloud sql users create quickstart-user \
--instance=quickstart-instance \
--password=DB_PASS

I limiti di lunghezza dei nomi utente sono gli stessi per Cloud SQL e per MySQL on-premise: 32 caratteri per MySQL 8.0, 16 caratteri per le versioni precedenti.

Configura un account di servizio Cloud Functions

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

Console

Nella console Google Cloud, vai alla pagina IAM.

Vai a IAM
Per l'account di servizio denominato Account di servizio predefinito di Compute Engine, fai clic sull'icona a forma di matita.

Fai clic su AGGIUNGI UN ALTRO RUOLO.
Aggiungi il Ruolo denominato Client Cloud SQL.
Fai clic su Salva.

gcloud

Esegui questo comando gcloud per ottenere un elenco degli account di servizio del progetto:
```
gcloud iam service-accounts list
```
Copia l'EMAIL dell'account di servizio Compute Engine.

Esegui questo comando per aggiungere il ruolo Client Cloud SQL all'account di servizio Compute Engine:

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

crea una funzione

Nella console Google Cloud, vai alla pagina Cloud Functions.

Vai a Cloud Functions
Fai clic su Crea funzione.
Per Ambiente, seleziona 2a generazione.
Nel campo Nome funzione, inserisci quickstart-function.
Nella regione Autenticazione, seleziona Consenti chiamate non autenticate.
Tocca Avanti.
Dal menu Runtime, seleziona una delle seguenti lingue:

linguaggio	Numero di versione
Go	1,20
Java	17
Node.js	18
Python	3.10

Nel menu Codice sorgente, verifica che sia selezionato l'Editor incorporato. In questo passaggio, utilizzerai la funzione predefinita fornita nell'editor.

Esegui il deployment della funzione

Nella parte inferiore della pagina Cloud Functions, fai clic su Esegui il deployment. La console Google Cloud ti reindirizza alla pagina dei dettagli della funzione.
Una volta completato il deployment della funzione, fai clic sul link URL per visualizzare un browser web su cui è visualizzato il messaggio Hello, World!.

Esegui il deployment dell'app Cloud SQL di esempio come funzione

Puoi configurare ed eseguire il deployment dell'app di esempio Cloud SQL come funzione in Cloud Functions. Prima utilizza Cloud Shell per configurare e creare l'app di esempio, quindi utilizzerai Cloud Functions per eseguire il deployment dell'app di esempio.

Esistono due modi per configurare, creare ed eseguire il deployment dell'app, a seconda che tu abbia creato un'istanza Cloud SQL per MySQL con IP pubblico o IP privato.

Configura un'app di esempio Cloud SQL

IP pubblico

Per i percorsi IP pubblici, Cloud Functions fornisce la crittografia e si connette tramite il proxy di autenticazione Cloud SQL tramite socket Unix.

Go

Nell'editor di Cloud Shell, apri il codice sorgente dell'app di esempio.
Apri l'editor di Cloud Shell
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.
Nel prompt dei comandi di Cloud Shell, nella metà inferiore dello schermo sotto l'editor di Cloud Shell, esegui questo comando per attivare il progetto. Sostituisci YOUR_PROJECT_ID con l'ID progetto.
```
gcloud config set project YOUR_PROJECT_ID
```
Se viene visualizzata la finestra di dialogo Autorizza Cloud Shell, fai clic su Autorizza.
Esegui il comando gcloud artifacts repositories create seguente in Cloud Shell per creare in Artifact Registry un repository denominato quickstart-repo nella stessa regione 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"
```
Esegui il comando gcloud builds submit come segue in Cloud Shell per creare un container Docker e pubblicarlo su 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 .
```
In gen2 di Cloud Functions, la configurazione e l'esecuzione automatica del proxy di autenticazione Cloud SQL non sono supportate. Questa funzionalità è supportata dall'uso di 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 di connessione dell'istanza.
```
gcloud run deploy quickstart-function --source . \
  --region YOUR_REGION_NAME \
  --add-cloudsql-instances INSTANCE_CONNECTION_NAME
```

Java

Nell'editor di Cloud Shell, apri il codice sorgente dell'app di esempio.
Apri l'editor di Cloud Shell
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.
Nel prompt dei comandi di Cloud Shell, nella metà inferiore dello schermo sotto l'editor di Cloud Shell, esegui questo comando per attivare il progetto. Sostituisci YOUR_PROJECT_ID con l'ID progetto.
```
gcloud config set project YOUR_PROJECT_ID
```
Se viene visualizzata la finestra di dialogo Autorizza Cloud Shell, fai clic su Autorizza.
Esegui il comando gcloud artifacts repositories create seguente in Cloud Shell per creare in Artifact Registry un repository denominato quickstart-repo nella stessa regione 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"
```
Esegui il comando mvn 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.
```
mvn clean package com.google.cloud.tools:jib-maven-plugin:2.8.0:build \
  -Dimage=YOUR_REGION_NAME-docker.pkg.dev/YOUR_PROJECT_ID/quickstart-repo/function-sql \
  -DskipTests -Djib.to.credHelper=gcloud
```
In gen2 di Cloud Functions, la configurazione e l'esecuzione automatica del proxy di autenticazione Cloud SQL non sono supportate. Questa funzionalità è supportata dall'uso di 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 di connessione dell'istanza.
```
gcloud run deploy quickstart-function --source . \
  --region YOUR_REGION_NAME \
  --add-cloudsql-instances INSTANCE_CONNECTION_NAME
```

Node.js

Nell'editor di Cloud Shell, apri il codice sorgente dell'app di esempio.
Apri l'editor di Cloud Shell
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.
Nel prompt dei comandi di Cloud Shell, nella metà inferiore dello schermo sotto l'editor di Cloud Shell, esegui questo comando per attivare il progetto. Sostituisci YOUR_PROJECT_ID con l'ID progetto.
```
gcloud config set project YOUR_PROJECT_ID
```
Se viene visualizzata la finestra di dialogo Autorizza Cloud Shell, fai clic su Autorizza.
Esegui il comando gcloud artifacts repositories create seguente in Cloud Shell per creare in Artifact Registry un repository denominato quickstart-repo nella stessa regione 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"
```
Esegui il comando gcloud builds submit come segue in Cloud Shell per creare un container Docker e pubblicarlo su 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 .
```
In gen2 di Cloud Functions, la configurazione e l'esecuzione automatica del proxy di autenticazione Cloud SQL non sono supportate. Questa funzionalità è supportata dall'uso di 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 di connessione dell'istanza.
```
gcloud run deploy quickstart-function --source . \
  --region YOUR_REGION_NAME \
  --add-cloudsql-instances INSTANCE_CONNECTION_NAME
```

Python

Nell'editor di Cloud Shell, apri il codice sorgente dell'app di esempio.
Apri l'editor di Cloud Shell
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.
Nel prompt dei comandi di Cloud Shell, nella metà inferiore dello schermo sotto l'editor di Cloud Shell, esegui questo comando per attivare il progetto. Sostituisci YOUR_PROJECT_ID con l'ID progetto.
```
gcloud config set project YOUR_PROJECT_ID
```
Se viene visualizzata la finestra di dialogo Autorizza Cloud Shell, fai clic su Autorizza.
Esegui il comando gcloud artifacts repositories create seguente in Cloud Shell per creare in Artifact Registry un repository denominato quickstart-repo nella stessa regione 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"
```
Esegui il comando gcloud builds submit come segue in Cloud Shell per creare un container Docker e pubblicarlo su 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 .
```
In gen2 di Cloud Functions, la configurazione e l'esecuzione automatica del proxy di autenticazione Cloud SQL non sono supportate. Questa funzionalità è supportata dall'uso di 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 di connessione dell'istanza.
```
gcloud run deploy quickstart-function --source . \
  --region YOUR_REGION_NAME \
  --add-cloudsql-instances INSTANCE_CONNECTION_NAME
```

IP privato

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

Go

Creare e scaricare certificati client e server SSL

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

Vai a Istanze Cloud SQL
Fai clic su quickstart-instance per visualizzare la pagina Panoramica
Fai clic sulla scheda Connessioni.
Nella sezione Sicurezza, fai clic su Crea certificato client.
Nella finestra di dialogo Crea un certificato client, inserisci quickstart-key come nome e fai clic su Crea.
Nella finestra di dialogo Nuovo certificato SSL creato, fai clic su ogni link di download per scaricare i certificati. Poi, fai clic su Chiudi.

Importante: archivia questa chiave privata in modo sicuro. Se lo perdi, devi creare un nuovo certificato client.

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

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

Crea connettore VPC serverless
Inserisci quickstart-connector come Nome.
Seleziona predefinita dal menu a discesa Rete
Seleziona Intervallo IP personalizzato dal menu a discesa Subnet.
Inserisci 10.8.0.0 nella casella di immissione Intervallo IP.
Fai clic su Crea per creare il connettore.

Crea un'app di esempio con certificati SSL

Nell'editor di Cloud Shell, apri il codice sorgente dell'app di esempio.
Apri l'editor di Cloud Shell
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.
Nel prompt dei comandi di Cloud Shell, nella metà inferiore dello schermo sotto l'editor di Cloud Shell, esegui questo comando per attivare il progetto. Sostituisci YOUR_PROJECT_ID con l'ID progetto.
```
gcloud config set project YOUR_PROJECT_ID
```
Se viene visualizzata la finestra di dialogo Autorizza Cloud Shell, fai clic su Autorizza.
Carica i file dei certificati SSL nella cartella certs.
1. Fai clic con il pulsante destro del mouse sulla cartella certs nell'editor di Cloud Shell e seleziona Carica file.
2. Seleziona i seguenti file sulla tua macchina locale:
3. Con i tre file di certificati SSL selezionati, fai clic su Apri per completare il processo di caricamento dei file nell'editor di Cloud Shell.
Esegui il comando gcloud artifacts repositories create seguente in Cloud Shell per creare in Artifact Registry un repository denominato quickstart-repo nella stessa regione 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"
```
Esegui il comando gcloud builds submit come segue in Cloud Shell per creare un container Docker e pubblicarlo su 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 .
```
In gen2 di Cloud Functions, la configurazione e l'esecuzione automatica del proxy di autenticazione Cloud SQL non sono supportate. Questa funzionalità è supportata dall'uso di 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 di connessione dell'istanza.
```
gcloud run deploy quickstart-function --source . \
  --region YOUR_REGION_NAME \
  --add-cloudsql-instances INSTANCE_CONNECTION_NAME
```

Java

Creare e scaricare certificati client e server SSL

Per gli utenti Java, il connettore fornisce già una connessione protetta in modo che la creazione e il download di certificati client e server SSL non siano necessari.

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

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

Crea connettore VPC serverless
Inserisci quickstart-connector come Nome.
Seleziona predefinita dal menu a discesa Rete
Seleziona Intervallo IP personalizzato dal menu a discesa Subnet.
Inserisci 10.8.0.0 nella casella di immissione Intervallo IP.
Fai clic su Crea per creare il connettore.

Crea app di esempio

Nell'editor di Cloud Shell, apri il codice sorgente dell'app di esempio.
Apri l'editor di Cloud Shell
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.
Nel prompt dei comandi di Cloud Shell, nella metà inferiore dello schermo sotto l'editor di Cloud Shell, esegui questo comando per attivare il progetto. Sostituisci YOUR_PROJECT_ID con l'ID progetto.
```
gcloud config set project YOUR_PROJECT_ID
```
Se viene visualizzata la finestra di dialogo Autorizza Cloud Shell, fai clic su Autorizza.
Esegui il comando gcloud artifacts repositories create seguente in Cloud Shell per creare in Artifact Registry un repository denominato quickstart-repo nella stessa regione 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"
```
Esegui il comando mvn 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.
```
mvn clean package com.google.cloud.tools:jib-maven-plugin:2.8.0:build \
  -Dimage=YOUR_REGION_NAME-docker.pkg.dev/YOUR_PROJECT_ID/quickstart-repo/function-sql \
  -DskipTests -Djib.to.credHelper=gcloud
```
In gen2 di Cloud Functions, la configurazione e l'esecuzione automatica del proxy di autenticazione Cloud SQL non sono supportate. Questa funzionalità è supportata dall'uso di 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 di connessione dell'istanza.
```
gcloud run deploy quickstart-function --source . \
  --region YOUR_REGION_NAME \
  --add-cloudsql-instances INSTANCE_CONNECTION_NAME
```

Node.js

Creare e scaricare certificati client e server SSL

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

Vai a Istanze Cloud SQL
Fai clic su quickstart-instance per visualizzare la pagina Panoramica
Fai clic sulla scheda Connessioni.
Nella sezione Sicurezza, fai clic su Crea certificato client.
Nella finestra di dialogo Crea un certificato client, inserisci quickstart-key come nome e fai clic su Crea.
Nella finestra di dialogo Nuovo certificato SSL creato, fai clic su ogni link di download per scaricare i certificati. Poi, fai clic su Chiudi.

Importante: archivia questa chiave privata in modo sicuro. Se lo perdi, devi creare un nuovo certificato client.

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

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

Crea connettore VPC serverless
Inserisci quickstart-connector come Nome.
Seleziona predefinita dal menu a discesa Rete
Seleziona Intervallo IP personalizzato dal menu a discesa Subnet.
Inserisci 10.8.0.0 nella casella di immissione Intervallo IP.
Fai clic su Crea per creare il connettore.

Crea app di esempio con certificati SSL

Nell'editor di Cloud Shell, apri il codice sorgente dell'app di esempio.
Apri l'editor di Cloud Shell
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.
Nel prompt dei comandi di Cloud Shell, nella metà inferiore dello schermo sotto l'editor di Cloud Shell, esegui questo comando per attivare il progetto. Sostituisci YOUR_PROJECT_ID con l'ID progetto.
```
gcloud config set project YOUR_PROJECT_ID
```
Carica i file dei certificati 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 i seguenti file sulla tua macchina locale:
3. Con i tre file di certificati SSL selezionati, fai clic su Apri per completare il processo di caricamento dei file nell'editor di Cloud Shell.
Esegui il comando gcloud artifacts repositories create seguente in Cloud Shell per creare in Artifact Registry un repository denominato quickstart-repo nella stessa regione 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"
```
Esegui il comando gcloud builds submit come segue in Cloud Shell per creare un container Docker e pubblicarlo su 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 .
```
In gen2 di Cloud Functions, la configurazione e l'esecuzione automatica del proxy di autenticazione Cloud SQL non sono supportate. Questa funzionalità è supportata dall'uso di 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 di connessione dell'istanza.
```
gcloud run deploy quickstart-function --source . \
  --region YOUR_REGION_NAME \
  --add-cloudsql-instances INSTANCE_CONNECTION_NAME
```

Python

Creare e scaricare certificati client e server SSL

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

Vai a Istanze Cloud SQL
Fai clic su quickstart-instance per visualizzare la pagina Panoramica
Fai clic sulla scheda Connessioni.
Nella sezione Sicurezza, fai clic su Crea certificato client.
Nella finestra di dialogo Crea un certificato client, inserisci quickstart-key come nome e fai clic su Crea.
Nella finestra di dialogo Nuovo certificato SSL creato, fai clic su ogni link di download per scaricare i certificati. Poi, fai clic su Chiudi.

Importante: archivia questa chiave privata in modo sicuro. Se lo perdi, devi creare un nuovo certificato client.

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

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

Crea connettore VPC serverless
Inserisci quickstart-connector come Nome.
Seleziona predefinita dal menu a discesa Rete
Seleziona Intervallo IP personalizzato dal menu a discesa Subnet.
Inserisci 10.8.0.0 nella casella di immissione Intervallo IP.
Fai clic su Crea per creare il connettore.

Crea app di esempio con certificati SSL

Nell'editor di Cloud Shell, apri il codice sorgente dell'app di esempio.
Apri l'editor di Cloud Shell
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.
Nel prompt dei comandi di Cloud Shell, nella metà inferiore dello schermo sotto l'editor di Cloud Shell, esegui questo comando per attivare il progetto. Sostituisci YOUR_PROJECT_ID con l'ID progetto.
```
gcloud config set project YOUR_PROJECT_ID
```
Carica i file dei certificati 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 i seguenti file sulla tua macchina locale:
3. Con i tre file di certificati SSL selezionati, fai clic su Apri per completare il processo di caricamento dei file nell'editor di Cloud Shell.
Esegui il comando gcloud artifacts repositories create seguente in Cloud Shell per creare in Artifact Registry un repository denominato quickstart-repo nella stessa regione 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"
```
Esegui il comando gcloud builds submit come segue in Cloud Shell per creare un container Docker e pubblicarlo su 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 .
```
In gen2 di Cloud Functions, la configurazione e l'esecuzione automatica del proxy di autenticazione Cloud SQL non sono supportate. Questa funzionalità è supportata dall'uso di 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 di connessione dell'istanza.
```
gcloud run deploy quickstart-function --source . \
  --region YOUR_REGION_NAME \
  --add-cloudsql-instances INSTANCE_CONNECTION_NAME
```

Esegui il deployment dell'app di esempio

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

IP pubblico

Console

Nella console Google Cloud, vai alla pagina Cloud Functions.

Vai a Cloud Functions
Seleziona la quickstart-function che hai creato in un passaggio precedente di questa guida rapida.
Nella pagina Dettagli funzione, fai clic sul link nel riquadro Basato su Cloud Run per accedere al servizio Cloud Functions sottostante.
Fai clic su Modifica ed esegui il deployment di nuova revisione.
Nel campo URL immagine container, fai clic su Seleziona.

Seleziona la scheda Artifact Registry, quindi espandi il nodo quickstart-repo.
Espandi il container function-sql, quindi seleziona l'immagine container creata nel passaggio precedente.
Fai clic su Seleziona.

Crea le seguenti variabili di ambiente facendo clic su Aggiungi variabile nella sezione Variabili di ambiente:

INSTANCE_UNIX_SOCKET: imposta su /cloudsql/YOUR_PROJECT_ID:YOUR_REGION_NAME:quickstart-instance.
DB_NAME: impostato su quickstart-db.
DB_USER: impostato su quickstart-user.
DB_PASS: imposta la password di quickstart-user specificato nel precedente passaggio Creare un utente della guida rapida.

Abilita la connessione a Cloud SQL:
1. Nella sezione Connessioni Cloud SQL, fai clic su Aggiungi connessione.
2. Seleziona il nome di connessione dell'istanza.
In fondo alla pagina, fai clic su Esegui il deployment.
Dopo il deployment della funzione quickstart-function, nella pagina Dettagli servizio viene visualizzato un URL per il servizio in esecuzione. Fai clic sul link URL per visualizzare l'app Cloud Functions di esempio di cui è stato eseguito il deployment connessa a Cloud SQL. L'app dovrebbe essere simile alla seguente:

gcloud

Go

Per eseguire il deployment di una funzione gen2 in Cloud Functions, esegui il seguente comando gcloud functions deploy. Prima di eseguire il comando, aggiorna le seguenti variabili:

YOUR_REGION_NAME con il nome della tua regione
INSTANCE_CONNECTION_NAME con il Nome connessione dell'istanza visualizzato nella pagina Istanze Cloud SQL nella console Google Cloud
DB_PASS con la password dell'elemento quickstart-user creato nel precedente passaggio della guida rapida Creare un utente

Esegui il comando gcloud functions deploy come segue per creare le funzioni Cloud Functions:

gcloud functions deploy quickstart-function \
--gen2 \
--runtime go120 \
--trigger-http \
--allow-unauthenticated \
--entry-point Votes \
--region YOUR_REGION_NAME \
--set-env-vars INSTANCE_UNIX_SOCKET=/cloudsql/INSTANCE_CONNECTION_NAME \
--set-env-vars DB_USER=quickstart-user \
--set-env-vars DB_PASS=DB_PASS \
--set-env-vars DB_NAME=quickstart-db

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

Java

Per eseguire il deployment di una funzione gen2 in Cloud Functions, esegui il seguente comando gcloud functions deploy. Prima di eseguire il comando, aggiorna le seguenti variabili:

YOUR_REGION_NAME con il nome della tua regione
INSTANCE_CONNECTION_NAME con il Nome connessione dell'istanza visualizzato nella pagina Istanze Cloud SQL nella console Google Cloud
DB_PASS con la password dell'elemento quickstart-user creato nel precedente passaggio della guida rapida Creare un utente

Esegui il comando gcloud functions deploy come segue per creare le funzioni Cloud Functions:

gcloud functions deploy quickstart-function \
--gen2 \
--runtime java11 \
--trigger-http \
--allow-unauthenticated \
--entry-point com.example.cloudsql.functions.Main \
--region YOUR_REGION_NAME \
--set-env-vars INSTANCE_UNIX_SOCKET=/cloudsql/INSTANCE_CONNECTION_NAME \
--set-env-vars DB_USER=quickstart-user \
--set-env-vars DB_PASS=DB_PASS \
--set-env-vars DB_NAME=quickstart-db

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

Node.js

Per eseguire il deployment di una funzione gen2 in Cloud Functions, esegui il seguente comando gcloud functions deploy. Prima di eseguire il comando, aggiorna le seguenti variabili:

YOUR_REGION_NAME con il nome della tua regione
INSTANCE_CONNECTION_NAME con il Nome connessione dell'istanza visualizzato nella pagina Istanze Cloud SQL nella console Google Cloud
DB_PASS con la password dell'elemento quickstart-user creato nel precedente passaggio della guida rapida Creare un utente

Esegui il comando gcloud functions deploy come segue per creare le funzioni Cloud Functions:

gcloud functions deploy quickstart-function \
--gen2 \
--runtime nodejs18 \
--trigger-http \
--allow-unauthenticated \
--entry-point votes \
--region YOUR_REGION_NAME \
--set-env-vars INSTANCE_UNIX_SOCKET=/cloudsql/INSTANCE_CONNECTION_NAME \
--set-env-vars DB_USER=quickstart-user \
--set-env-vars DB_PASS=DB_PASS \
--set-env-vars DB_NAME=quickstart-db

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

Python

Per eseguire il deployment di una funzione gen2 in Cloud Functions, esegui il seguente comando gcloud functions deploy. Prima di eseguire il comando, aggiorna le seguenti variabili:

YOUR_REGION_NAME con il nome della tua regione
INSTANCE_CONNECTION_NAME con il Nome connessione dell'istanza visualizzato nella pagina Istanze Cloud SQL nella console Google Cloud
DB_PASS con la password dell'elemento quickstart-user creato nel precedente passaggio della guida rapida Creare un utente

Esegui il comando gcloud functions deploy come segue per creare le funzioni Cloud Functions:

gcloud functions deploy quickstart-function \
--gen2 \
--runtime python310 \
--trigger-http \
--allow-unauthenticated \
--entry-point votes \
--region YOUR_REGION_NAME \
--set-env-vars INSTANCE_UNIX_SOCKET=/cloudsql/INSTANCE_CONNECTION_NAME \
--set-env-vars DB_USER=quickstart-user \
--set-env-vars DB_PASS=DB_PASS \
--set-env-vars DB_NAME=quickstart-db

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

IP privato

Console

Nella console Google Cloud, vai alla pagina Cloud Functions.

Vai a Cloud Functions
Seleziona la quickstart-function che hai creato in un passaggio precedente di questa guida rapida.
Nella pagina Dettagli funzione, fai clic sul link nel riquadro Basato su Cloud Run per accedere al servizio Cloud Functions sottostante.
Fai clic su Modifica ed esegui il deployment di nuova revisione.
Nel campo URL immagine container, fai clic su Seleziona.

Seleziona la scheda Artifact Registry, quindi espandi il nodo quickstart-repo.
Espandi il container function-sql, quindi seleziona l'immagine container creata nel passaggio precedente.
Fai clic su Seleziona.

Crea le seguenti variabili di ambiente facendo clic su Aggiungi variabile nella sezione Variabili di ambiente:

DB_NAME: imposta su quickstart-db.
DB_USER: imposta su quickstart-user.
DB_PASS: imposta la password dell'elemento quickstart-user specificato nel passaggio precedente della guida rapida Creare un utente.
INSTANCE_CONNECTION_NAME: imposta il Nome connessione dell'istanza visualizzato nella pagina Istanze Cloud SQL nella console Google Cloud.
DB_PORT: imposta su 3306.

INSTANCE_HOST: imposta l'indirizzo IP privato dell'istanza visualizzato nella pagina Istanze Cloud SQL nella console Google Cloud.
DB_ROOT_CERT: imposta su certs/server-ca.pem.
DB_CERT: imposta su certs/client-cert.pem.
DB_KEY: imposta su certs/client-key.pem.
PRIVATE_IP: imposta su TRUE.

Abilita la connessione a Cloud SQL:
1. Nella sezione Connessioni Cloud SQL, fai clic su Aggiungi connessione.
2. Seleziona il nome di 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 attraverso il connettore VPC.
In fondo alla pagina, fai clic su Esegui il deployment.
Dopo il deployment della funzione quickstart-function, nella pagina Dettagli servizio viene visualizzato un URL per il servizio in esecuzione. Fai clic sul link URL per visualizzare l'app Cloud Functions di esempio di cui è stato eseguito il deployment connessa a Cloud SQL. L'app dovrebbe essere simile alla seguente:

gcloud

Go

Per eseguire il deployment di una funzione gen2 in Cloud Functions, esegui il seguente comando gcloud functions deploy. Prima di eseguire il comando, aggiorna le seguenti variabili:

YOUR_REGION_NAME con il nome della tua regione
PRIVATE_IP_ADDRESS con l'indirizzo IP privato della tua istanza Cloud SQL visualizzato nella pagina Istanze Cloud SQL nella console Google Cloud
DB_PASS con la password dell'elemento quickstart-user creato nel passaggio precedente della guida rapida Creare un utente
INSTANCE_CONNECTION_NAME con il Nome connessione dell'istanza visualizzato nella pagina Istanze Cloud SQL nella console Google Cloud

Esegui il comando gcloud functions deploy come segue per creare le funzioni Cloud Functions:

gcloud functions deploy quickstart-function \
--gen2 \
--runtime go120 \
--trigger-http \
--allow-unauthenticated \
--entry-point Votes \
--region YOUR_REGION_NAME \
--vpc-connector=quickstart-connector \
--vpc-egress=all-traffic \
--set-env-vars INSTANCE_HOST=PRIVATE_IP_ADDRESS \
--set-env-vars DB_USER=quickstart-user \
--set-env-vars DB_PASS=DB_PASS \
--set-env-vars DB_NAME=quickstart-db \
--set-env-vars DB_PORT=3306 \
--set-env-vars DB_ROOT_CERT=certs/server-ca.pem \
--set-env-vars DB_CERT=certs/client-cert.pem \
--set-env-vars DB_KEY=certs/client-key.pem \
--set-env-vars PRIVATE_IP=TRUE

Gli utenti Java devono eseguire il comando gcloud functions deploy senza i flag INSTANCE_HOST, DB_PORT, DB_ROOT_CERT, DB_CERT, DB_KEY e PRIVATE_IP, come segue, per creare le funzioni Cloud Functions perché il connettore Java fornisce già una connessione sicura:

gcloud functions deploy quickstart-function \
--gen2 \
--runtime go120 \
--trigger-http \
--allow-unauthenticated \
--entry-point Votes \
--region YOUR_REGION_NAME \
--vpc-connector=quickstart-connector \
--vpc-egress=all-traffic \
--set-env-vars DB_NAME=quickstart-db \
--set-env-vars DB_USER=quickstart-user \
--set-env-vars DB_PASS=DB_PASS \
--set-env-vars INSTANCE_CONNECTION_NAME=INSTANCE_CONNECTION_NAME \
--set-env-vars PRIVATE_IP=TRUE

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

Java

Per eseguire il deployment di una funzione gen2 in Cloud Functions, esegui il seguente comando gcloud functions deploy. Prima di eseguire il comando, aggiorna le seguenti variabili:

YOUR_REGION_NAME con il nome della tua regione
PRIVATE_IP_ADDRESS con l'indirizzo IP privato della tua istanza Cloud SQL visualizzato nella pagina Istanze Cloud SQL nella console Google Cloud
DB_PASS con la password dell'elemento quickstart-user creato nel passaggio precedente della guida rapida Creare un utente
INSTANCE_CONNECTION_NAME con il Nome connessione dell'istanza visualizzato nella pagina Istanze Cloud SQL nella console Google Cloud

Esegui il comando gcloud functions deploy come segue per creare le funzioni Cloud Functions:

gcloud functions deploy quickstart-function \
--gen2 \
--runtime java11 \
--trigger-http \
--allow-unauthenticated \
--entry-point com.example.cloudsql.functions.Main \
--region YOUR_REGION_NAME \
--vpc-connector=quickstart-connector \
--vpc-egress=all-traffic \
--set-env-vars INSTANCE_HOST=PRIVATE_IP_ADDRESS \
--set-env-vars DB_USER=quickstart-user \
--set-env-vars DB_PASS=DB_PASS \
--set-env-vars DB_NAME=quickstart-db \
--set-env-vars DB_PORT=3306 \
--set-env-vars DB_ROOT_CERT=certs/server-ca.pem \
--set-env-vars DB_CERT=certs/client-cert.pem \
--set-env-vars DB_KEY=certs/client-key.pem \
--set-env-vars PRIVATE_IP=TRUE

gcloud functions deploy quickstart-function \
--gen2 \
--runtime java11 \
--trigger-http \
--allow-unauthenticated \
--entry-point com.example.cloudsql.functions.Main \
--region YOUR_REGION_NAME \
--vpc-connector=quickstart-connector \
--vpc-egress=all-traffic \
--set-env-vars DB_NAME=quickstart-db \
--set-env-vars DB_USER=quickstart-user \
--set-env-vars DB_PASS=DB_PASS \
--set-env-vars INSTANCE_CONNECTION_NAME=INSTANCE_CONNECTION_NAME \
--set-env-vars PRIVATE_IP=TRUE

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

Node.js

Per eseguire il deployment di una funzione gen2 in Cloud Functions, esegui il seguente comando gcloud functions deploy. Prima di eseguire il comando, aggiorna le seguenti variabili:

YOUR_REGION_NAME con il nome della tua regione
PRIVATE_IP_ADDRESS con l'indirizzo IP privato della tua istanza Cloud SQL visualizzato nella pagina Istanze Cloud SQL nella console Google Cloud
DB_PASS con la password dell'elemento quickstart-user creato nel passaggio precedente della guida rapida Creare un utente
INSTANCE_CONNECTION_NAME con il Nome connessione dell'istanza visualizzato nella pagina Istanze Cloud SQL nella console Google Cloud

Esegui il comando gcloud functions deploy come segue per creare le funzioni Cloud Functions:

gcloud functions deploy quickstart-function \
--gen2 \
--runtime nodejs18 \
--trigger-http \
--allow-unauthenticated \
--entry-point votes \
--region YOUR_REGION_NAME \
--vpc-connector=quickstart-connector \
--vpc-egress=all-traffic \
--set-env-vars INSTANCE_HOST=PRIVATE_IP_ADDRESS \
--set-env-vars DB_USER=quickstart-user \
--set-env-vars DB_PASS=DB_PASS \
--set-env-vars DB_NAME=quickstart-db \
--set-env-vars DB_PORT=3306 \
--set-env-vars DB_ROOT_CERT=certs/server-ca.pem \
--set-env-vars DB_CERT=certs/client-cert.pem \
--set-env-vars DB_KEY=certs/client-key.pem \
--set-env-vars PRIVATE_IP=TRUE

gcloud functions deploy quickstart-function \
--gen2 \
--runtime nodejs18 \
--trigger-http \
--allow-unauthenticated \
--entry-point votes \
--region YOUR_REGION_NAME \
--vpc-connector=quickstart-connector \
--vpc-egress=all-traffic \
--set-env-vars DB_NAME=quickstart-db \
--set-env-vars DB_USER=quickstart-user \
--set-env-vars DB_PASS=DB_PASS \
--set-env-vars INSTANCE_CONNECTION_NAME=INSTANCE_CONNECTION_NAME \
--set-env-vars PRIVATE_IP=TRUE

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

Python

Per eseguire il deployment di una funzione gen2 in Cloud Functions, esegui il seguente comando gcloud functions deploy. Prima di eseguire il comando, aggiorna le seguenti variabili:

YOUR_REGION_NAME con il nome della tua regione
PRIVATE_IP_ADDRESS con l'indirizzo IP privato della tua istanza Cloud SQL visualizzato nella pagina Istanze Cloud SQL nella console Google Cloud
DB_PASS con la password dell'elemento quickstart-user creato nel passaggio precedente della guida rapida Creare un utente
INSTANCE_CONNECTION_NAME con il Nome connessione dell'istanza visualizzato nella pagina Istanze Cloud SQL nella console Google Cloud

Esegui il comando gcloud functions deploy come segue per creare le funzioni Cloud Functions:

gcloud functions deploy quickstart-function \
--gen2 \
--runtime python310 \
--trigger-http \
--allow-unauthenticated \
--entry-point votes \
--region YOUR_REGION_NAME \
--vpc-connector=quickstart-connector \
--vpc-egress=all-traffic \
--set-env-vars INSTANCE_HOST=PRIVATE_IP_ADDRESS \
--set-env-vars DB_USER=quickstart-user \
--set-env-vars DB_PASS=DB_PASS \
--set-env-vars DB_NAME=quickstart-db \
--set-env-vars DB_PORT=3306 \
--set-env-vars DB_ROOT_CERT=certs/server-ca.pem \
--set-env-vars DB_CERT=certs/client-cert.pem \
--set-env-vars DB_KEY=certs/client-key.pem \
--set-env-vars PRIVATE_IP=TRUE

gcloud functions deploy quickstart-function \
--gen2 \
--runtime python310 \
--trigger-http \
--allow-unauthenticated \
--entry-point votes \
--region YOUR_REGION_NAME \
--vpc-connector=quickstart-connector \
--vpc-egress=all-traffic \
--set-env-vars DB_NAME=quickstart-db \
--set-env-vars DB_USER=quickstart-user \
--set-env-vars DB_PASS=DB_PASS \
--set-env-vars INSTANCE_CONNECTION_NAME=INSTANCE_CONNECTION_NAME \
--set-env-vars PRIVATE_IP=TRUE

Quando viene visualizzato un messaggio che conferma che è stato eseguito il deployment di Cloud Functions, fai clic sul link URL del servizio nel messaggio per visualizzare l'app Cloud Functions di esempio di cui è stato eseguito il deployment connessa 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.

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

Vai a Istanze Cloud SQL
Seleziona l'istanza quickstart-instance per aprire la pagina Dettagli istanza.
Nella barra delle icone nella parte superiore della pagina, fai clic su Elimina.
Nella finestra di dialogo Elimina istanza, digita quickstart-instance e fai clic su Elimina per eliminare l'istanza.
Nella console Google Cloud, vai alla pagina Cloud Functions.

Vai a Cloud Functions
Seleziona la casella di controllo accanto al nome del servizio quickstart-function.
Fai clic su Elimina nella parte superiore della pagina di Cloud Functions.

Passaggi di pulizia facoltativi

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

Nella console Google Cloud, vai alla pagina IAM.

Vai a IAM
Fai clic sull'icona di modifica (che appare come una matita) per l'account IAM denominato Account di servizio predefinito di Compute Engine.
Elimina il ruolo Client Cloud SQL.
Fai clic su Salva.

Se non utilizzi le API che sono state abilitate in questa guida rapida, puoi disabilitarle.

API che sono state abilitate in questa guida rapida:
- API Compute Engine
- API Cloud SQL Admin
- API Cloud Run
- API Container Registry
- API Cloud Build

Nella console Google Cloud, vai alla pagina API.

Vai alle API
Seleziona un'API da disabilitare, quindi fai clic sul pulsante Disabilita API.

Passaggi successivi

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

Scopri di più sulla creazione di utenti MySQL e database per la tua istanza Cloud SQL.

Per ulteriori informazioni sui prezzi, consulta la pagina relativa ai prezzi di Cloud SQL per MySQL.

Scopri di più su:

Configurazione dell'istanza Cloud SQL con un indirizzo IP pubblico.
Configurazione dell'istanza Cloud SQL con un indirizzo IP privato.

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