Alcune o tutte le informazioni in questa pagina potrebbero non essere applicabili a Cloud de Confiance di S3NS. Per maggiori dettagli, consulta Differenze rispetto a Google Cloud.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Connettiti a Cloud SQL per PostgreSQL dall'ambiente standard di App Engine

MySQL | PostgreSQL | SQL Server

Scopri come eseguire il deployment di un'app di esempio nell'ambiente standard di App Engine connessa a un'istanza PostgreSQL utilizzando la console Cloud de Confiance 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).

Prima di iniziare

In the Cloud de Confiance console, on the project selector page, select or create a Cloud de Confiance 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 Cloud de Confiance project.
Abilita le API Cloud necessarie per eseguire un'app di esempio Cloud SQL nell'ambiente standard App Engine.
Console

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

Abilita le API

Vengono abilitate le seguenti API:
- API Cloud SQL Admin
- API Compute Engine
- API Cloud Build
- API Cloud Logging
gcloud

Fai clic sul pulsante seguente per aprire Cloud Shell, che fornisce l'accesso da riga di comando alle tue risorse Cloud de Confiance 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 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

Configura Cloud SQL

Crea un'istanza Cloud SQL

IP pubblico

Segui questi passaggi per configurare un'istanza Cloud SQL a cui connetterti tramite IP pubblico:

Console

Nella console Cloud de Confiance , vai alla pagina Istanze Cloud SQL.

Vai a Istanze Cloud SQL
Fai clic su Crea istanza.
Dal menu Crea istanza, seleziona Nuova istanza.
Fai clic su Scegli PostgreSQL.
Assicurati che sia selezionata la versione Enterprise Plus di Cloud SQL per la tua istanza.
Nel campo ID istanza, inserisci quickstart-instance.
Nel campo Password, inserisci una password per l'utente postgres. Salva questa password per utilizzarla in futuro.
Nella sezione Scegli la disponibilità per regione e zona, seleziona Zona singola.
Fai clic sul menu Mostra opzioni di configurazione.
Espandi il nodo Configurazione macchina.
Nella regione Forme di macchine, seleziona la forma 4 vCPU, 32 GB.
Fai clic su Crea istanza e poi attendi l'inizializzazione e l'avvio dell'istanza.

gcloud

Prima di eseguire il comando come segue, sostituisci DB_ROOT_PASSWORD con la password dell'utente del database.

(Facoltativo) 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 desiderati nella macchina.
--memory: valore numerico 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 sono specificate unità, viene utilizzato il 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

Per configurare un'istanza Cloud SQL a cui connetterti tramite IP privato:

Console

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

Nella console Cloud de Confiance , vai alla pagina Reti VPC.

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

Crea un'istanza con indirizzo IP privato e SSL abilitato

Nella console Cloud de Confiance , vai alla pagina Istanze Cloud SQL.

Vai a Istanze Cloud SQL
Fai clic su Crea istanza.
Dal menu Crea istanza, seleziona Nuova istanza.
Fai clic su Scegli PostgreSQL.
Assicurati che sia selezionata la versione Enterprise Plus di Cloud SQL per la tua istanza.
Nel campo ID istanza, inserisci quickstart-instance.
Nel campo Password, inserisci una password per l'utente postgres. Salva questa password per utilizzarla in futuro.
Nella sezione Scegli la disponibilità per regione e zona, seleziona Zona singola.
Fai clic sul menu Mostra opzioni di configurazione.
Espandi il nodo Configurazione macchina.
Nella regione Forme di macchine, seleziona la forma 4 vCPU, 32 GB.
Espandi il nodo Connessioni.
Deseleziona la casella di controllo IP pubblico per creare un'istanza solo con un indirizzo IP privato.
Seleziona la casella di controllo IP privato.
Seleziona la casella di controllo Accesso privato ai servizi (PSA).
Nel menu a discesa Rete VPC *, seleziona predefinita.
Nella sezione Sicurezza, assicurati che l'opzione Consenti solo connessioni SSL sia selezionata per attivare le connessioni SSL.
Fai clic su Crea istanza, quindi attendi l'inizializzazione e l'avvio dell'istanza.

gcloud

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

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

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

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

Prima di eseguire il comando come segue, sostituisci DB_ROOT_PASSWORD con la password dell'utente del database.

(Facoltativo) 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 nella 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 sono specificate unità, viene utilizzato il 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

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

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

Crea un database

Per creare un database:

Console

Nella console Cloud de Confiance , vai alla pagina Istanze Cloud SQL.

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

Nel campo Nome database della finestra di dialogo Nuovo database, inserisci quickstart-db.
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 Cloud de Confiance , vai alla pagina Istanze Cloud SQL.

Vai a Istanze Cloud SQL
Per aprire la pagina Panoramica di un'istanza, fai clic sul nome dell'istanza.
Dal menu di navigazione SQL, seleziona Utenti.
Fai clic su Aggiungi account utente.
Nella pagina Aggiungi un account utente all'istanza instance_name, 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 per utilizzarla in un passaggio successivo di questa guida rapida.
Fai clic su Aggiungi.

gcloud

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

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.

Esegui il deployment di un'app di esempio nell'ambiente standard di App Engine

Crea l'applicazione App Engine

Crea l'applicazione App Engine nel tuo Cloud de Confiance by S3NS progetto. In questo modo viene attivato il servizio App Engine, viene creata un'applicazione App Engine predefinita e viene creato uaccount di serviziont App Engine che verrà utilizzato per connettersi a Cloud SQL.

Console

Nella console Cloud de Confiance , vai alla pagina App Engine.

Vai ad App Engine
Fai clic sul pulsante Crea applicazione.
Seleziona us-central dal menu a discesa Seleziona una regione.
Fai clic su Avanti.
Fai clic sul link Lo farò in un secondo momento quando viene visualizzato nella pagina Inizia.

gcloud

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

gcloud app create

Quando ti viene chiesto di scegliere la regione in cui vuoi collocare l'applicazione App Engine, inserisci la scelta numerica per us-central.

Configura il account di servizio App Engine

Configura il account di servizio utilizzato da App Engine in modo che disponga del ruolo Client Cloud SQL con le autorizzazioni per connettersi a Cloud SQL.

Console

Nella Cloud de Confiance console, vai alla pagina Service account.

Vai a IAM
Per il service account denominato Account di servizio predefinito di App Engine, fai clic sull'icona a forma di matita.
Nota: il nome del service account viene visualizzato accanto all'entità dell'account. Il nome dell'entità è project-name@appspot.s3ns-system.iam.gserviceaccount.com.
Fai clic su Aggiungi un altro ruolo.
Aggiungi il ruolo denominato Client Cloud SQL.
Fai clic su Salva.

gcloud

Esegui il seguente comando gcloud per ottenere un elenco dei service account del tuo progetto:
```
gcloud iam service-accounts list
```
Copia l'EMAIL del service account App Engine.

Esegui questo comando per aggiungere il ruolo Client Cloud SQL all'service account 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 Cloud SQL

Con un'istanza Cloud SQL, un database e un account di servizio con autorizzazioni client, ora puoi configurare ed eseguire il deployment di un'applicazione di esempio per connetterti all'istanza Cloud SQL.

IP pubblico

Per i percorsi IP pubblici, l'ambiente standard App Engine fornisce la crittografia e si connette utilizzando il proxy di autenticazione Cloud SQL tramite socket Unix.

Go

Nell'editor di Cloud Shell, apri il codice sorgente dell'app di esempio.
Apri l'editor di Cloud Shell
Nella finestra di dialogo Apri in Cloud Shell, fai clic su Conferma per scaricare il codice dell'app di esempio e aprire la directory dell'app di esempio nell'editor di Cloud Shell.
Al 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 progetto.
Se viene visualizzata una finestra di dialogo Autorizza Cloud Shell, fai clic su Autorizza.
Dal menu di navigazione di Explorer dell'editor di Cloud Shell, vai al file golang-samples/cloudsql/postgres/database-sql/cmd/app/app.standard.yaml e aprilo.
Sostituisci i segnaposto per le variabili di ambiente nel file app.standard.yaml con i seguenti valori:

<PROJECT-ID> con l'ID progetto.
<INSTANCE-REGION> con us-central1.
<INSTANCE-NAME> con l'ID della tua istanza che viene visualizzato nella pagina Istanze Cloud SQL nella console Cloud de Confiance by S3NS .
<YOUR_DB_USER_NAME> con quickstart-user.
<YOUR_DB_PASSWORD> con la password di quickstart-user che hai creato in Creare un utente.
<YOUR_DB_NAME> con quickstart-db.

Al prompt dei comandi di Cloud Shell, nella directory golang-samples/cloudsql/postgres/database-sql, esegui il comando gcloud app deploy per eseguire il deployment dell'app di esempio nell'ambiente standard di App Engine.

gcloud app deploy cmd/app/app.standard.yaml

Se ti viene chiesto di scegliere la regione per la creazione dell'app, inserisci la scelta numerica per us-central.
Quando ti viene chiesto Vuoi continuare?, digita Y.
Al termine del comando di deployment, esegui il comando gcloud app browse:

gcloud app browse

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

Visualizza l'app di esempio di cui è stato eseguito il deployment.

Java

Nell'editor di Cloud Shell, apri il codice sorgente dell'app di esempio.
Apri l'editor di Cloud Shell
Nella finestra di dialogo Apri in Cloud Shell, fai clic su Conferma per scaricare il codice dell'app di esempio e aprire la directory dell'app di esempio nell'editor di Cloud Shell.
Al prompt dei comandi di Cloud Shell, esegui questo comando per attivare il tuo progetto:
```
gcloud config set project YOUR-PROJECT-ID
```
Nota:sostituisci YOUR-PROJECT-ID con l'ID progetto.
Se viene visualizzata una finestra di dialogo Autorizza Cloud Shell, fai clic su Autorizza.
Dal menu di navigazione di Explorer dell'editor di Cloud Shell, vai al file java-docs-samples/cloud-sql/postgres/servlet/src/main/webapp/WEB-INF/appengine-web.xml e aprilo.
Sostituisci i segnaposto per le variabili di ambiente nel file appengine-web.xml con i seguenti valori:

my-project:region:instance con il nome connessione dell'istanza visualizzato nella pagina Istanze Cloud SQL della console Cloud de Confiance by S3NS .
my-db-user con quickstart-user.
my-db-password con la password di quickstart-user che hai creato in Crea un utente.
my_db con quickstart-db.

Al prompt dei comandi di Cloud Shell, nella directory 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 standard di App Engine.

mvn clean package appengine:deploy -DskipTests

Se ti viene chiesto di scegliere la regione per la creazione dell'app, inserisci la scelta numerica per us-central.
Quando ti viene chiesto Vuoi continuare?, digita Y.
Al termine del comando di deployment, esegui il comando gcloud app browse:

gcloud app browse

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

Visualizza l'app di esempio di cui è stato eseguito il deployment.

Node.js

Nell'editor di Cloud Shell, apri il codice sorgente dell'app di esempio.
Apri l'editor di Cloud Shell
Nella finestra di dialogo Apri in Cloud Shell, fai clic su Conferma per scaricare il codice dell'app di esempio e aprire la directory dell'app di esempio nell'editor di Cloud Shell.
Al prompt dei comandi di Cloud Shell, esegui questo comando per attivare il tuo progetto:
```
gcloud config set project YOUR-PROJECT-ID
```
Nota:sostituisci YOUR-PROJECT-ID con l'ID progetto.
Se viene visualizzata la finestra di dialogo Autorizza Cloud Shell, fai clic su Autorizza.
Dal menu di navigazione di Explorer dell'editor di Cloud Shell, vai al file nodejs-docs-samples/cloud-sql/postgres/knex/app.standard.yaml e aprilo.
Sostituisci i segnaposto per le variabili di ambiente nel file app.standard.yaml con i seguenti valori:

<MY-PROJECT> con l'ID progetto.
<INSTANCE-REGION> con us-central1.
<INSTANCE-NAME> con l'ID della tua istanza che viene visualizzato nella pagina Istanze Cloud SQL nella console Cloud de Confiance by S3NS .
MY_DB_USER con quickstart-user.
MY_DB_PASSWORD con la password di quickstart-user che hai creato in Crea un utente.
MY_DATABASE con quickstart-db.

Al prompt dei comandi di Cloud Shell, nella directory nodejs-docs-samples/cloud-sql/postgres/knex, esegui il comando gcloud app deploy per eseguire il deployment dell'app di esempio nell'ambiente standard di App Engine.

gcloud app deploy app.standard.yaml

Se ti viene chiesto di scegliere la regione per la creazione dell'app, inserisci la scelta numerica per us-central.
Quando ti viene chiesto Vuoi continuare?, digita Y.
Al termine del comando di deployment, esegui il comando gcloud app browse:

gcloud app browse

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

Visualizza l'app di esempio di cui è stato eseguito il deployment.

Python

Nell'editor di Cloud Shell, apri il codice sorgente dell'app di esempio.
Apri l'editor di Cloud Shell
Nella finestra di dialogo Apri in Cloud Shell, fai clic su Conferma per scaricare il codice dell'app di esempio e aprire la directory dell'app di esempio nell'editor di Cloud Shell.
Al 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 progetto.
Se viene visualizzata la finestra di dialogo Autorizza Cloud Shell, fai clic su Autorizza.
Dal menu di navigazione di Explorer dell'editor di Cloud Shell, vai al file python-docs-samples/cloud-sql/postgres/sqlalchemy/app.standard.yaml e aprilo.
Sostituisci i segnaposto per le variabili di ambiente nel file app.standard.yaml con i seguenti valori:

<PROJECT-ID> con l'ID progetto.
<INSTANCE-REGION> con us-central1.
<INSTANCE-NAME> con l'ID della tua istanza che viene visualizzato nella pagina Istanze Cloud SQL nella console Cloud de Confiance by S3NS .
<YOUR_DB_USER_NAME> con quickstart-user.
<YOUR_DB_PASSWORD> con la password di quickstart-user che hai creato in Creare un utente.
<YOUR_DB_NAME> con quickstart-db.

Al prompt dei comandi di Cloud Shell, nella directory python-docs-samples/cloud-sql/postgres/sqlalchemy, esegui il comando gcloud app deploy per eseguire il deployment dell'app di esempio nell'ambiente standard di App Engine.

gcloud app deploy app.standard.yaml

Se ti viene chiesto di scegliere la regione per la creazione dell'app, inserisci la scelta numerica per us-central.
Quando ti viene chiesto Vuoi continuare?, digita Y.
Al termine del comando di deployment, esegui il comando gcloud app browse:

gcloud app browse

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

Visualizza l'app di esempio di cui è stato eseguito il deployment.

IP privato

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

Go

Crea e scarica certificati server e client SSL

Nella console Cloud de Confiance , vai alla pagina Istanze Cloud SQL.

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

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

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

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

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

Crea un'app di esempio con certificati SSL

Nell'editor di Cloud Shell, apri il codice sorgente dell'app di esempio.
Apri l'editor di Cloud Shell
Nella finestra di dialogo Apri in Cloud Shell, fai clic su Conferma per scaricare il codice dell'app di esempio e aprire la directory dell'app di esempio nell'editor di Cloud Shell.
Al 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 progetto.
Se viene visualizzata la finestra di dialogo Autorizza Cloud Shell, fai clic su Autorizza.
Carica i file dei certificati SSL nella cartella certs.
1. Dal menu di navigazione di Explorer dell'editor di Cloud Shell, vai alla cartella golang-samples/cloudsql/postgres/database-sql/certs.
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 sulla macchina locale:
4. 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.
Dal menu di navigazione di Explorer dell'editor di Cloud Shell, vai al file golang-samples/cloudsql/postgres/database-sql/cmd/app/app.standard.yaml e aprilo.
Copia e incolla il seguente codice nel file, sostituendo i contenuti esistenti:

runtime: go116

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

Effettua le seguenti sostituzioni di variabili:

YOUR_DB_PASSWORD con la password di quickstart-user che hai creato in Crea un utente.
INSTANCE_HOST con l'indirizzo IP privato dell'istanza visualizzato nella pagina Istanze Cloud SQL della console Cloud de Confiance by S3NS .
PROJECT_ID con l'ID progetto.

Al prompt dei comandi di Cloud Shell, nella directory golang-samples/cloudsql/postgres/database-sql, esegui il comando gcloud app deploy per eseguire il deployment dell'app di esempio nell'ambiente standard di App Engine.

gcloud app deploy cmd/app/app.standard.yaml

Se ti viene chiesto di scegliere la regione per la creazione dell'app, inserisci la scelta numerica per us-central.
Quando ti viene chiesto Vuoi continuare?, digita Y.
Al termine del comando di deployment, esegui il comando gcloud app browse:

gcloud app browse

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

Visualizza l'app di esempio di cui è stato eseguito il deployment.

Java

Crea e scarica certificati server e client SSL

Per gli utenti Java, il connettore fornisce già una connessione sicura, pertanto la creazione e il download dei certificati server e client SSL non sono necessari.

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

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

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

Crea l'app di esempio

Nell'editor di Cloud Shell, apri il codice sorgente dell'app di esempio.
Apri l'editor di Cloud Shell
Nella finestra di dialogo Apri in Cloud Shell, fai clic su Conferma per scaricare il codice dell'app di esempio e aprire la directory dell'app di esempio nell'editor di Cloud Shell.
Al prompt dei comandi di Cloud Shell, esegui questo comando per attivare il tuo progetto:
```
gcloud config set project YOUR-PROJECT-ID
```
Nota:sostituisci YOUR-PROJECT-ID con l'ID progetto.
Se viene visualizzata la finestra di dialogo Autorizza Cloud Shell, fai clic su Autorizza.
Dal menu di navigazione di Explorer dell'editor di Cloud Shell, vai al file java-docs-samples/cloud-sql/postgres/servlet/src/main/webapp/WEB-INF/appengine-web.xml e aprilo.
Copia e incolla il seguente codice nel file appengine-web.xml, sostituendo i contenuti esistenti:

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

Effettua le seguenti sostituzioni di variabili:

project-name:region-name:instance-name con il nome connessione dell'istanza che viene visualizzato nella pagina Istanze Cloud SQL della console Cloud de Confiance by S3NS .
my-db-password con la password di quickstart-user che hai creato in Crea un utente.
PROJECT_ID con l'ID progetto.

Al prompt dei comandi di Cloud Shell, nella directory 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 standard di App Engine.

mvn clean package appengine:deploy -DskipTests

Se ti viene chiesto di scegliere la regione per la creazione dell'app, inserisci la scelta numerica per us-central.
Quando ti viene chiesto Vuoi continuare?, digita Y.
Al termine del comando di deployment, esegui il comando gcloud app browse:

gcloud app browse

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

Visualizza l'app di esempio di cui è stato eseguito il deployment.

Node.js

Crea e scarica certificati server e client SSL

Nella console Cloud de Confiance , vai alla pagina Istanze Cloud SQL.

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

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

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

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

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

Crea un'app di esempio con certificati SSL

Nell'editor di Cloud Shell, apri il codice sorgente dell'app di esempio.
Apri l'editor di Cloud Shell
Nella finestra di dialogo Apri in Cloud Shell, fai clic su Conferma per scaricare il codice dell'app di esempio e aprire la directory dell'app di esempio nell'editor di Cloud Shell.
Al 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 progetto.
Se viene visualizzata la finestra di dialogo Autorizza Cloud Shell, fai clic su Autorizza.
Carica i file dei certificati SSL nella cartella certs.
1. Dal menu di navigazione di Explorer dell'editor di Cloud Shell, vai alla cartella nodejs-docs-samples/cloud-sql/postgres/knex/certs.
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 sulla macchina locale:
4. 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.
Dal menu di navigazione di Explorer dell'editor di Cloud Shell, vai al file nodejs-docs-samples/cloud-sql/postgres/knex/app.standard.yaml e aprilo.
Copia e incolla il seguente codice nel file, sostituendo i contenuti esistenti:

runtime: nodejs16

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

Effettua le seguenti sostituzioni di variabili:

MY_DB_PASSWORD con la password di quickstart-user che hai creato in Crea un utente.
INSTANCE_HOST con l'indirizzo IP privato dell'istanza visualizzato nella pagina Istanze Cloud SQL della console Cloud de Confiance by S3NS .
PROJECT_ID con l'ID progetto.

Al prompt dei comandi di Cloud Shell, nella directory nodejs-docs-samples/cloud-sql/postgres/knex, esegui il comando gcloud app deploy per eseguire il deployment dell'app di esempio nell'ambiente standard di App Engine.

gcloud app deploy app.standard.yaml

Se ti viene chiesto di scegliere la regione per la creazione dell'app, inserisci la scelta numerica per us-central.
Quando ti viene chiesto Vuoi continuare?, digita Y.
Al termine del comando di deployment, esegui il comando gcloud app browse:

gcloud app browse

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

Visualizza l'app di esempio di cui è stato eseguito il deployment.

Python

Crea e scarica certificati server e client SSL

Nella console Cloud de Confiance , vai alla pagina Istanze Cloud SQL.

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

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

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

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

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

Crea un'app di esempio con certificati SSL

Nell'editor di Cloud Shell, apri il codice sorgente dell'app di esempio.
Apri l'editor di Cloud Shell
Nella finestra di dialogo Apri in Cloud Shell, fai clic su Conferma per scaricare il codice dell'app di esempio e aprire la directory dell'app di esempio nell'editor di Cloud Shell.
Al prompt dei comandi di Cloud Shell, esegui questo comando per attivare il tuo progetto:
```
gcloud config set project YOUR-PROJECT-ID
```
Nota:sostituisci YOUR-PROJECT-ID con l'ID progetto.
Se viene visualizzata la finestra di dialogo Autorizza Cloud Shell, fai clic su Autorizza.
Carica i file dei certificati SSL nella cartella certs.
1. Dal menu di navigazione di Explorer dell'editor di Cloud Shell, vai alla cartella python-docs-samples/cloud-sql/postgres/sqlalchemy/certs.
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 sulla macchina locale:
4. 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.
Dal menu di navigazione di Explorer dell'editor di Cloud Shell, vai al file python-docs-samples/cloud-sql/postgres/sqlalchemy/app.standard.yaml e aprilo.
Copia e incolla il seguente codice nel file, sostituendo i contenuti esistenti:

runtime: python37
entrypoint: 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

Effettua le seguenti sostituzioni di variabili:

YOUR_DB_PASSWORD con la password di quickstart-user che hai creato in Crea un utente.
INSTANCE_HOST con l'indirizzo IP privato dell'istanza visualizzato nella pagina Istanze Cloud SQL della console Cloud de Confiance by S3NS .
PROJECT_ID con l'ID progetto.

Al prompt dei comandi di Cloud Shell, nella directory python-docs-samples/cloud-sql/postgres/sqlalchemy, esegui il comando gcloud app deploy per eseguire il deployment dell'app di esempio nell'ambiente standard di App Engine.

gcloud app deploy app.standard.yaml

Se ti viene chiesto di scegliere la regione per la creazione dell'app, inserisci la scelta numerica per us-central.
Quando ti viene chiesto Vuoi continuare?, digita Y.
Al termine del comando di deployment, esegui il comando gcloud app browse:

gcloud app browse

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

Visualizza l'app di esempio di cui è stato eseguito il deployment.

Esegui la pulizia

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

Nella console Cloud de Confiance , vai alla pagina Istanze Cloud SQL.

Vai a Istanze Cloud SQL
Seleziona l'istanza quickstart-instance per aprire la pagina Dettagli istanza.
Nella barra delle icone nella parte superiore della pagina, fai clic su Elimina.
Nella finestra di dialogo Elimina istanza, digita quickstart-instance e poi fai clic su Elimina per eliminare l'istanza. Se disabiliti l'app, questa non esegue istanze e non gestisce le richieste. Se la tua app sta elaborando una richiesta, la completa prima di essere disattivata.

Per disattivare un'app App Engine e conservarne i dati, segui questi passaggi:

Nella console Cloud de Confiance , vai alla pagina Impostazioni:

Vai alle impostazioni
Nella scheda Impostazioni applicazione, fai clic su Disabilita applicazione.
Nel campo ID app, inserisci l'ID dell'app che vuoi disattivare e fai clic su Disattiva.

Passaggi di pulizia facoltativi

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

Nella Cloud de Confiance console, vai alla pagina Service account.

Vai a IAM
Fai clic sull'icona di modifica (a forma di matita) per l'account IAM denominato Account di servizio predefinito Compute Engine.
Elimina il ruolo Client Cloud SQL.
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 Compute Engine
- API Cloud SQL Admin
- API Cloud Run
- API Container Registry
- API Cloud Build

Nella console Cloud de Confiance , vai alla pagina API.

Vai alle API
Seleziona le API che vuoi disattivare 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 PostgreSQL e database per la tua istanza Cloud SQL.

Per ulteriori informazioni sui prezzi, consulta la pagina 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 di più sulla connessione a un'istanza Cloud SQL da altre applicazioni Google Cloud: