Connettersi a Cloud SQL per PostgreSQL dal computer locale
Scopri come eseguire il deployment di un'app di esempio su un computer locale basato su Linux, macOS o Windows connesso a un'istanza PostgreSQL utilizzando la console Google Cloud e un'applicazione client.
Supponendo che tu completi tutti i passaggi in modo tempestivo, le risorse create in questa guida rapida costano in genere meno di un dollaro.
Prima di iniziare
- Accedi al tuo account Google Cloud. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.
-
Abilita le API Cloud necessarie per eseguire un'app Cloud SQL di esempio sul tuo computer locale.
Console
Fai clic sul pulsante Abilita API per abilitare le API richieste per questa guida rapida.
Ciò consente le seguenti API:
- API Cloud SQL Admin
- API IAM
gcloud
Installa gcloud CLI, che fornisce l'accesso tramite riga di comando alle tue risorse Google Cloud. L'interfaccia a riga di comando gcloud CLI 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 questo comando
gcloud
:gcloud services enable sqladmin.googleapis.com iam.googleapis.com
Questo comando abilita le API seguenti:
- API Cloud SQL Admin
- API IAM
Configura Cloud SQL
crea un'istanza Cloud SQL
Console
Crea un'istanza con un indirizzo IP pubblico
-
Nella console Google Cloud, vai alla pagina Istanze Cloud SQL.
- Fai clic su Crea istanza.
- Fai clic su Scegli PostgreSQL.
- Inserisci
quickstart-instance
in ID istanza. - Inserisci una password per l'utente Postgres. Salva questa password per uso futuro.
- Fai clic sull'opzione Zona singola per Scegli la disponibilità per regione e zona.
- Fai clic ed espandi la sezione Mostra opzioni di configurazione.
- Nel menu a discesa Tipo di macchina, seleziona Leggera.
Fai clic su Crea istanza e attendi che l'istanza venga inizializzata e avviata.
gcloud
Crea un'istanza con un indirizzo IP pubblico
Prima di eseguire il comando gcloud
sql instances create
come segue, sostituisci DB_ROOT_PASSWORD con la password dell'utente del tuo database.
Facoltativamente, modifica i valori dei seguenti parametri:
- --database_version: il tipo e la versione del motore del database. Se non specificato, viene utilizzato il valore predefinito dell'API. Consulta la documentazione relativa alle versioni del database gcloud per vedere le versioni attualmente disponibili.
- --cpu: il numero di core da impostare nella macchina.
- --memory: valore di un numero intero che indica la quantità di memoria da impostare nella macchina. È necessario fornire un'unità di dimensione (ad esempio, 3072 MB o 9 GB). Se non vengono specificate unità, vengono utilizzati i GB.
- --region: località regionale dell'istanza
(ad esempio asia-east1, us-east1). Se non specificato, viene utilizzato il valore predefinito
us-central
. 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
-
Nella console Google Cloud, vai alla pagina Istanze Cloud SQL.
- Seleziona
quickstart-instance
. - Apri la scheda Database.
- Fai clic su Crea database.
- Nella finestra di dialogo Nuovo database, inserisci
quickstart_db
come nome del database.
- Fai clic su Crea.
gcloud
Esegui il comando gcloud
sql databases create
per creare un database.
gcloud sql databases create quickstart_db --instance=quickstart-instance
Crea un utente
Console
-
Nella console Google Cloud, vai alla pagina Istanze Cloud SQL.
- Per aprire la pagina Panoramica di un'istanza, fai clic sul nome dell'istanza.
- Seleziona Utenti dal menu di navigazione SQL.
- Fai clic su Aggiungi account utente.
- 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. Annotalo per utilizzarlo in un passaggio successivo di questa guida rapida.
- Nel campo Nome utente, inserisci
- Fai clic su Aggiungi.
gcloud
Sostituisci quanto segue:
- PASSWORD con una password per l'utente del database. Annotalo per utilizzarlo in un passaggio successivo di questa guida rapida.
Esegui il comando gcloud sql users create
per creare l'utente.
gcloud sql users create quickstart-user --instance=quickstart-instance --password=PASSWORD
I limiti di lunghezza del nome utente sono gli stessi per Cloud SQL e per PostgreSQL on-premise.
Configurare un account di servizio
Console
Crea un account di servizio
- Nella console Google Cloud, vai alla pagina Crea account di servizio.
- Seleziona un progetto Google Cloud.
- Inserisci un
quickstart-service-account
come nome dell'account di servizio. - (Facoltativo) Inserisci una descrizione dell'account di servizio.
- Fai clic su Crea e continua e vai al passaggio successivo.
- Scegli il ruolo client Cloud SQL da concedere all'account di servizio del progetto.
- Fai clic su Continua.
- Fai clic su Fine per completare la creazione dell'account di servizio.
Vai a Crea account di servizio
Creare e scaricare il file delle chiavi dell'account di servizio
- Nella console Google Cloud, vai alla pagina Account di servizio.
- Seleziona un progetto.
- Fai clic sull'indirizzo email dell'account di servizio
quickstart-service-account
per cui vuoi creare una chiave. - Fai clic sulla scheda Chiavi.
- Fai clic sul menu a discesa Aggiungi chiave, quindi seleziona Crea nuova chiave.
- In Tipo di chiave, seleziona JSON e fai clic su Crea.
Facendo clic su Crea viene scaricato un file della chiave dell'account di servizio. Dopo aver scaricato il file della chiave, non puoi scaricarlo di nuovo.
Assicurati di archiviare il file della chiave in modo sicuro poiché può essere utilizzato per l'autenticazione come account di servizio. Puoi spostare e rinominare questo file come preferisci.
gcloud
Crea un account di servizio
- Per creare l'account di servizio, esegui il comando
gcloud iam service-accounts create
: DESCRIPTION
: una descrizione facoltativa dell'account di servizio- 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"
gcloud iam service-accounts create quickstart-service-account --description="DESCRIPTION" --display-name="quickstart-service-account"
Sostituisci il seguente valore:
Creare e scaricare il file delle chiavi dell'account di servizio
Per utilizzare l'account di servizio appena creato dal computer locale, è necessario 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. Dopo aver scaricato il file della chiave, non puoi scaricarlo di nuovo.
Assicurati di archiviare il file della chiave in modo sicuro, poiché chiunque può utilizzarlo per autenticarti come account di servizio. Puoi spostare e rinominare questo file come preferisci.
Configura l'ambiente di sviluppo per il linguaggio di programmazione
Imposta l'ambiente di sviluppo del tuo computer locale per il linguaggio di programmazione che preferisci.
Go
Completa i seguenti passaggi per configurare il tuo ambiente di sviluppo per l'esecuzione dell'app Go di esempio.
- Vai alla guida alla configurazione per un ambiente di sviluppo Go.
- Completa le istruzioni nella sezione Installare Go.
Java
Completa i seguenti passaggi per configurare l'ambiente di sviluppo per l'esecuzione dell'app Java di esempio.
- Vai alla guida alla configurazione per un ambiente di sviluppo Java.
- Completa le istruzioni nella sezione Installare un JDK (Java Development Kit).
- Completa le istruzioni in Installare uno strumento di automazione delle build per configurare Apache Maven.
Node.js
Completa i passaggi seguenti per configurare il tuo ambiente di sviluppo per eseguire l'app Node.js di esempio.
- Vai alla guida alla configurazione per un ambiente di sviluppo Node.js.
- Completa le istruzioni nella sezione Installazione di Node.js e npm.
Python
Completa i seguenti passaggi per configurare l'ambiente di sviluppo per l'esecuzione dell'app Python di esempio.
- Vai alla guida alla configurazione per un ambiente di sviluppo Python.
- Completa le istruzioni nella sezione Installazione di Python.
Installa Git
Installa Git, un sistema di controllo della versione open source.
Clona un'app di esempio
Clona un'app di esempio sul computer locale utilizzando il comando git clone
.
Go
Esegui i comandi seguenti per clonare l'app Go di esempio sul tuo computer locale e cambiare la directory nella directory contenente l'app di esempio.
-
Clonare l'app di esempio.
git clone https://github.com/GoogleCloudPlatform/golang-samples
-
Cambia la directory nella directory contenente l'app di esempio.
cd golang-samples/cloudsql/postgres/database-sql
Java
Esegui i comandi seguenti per clonare l'app Java di esempio sul tuo computer locale e passare alla directory contenente l'app di esempio.
-
Clonare l'app di esempio.
git clone https://github.com/GoogleCloudPlatform/java-docs-samples
-
Cambia la directory nella directory contenente l'app di esempio.
cd java-docs-samples/cloud-sql/postgres/servlet
Node.js
Esegui i comandi seguenti per clonare l'app Node.js di esempio sul computer locale e modificare la directory nella directory contenente l'app di esempio.
-
Clonare l'app di esempio.
git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples
-
Cambia la directory nella directory contenente l'app di esempio.
cd nodejs-docs-samples/cloud-sql/postgres/knex
Python
Esegui i comandi seguenti per clonare l'app Python di esempio sul tuo computer locale e cambiare la directory nella directory contenente l'app di esempio.
-
Clonare l'app di esempio.
git clone https://github.com/GoogleCloudPlatform/python-docs-samples
-
Cambia la directory nella directory 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.
Esegui la pulizia
Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questa pagina, segui questi passaggi.
-
Nella console Google Cloud, vai alla pagina Istanze Cloud SQL.
- Seleziona l'istanza
quickstart-instance
per aprire la pagina Dettagli istanza. - Nella barra delle icone nella parte superiore della pagina, fai clic su Elimina.
- Nella finestra di dialogo Elimina istanza, digita
quickstart-instance
e fai clic su Elimina per eliminare l'istanza.
Passaggi di pulizia facoltativi
Se non utilizzi il ruolo Client Cloud SQL che hai assegnato all'account di servizio quickstart-service-account
, puoi rimuoverlo.
-
Nella console Google Cloud, vai alla pagina IAM.
- Fai clic sull'icona di modifica (che sembra una matita) per l'account IAM denominato quickstart-service-account.
- Elimina il ruolo Client Cloud SQL.
- Fai clic su Salva.
Se non utilizzi le API che sono state abilitate in questa guida rapida, puoi disabilitarle.
- API che sono state abilitate in questa guida rapida:
- API Cloud SQL Admin
- API Identity and Access Management
Nella console Google Cloud, vai alla pagina API.
Seleziona un'API da disabilitare, quindi fai clic sul pulsante Disabilita API.
Passaggi successivi
In base alle tue esigenze, puoi scoprire di più sulla creazione di istanze Cloud SQL.Scopri di più sulla creazione di utenti PostgreSQL e database per la tua istanza Cloud SQL.
Per ulteriori informazioni sui prezzi, consulta la pagina relativa ai prezzi di Cloud SQL per PostgreSQL.
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: