Connettiti a Cloud SQL per PostgreSQL dall'ambiente flessibile App Engine

Connettiti a Cloud SQL per PostgreSQL dall'ambiente flessibile App Engine

MySQL   |  PostgreSQL   |  SQL Server

Scopri come eseguire il deployment di un'app di esempio nell'ambiente flessibile di App Engine connesso a un'istanza PostgreSQL mediante la console Google Cloud e un client dell'app.

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

Prima di iniziare

Nota: il nome che utilizzi per il progetto deve essere compreso tra 4 e 30 caratteri. Quando digita il nome, il modulo suggerisce un ID progetto che puoi modificare. La 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 non può essere un trattino.

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

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

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

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

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

5. Make sure that billing is enabled for your Google Cloud project.

6. Abilita le API Cloud necessarie per eseguire un'app di esempio Cloud SQL nell'ambiente flessibile di App Engine.

   Console

   Fai clic sul pulsante in basso per abilitare le API richieste per questa guida rapida.

   Abilita le API

   Ciò abilita le seguenti API:

   • API Cloud SQL Admin
   • API Compute Engine
   • API Cloud Build
   • API Cloud Logging

   Se fai clic sul pulsante, abiliti anche l'ambiente flessibile di Google App Engine.

   gcloud

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

   Apri Cloud Shell

   Esegui il seguente comando gcloud utilizzando Cloud Shell:

   gcloud services enable appengineflex.googleapis.com sqladmin.googleapis.com \
   compute.googleapis.com cloudbuild.googleapis.com logging.googleapis.com

   Questo comando abilita le seguenti API:

   • API Cloud SQL Admin
   • API Compute Engine
   • API Cloud Build
   • API Cloud Logging

   Eseguendo il comando precedente, abiliti anche l'ambiente flessibile di Google App Engine.

Configura Cloud SQL

Crea un'istanza Cloud SQL

IP pubblico

Console

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

   Vai a Istanze Cloud SQL

2. Fai clic su Crea istanza.
3. Fai clic su Scegli PostgreSQL.
4. Assicurati che Enterprise Plus sia selezionata come versione Cloud SQL per l'istanza.
5. Nel campo ID istanza, inserisci quickstart-instance.
6. Nel campo Password, inserisci una password per l'utente postgres. Salva questa password per un uso futuro.
7. Nella sezione Scegli la disponibilità per regione e zona seleziona Zona singola.
8. Fai clic sul menu Mostra opzioni di configurazione.
9. Espandi il nodo Configurazione macchina.
10. Nella regione Forme di macchine, seleziona la forma con 4 vCPU, 32 GB.
11. Fai clic su Crea istanza e attendi fino all'inizializzazione e all'avvio dell'istanza.

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 conoscere le versioni attualmente disponibili.
• --cpu: il numero di core desiderato nella macchina.
• --memory: il valore numerico intero che indica come desiderata nella macchina. Deve essere fornita una unità di misura (ad es. 3072 MB o 9 GB). Se non viene specificata alcuna unità, si presume GB.
• --region: posizione 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=POSTGRES_14 \
 --cpu=1 \
 --memory=4GB \
 --region=us-central \
 --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

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. Per il Nome dell'intervallo allocato, specifica google-managed-services-default.
7. Seleziona l'opzione Automatico per l'intervallo IP e specifica 16 come lunghezza del prefisso.
8. Fai clic su Alloca per creare l'intervallo allocato.
9. Seleziona la scheda Connessioni private ai servizi per la rete VPC default.
10. Fai clic su Crea connessione per creare una connessione privata tra la tua rete e un producer di servizi.
11. In Allocazione assegnata, seleziona google-managed-services-default.
12. Fai clic su Connetti per creare la connessione.

Crea un'istanza con indirizzo IP privato e SSL abilitato

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

   Vai a Istanze Cloud SQL

2. Fai clic su Crea istanza.
3. Fai clic su Scegli PostgreSQL.
4. Assicurati che Enterprise Plus sia selezionata come versione Cloud SQL per l'istanza.
5. Nel campo ID istanza, inserisci quickstart-instance.
6. Nel campo Password, inserisci una password per l'utente postgres. Salva questa password per un uso futuro.
7. Nella sezione Scegli la disponibilità per regione e zona seleziona Zona singola.
8. Fai clic sul menu Mostra opzioni di configurazione.
9. Espandi il nodo Configurazione macchina.
10. Nella regione Forme di macchine, seleziona la forma con 4 vCPU, 32 GB.
11. Espandi il nodo Connessioni.
12. Deseleziona la casella di controllo IP pubblico per creare un'istanza solo con un indirizzo IP privato.
13. Seleziona la casella di controllo IP privato.
14. Nel menu Rete, seleziona predefinita.
15. Fai clic su Crea istanza e attendi l'inizializzazione e l'avvio dell'istanza.
16. Fai clic su Connessioni.
17. Nella sezione Sicurezza, seleziona Consenti solo connessioni SSL per attivare le connessioni SSL.
18. Nella finestra di dialogo Consenti solo connessioni SSL, fai clic su Salva. e attenderemo il riavvio dell'istanza.

gcloud

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

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

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

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

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

Creare un'istanza con indirizzo IP privato e SSL abilitati

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 le versioni del database gcloud documentazione per conoscere le versioni attualmente disponibili.
• --cpu: il numero di core nella macchina.
• --memory: un valore intero che indica la quantità di memoria da includere nella macchina. L'unità di misura può essere forniti (ad esempio, 3072 MB o 9 GB). Se non viene specificata alcuna unità, si presume GB.
• --region: la posizione regionale dell'istanza (ad esempio asia-east1, us-east1). Se non specificato, viene utilizzato il valore predefinito us-central1. Consulta l'elenco completo delle regioni.

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

gcloud sql instances create quickstart-instance \
--database-version=POSTGRES_14 \
 --cpu=1 \
 --memory=4GB \
 --region=us-central \
 --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

Console

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

   Vai a Istanze Cloud SQL

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

gcloud

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

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

Crea un utente

Console

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

   Vai a Istanze Cloud SQL

2. Seleziona l'istanza PostgreSQL quickstart-instance che hai creato.
3. Dal menu di navigazione SQL, seleziona Utenti.
4. Fai clic su Aggiungi account utente.
5. Nella pagina Aggiungi un account utente all'istanza quickstart-instance, aggiungi le seguenti informazioni:
   1. Nel campo Nome utente, inserisci quickstart-user.
   2. Nel campo Password, specifica una password per l'utente del database. Prendi nota di questa password da utilizzare in un passaggio successivo di questa guida rapida.
6. 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 del nome utente sono gli stessi per Cloud SQL e per PostgreSQL on-premise.

Eseguire il deployment di un'app di esempio nell'ambiente flessibile di App Engine

Crea un'applicazione App Engine

Crea un'app App Engine nel tuo progetto Google Cloud. In questo modo, viene attivato il servizio App Engine, viene creata un'app App Engine predefinita e viene creato un account di servizio App Engine che utilizzi per connetterti a Cloud SQL.

Nota: Puoi creare un'app App Engine solo una volta per progetto Google Cloud.

Console

1. Nella console Google Cloud, vai alla pagina App Engine.

   Vai ad App Engine

2. Fai clic su Crea applicazione.
3. Nel menu a discesa Seleziona una regione, seleziona us-central.
4. Fai clic su Avanti.
5. Quando viene visualizzata la pagina Inizia, scorri fino in fondo.
6. Fai clic sul link Lo farò più tardi.

gcloud

1. Esegui il seguente comando gcloud app create per creare un'app App Engine:

gcloud app create

2. Quando ti viene chiesto di scegliere la regione in cui vuoi che si trovi la tua app App Engine, inserisci la scelta numerica per us-central.

Configura l'account di servizio App Engine

Configura l'account di servizio utilizzato da App Engine in modo che disponga del ruolo Client Cloud SQL. Se assegni il ruolo all'account di servizio, questo disporrà delle autorizzazioni per connettersi a Cloud SQL.

Console

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

   Vai a IAM

2. Per l'account di servizio denominato Account di servizio predefinito di App Engine, fai clic sull'icona a forma di matita.
   Nota: Il nome dell'account di servizio viene visualizzato accanto all'entità dell'account. Il nome dell'entità è [e-mail].
3. Fai clic su Aggiungi un altro ruolo.
4. Aggiungi il ruolo denominato Client Cloud SQL.
5. Fai clic su Salva.

gcloud

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

   gcloud iam service-accounts list

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

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

Configura ed esegui il deployment di un'app di esempio per Cloud SQL

Ora che hai creato un'istanza e un database Cloud SQL e hai configurato l'account di servizio App Engine in modo che abbia le autorizzazioni per connettersi a Cloud SQL puoi configurare ed eseguire il deployment di un'app di esempio per connetterti all'istanza Cloud SQL.

IP pubblico

Per i percorsi IP pubblici, l'ambiente flessibile di App Engine fornisce la crittografia. Questo utilizza un socket Unix e il proxy di autenticazione Cloud SQL per connettersi all'istanza Cloud SQL.

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 scarica il codice dell'app di esempio e apri la directory dell'app di esempio nell'editor di Cloud Shell.
3. Al prompt dei comandi di Cloud Shell, esegui il seguente comando per attivare il progetto:

   gcloud config set project YOUR-PROJECT-ID

   Nota: sostituisci YOUR-PROJECT-ID con l'ID del tuo progetto.
4. Se viene visualizzata la finestra di dialogo Autorizza Cloud Shell, fai clic su Autorizza.
5. Nel menu di navigazione Explorer dell'editor di Cloud Shell, fai clic sul nodo espandibile che corrisponde al nome utente del tuo account Google Cloud.
6. Individua e apri il file cloudshell_open/golang-samples/cloudsql/postgres/database-sql/app.flexible.yaml.
7. Sostituisci i segnaposto per le variabili di ambiente nella app.flexible.yaml con i seguenti valori:
• <PROJECT-ID> con il tuo ID progetto.
• <INSTANCE-REGION> con us-central1.
• <INSTANCE-NAME> con quickstart-instance.
• &lt;YOUR_DB_USER_NAME&gt; con quickstart-user.
• <YOUR_DB_PASSWORD> con la password dell'quickstart-user che hai creato in Creare un utente.
• &lt;YOUR_DB_NAME&gt; con quickstart-db.
8. Nel prompt dei comandi di Cloud Shell, cloudshell_open/golang-samples/cloudsql/postgres/database-sql, esegui questo comando gcloud app deploy per eseguire il deployment dell'app di esempio nell'ambiente flessibile di App Engine.

gcloud app deploy app.flexible.yaml

9. Quando ti viene richiesto Vuoi continuare?, inserisci Y.
10. Al termine delle azioni eseguite eseguendo il comando gcloud app deploy, esegui il comando gcloud app browse:

gcloud app browse

11. Fai clic sul link generato per visualizzare l'app di esempio in esecuzione nell'ambiente flessibile di App Engine. Questo ambiente è connesso a Cloud 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 relativa directory nell'editor di Cloud Shell.
3. Nel prompt dei comandi di Cloud Shell, esegui questo comando per attivare il progetto:

   gcloud config set project YOUR-PROJECT-ID

   Nota: sostituisci YOUR-PROJECT-ID con il tuo ID progetto.
4. Se viene visualizzata la finestra di dialogo Autorizza Cloud Shell, fai clic su Autorizza.
5. Nel menu di navigazione Explorer dell'editor di Cloud Shell, fai clic sul nodo espandibile che corrisponde al nome utente del tuo account Google Cloud.
6. Individua e apri il file cloudshell_open/java-docs-samples/cloud-sql/postgres/servlet/src/main/webapp/WEB-INF/appengine-web.xml.
7. Sostituisci i segnaposto per le variabili di ambiente nella appengine-web.xml con i seguenti valori:
• my-project:region:instance con il Nome connessione dell'istanza che compare nelle istanze di Cloud SQL nella console Google Cloud.
• my-db-user con quickstart-user.
• my-db-password con la password del quickstart-user creato in Crea un utente.
• my_db con quickstart-db.
8. Al prompt dei comandi di Cloud Shell, nella directory cloudshell_open/java-docs-samples/cloud-sql/postgres/servlet, esegui il seguente comando Apache Maven mvn clean package per eseguire il deployment dell'app di esempio nell'ambiente flessibile di App Engine.

mvn clean package appengine:deploy -DskipTests

9. Quando ti viene chiesto Vuoi continuare?, inserisci Y.
10. Dopo le azioni eseguite eseguendo il comando gcloud app deploy completato, esegui gcloud app browse :

gcloud app browse

11. Fai clic sul link generato per visualizzare l'app di esempio in esecuzione nell'ambiente flessibile di App Engine. Questo ambiente è connesso a Cloud SQL.

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 scarica il codice dell'app di esempio e apri la directory dell'app di esempio nell'editor di Cloud Shell.
3. Nel prompt dei comandi di Cloud Shell, esegui questo comando per attivare il progetto:

   gcloud config set project YOUR-PROJECT-ID

   Nota: sostituisci YOUR-PROJECT-ID con l'ID del tuo progetto.
4. Se viene visualizzata la finestra di dialogo Autorizza Cloud Shell, fai clic su Autorizza.
5. Nel menu di navigazione Explorer dell'editor di Cloud Shell, fai clic sul nodo espandibile che corrisponde al nome utente del tuo account Google Cloud.
6. Individua e apri il file cloudshell_open/nodejs-docs-samples/cloud-sql/postgres/knex/app.flexible.yaml.
7. Sostituisci i segnaposto per le variabili di ambiente nel file app.flexible.yaml con i seguenti valori:
• <MY-PROJECT> con il tuo ID progetto.
• &lt;INSTANCE-REGION&gt; con us-central1.
• &lt;INSTANCE-NAME&gt; con quickstart-instance.
• MY_DB_USER con quickstart-user.
• MY_DB_PASSWORD con la password del quickstart-user creato in Crea un utente.
• MY_DATABASE con quickstart-db.
8. Al prompt dei comandi di Cloud Shell, nella directory cloudshell_open/nodejs-docs-samples/cloud-sql/postgres/knex, esegui il seguente gcloud app deploy comando per eseguire il deployment dell'app di esempio nell'ambiente flessibile di App Engine.

gcloud app deploy app.flexible.yaml

9. Quando ti viene chiesto Vuoi continuare?, inserisci Y.
10. Dopo le azioni eseguite eseguendo il comando gcloud app deploy completato, esegui gcloud app browse :

gcloud app browse

11. Fai clic sul link generato per visualizzare l'app di esempio in esecuzione nell'ambiente flessibile di App Engine. Questo ambiente è connesso a Cloud 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 relativa directory nell'editor di Cloud Shell.
3. Nel prompt dei comandi di Cloud Shell, esegui questo comando per attivare il progetto:

   gcloud config set project YOUR-PROJECT-ID

   Nota: sostituisci YOUR-PROJECT-ID con l'ID del tuo progetto.
4. Se viene visualizzata la finestra di dialogo Autorizza Cloud Shell, fai clic su Autorizza.
5. Nel menu di navigazione Explorer dell'editor di Cloud Shell, fai clic sul nodo espandibile che corrisponde al nome utente del tuo account Google Cloud.
6. Individua e apri il file cloudshell_open/python-docs-samples/cloud-sql/postgres/sqlalchemy/app.flexible.yaml.
7. Sostituisci i segnaposto per le variabili di ambiente nel file app.flexible.yaml con i seguenti valori:
• &lt;PROJECT-ID&gt; con il tuo ID progetto.
• <INSTANCE-REGION> con us-central1.
• <INSTANCE-NAME> con quickstart-instance.
• <YOUR_DB_USER_NAME> con quickstart-user.
• &lt;YOUR_DB_PASSWORD&gt; con la password del quickstart-user creato in Crea un utente.
• &lt;YOUR_DB_NAME&gt; con quickstart-db.
8. Nel prompt dei comandi di Cloud Shell, cloudshell_open/python-docs-samples/cloud-sql/postgres/sqlalchemy, esegui questo comando gcloud app deploy per eseguire il deployment dell'app di esempio nell'ambiente flessibile di App Engine.

gcloud app deploy app.flexible.yaml

9. Quando ti viene richiesto Vuoi continuare?, inserisci Y.
10. Al termine delle azioni eseguite eseguendo il comando gcloud app deploy, esegui il comando gcloud app browse:

gcloud app browse

11. Fai clic sul link generato per visualizzare l'app di esempio in esecuzione nell'ambiente flessibile di App Engine. Questo ambiente è connesso a Cloud SQL.

IP privato

Per i percorsi IP privati, assicurati che la VM dell'ambiente flessibile di App Engine e l'istanza Cloud SQL siano ospitate sulla stessa rete Virtual Private Cloud (VPC). Se si trova nella stessa rete VPC, la tua app App Engine Flexible Environment può connettersi direttamente all'istanza Cloud SQL senza utilizzare il proxy di autenticazione Cloud SQL.

Vai

Creazione e download di 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. Quindi, fai clic su Chiudi.

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

Crea 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 scarica il codice dell'app di esempio e apri la directory dell'app di esempio nell'editor di Cloud Shell.
3. Al prompt dei comandi di Cloud Shell, esegui il seguente comando per attivare il progetto:

   gcloud config set project YOUR-PROJECT-ID

   Nota: sostituisci YOUR-PROJECT-ID con l'ID del tuo progetto.
4. Se viene visualizzata la finestra di dialogo Autorizza Cloud Shell, fai clic su Autorizza.
5. Carica i file dei certificati SSL nella cartella certs.
   1. Dal menu di navigazione Explorer dell'editor di Cloud Shell, passa alla golang-samples/cloudsql/postgres/database-sql/certs cartella.
   2. Fai clic con il tasto destro del mouse sulla cartella certs nell'editor di Cloud Shell e seleziona Carica file.
   3. Seleziona i seguenti file sul computer locale:
   • client-key.pem
   • client-cert.pem
   • server-ca.pem
   4. Con i tre file dei certificati SSL selezionati, fai clic su Apri per completare il processo di caricamento dei file nell'editor di Cloud Shell.
6. Nel menu di navigazione Explorer dell'editor di Cloud Shell, fai clic sul nodo espandibile che corrisponde al nome utente del tuo account Google Cloud.
7. Individua e apri il file cloudshell_open/golang-samples/cloudsql/postgres/database-sql/app.flexible.yaml.
8. Copia e incolla il seguente codice nel file, sostituendo i contenuti esistenti:

runtime: custom
env: flex

env_variables:
  DB_USER: quickstart-user
  DB_PASS: YOUR_DB_PASSWORD
  DB_NAME: quickstart-db
  DB_PORT: 3306
  INSTANCE_HOST: INSTANCE_HOST
  DB_ROOT_CERT: certs/server-ca.pem
  DB_CERT: certs/client-cert.pem
  DB_KEY: certs/client-key.pem
  PRIVATE_IP: TRUE

vpc_access_connector:
  name: projects/PROJECT_ID/locations/us-central1/connectors/quickstart-connector

9. Apporta le seguenti sostituzioni delle variabili:
• YOUR_DB_PASSWORD con la password di quickstart-user che hai creato in Creare un utente.
• INSTANCE_HOST con l'indirizzo IP privato dell'istanza visualizzato nella pagina Istanze Cloud SQL nella console Google Cloud.
• PROJECT_ID con l'ID progetto.
10. Al prompt dei comandi di Cloud Shell, nella directory cloudshell_open/golang-samples/cloudsql/postgres/database-sql, esegui il seguente gcloud app deploy comando per eseguire il deployment dell'app di esempio nell'ambiente flessibile di App Engine.

gcloud app deploy app.flexible.yaml

11. Quando ti viene chiesto Vuoi continuare?, inserisci Y.
12. Dopo le azioni eseguite eseguendo il comando gcloud app deploy completato, esegui gcloud app browse :

gcloud app browse

13. Fai clic sul link generato per visualizzare l'app di esempio in esecuzione nell'ambiente flessibile di App Engine. Questo ambiente è connesso a Cloud SQL.

Java

Crea e scarica certificati client e server SSL

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

Crea 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 scarica il codice dell'app di esempio e apri la directory dell'app di esempio nell'editor di Cloud Shell.
3. Nel prompt dei comandi di Cloud Shell, esegui questo comando per attivare il progetto:

   gcloud config set project YOUR-PROJECT-ID

   Nota: sostituisci YOUR-PROJECT-ID con l'ID del tuo progetto.
4. Se viene visualizzata la finestra di dialogo Autorizza Cloud Shell, fai clic su Autorizza.
5. Nel menu di navigazione Explorer dell'editor di Cloud Shell, fai clic sul nodo espandibile che corrisponde al nome utente del tuo account Google Cloud.
6. Individua e apri il file cloudshell_open/java-docs-samples/cloud-sql/postgres/servlet/src/main/webapp/WEB-INF/appengine-web.xml.
7. Copia e incolla il seguente codice nel appengine-web.xml file, sostituendo i contenuti esistenti del file:

<runtime>java17</runtime>
  <env-variables>
    <env-var name="INSTANCE_CONNECTION_NAME" value="project-name:region-name:instance-name" />
    <env-var name="DB_PORT" value="5432" />
    <env-var name="DB_USER" value="quickstart-user" />
    <env-var name="DB_PASS" value="my-db-password" />
    <env-var name="DB_NAME" value="quickstart-db" />
  </env-variables>
<vpc-access-connector>
  <name>projects/PROJECT_ID/locations/us-central1/connectors/quickstart-connector</name>
  <egress-setting>all-traffic</egress-setting>
</vpc-access-connector>

8. Apporta le seguenti sostituzioni delle variabili:
• project-name:region-name:instance-name con il nome della connessione dell'istanza visualizzato nella pagina Istanze Cloud SQL della console Google Cloud.
• my-db-password con la password di quickstart-user che hai creato in Creare un utente.
• PROJECT_ID con l'ID progetto.
9. Nel prompt dei comandi di Cloud Shell, cloudshell_open/java-docs-samples/cloud-sql/postgres/servlet, esegui questo comando Apache Maven Comando mvn clean package per eseguire il deployment dell'app di esempio nell'ambiente flessibile di App Engine.

mvn clean package appengine:deploy -DskipTests

10. Quando ti viene richiesto Vuoi continuare?, inserisci Y.
11. Dopo le azioni eseguite eseguendo il comando gcloud app deploy completato, esegui gcloud app browse :

gcloud app browse

12. Fai clic sul link generato per visualizzare l'app di esempio in esecuzione nell'ambiente flessibile di App Engine. Questo ambiente è connesso a Cloud SQL.

Node.js

Creazione e download di 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. Quindi, fai clic su Chiudi.

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

Crea 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. Nel prompt dei comandi di Cloud Shell, esegui questo comando per attivare il progetto:

   gcloud config set project YOUR-PROJECT-ID

   Nota: sostituisci YOUR-PROJECT-ID con il tuo ID progetto.
4. Se viene visualizzata la finestra di dialogo Autorizza Cloud Shell, fai clic su Autorizza.
5. Carica i file dei certificati SSL nella cartella certs.
   1. Dal menu di navigazione Explorer dell'editor di Cloud Shell, passa alla nodejs-docs-samples/cloud-sql/postgres/knex/certs cartella.
   2. Fai clic con il tasto destro del mouse sulla cartella certs nell'editor di Cloud Shell e seleziona Carica file
   3. Seleziona i seguenti file sul computer locale:
   • client-key.pem
   • client-cert.pem
   • server-ca.pem
   4. Con i tre file dei certificati SSL selezionati, fai clic su Apri per completare il processo di caricamento dei file nell'editor di Cloud Shell.
6. Nel menu di navigazione Explorer dell'editor di Cloud Shell, fai clic sul nodo espandibile che corrisponde al nome utente del tuo account Google Cloud.
7. Individua e apri il file cloudshell_open/nodejs-docs-samples/cloud-sql/postgres/knex/app.flexible.yaml.
8. Copia e incolla il codice seguente nel file, sostituendo il contenuto del file esistente:

runtime: nodejs
env: flex

env_variables:
  DB_USER: quickstart-user
  DB_PASS: MY_DB_PASSWORD
  DB_NAME: quickstart-db
  DB_PORT: 5432
  INSTANCE_HOST: INSTANCE_HOST
  DB_ROOT_CERT: certs/server-ca.pem
  DB_CERT: certs/client-cert.pem
  DB_KEY: certs/client-key.pem
  PRIVATE_IP: TRUE

vpc_access_connector:
  name: projects/PROJECT_ID/locations/us-central1/connectors/quickstart-connector

9. Apporta le seguenti sostituzioni delle variabili:
• MY_DB_PASSWORD con la password del quickstart-user creato in Crea un utente.
• INSTANCE_HOST con l'indirizzo IP privato dell'istanza visualizzato nella pagina Istanze Cloud SQL nella console Google Cloud.
• PROJECT_ID con l'ID progetto.
10. Al prompt dei comandi di Cloud Shell, nella directory cloudshell_open/nodejs-docs-samples/cloud-sql/postgres/knex, esegui il seguente gcloud app deploy comando per eseguire il deployment dell'app di esempio nell'ambiente flessibile di App Engine.

gcloud app deploy app.flexible.yaml

11. Quando ti viene chiesto Vuoi continuare?, inserisci Y.
12. Al termine delle azioni eseguite eseguendo il comando gcloud app deploy, esegui il comando gcloud app browse:

gcloud app browse

13. Fai clic sul link generato per visualizzare l'app di esempio in esecuzione nell'ambiente flessibile di App Engine. Questo ambiente è connesso a Cloud SQL.

Python

Creazione e download di 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 relativa 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. Quindi, fai clic su Chiudi.

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

Crea 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. Al prompt dei comandi di Cloud Shell, esegui il seguente comando per attivare il progetto:

   gcloud config set project YOUR-PROJECT-ID

   Nota: sostituisci YOUR-PROJECT-ID con il tuo ID progetto.
4. Se viene visualizzata la finestra di dialogo Autorizza Cloud Shell, fai clic su Autorizza.
5. Carica i file dei certificati SSL nella cartella certs.
   1. Dal menu di navigazione Explorer dell'editor di Cloud Shell, passa alla python-docs-samples/cloud-sql/postgres/sqlalchemy/certs cartella.
   2. Fai clic con il tasto destro del mouse sulla cartella certs nell'editor di Cloud Shell e seleziona Carica file
   3. Seleziona i seguenti file sul computer locale:
   • client-key.pem
   • client-cert.pem
   • server-ca.pem
   4. Con i tre file dei certificati SSL selezionati, fai clic su Apri per completare il processo di caricamento dei file nell'editor di Cloud Shell.
6. Nel menu di navigazione Explorer dell'editor di Cloud Shell, fai clic sul nodo espandibile che corrisponde al nome utente del tuo account Google Cloud.
7. Individua e apri il file cloudshell_open/python-docs-samples/cloud-sql/postgres/sqlalchemy/app.flexible.yaml.
8. Copia e incolla il seguente codice nel file, sostituendo i contenuti esistenti del file:

runtime: custom
env: flex
entrypoint: gunicorn -b :$PORT app:appentrypoint: gunicorn -b :$PORT app:app

env_variables:
  DB_USER: quickstart-user
  DB_PASS: YOUR_DB_PASSWORD
  DB_NAME: quickstart-db
  DB_PORT: 5432
  INSTANCE_HOST: INSTANCE_HOST
  DB_ROOT_CERT: certs/server-ca.pem
  DB_CERT: certs/client-cert.pem
  DB_KEY: certs/client-key.pem
  PRIVATE_IP: TRUE

vpc_access_connector:
  name: projects/PROJECT_ID/locations/us-central1/connectors/quickstart-connector

9. Apporta le seguenti sostituzioni delle variabili:
• YOUR_DB_PASSWORD con la password del quickstart-user creato in Crea un utente.
• INSTANCE_HOST con l'indirizzo IP privato della tua istanza che compare nelle istanze di Cloud SQL nella console Google Cloud.
• PROJECT_ID con il tuo ID progetto.
10. Nel prompt dei comandi di Cloud Shell, cloudshell_open/python-docs-samples/cloud-sql/postgres/sqlalchemy, esegui questo comando gcloud app deploy per eseguire il deployment dell'app di esempio nell'ambiente flessibile di App Engine.

gcloud app deploy app.flexible.yaml

11. Quando ti viene richiesto Vuoi continuare?, inserisci Y.
12. Al termine delle azioni eseguite eseguendo il comando gcloud app deploy, esegui il comando gcloud app browse:

gcloud app browse

13. Fai clic sul link generato per visualizzare l'app di esempio in esecuzione nell'ambiente flessibile di App Engine. Questo ambiente è connesso 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. La disattivazione dell'app ne impedisce l'esecuzione delle istanze e la gestione delle richieste. Se la tua app sta elaborando una richiesta, l'app completa la richiesta prima di essere disattivata.

Per disabilitare un'app di App Engine e conservare i relativi dati, procedi nel seguente modo: seguenti:

1. Nella console Google Cloud, vai alla pagina Impostazioni:

   Vai alle impostazioni

2. Nella scheda Impostazioni applicazione, fai clic su Disabilita applicazione.

3. Nel campo ID app, inserisci l'ID dell'app che vuoi disattivare e quindi fai clic su Disattiva.

Passaggi facoltativi di pulizia

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

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

   Vai a IAM

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

Se non utilizzi le API abilitate in questa guida rapida, puoi disattivarle.

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

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

   Vai alle API

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

Passaggi successivi

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

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

Per ulteriori informazioni sui prezzi, consulta la pagina Prezzi di Cloud SQL per PostgreSQL.

Scopri di più su:

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

Inoltre, puoi scoprire come connetterti a un'istanza Cloud SQL da altri prodotti Google Cloud:

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