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

Connettiti a Cloud SQL per SQL Server 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 connesso a un'istanza SQL Server 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 (USD).

Prima di iniziare

Nota: il nome che utilizzi per il tuo 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. 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.

2. Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.

   Nota: se non prevedi di conservare le risorse create in questa procedura, crea un progetto anziché selezionarne uno esistente. Dopo aver completato questi passaggi, puoi eliminare il progetto, rimuovendo tutte le risorse associate.

   Vai al selettore progetti

3. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

4. Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.

   Nota: se non prevedi di conservare le risorse create in questa procedura, crea un progetto anziché selezionarne uno esistente. Dopo aver completato questi passaggi, puoi eliminare il progetto, rimuovendo tutte le risorse associate.

   Vai al selettore progetti

5. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

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

   Console

   Fai clic sul pulsante di seguito per abilitare le API richieste per questa guida rapida.

   Abilita le API

   Questa operazione abilita 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 tramite riga di comando alle risorse Google Cloud direttamente dal browser. Puoi usare Cloud Shell per eseguire i comandi gcloud presentati in questa guida rapida.

   Apri Cloud Shell

   Esegui il comando gcloud seguente utilizzando Cloud Shell:

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

   Questo comando abilita le API seguenti:

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

configura Cloud SQL

crea un'istanza Cloud SQL

IP pubblico

L'ambiente standard App Engine non supporta la connessione a Cloud SQL per SQL Server su IP pubblico mediante socket Unix, ma è possibile connettersi utilizzando i connettori Go, Java e Python.

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 SQL Server.
4. Nel campo ID istanza, inserisci quickstart-instance.
5. Nel campo Password, inserisci una password per l'utente sqlserver. Salva questa password per un utilizzo futuro.
6. Nella sezione Scegli disponibilità a livello di regione e zona, seleziona Zona singola.
7. Fai clic sul menu Mostra opzioni di configurazione.
8. Nell'elenco a discesa Tipo di macchina, seleziona Leggera.
9. Fai clic su Crea istanza, quindi attendi che l'istanza venga inizializzata e avviata.

gcloud

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

Se vuoi, puoi modificare i valori dei seguenti parametri:

• --database-version: il tipo e la versione del motore del database. Se non specificati, viene utilizzato il valore predefinito dell'API. Consulta la documentazione relativa alle versioni dei database gcloud per vedere le versioni attuali disponibili.
• --cpu: il numero di core desiderati nella macchina.
• --memory: un numero intero che indica la quantità di memoria desiderata nella macchina. È necessario specificare un'unità di dimensione (ad esempio, 3072 MB o 9 GB). Se non vengono specificate unità, si presume il valore GB.
• --region: località 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 di Cloud SQL.

 gcloud sql instances create quickstart-instance \
--database-version=SQLSERVER_2017_STANDARD \
--cpu=1 \
--memory=4GB \
--region=us-central1 \
--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 ai servizi privati.
4. Seleziona la scheda Intervalli IP allocati per i servizi.
5. Fai clic su Assegna intervallo IP.
6. Come Nome dell'intervallo allocato, specifica google-managed-services-default.
7. Seleziona l'opzione Automatico per l'intervallo IP e specifica la lunghezza del prefisso come 16.
8. Fai clic su Assegna per creare l'intervallo allocato.
9. Seleziona la scheda Connessioni private ai servizi per la rete VPC default.
10. Fai clic su Crea connessione per creare una connessione privata tra la tua rete e un producer di servizi.
11. Per Allocazione assegnata, seleziona google-managed-services-default.
12. Fai clic su Connetti per creare la connessione.

Crea un'istanza con indirizzo IP privato e SSL abilitati

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 SQL Server.
4. Inserisci quickstart-instance in ID istanza.
5. Inserisci una password per l'utente sqlserver. Salva questa password per uso futuro.
6. Fai clic sull'opzione Zona singola per Scegli la disponibilità a livello di regione e zona.
7. Fai clic ed espandi Mostra opzioni di configurazione.
8. In Tipo di macchina, seleziona Leggera.
9. In Connessioni, seleziona IP privato.
10. Seleziona predefinita nel menu a discesa Rete.
11. Deseleziona la casella di controllo IP pubblico per creare un'istanza solo con un IP privato.
12. Fai clic su Crea istanza, quindi attendi che l'istanza venga inizializzata e avviata.
13. Fai clic su Connections (Connessioni).
14. Nella sezione Sicurezza, seleziona Consenti solo connessioni SSL per attivare le connessioni SSL.
15. Nella finestra di dialogo Consenti solo connessioni SSL, fai clic su Salva e riavvia, quindi attendi 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 allocato. Sostituisci YOUR_PROJECT_ID con l'ID del 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 abilitati

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

Se vuoi, puoi modificare i valori dei seguenti parametri:

• --database-version: il tipo e la versione del motore del database. Se non specificati, viene utilizzato il valore predefinito dell'API. Consulta la documentazione relativa alle versioni dei database gcloud per vedere le versioni attuali disponibili.
• --cpu: il numero di core nella macchina.
• --memory: un numero intero che indica la quantità di memoria da includere nella macchina. È possibile fornire un'unità di dimensione (ad esempio, 3072 MB o 9 GB). Se non vengono specificate unità, si presume il valore GB.
• --region: la località 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=SQLSERVER_2017_STANDARD \
 --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 abilitare consenti solo le 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. Dal 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

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 progetto Google Cloud. Abilita il servizio App Engine, crea un'applicazione App Engine predefinita e crea un account di servizio App Engine che verrà utilizzato per la connessione a Cloud SQL.

Nota: questo passaggio deve essere eseguito 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 sul pulsante Crea applicazione.
3. Seleziona us-central dal menu a discesa Seleziona una regione.
4. Tocca Avanti.
5. Fai clic sul link Lo farò più tardi quando verrà visualizzato nella pagina Inizia.

gcloud

1. Esegui questo comando gcloud app create per creare un'applicazione App Engine:

gcloud app create

2. Quando ti viene chiesto di scegliere la regione in cui vuoi che si trovi l'applicazione 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 con le autorizzazioni per la connessione 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 degli account di servizio del progetto:

   gcloud iam service-accounts list

2. Copia l'indirizzo EMAIL dell'account di servizio App Engine.
3. Esegui questo comando per aggiungere il ruolo Client Cloud SQL all'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 Cloud SQL

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

IP pubblico

L'ambiente standard App Engine supporta la connessione a Cloud SQL per SQL Server su IP pubblico utilizzando i connettori Go, Java e Python.

Go

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 una finestra di dialogo Autorizza Cloud Shell, fai clic su Autorizza.
5. Dal menu di navigazione Explorer dell'editor di Cloud Shell, vai al file golang-samples/cloudsql/sqlserver/database-sql/cmd/app/app.standard.yaml e aprilo.
6. Sostituisci i segnaposto per le variabili di ambiente nel file app.standard.yaml con i seguenti valori:
• <PROJECT-ID> con il tuo ID progetto.
• <INSTANCE-REGION> con us-central1.
• <INSTANCE-NAME> con l'ID dell'istanza visualizzato nella pagina Istanze Cloud SQL nella console Google Cloud.
• <YOUR_DB_USER_NAME> con sqlserver.
• <YOUR_DB_PASSWORD> con la password del quickstart-user che hai creato nella fase Crea un utente.
• <YOUR_DB_NAME> con quickstart-db.
7. Nel prompt dei comandi di Cloud Shell, nella directory golang-samples/cloudsql/sqlserver/database-sql, esegui questo 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

8. Se ti viene chiesto di scegliere la regione per creare l'app, inserisci la scelta numerica per us-central.
9. Quando ti viene richiesto se vuoi continuare?, inserisci Y.
10. Al termine del comando di deployment, 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 standard 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 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 una finestra di dialogo Autorizza Cloud Shell, fai clic su Autorizza.
5. Dal menu di navigazione Explorer dell'editor di Cloud Shell, vai al file java-docs-samples/cloud-sql/sqlserver/servlet/src/main/webapp/WEB-INF/appengine-web.xml e aprilo.
6. Sostituisci i segnaposto per le variabili di ambiente nel file appengine-web.xml con i seguenti valori:
• project-name:region-name:instance-name con il nome della connessione dell'istanza visualizzato nella pagina Istanze Cloud SQL nella console Google Cloud.
• my-db-user con quickstart-user.
• my-db-password con la password del sqlserver che hai creato nella fase Crea un utente.
• my_db con quickstart-db.
7. Nel prompt dei comandi di Cloud Shell, nella directory java-docs-samples/cloud-sql/sqlserver/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

8. Se ti viene chiesto di scegliere la regione per creare l'app, inserisci la scelta numerica per us-central.
9. Quando ti viene richiesto se vuoi continuare?, inserisci Y.
10. Al termine del comando di deployment, 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 standard 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 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 una finestra di dialogo Autorizza Cloud Shell, fai clic su Autorizza.
5. Dal menu di navigazione Explorer dell'editor di Cloud Shell, vai al file python-docs-samples/cloud-sql/sql-server/sqlalchemy/app.standard.yaml e aprilo.
6. Sostituisci i segnaposto per le variabili di ambiente nel file app.standard.yaml con i seguenti valori:
• <PROJECT-ID> con il tuo ID progetto.
• <INSTANCE-REGION> con us-central1.
• <INSTANCE-NAME> con l'ID dell'istanza visualizzato nella pagina Istanze Cloud SQL nella console Google Cloud.
• <YOUR_DB_USER_NAME> con sqlserver.
• <YOUR_DB_PASSWORD> con la password del quickstart-user che hai creato nella fase Crea un utente.
• <YOUR_DB_NAME> con quickstart-db.
7. Nel prompt dei comandi di Cloud Shell, nella directory python-docs-samples/cloud-sql/sql-server/sqlalchemy, esegui questo comando gcloud app deploy per eseguire il deployment dell'app di esempio nell'ambiente standard di App Engine.

gcloud app deploy app.standard.yaml

8. Se ti viene chiesto di scegliere la regione per creare l'app, inserisci la scelta numerica per us-central.
9. Quando ti viene richiesto se vuoi continuare?, inserisci Y.
10. Al termine del comando di deployment, 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 standard di App Engine. Questo ambiente è connesso a Cloud SQL.

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 il certificato server 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 Scarica certificati per scaricare il certificato del server SSL.

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

1. Nella console Google Cloud, vai alla pagina Accesso VPC serverless - Crea connettore.

   Crea un connettore VPC serverless

2. Inserisci quickstart-connector come Nome.
3. Seleziona predefinita dal menu a discesa Rete.
4. Seleziona Intervallo IP personalizzato dal menu a discesa Subnet.
5. Inserisci 10.8.0.0 nella casella di immissione Intervallo IP.
6. Fai clic su Crea.

Crea app di esempio con certificato server 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 una finestra di dialogo Autorizza Cloud Shell, fai clic su Autorizza.
5. Carica il file del certificato del server SSL nella cartella certs.
   1. Dal menu di navigazione Explorer dell'editor di Cloud Shell, vai alla cartella golang-samples/cloudsql/sqlserver/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 il seguente file sulla macchina locale: server-ca.pem.
   4. Con il file del certificato server SSL selezionato, fai clic su Apri per completare il processo di caricamento del file nell'editor di Cloud Shell.
6. Dal menu di navigazione Explorer dell'editor di Cloud Shell, vai al file golang-samples/cloudsql/sqlserver/database-sql/cmd/app/app.standard.yaml e aprilo.
7. Copia e incolla il seguente codice nel file, sostituendo i contenuti esistenti del file:

runtime: go116

env_variables:
  INSTANCE_CONNECTION_NAME: PROJECT-ID:INSTANCE-REGION:INSTANCE-NAME
  DB_USER: sqlserver
  DB_PASS: YOUR_DB_PASSWORD
  DB_NAME: quickstart-db
  DB_PORT: 1433
  INSTANCE_HOST: INSTANCE_HOST
  DB_ROOT_CERT: certs/server-ca.pem
  PRIVATE_IP: TRUE

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

8. Sostituisci le variabili seguenti:
• PROJECT_ID con l'ID progetto.
• ISTANZA-REGION con us-central1.
• INSTANCE-NAME con l'ID dell'istanza visualizzato nella pagina Istanze Cloud SQL nella console Google Cloud.
• YOUR_DB_PASSWORD con la password del quickstart-user che hai creato nella fase Crea un utente.
• INSTANCE_HOST con l'indirizzo IP privato dell'istanza visualizzato nella pagina Istanze Cloud SQL nella console Google Cloud.
9. Nel prompt dei comandi di Cloud Shell, nella directory golang-samples/cloudsql/sqlserver/database-sql, esegui questo 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

10. Se ti viene chiesto di scegliere la regione per creare l'app, inserisci la scelta numerica per us-central.
11. Quando ti viene richiesto se vuoi continuare?, inserisci Y.
12. Al termine del comando di deployment, 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 standard di App Engine. Questo ambiente è connesso a Cloud SQL.

Node.js

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

1. Nella console Google Cloud, vai alla pagina Accesso VPC serverless - Crea connettore.

   Crea un connettore VPC serverless

2. Inserisci quickstart-connector come Nome.
3. Seleziona predefinita dal menu a discesa Rete
4. Seleziona Intervallo IP personalizzato dal menu a discesa Subnet.
5. Inserisci 10.8.0.0 nella casella di immissione Intervallo IP
6. Fai clic su Crea per creare il connettore.

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 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 una finestra di dialogo Autorizza Cloud Shell, fai clic su Autorizza.
5. Dal menu di navigazione Explorer dell'editor di Cloud Shell, vai al file nodejs-docs-samples/cloud-sql/sqlserver/mssql/app.standard.yaml e aprilo.
6. Sostituisci i segnaposto per le variabili di ambiente nel file app.standard.yaml con i seguenti valori:
• CLOUD_SQL_INSTANCE_IP_ADDRESS con l'indirizzo IP privato dell'istanza visualizzato nella pagina Istanze Cloud SQL nella console Google Cloud.
• MY_DB_USER con quickstart-user.
• MY_DB_PASSWORD con la password del quickstart-user che hai creato nella fase Crea un utente.
• MY_DATABASE con quickstart-db.
• <MY-PROJECT> con il tuo ID progetto.
• <CONNECTOR_NAME> con quickstart-connector.
7. Nel prompt dei comandi di Cloud Shell, nella directory nodejs-docs-samples/cloud-sql/sqlserver/mssql, esegui questo comando gcloud app deploy per eseguire il deployment dell'app di esempio nell'ambiente standard di App Engine.

gcloud app deploy app.standard.yaml

8. Se ti viene chiesto di scegliere la regione per creare l'app, inserisci la scelta numerica per us-central.
9. Quando ti viene richiesto se vuoi continuare?, inserisci Y.
10. Al termine del comando di deployment, 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 standard di App Engine. Questo ambiente è connesso a Cloud SQL.

Python

Crea e scarica il certificato server 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 Scarica certificati per scaricare il certificato del server SSL.

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

1. Nella console Google Cloud, vai alla pagina Accesso VPC serverless - Crea connettore.

   Crea un connettore VPC serverless

2. Inserisci quickstart-connector come Nome.
3. Seleziona predefinita dal menu a discesa Rete.
4. Seleziona Intervallo IP personalizzato dal menu a discesa Subnet.
5. Inserisci 10.8.0.0 nella casella di immissione Intervallo IP.
6. Fai clic su Crea.

Crea app di esempio con certificato server 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 una finestra di dialogo Autorizza Cloud Shell, fai clic su Autorizza.
5. Carica il file del certificato del server SSL nella cartella certs.
   1. Dal menu di navigazione Explorer dell'editor di Cloud Shell, vai alla cartella python-docs-samples/cloud-sql/sql-server/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 il seguente file sulla macchina locale: server-ca.pem.
   4. Con il file del certificato server SSL selezionato, fai clic su Apri per completare il processo di caricamento del file nell'editor di Cloud Shell.
6. Dal menu di navigazione Explorer dell'editor di Cloud Shell, vai al file python-docs-samples/cloud-sql/sql-server/sqlalchemy/app.standard.yaml e aprilo.
7. Copia e incolla il seguente codice nel file, sostituendo i contenuti esistenti del file:

runtime: python37
entrypoint: gunicorn -b :$PORT app:app

env_variables:
  DB_NAME: quickstart-db
  DB_USER: sqlserver
  DB_PASS: YOUR_DB_PASSWORD
  INSTANCE_HOST: INSTANCE_HOST
  DB_PORT: 1433
  DB_ROOT_CERT: certs/server-ca.pem
  PRIVATE_IP: TRUE

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

8. Sostituisci le variabili seguenti:
• YOUR_DB_PASSWORD con la password del quickstart-user che hai creato nella fase 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.
9. Nel prompt dei comandi di Cloud Shell, nella directory python-docs-samples/cloud-sql/sql-server/sqlalchemy, esegui questo comando gcloud app deploy per eseguire il deployment dell'app di esempio nell'ambiente standard di App Engine.

gcloud app deploy app.standard.yaml

10. Se ti viene chiesto di scegliere la regione per creare l'app, inserisci la scelta numerica per us-central.
11. Quando ti viene richiesto se vuoi continuare?, inserisci Y.
12. Al termine del comando di deployment, 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 standard 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. Se disattivi la tua app, non potrai più eseguire istanze e gestire le richieste. Se la tua app elabora una richiesta, la completa prima di essere disabilitata.

Per disabilitare un'app App Engine e conservare i relativi dati:

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

   Vai alle Impostazioni

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

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

Passaggi di pulizia facoltativi

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 (che raffigura una matita) per l'account IAM denominato Account di servizio predefinito di Compute Engine.
3. Elimina il ruolo Client Cloud SQL.
4. Fai clic su Salva.

Se non utilizzi le API che sono state abilitate in questa guida rapida, puoi disabilitarle.

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

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

   Vai alle API

2. Seleziona un'API che vuoi disabilitare e 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 di più sulla creazione di utenti SQL Server e database per la tua istanza Cloud SQL.

Per saperne di più sui prezzi, consulta la pagina relativa ai prezzi di Cloud SQL per SQL Server.

Scopri di più su:

• Configurazione dell'istanza Cloud SQL con un indirizzo IP pubblico.
• Configurazione dell'istanza Cloud SQL con un indirizzo IP privato.

Inoltre, puoi scoprire come connetterti a un'istanza Cloud SQL da altre applicazioni Google Cloud:

• Da un'applicazione in esecuzione nell'ambiente standard di App Engine
• Da un'applicazione in esecuzione su Compute Engine
• Da un'applicazione in esecuzione su GKE
• Da Cloud Functions
• Da Cloud Run