Scopri come eseguire il deployment di un'app di esempio nell'ambiente standard di App Engine
connessa 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 in genere costano meno di un dollaro (USD).
Prima di iniziare
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.
In the Google Cloud console, on the project selector page,
select or create a Google Cloud project.
Fai clic sul pulsante seguente per aprire Cloud Shell, che fornisce l'accesso da riga di comando alle tue risorse Google Cloud direttamente dal browser.
Cloud Shell può essere utilizzato per eseguire i comandi gcloud presentati in questa guida rapida.
L'ambiente standard di App Engine non supporta la connessione a
Cloud SQL per SQL Server tramite IP pubblico utilizzando i socket Unix, ma
le connessioni sono possibili utilizzando i connettori Go, Java e Python.
Console
Nella console Google Cloud , vai alla pagina Istanze Cloud SQL.
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 sqlserver. Salva questa password per un uso 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 sezione 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
desiderato 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.
gcloudcomputeaddressescreategoogle-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.
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 dimensione (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 deployment di un'app di esempio nell'ambiente standard di App Engine
Crea l'applicazione App Engine
Crea l'applicazione App Engine nel tuo Google Cloud 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 Google Cloud , vai alla pagina App Engine.
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:
gcloudappcreate
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.
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
L'ambiente standard App Engine supporta la connessione a
Cloud SQL per SQL Server tramite IP pubblico utilizzando
i connettori Go, Java e Python.
Vai
Nell'editor di Cloud Shell, apri il codice sorgente dell'app di esempio.
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:
gcloudconfigsetprojectYOUR-PROJECT-ID
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/sqlserver/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 il tuo ID progetto.
<INSTANCE-REGION> con us-central1.
<INSTANCE-NAME> con l'ID dell'istanza
che viene visualizzato nella pagina Istanze Cloud SQL
nella console Google Cloud .
<YOUR_DB_USER_NAME> con sqlserver.
<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/sqlserver/database-sql, esegui il comando gcloud app deploy per eseguire il deployment dell'app di esempio nell'ambiente standard di App Engine.
gcloudappdeploycmd/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:
gcloudappbrowse
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
Nell'editor di Cloud Shell, apri il codice sorgente dell'app di esempio.
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:
gcloudconfigsetprojectYOUR-PROJECT-ID
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/sqlserver/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:
project-name:region-name:instance-name con il nome connessione dell'istanza
visualizzato nella pagina Istanze Cloud SQL
della console Google Cloud .
my-db-user con quickstart-user.
my-db-password con la password di
sqlserver 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/sqlserver/servlet, esegui il comando Apache Mavenmvn clean package per eseguire il deployment dell'app di esempio nell'ambiente standard di App Engine.
mvncleanpackageappengine: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:
gcloudappbrowse
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
Nell'editor di Cloud Shell, apri il codice sorgente dell'app di esempio.
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:
gcloudconfigsetprojectYOUR-PROJECT-ID
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
python-docs-samples/cloud-sql/sql-server/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 il tuo ID progetto.
<INSTANCE-REGION> con us-central1.
<INSTANCE-NAME> con l'ID dell'istanza
che viene visualizzato nella pagina Istanze Cloud SQL
nella console Google Cloud .
<YOUR_DB_USER_NAME> con sqlserver.
<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/sql-server/sqlalchemy, esegui il comando gcloud app deploy per eseguire il deployment dell'app di esempio nell'ambiente standard di App Engine.
gcloudappdeployapp.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:
gcloudappbrowse
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.
Vai
Crea e scarica il certificato server SSL
Nella console Google Cloud , vai alla pagina Istanze Cloud SQL.
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:
gcloudconfigsetprojectYOUR-PROJECT-ID
Se viene visualizzata una finestra di dialogo Autorizza Cloud Shell, fai clic su Autorizza.
Carica il file del certificato server SSL nella cartella certs.
Dal menu di navigazione di Explorer dell'editor di Cloud Shell, vai alla cartella
golang-samples/cloudsql/sqlserver/database-sql/certs.
Fai clic con il tasto destro del mouse sulla cartella certs nell'editor di Cloud Shell e seleziona Carica file.
Seleziona il seguente file sulla tua macchina locale: server-ca.pem.
Con il file del certificato del server SSL selezionato, fai clic su Apri per completare la procedura di caricamento del file nell'editor di Cloud Shell.
Dal menu di navigazione di Explorer dell'editor di Cloud Shell, vai al file
golang-samples/cloudsql/sqlserver/database-sql/cmd/app/app.standard.yaml e aprilo.
Copia e incolla il seguente codice nel file, sostituendo il contenuto esistente:
INSTANCE-NAME con l'ID dell'istanza
che viene visualizzato nella pagina Istanze Cloud SQL
della console Google Cloud .
YOUR_DB_PASSWORD con la password del
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 Google Cloud .
Al prompt dei comandi di Cloud Shell, nella directory golang-samples/cloudsql/sqlserver/database-sql, esegui il comando gcloud app deploy per eseguire il deployment dell'app di esempio nell'ambiente standard di App Engine.
gcloudappdeploycmd/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:
gcloudappbrowse
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
Nella console Google Cloud , vai alla pagina Accesso VPC serverless - Crea connettore.
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:
gcloudconfigsetprojectYOUR-PROJECT-ID
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
nodejs-docs-samples/cloud-sql/sqlserver/mssql/app.standard.yaml e aprilo.
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
della console Google Cloud .
MY_DB_USER con quickstart-user.
MY_DB_PASSWORD con la password di
quickstart-user che hai creato in Creare un
utente.
MY_DATABASE con quickstart-db.
<MY-PROJECT> con il tuo ID progetto.
<CONNECTOR_NAME> con quickstart-connector.
Al prompt dei comandi di Cloud Shell, nella directory nodejs-docs-samples/cloud-sql/sqlserver/mssql, esegui il comando gcloud app deploy per eseguire il deployment dell'app di esempio nell'ambiente standard di App Engine.
gcloudappdeployapp.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:
gcloudappbrowse
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
Nella console Google Cloud , vai alla pagina Istanze Cloud SQL.
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:
gcloudconfigsetprojectYOUR-PROJECT-ID
Se viene visualizzata una finestra di dialogo Autorizza Cloud Shell, fai clic su Autorizza.
Carica il file del certificato server SSL nella cartella certs.
Dal menu di navigazione di Explorer dell'editor di Cloud Shell, vai alla cartella
python-docs-samples/cloud-sql/sql-server/sqlalchemy/certs.
Fai clic con il tasto destro del mouse sulla cartella certs nell'editor di Cloud Shell e seleziona Carica file.
Seleziona il seguente file sulla tua macchina locale: server-ca.pem.
Con il file del certificato del server SSL selezionato, fai clic su Apri per completare la procedura di caricamento del 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/sql-server/sqlalchemy/app.standard.yaml e aprilo.
Copia e incolla il seguente codice nel file, sostituendo
il contenuto esistente:
YOUR_DB_PASSWORD con la password del
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 Google Cloud .
PROJECT_ID con l'ID progetto.
Al prompt dei comandi di Cloud Shell, nella directory python-docs-samples/cloud-sql/sql-server/sqlalchemy, esegui il comando gcloud app deploy per eseguire il deployment dell'app di esempio nell'ambiente standard di App Engine.
gcloudappdeployapp.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:
gcloudappbrowse
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.
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 poi fai clic su Elimina per eliminare l'istanza.
La disattivazione dell'app impedisce l'esecuzione di istanze e la gestione delle 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:
Nella console Google Cloud , vai alla pagina Impostazioni:
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-07-09 UTC."],[],[]]