Connettiti a Cloud SQL per PostgreSQL dal computer locale

Connettiti a Cloud SQL per PostgreSQL dal computer locale

MySQL   |  PostgreSQL   |  SQL Server

Scopri come eseguire il deployment di un'app di esempio sul computer locale Linux, macOS o Windows connesso a un'istanza PostgreSQL utilizzando la console Google Cloud e un'applicazione client.

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

Prima di iniziare

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

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

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

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

   Go to project selector

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

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

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

   Go to project selector

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

6. Abilita le API Cloud necessarie per eseguire un'app di esempio Cloud SQL sul tuo computer locale.

   Console

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

   Abilita le API

   Vengono abilitate le seguenti API:

   • API Cloud SQL Admin
   • API IAM

   gcloud

   Installa gcloud CLI, che fornisce accesso da riga di comando alle tue Google Cloud risorse. L'interfaccia a riga di comando gcloud viene utilizzata per eseguire i comandi gcloud CLI presentati in questa guida rapida. Tutti i comandi sono formattati per essere eseguiti in un terminale Linux/macOS o in Windows Powershell.

   Apri il terminale ed esegui il seguente comando gcloud:

   gcloud services enable sqladmin.googleapis.com iam.googleapis.com

   Questo comando abilita le seguenti API:

   • API Cloud SQL Admin
   • API IAM

Configura Cloud SQL

Crea un'istanza Cloud SQL

Console

Creare un'istanza con un indirizzo IP pubblico

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. Inserisci quickstart-instance in ID istanza.
5. Inserisci una password per l'utente postgres. Salva questa password per utilizzarla in futuro.
6. Fai clic sull'opzione Zona singola per Scegli la disponibilità per regione e zona.
7. Fai clic ed espandi la sezione Mostra opzioni di configurazione.
8. Nel menu a discesa Tipo di macchina, seleziona Leggera.

9. Fai clic su Crea istanza e attendi fino all'inizializzazione e all'avvio dell'istanza.

gcloud

Creare un'istanza con un indirizzo IP pubblico

Prima di eseguire il comando gcloud sql instances create come indicato di seguito, 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 da impostare nella macchina.
• --memory: valore intero che indica la quantità di memoria da impostare nella macchina. Deve essere fornita una unità di misura (ad es. 3072 MB o 9 GB). Se non vengono specificate unità di misura, viene assunto il valore GB.
• --region: posizione regionale dell'istanza (ad esempio asia-east1, us-east1). Se non specificato, viene utilizzato il valore predefinito us-central. Consulta l'elenco completo delle regioni.

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

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

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. Apri la scheda Database.
4. Fai clic su Crea database.
1. Nella finestra di dialogo Nuovo database, inserisci quickstart_db come nome del database.
   
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. 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.
5. Nella pagina Aggiungi un account utente all'istanza instance_name, aggiungi le seguenti informazioni:
   • Nel campo Nome utente, inserisci quickstart-user
   • Nel campo Password, specifica una password per l'utente del database. Prendi nota di questo valore per utilizzarlo in un passaggio successivo di questa guida rapida.
6. Fai clic su Aggiungi.

gcloud

Sostituisci quanto segue:

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.

Configurare un account di servizio

Crea e configura un Google Cloud account di servizio con il ruolo Client Cloud SQL con autorizzazioni per connettersi a Cloud SQL. Dopo aver creato un account di servizio, potrebbe essere necessario attendere almeno 60 secondi prima di utilizzarlo.

Console

Crea un account di servizio

1. Nella console Google Cloud, vai alla pagina Crea account di servizio.

Vai a Crea account di servizio

2. Seleziona un progetto Google Cloud.
3. Inserisci quickstart-service-account come nome dell'account di servizio.
4. (Facoltativo) Inserisci una descrizione dell'account di servizio.
5. Fai clic su Crea e continua e vai al passaggio successivo.
6. Scegli il ruolo Client Cloud SQL da concedere all'account di servizio nel progetto.
7. Fai clic su Continua.
8. Fai clic su Fine per completare la creazione dell'account di servizio.

Crea e scarica il file della chiave dell'account di servizio

1. Nella console Google Cloud, vai alla pagina Account di servizio.

Vai ad Account di servizio

2. Seleziona un progetto.
3. Fai clic sull'indirizzo email dell'account di servizio quickstart-service-account per cui vuoi creare una chiave.
4. Fai clic sulla scheda Chiavi.
5. Fai clic sul menu a discesa Aggiungi chiave, quindi seleziona Crea nuova chiave.
6. In Tipo di chiave, seleziona JSON e fai clic su Crea.

Facendo clic su Crea viene scaricato un file della chiave del service account. Una volta scaricato, il file della chiave non potrà essere scaricato di nuovo.

Assicurati di archiviare il file della chiave in modo sicuro perché può essere utilizzato per l'autenticazione come account di servizio. Puoi spostare e rinominare il file come preferisci.

gcloud

Crea un account di servizio

1. Per creare l'account di servizio, esegui il comando gcloud iam service-accounts create:

gcloud iam service-accounts create quickstart-service-account --description="DESCRIPTION" --display-name="quickstart-service-account"

Sostituisci il seguente valore:

• DESCRIPTION: una descrizione facoltativa dell'account di servizio
2. Per concedere al tuo account di servizio il ruolo Client Cloud SQL nel progetto, esegui il comando gcloud projects add-iam-policy-binding Sostituisci PROJECT_ID con l'ID del tuo progetto Google Cloud:

   gcloud projects add-iam-policy-binding PROJECT_ID --member="serviceAccount:quickstart-service-account@PROJECT_ID.iam.gserviceaccount.com" --role="roles/cloudsql.client"

Crea e scarica il file della chiave dell'account di servizio

Per utilizzare l'account di servizio che hai appena creato dal computer locale, devi avere un file della chiave dell'account di servizio per autenticare l'applicazione di esempio come account di servizio. Per creare e scaricare il file della chiave dell'account di servizio, esegui il comando gcloud iam service-accounts keys create:

gcloud iam service-accounts keys create KEY_FILE --iam-account=quickstart-service-account@PROJECT_ID.iam.gserviceaccount.com

Sostituisci i seguenti valori:

• KEY_FILE: il percorso di un nuovo file di output per la chiave privata, ad esempio ~/sa-private-key.json.
• PROJECT_ID: l'ID del tuo progetto Google Cloud.

Il file della chiave dell'account di servizio viene scaricato sul computer locale. Una volta scaricato, il file della chiave non potrà essere scaricato di nuovo.

Assicurati di archiviare il file della chiave in modo sicuro perché chiunque può utilizzarlo per autenticarsi come tuo account di servizio. Puoi spostare e rinominare il file come preferisci.

Configurare l'ambiente di sviluppo per il linguaggio di programmazione

Configura l'ambiente di sviluppo del computer locale per il linguaggio di programmazione che preferisci.

Vai

Completa i seguenti passaggi per configurare l'ambiente di sviluppo in modo da eseguire l'app di esempio Go.

1. Vai alla guida alla configurazione di un ambiente di sviluppo Go.
2. Segui le istruzioni nella sezione Installare Go.

Java

Completa i seguenti passaggi per configurare l'ambiente di sviluppo in modo da eseguire l'app di esempio Java.

1. Vai alla guida alla configurazione di un ambiente di sviluppo Java.
2. Segui le istruzioni nella sezione Installa un JDK (Java Development Kit).
3. Completa le istruzioni riportate in Installare uno strumento di automazione della compilazione per configurare Apache Maven.

Node.js

Completa i seguenti passaggi per configurare l'ambiente di sviluppo per l'esecuzione dell'app di esempio Node.js.

1. Vai alla guida alla configurazione di un ambiente di sviluppo Node.js.
2. Segui le istruzioni riportate nella sezione Installazione di Node.js e npm.

Python

Completa i seguenti passaggi per configurare l'ambiente di sviluppo per l'esecuzione dell'app di esempio Python.

1. Vai alla guida alla configurazione di un ambiente di sviluppo Python.
2. Segui le istruzioni nella sezione Installazione di Python.

Installa Git

Installa Git, un sistema di controllo della versione open source.

Linux

Segui la documentazione ufficiale sull'installazione di Git per Linux.

macOS

Segui la documentazione ufficiale sull'installazione di Git per macOS.

Windows

Segui la documentazione ufficiale di installazione di Git per Windows.

Clona un'app di esempio

Clona un'app di esempio sul computer locale utilizzando il comando git clone.

Vai

Esegui i comandi seguenti per clonare l'app di esempio Go sul tuo computer locale e passa alla directory contenente l'app di esempio.

1. Clona l'app di esempio.

   git clone https://github.com/GoogleCloudPlatform/golang-samples

2. Cambia directory in quella contenente l'app di esempio.

   cd golang-samples/cloudsql/postgres/database-sql

Java

Esegui i comandi seguenti per clonare l'app di esempio Java sul tuo computer locale e passare alla directory contenente l'app di esempio.

1. Clona l'app di esempio.

   git clone https://github.com/GoogleCloudPlatform/java-docs-samples

2. Cambia directory in quella contenente l'app di esempio.

   cd java-docs-samples/cloud-sql/postgres/servlet

Node.js

Esegui i comandi seguenti per clonare l'app di esempio Node.js sul tuo computer locale e passa alla directory contenente l'app di esempio.

1. Clona l'app di esempio.

   git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples

2. Cambia directory in quella contenente l'app di esempio.

   cd nodejs-docs-samples/cloud-sql/postgres/knex

Python

Esegui i comandi seguenti per clonare l'app di esempio Python sul tuo computer locale e passare alla directory contenente l'app di esempio.

1. Clona l'app di esempio.

   git clone https://github.com/GoogleCloudPlatform/python-docs-samples

2. Cambia directory in quella contenente l'app di esempio.

   cd python-docs-samples/cloud-sql/postgres/sqlalchemy

Configura ed esegui l'app di esempio

Configura ed esegui l'app di esempio.

Linux/macOS

Vai

Apri il terminale ed esegui i seguenti comandi per inizializzare le variabili di ambiente necessarie per eseguire l'app di esempio. Prima di eseguire i comandi, apporta le seguenti sostituzioni:

• CREDENTIALS_JSON_FILE con il percorso del file della chiave delle credenziali JSON del tuo account di servizio utilizzando un formato come /path/to/service/account/key.json.
• INSTANCE_CONNECTION_NAME con il nome connessione dell'istanza visualizzato nella pagina Panoramica dell'istanza Cloud SQL.
• YOUR_DB_PASSWORD con la password di quickstart-user che hai creato nel passaggio precedente della procedura di creazione di un utente.

export GOOGLE_APPLICATION_CREDENTIALS=CREDENTIALS_JSON_FILE
export INSTANCE_CONNECTION_NAME='INSTANCE_CONNECTION_NAME'
export DB_PORT='5432'
export DB_NAME='quickstart_db'
export DB_USER='quickstart-user'
export DB_PASS='YOUR_DB_PASSWORD'

Esegui i comandi seguenti per installare le dipendenze dell'app di esempio Go sul tuo computer locale ed esegui l'app di esempio.

1. Ottieni le dipendenze necessarie per eseguire l'app di esempio.

   go get ./...

2. Esegui l'app di esempio.

   go run cmd/app/main.go

3. Visualizza l'app di esempio in esecuzione. Apri una finestra del browser e vai a http://127.0.0.1:8080.

   

4. Per interrompere l'app di esempio, premi Ctrl+C nella finestra del terminale in cui hai avviato l'app di esempio.

Java

Esegui i seguenti comandi per inizializzare le variabili di ambiente necessarie per eseguire l'app di esempio. Prima di eseguire i comandi, effettua le seguenti sostituzioni:

• CREDENTIALS_JSON_FILE con il percorso del file della chiave delle credenziali JSON del tuo account di servizio utilizzando un formato come /path/to/service/account/key.json.
• INSTANCE_CONNECTION_NAME con il nome connessione dell'istanza visualizzato nella pagina Panoramica dell'istanza Cloud SQL.
• YOUR_DB_PASSWORD con la password di quickstart-user che hai creato nel passaggio precedente della procedura di creazione di un utente.

export GOOGLE_APPLICATION_CREDENTIALS=CREDENTIALS_JSON_FILE
export INSTANCE_CONNECTION_NAME='INSTANCE_CONNECTION_NAME'
export DB_PORT='5432'
export DB_NAME='quickstart_db'
export DB_USER='quickstart-user'
export DB_PASS='YOUR_DB_PASSWORD'

1. Esegui il comando seguente per ottenere le dipendenze dell'app di esempio Java sul tuo computer locale ed esegui l'app di esempio.

   mvn jetty:run

2. Visualizza l'app di esempio in esecuzione. Apri una finestra del browser e vai a http://127.0.0.1:8080.

   

3. Per interrompere l'app di esempio, premi Ctrl+C nella finestra del terminale in cui hai avviato l'app di esempio.

Node.js

1. Esegui i seguenti comandi per inizializzare le variabili di ambiente necessarie per eseguire l'app di esempio. Prima di eseguire i comandi, effettua le seguenti sostituzioni:

   • CREDENTIALS_JSON_FILE con il percorso del file della chiave delle credenziali JSON del tuo account di servizio utilizzando un formato come /path/to/service/account/key.json.
   • YOUR_DB_PASSWORD con la password di quickstart-user che hai creato nel passaggio precedente della procedura di creazione di un utente.

   export GOOGLE_APPLICATION_CREDENTIALS=CREDENTIALS_JSON_FILE
   export INSTANCE_HOST='127.0.0.1'
   export DB_PORT='5432'
   export DB_NAME='quickstart_db'
   export DB_USER='quickstart-user'
   export DB_PASS='YOUR_DB_PASSWORD'

2. Scarica il proxy di autenticazione Cloud SQL.

   curl -o cloud-sql-proxy \
   https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.0.0/cloud-sql-proxy.linux.amd64

3. Esegui il proxy di autenticazione Cloud SQL come processo in background. Sostituisci INSTANCE_CONNECTION_NAME con il nome connessione dell'istanza visualizzato nella pagina Panoramica dell'istanza Cloud SQL.

   ./cloud-sql-proxy \
   --credentials-file $GOOGLE_APPLICATION_CREDENTIALS \
   INSTANCE_CONNECTION_NAME &

Nota: il processo che esegue il proxy di autenticazione Cloud SQL in background può essere interrotto utilizzando il comando fg nella finestra del terminale in cui hai avviato l'app di esempio. In questo modo, il job del proxy di autenticazione Cloud SQL in esecuzione dovrebbe essere visualizzato in primo piano nel terminale. Quindi premi Ctrl+C per arrestare il job proxy.

Esegui i comandi seguenti per installare i pacchetti Node.js richiesti sul tuo computer locale ed eseguire l'app di esempio.

1. Installa i pacchetti Node.js necessari per eseguire l'app in locale.

   npm install

2. Esegui l'app di esempio.

   npm start

3. Visualizza l'app di esempio in esecuzione. Apri una finestra del browser e vai a http://127.0.0.1:8080.

   

4. Per interrompere l'app di esempio, premi Ctrl+C nella finestra del terminale in cui hai avviato l'app di esempio.

Python

Esegui i seguenti comandi per inizializzare le variabili di ambiente necessarie per eseguire l'app di esempio. Prima di eseguire i comandi, effettua le seguenti sostituzioni:

• CREDENTIALS_JSON_FILE con il percorso del file della chiave delle credenziali JSON del tuo account di servizio utilizzando un formato come /path/to/service/account/key.json.
• INSTANCE_CONNECTION_NAME con il nome connessione dell'istanza visualizzato nella pagina Panoramica dell'istanza Cloud SQL.
• YOUR_DB_PASSWORD con la password di quickstart-user che hai creato nel passaggio precedente della procedura di creazione di un utente.

export GOOGLE_APPLICATION_CREDENTIALS=CREDENTIALS_JSON_FILE
export INSTANCE_CONNECTION_NAME='INSTANCE_CONNECTION_NAME'
export DB_PORT='5432'
export DB_NAME='quickstart_db'
export DB_USER='quickstart-user'
export DB_PASS='YOUR_DB_PASSWORD'

Esegui i comandi seguenti per installare i requisiti dell'app di esempio Python sul computer locale ed esegui l'app di esempio.

1. Inizializza un ambiente virtuale e installa i requisiti per eseguire l'app di esempio.

   python3 -m venv env
   source env/bin/activate
   pip install -r requirements.txt

2. Esegui l'app di esempio.

   python app.py

3. Visualizza l'app di esempio in esecuzione. Apri una finestra del browser e vai a http://127.0.0.1:8080.

   

4. Per interrompere l'app di esempio, premi Ctrl+C nella finestra del terminale in cui hai avviato l'app di esempio.

Windows

Vai

Esegui i seguenti comandi per inizializzare le variabili di ambiente necessarie per eseguire l'app di esempio. Prima di eseguire i comandi, effettua le seguenti sostituzioni:

• CREDENTIALS_JSON_FILE con il percorso del file della chiave delle credenziali JSON del tuo account di servizio utilizzando un formato come C:\Users\Your-Username\Downloads\key.json.
• INSTANCE_CONNECTION_NAME con il nome connessione dell'istanza visualizzato nella pagina Panoramica dell'istanza Cloud SQL.
• YOUR_DB_PASSWORD con la password di quickstart-user che hai creato nel passaggio precedente della procedura di creazione di un utente.

$env:GOOGLE_APPLICATION_CREDENTIALS="CREDENTIALS_JSON_FILE"
$env:INSTANCE_CONNECTION_NAME="INSTANCE_CONNECTION_NAME"
$env:DB_PORT="5432"
$env:DB_NAME="quickstart_db"
$env:DB_USER="quickstart-user"
$env:DB_PASS="YOUR_DB_PASSWORD"

Esegui i comandi seguenti per installare le dipendenze dell'app di esempio Go sul tuo computer locale ed esegui l'app di esempio.

1. Ottieni le dipendenze necessarie per eseguire l'app di esempio.

   go get ./...

2. Esegui l'app di esempio.

   go run cmd\app\main.go

3. Visualizza l'app di esempio in esecuzione. Apri una finestra del browser e vai a http://127.0.0.1:8080.

   

4. Per interrompere l'app di esempio, premi Control+C nella finestra di PowerShell in cui hai avviato l'app di esempio.

Java

Esegui i seguenti comandi per inizializzare le variabili di ambiente necessarie per eseguire l'app di esempio. Prima di eseguire i comandi, effettua le seguenti sostituzioni:

• CREDENTIALS_JSON_FILE con il percorso del file della chiave delle credenziali JSON del tuo account di servizio utilizzando un formato come C:\Users\Your-Username\Downloads\key.json.
• INSTANCE_CONNECTION_NAME con il nome connessione dell'istanza visualizzato nella pagina Panoramica dell'istanza Cloud SQL.
• YOUR_DB_PASSWORD con la password di quickstart-user che hai creato nel passaggio precedente della procedura di creazione di un utente.

$env:GOOGLE_APPLICATION_CREDENTIALS="CREDENTIALS_JSON_FILE"
$env:INSTANCE_CONNECTION_NAME="INSTANCE_CONNECTION_NAME"
$env:DB_PORT="5432"
$env:DB_NAME="quickstart_db"
$env:DB_USER="quickstart-user"
$env:DB_PASS="YOUR_DB_PASSWORD"

1. Esegui il comando seguente per ottenere le dipendenze dell'app di esempio Java sul tuo computer locale ed esegui l'app di esempio.

   mvn jetty:run

2. Visualizza l'app di esempio in esecuzione. Apri una finestra del browser e vai a http://127.0.0.1:8080.

   

3. Per interrompere l'app di esempio, premi Control+C nella finestra di PowerShell in cui hai avviato l'app di esempio.

Node.js

1. Esegui i seguenti comandi per inizializzare le variabili di ambiente necessarie per eseguire l'app di esempio. Prima di eseguire i comandi, effettua le seguenti sostituzioni:

   • CREDENTIALS_JSON_FILE con il percorso del file della chiave delle credenziali JSON del tuo account di servizio utilizzando un formato come C:\Users\Your-Username\Downloads\key.json.
   • YOUR_DB_PASSWORD con la password di quickstart-user che hai creato nel passaggio precedente della procedura di creazione di un utente.

   $env:GOOGLE_APPLICATION_CREDENTIALS="CREDENTIALS_JSON_FILE"
   $env:INSTANCE_HOST="127.0.0.1"
   $env:DB_PORT="5432"
   $env:DB_NAME="quickstart_db"
   $env:DB_USER="quickstart-user"
   $env:DB_PASS="YOUR_DB_PASSWORD"

2. Scarica il proxy di autenticazione Cloud SQL.

   wget https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.0.0/cloud-sql-proxy.x64.exe 
   -O cloud-sql-proxy.exe

3. Esegui il proxy di autenticazione Cloud SQL come processo in background. Sostituisci INSTANCE_CONNECTION_NAME con il nome connessione dell'istanza visualizzato nella pagina Panoramica dell'istanza Cloud SQL.

   Start-Process -filepath  ".\cloud-sql-proxy.exe" -ArgumentList `
   "--credentials-file $env:GOOGLE_APPLICATION_CREDENTIALS" INSTANCE_CONNECTION_NAME

Nota: il processo che esegue il proxy di autenticazione Cloud SQL in background può essere interrotto selezionando la finestra cmd.exe generata dal comando Start-Process. Chiudi la finestra per interrompere il job proxy.

Esegui i comandi seguenti per installare i pacchetti Node.js richiesti sul computer locale ed eseguire l'app di esempio.

1. Installa i pacchetti Node.js necessari per eseguire l'app in locale.

   npm install

2. Esegui l'app di esempio.

   npm start

3. Visualizza l'app di esempio in esecuzione. Apri una finestra del browser e vai a http://127.0.0.1:8080.

   

4. Per interrompere l'app di esempio, premi Control+C nella finestra di PowerShell in cui hai avviato l'app di esempio.

Python

Esegui i seguenti comandi per inizializzare le variabili di ambiente necessarie per eseguire l'app di esempio. Prima di eseguire i comandi, effettua le seguenti sostituzioni:

• CREDENTIALS_JSON_FILE con il percorso del file della chiave delle credenziali JSON del tuo account di servizio utilizzando un formato come C:\Users\Your-Username\Downloads\key.json.
• INSTANCE_CONNECTION_NAME con il nome connessione dell'istanza visualizzato nella pagina Panoramica dell'istanza Cloud SQL.
• YOUR_DB_PASSWORD con la password di quickstart-user che hai creato nel passaggio precedente della procedura di creazione di un utente.

$env:GOOGLE_APPLICATION_CREDENTIALS="CREDENTIALS_JSON_FILE"
$env:INSTANCE_CONNECTION_NAME="INSTANCE_CONNECTION_NAME"
$env:DB_PORT="5432"
$env:DB_NAME="quickstart_db"
$env:DB_USER="quickstart-user"
$env:DB_PASS="YOUR_DB_PASSWORD"

Esegui i comandi seguenti per ottenere i requisiti dell'app di esempio Python sul computer locale ed esegui l'app di esempio.

1. Inizializza un ambiente virtuale e installa i requisiti per eseguire l'app di esempio.

   virtualenv --python python3 env
   .\env\Scripts\activate
   pip install -r requirements.txt

2. Esegui l'app di esempio.

   python app.py

3. Visualizza l'app di esempio in esecuzione. Apri una finestra del browser e vai a http://127.0.0.1:8080.

   

4. Per interrompere l'app di esempio, premi Control+C nella finestra di PowerShell in cui hai avviato l'app di esempio.

Esegui la pulizia

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

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

   Vai a Istanze Cloud SQL

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

Passaggi facoltativi per la pulizia

Se non utilizzi il ruolo Client Cloud SQL che hai assegnato all'account di servizioquickstart-service-account, 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 quickstart-service-account.
3. Elimina il ruolo Client Cloud SQL.
4. Fai clic su Salva.

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

• API abilitate in questa guida rapida:
  • API Cloud SQL Admin
  • API Identity and Access Management

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

   Vai alle API

2. Seleziona l'API che vuoi disattivare e fai clic sul pulsante Disattiva 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:

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