Connettiti a Cloud SQL per MySQL da Cloud Run

Connettiti a Cloud SQL per MySQL da Cloud Run

MySQL   |  PostgreSQL   |  SQL Server

Scopri come eseguire il deployment di un'app di esempio su Cloud Run 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 in genere costano meno di un dollaro (USD).

---

Per seguire le indicazioni dettagliate per questa attività direttamente nella console Google Cloud , fai clic su Procedura guidata:

Procedura guidata

---

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.

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 senza costi per l'esecuzione, il test e il deployment dei workload.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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

Verify that billing is enabled for your Google Cloud project.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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

Verify that billing is enabled for your Google Cloud project.

1. Verifica di disporre delle autorizzazioni necessarie per completare questa guida rapida.
2. 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 rapida.

   Abilita le API

   Vengono abilitate 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, che fornisce l'accesso tramite riga di comando alle tue risorse Google Cloud direttamente dal browser. Cloud Shell può essere utilizzato 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 \
   artifactregistry.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 Artifact Registry
   • API Cloud Build
   • API Service Networking

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per eseguire il deployment di un'app di esempio su Cloud Run connessa a un'istanza MySQL, chiedi all'amministratore di concederti i seguenti ruoli IAM nel progetto che vuoi utilizzare:

• Creare o eliminare un repository Artifact Registry: Artifact Registry Writer (roles/artifactregistry.writer)
• Creare o eliminare un'istanza, un database e un utente: ruolo Amministratore Cloud SQL (roles/cloudsql.admin).
• Creare o eliminare un account di servizio IAM: ruolo Amministratore service account (roles/iam.serviceAccountAdmin).
• Crea una connessione:
  • Service Networking Admin (roles/servicenetworking.networksAdmin))
  • Amministratore Service Usage (roles/serviceusage.serviceUsageAdmin).
• Visualizza gli oggetti e i relativi metadati: Storage Object Viewer (roles/storage.objectViewer)
• Fornisce le autorizzazioni per amministrare le policy sui progetti. Project IAM Admin (roles/resourcemanager.projectIamAdmin).
• Accesso in lettura e scrittura a tutte le risorse Cloud Run: Sviluppatore Cloud Run (roles/run.developer).
• Esegue il deployment e gestisce le risorse di cui è stato eseguito il deployment nell'origine Cloud Run: Cloud Run Source Developer (roles/run.sourceDeveloper).
• Per consentire l'accesso pubblico: Cloud Run Admin (roles/run.admin).
• Per eseguire operazioni come account di servizio: Service Account User (roles/iam.serviceAccountUser).

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Configura Cloud SQL

Crea un'istanza Cloud SQL

IP pubblico

Per configurare un'istanza Cloud SQL a cui connetterti tramite IP pubblico, segui questi passaggi:

Console

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

   Vai a Istanze Cloud SQL

2. Fai clic su Crea istanza.
3. Dal menu Crea istanza, seleziona Nuova istanza.
4. Fai clic su Scegli MySQL.
5. Assicurati che sia selezionata Enterprise Plus come versione di Cloud SQL per la tua istanza.
6. Nel campo ID istanza, inserisci quickstart-instance.
7. Nel campo Password, inserisci una password per l'utente root. Salva questa password per utilizzarla in futuro.
8. Nella sezione Scegli la disponibilità per regione e zona, seleziona Zona singola.
9. Fai clic sul menu Mostra opzioni di configurazione.
10. Espandi il nodo Configurazione macchina.
11. Nella regione Forme di macchine, seleziona la forma 4 vCPU, 32 GB.
12. Fai clic su Crea istanza e 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.

Se vuoi, modifica i valori dei seguenti parametri:

• --database-version: il tipo e la versione del motore del database. Se non viene specificato, viene utilizzato il valore predefinito dell'API. Consulta la documentazione sulle versioni del database gcloud per visualizzare le versioni attualmente disponibili.
• --cpu: il numero di core desiderato nella macchina.
• --memory: valore intero che indica la quantità di memoria desiderata nella macchina. Deve essere fornita un'unità di misura delle dimensioni (ad esempio, 3072 MB o 9 GB). Se non vengono specificate unità, viene utilizzato il GB.
• --region: località regionale dell'istanza (ad esempio asia-east1, us-east1). Se non viene 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

Per configurare un'istanza Cloud SQL a cui connetterti tramite IP privato, segui questi passaggi:

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 a 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. In Nome dell'intervallo allocato, specifica google-managed-services-default.
7. Seleziona l'opzione Automatico per l'intervallo IP e specifica la lunghezza del prefisso come 16.
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.

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. Dal menu Crea istanza, seleziona Nuova istanza.
4. Fai clic su Scegli MySQL.
5. Assicurati che sia selezionata Enterprise Plus come versione di Cloud SQL per la tua istanza.
6. Nel campo ID istanza, inserisci quickstart-instance.
7. Nel campo Password, inserisci una password per l'utente root. Salva questa password per utilizzarla in futuro.
8. Nella sezione Scegli la disponibilità per regione e zona, seleziona Zona singola.
9. Fai clic sul menu Mostra opzioni di configurazione.
10. Espandi il nodo Configurazione macchina.
11. Nella regione Forme di macchine, seleziona la forma 4 vCPU, 32 GB.
12. Espandi il nodo Connessioni.
13. Deseleziona la casella di controllo IP pubblico per creare un'istanza solo con un indirizzo IP privato.
14. Seleziona la casella di controllo IP privato.
15. Seleziona la casella di controllo Accesso privato ai servizi (PSA).
16. Nel menu a discesa Rete VPC *, seleziona predefinita.
17. Nella sezione Sicurezza, assicurati che sia selezionata l'opzione Consenti solo connessioni SSL per abilitare le connessioni SSL.
18. Fai clic su Crea istanza, quindi attendi che l'istanza venga inizializzata e avviata.

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

   Se vuoi, modifica i valori dei seguenti parametri:

   • --database-version: il tipo e la versione del motore del database. Se non viene specificato, viene utilizzato il valore predefinito dell'API. Consulta la documentazione sulle versioni del database gcloud per visualizzare le versioni attualmente disponibili.
   • --cpu: il numero di core della macchina.
   • --memory: un valore numerico intero che indica la quantità di memoria da includere nella macchina. È possibile fornire un'unità di misura (ad esempio 3072 MB o 9 GB). Se non vengono specificate unità, viene utilizzato il GB.
   • --region: la località regionale dell'istanza (ad esempio asia-east1, us-east1). Se non viene 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

2. Esegui il comando gcloud sql instances patch per attivare l'opzione Consenti solo connessioni SSL per l'istanza.

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

Crea un database

Per creare un database, segui questi passaggi:

Console

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

   Vai a Istanze Cloud SQL

2. Seleziona quickstart-instance.
3. Dal menu di navigazione SQL, seleziona Database.
4. Fai clic su  Crea database.
1. Nel campo Nome database della finestra di dialogo Crea un database, inserisci quickstart-db. Lascia i valori per il set di caratteri e la regole di confronto.
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

Crea un utente

Per creare un utente, segui questi passaggi:

Console

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

   Vai a Istanze Cloud SQL

2. Per aprire la pagina Panoramica di un'istanza, fai clic sul nome dell'istanza.
3. Seleziona Utenti dal menu di navigazione SQL.
4. Fai clic su Aggiungi account utente.
• Nella pagina Aggiungi un account utente all'istanza instance_name, aggiungi le seguenti informazioni:
  • Nome utente: imposta su quickstart-user
  • Password: specifica una password per l'utente del database. Prendi nota di questo valore per utilizzarlo in un passaggio successivo di questa guida rapida.
  • Nella sezione Nome host, l'impostazione predefinita è Consenti qualsiasi host, il che significa che l'utente può connettersi da qualsiasi indirizzo IP.

    Facoltativamente, seleziona Limita host in base all'indirizzo o all'intervallo di indirizzi IP e inserisci un indirizzo o un intervallo di indirizzi IP nella sezione Host. L'utente può quindi connettersi solo dall'indirizzo o dagli indirizzi IP specificati.

5. Fai clic su Aggiungi.

gcloud

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

1. PASSWORD con una password per l'utente del database. Prendi nota di questo valore 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=PASSWORD

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

Esegui il deployment dell'app di esempio in Cloud Run

Configura un account di servizio Cloud Run

Configura l' account di servizio predefinito di Compute Engine utilizzato da Cloud Run in modo che abbia i ruoli Cloud SQL Client e Storage Object Viewer.

Console

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

   Vai a Service account IAM

2. Fai clic sul menu Azioni accanto al service account, quindi fai clic su Gestisci accesso.
3. Fai clic su Aggiungi un altro ruolo, quindi trova e seleziona Client Cloud SQL (roles/cloudsql.client) nel menu a discesa Ruolo.
4. Fai clic su Aggiungi un altro ruolo, quindi trova e seleziona Storage Object Viewer (roles/storage.objectViewer) nel menu a discesa Ruolo.
5. Fai clic su Salva.

gcloud

1. Esegui questo comando gcloud per ottenere un elenco dei service account del tuo progetto:

   gcloud iam service-accounts list

2. Copia l'EMAIL del account di servizio predefinito di Compute Engine.
3. Esegui questo comando per aggiungere il ruolo Cloud SQL Client al service account predefinito di Compute Engine:

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

4. Esegui questo comando per aggiungere il ruolo Storage Object Viewer al service account predefinito di Compute Engine:

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

Configura un'app di esempio Cloud SQL

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

IP pubblico

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

Vai

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. Imposta la proprietà "project" di Cloud Shell eseguendo il comando seguente, sostituendo YOUR_PROJECT_ID con l'ID progetto:

   gcloud config set project YOUR_PROJECT_ID

4. Crea un repository Docker in Artifact Registry denominato run-sql nella stessa regione dell'istanza Cloud SQL. Sostituisci YOUR_PROJECT_ID con l'ID progetto e YOUR_REGION_NAME con il nome della regione.

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

5. Esegui questo comando 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 regione.

   gcloud builds submit --tag YOUR_REGION_NAME-docker.pkg.dev/YOUR_PROJECT_ID/run-sql/run-sql

Java

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. Crea un repository Docker in Artifact Registry denominato run-sql nella stessa regione dell'istanza Cloud SQL. Sostituisci YOUR_PROJECT_ID con l'ID progetto e YOUR_REGION_NAME con il nome della regione.

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

4. Esegui questo comando 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 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/run-sql/run-sql \
         -DskipTests -Djib.to.credHelper=gcloud
         

Node.js

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. Crea un repository Docker in Artifact Registry denominato run-sql nella stessa regione dell'istanza Cloud SQL. Sostituisci YOUR_PROJECT_ID con l'ID progetto e YOUR_REGION_NAME con il nome della regione.

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

4. Esegui questo comando 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 regione.

   gcloud builds submit --tag YOUR_REGION_NAME-docker.pkg.dev/YOUR_PROJECT_ID/run-sql/run-sql

Python

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. Crea un repository Docker in Artifact Registry denominato run-sql nella stessa regione dell'istanza Cloud SQL. Sostituisci YOUR_PROJECT_ID con l'ID progetto e YOUR_REGION_NAME con il nome della regione.

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

4. Esegui questo comando 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 regione.

   gcloud builds submit --tag YOUR_REGION_NAME-docker.pkg.dev/YOUR_PROJECT_ID/run-sql/run-sql

IP privato

Per i percorsi IP privati, l'applicazione si connette direttamente all'istanza tramite VPC diretto in uscita o un connettore VPC. Questo metodo utilizza un socket TCP per connettersi direttamente all'istanza Cloud SQL senza utilizzare il Cloud SQL Auth Proxy.

Vai

Creare e scaricare certificati server e client 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 Crea certificato client.
5. Nella finestra di dialogo Crea un certificato client, inserisci quickstart-key come nome e fai clic su Crea.

6. 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. In caso di smarrimento, dovrai creare un nuovo certificato client.

Crea un'app di esempio con certificati 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 Open in Cloud Shell, fai clic su Conferma per scaricare il codice dell'app di esempio e aprire la directory di quest'ultima nell'editor di Cloud Shell.
3. 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:
   • client-key.pem
   • client-cert.pem
   • server-ca.pem
   3. Con i tre file del certificato SSL selezionati, fai clic su Apri per completare la procedura di caricamento dei file nell'editor di Cloud Shell.
4. Crea un repository Docker in Artifact Registry denominato run-sql nella stessa regione dell'istanza Cloud SQL. Sostituisci YOUR_PROJECT_ID con l'ID progetto e YOUR_REGION_NAME con il nome della regione.

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

5. Esegui questo comando 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 regione.

   gcloud builds submit --tag YOUR_REGION_NAME-docker.pkg.dev/YOUR_PROJECT_ID/run-sql/run-sql

Java

Creare e scaricare certificati server e client SSL

Per gli utenti Java, il connettore Java fornisce già una connessione sicura, quindi non è necessario creare e scaricare certificati client e server SSL.

Crea l'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. Crea un repository Docker in Artifact Registry denominato run-sql nella stessa regione dell'istanza Cloud SQL. Sostituisci YOUR_PROJECT_ID con l'ID progetto e YOUR_REGION_NAME con il nome della regione.

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

4. Esegui questo comando 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 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/run-sql/run-sql \
         -DskipTests -Djib.to.credHelper=gcloud
         

Node.js

Creare e scaricare certificati server e client 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 Crea certificato client.
5. Nella finestra di dialogo Crea un certificato client, inserisci quickstart-key come nome e fai clic su Crea.

6. 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. In caso di smarrimento, dovrai creare un nuovo certificato client.

Crea un'app di esempio con certificati 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 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:
   • client-key.pem
   • client-cert.pem
   • server-ca.pem
   3. Con i tre file del certificato SSL selezionati, fai clic su Apri per completare la procedura di caricamento dei file nell'editor di Cloud Shell.
4. Crea un repository Docker in Artifact Registry denominato run-sql nella stessa regione dell'istanza Cloud SQL. Sostituisci YOUR_PROJECT_ID con l'ID progetto e YOUR_REGION_NAME con il nome della regione.

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

5. Esegui questo comando 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 regione.

   gcloud builds submit --tag YOUR_REGION_NAME-docker.pkg.dev/YOUR_PROJECT_ID/run-sql/run-sql

Python

Creare e scaricare certificati server e client 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 Crea certificato client.
5. Nella finestra di dialogo Crea un certificato client, inserisci quickstart-key come nome e fai clic su Crea.

6. 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. In caso di smarrimento, dovrai creare un nuovo certificato client.

Crea un'app di esempio con certificati 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 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:
   • client-key.pem
   • client-cert.pem
   • server-ca.pem
   3. Con i tre file del certificato SSL selezionati, fai clic su Apri per completare la procedura di caricamento dei file nell'editor di Cloud Shell.
4. Crea un repository Docker in Artifact Registry denominato run-sql nella stessa regione dell'istanza Cloud SQL. Sostituisci YOUR_PROJECT_ID con l'ID progetto e YOUR_REGION_NAME con il nome della regione.

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

5. Esegui questo comando 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 regione.

   gcloud builds submit --tag YOUR_REGION_NAME-docker.pkg.dev/YOUR_PROJECT_ID/run-sql/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.

Il metodo di connessione dell'immagine varia in base alle variabili di ambiente impostate.

• Per connetterti utilizzando TCP, imposta il valore della variabile di ambiente INSTANCE_HOST. Questo metodo di connessione rispetta i certificati e le porte configurati come variabili di ambiente.
• Per connetterti utilizzando i socket Unix, imposta il valore della variabile di ambiente INSTANCE_UNIX_SOCKET.

  Non impostare il valore della variabile di ambiente INSTANCE_HOST.

  I socket Unix non sono supportati in modo nativo in Java. Se la tua applicazione è scritta in Java, devi utilizzare il connettore Java di Cloud SQL.

• Per connetterti utilizzando uno dei connettori dei linguaggi di Cloud SQL, imposta i valori per le variabili di ambiente INSTANCE_CONNECTION_NAME e DB_IAM_HOST.

  Non impostare i valori per le seguenti variabili di ambiente:

  • INSTANCE_HOST
  • INSTANCE_UNIX_SOCKET
  • DB_PORT
  • DB_ROOT_CERT
  • DB_CERT
  • DB_KEY
  Questi valori non vengono utilizzati perché il connettore dei linguaggi di Cloud SQL fornisce già una connessione sicura utilizzando il server proxy di autenticazione Cloud SQL, che stabilisce connessioni a Cloud SQL sulla porta 3307.

IP pubblico

Console

Nota: se utilizzi la console per eseguire il deployment di una funzione, devi abilitare le API richieste, avere i ruoli richiesti e fare clic sul modulo per Scrivi una funzione.

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

   Vai a Cloud Run

2. Fai clic su Esegui il deployment del container per visualizzare il modulo Crea servizio.

3. Fai clic sul pulsante Seleziona nel campo di immissione URL immagine container.
1. Seleziona 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 Consenti accesso pubblico. Se non disponi delle autorizzazioni (ruolo Amministratore Cloud Run) per selezionare questa opzione, il servizio verrà sottoposto a deployment e richiederà l'autenticazione.
6. Espandi la sezione Container, variabili e secret, connessioni, sicurezza .
7. Crea le seguenti Environment variables facendo clic su Aggiungi variabile in Variabili di ambiente. Imposta i valori per le variabili di ambiente come segue:
• INSTANCE_UNIX_SOCKET: imposta su /cloudsql/YOUR_PROJECT_ID:us-central1:quickstart-instance.
• INSTANCE_CONNECTION_NAME: imposta il Nome connessione dell'istanza visualizzato nella pagina Istanze Cloud SQL nella console Google Cloud .
• DB_NAME: impostato su quickstart-db.
• DB_USER: impostalo su quickstart-user.
• DB_PASS: impostala sulla password dell'utente quickstart-user che hai specificato nel passaggio precedente della guida rapida Crea un utente.

8. Abilita la connessione a Cloud SQL:

   • Fai clic sulla scheda Connessioni.
   • Fai clic sul pulsante Aggiungi connessione nella sezione Connessioni Cloud SQL.
   • Seleziona dal menu a discesa il quickstart-instance che hai creato in precedenza.

   

9. Per creare il servizio Cloud Run, fai clic su Crea.

10. Una volta eseguito il deployment del servizio Cloud Run, nella pagina Dettagli servizio verrà visualizzato un URL per il 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 su Cloud Run connessa a Cloud SQL.

    

gcloud

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

• YOUR_PROJECT_ID con l'ID progetto.

• INSTANCE_CONNECTION_NAME con il nome connessione dell'istanza che appare nella pagina Istanze Cloud SQL della console Google Cloud .

• DB_PASS con la password dell'utente quickstart-user che hai creato nel passaggio precedente della guida rapida Crea un utente.

Esegui il comando gcloud run deploy come segue per creare il servizio Cloud Run. Le variabili di ambiente variano a seconda del metodo di connessione che vuoi utilizzare:

gcloud run deploy run-sql --image gcr.io/YOUR_PROJECT_ID/run-sql \
    --add-cloudsql-instances INSTANCE_CONNECTION_NAME \
    --set-env-vars INSTANCE_CONNECTION_NAME="INSTANCE_CONNECTION_NAME" \
    --set-env-vars DB_NAME="quickstart-db" \
    --set-env-vars DB_USER="quickstart-user" \
    --set-env-vars DB_PASS="DB_PASS"

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 è stato eseguito il deployment del servizio Cloud Run, fai clic sul link URL servizio nel messaggio per visualizzare l'app di esempio su Cloud Run connessa a Cloud SQL.

   

IP privato

Console

Nota: se utilizzi la console per eseguire il deployment di una funzione, devi abilitare le API richieste, avere i ruoli richiesti e fare clic sul modulo per Scrivi una funzione.

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 per eseguire il 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 Consenti accesso pubblico. Se non disponi delle autorizzazioni (ruolo Amministratore Cloud Run) per selezionare questa opzione, il servizio verrà sottoposto a deployment e richiederà l'autenticazione.
6. Espandi la sezione 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: impostato su quickstart-user.
• DB_PASS: imposta la password di quickstart-user che hai specificato nel passaggio precedente della guida rapida Crea un utente.
• INSTANCE_CONNECTION_NAME: impostalo sul nome della connessione dell'istanza visualizzato nella pagina Istanze Cloud SQL della console Google Cloud .
• DB_PORT: impostato su 3306.
• DB_ROOT_CERT: impostato su certs/server-ca.pem.
• DB_CERT: impostato su certs/client-cert.pem.
• DB_KEY: impostato su certs/client-key.pem.
• PRIVATE_IP: impostato su TRUE.

8. Abilita 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 che hai creato in precedenza.
   4. Nella scheda Networking, seleziona Connettiti a un VPC per il traffico in uscita, quindi seleziona predefinita nei campi Rete e Subnet.
   5. Seleziona l'opzione Instrada al VPC tutto il traffico.

9. Fai clic su Crea per creare il servizio Cloud Run.

10. Dopo il deployment del servizio Cloud Run, la pagina Dettagli 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 su Cloud Run connessa a Cloud SQL.

    

gcloud

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

• YOUR_PROJECT_ID con l'ID progetto.

• INSTANCE_CONNECTION_NAME con il nome connessione dell'istanza che appare nella pagina Istanze Cloud SQL della console Google Cloud .

• DB_PASS con la password dell'utente quickstart-user che hai creato nel passaggio precedente della guida rapida Crea un utente.

Esegui il comando gcloud run deploy come segue per creare il servizio Cloud Run. Le variabili di ambiente variano a seconda del metodo di connessione che vuoi utilizzare:

gcloud run deploy run-sql --image gcr.io/YOUR_PROJECT_ID/run-sql \
    --add-cloudsql-instances INSTANCE_CONNECTION_NAME \
    --vpc-egress all-traffic \
    --network=default \
    --subnet=default \
    --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 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"
    

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 è stato eseguito il deployment del servizio Cloud Run, fai clic sul link URL servizio nel messaggio per visualizzare l'app di esempio su Cloud Run 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.

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, quindi 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 di Cloud Run.

Passaggi di pulizia facoltativi

Se non utilizzi il ruolo Cloud SQL Client assegnato al account di servizio Compute Engine, puoi rimuoverlo.

1. Nella Google Cloud console, vai alla pagina Service account.

   Vai a IAM

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

Se non utilizzi le API abilitate nell'ambito di questa guida rapida, puoi disabilitarle.

• 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 un'API che vuoi disabilitare e poi fai clic sul pulsante Disabilita API.

Passaggi successivi

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

Puoi anche scoprire come creare utenti e database MySQL per la tua istanza Cloud SQL.

Per ulteriori informazioni sui prezzi, consulta 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:

• 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
• Da Cloud Run