Connettiti a Cloud SQL per SQL Server da Cloud Run

Scopri come eseguire il deployment di un'app di esempio su Cloud Run 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

  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 senza costi per l'esecuzione, il test e il deployment dei workload.
  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud 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.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

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

    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.

    Go to project selector

  5. Verify that billing is enabled for your Google Cloud project.

  6. Verifica di disporre delle autorizzazioni necessarie per completare questa guida rapida.
  7. Abilita le API Cloud necessarie per eseguire un'app di esempio Cloud SQL su Cloud Run.

    Console

    Fai clic su Abilita API per abilitare le API richieste per questa guida rapida.

    Abilita le API

    Vengono abilitate le seguenti API:

    • API Compute Engine
    • API Cloud SQL Admin
    • API Cloud Run
    • API Container Registry
    • API Cloud Build
    • API Service Networking

    gcloud

    Fai clic sul pulsante seguente per aprire Cloud Shell, che fornisce l'accesso tramite 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.

    Apri Cloud Shell

    Esegui il seguente comando gcloud utilizzando Cloud Shell:

    gcloud services enable compute.googleapis.com sqladmin.googleapis.com run.googleapis.com \
    artifactregistry.googleapis.com cloudbuild.googleapis.com servicenetworking.googleapis.com

    Questo comando abilita le seguenti API:

    • API Compute Engine
    • API Cloud SQL Admin
    • API Cloud Run
    • API Artifact Registry
    • API Cloud Build
    • API Service Networking

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per eseguire il deployment di un'app di esempio su Cloud Run connessa a un'istanza SQL Server, chiedi all'amministratore di concederti i seguenti ruoli IAM nel progetto che vuoi utilizzare:

  • Creare o eliminare un repository Artifact Registry: Artifact Registry Writer (roles/artifactregistry.writer)
  • Creare o eliminare un'istanza, un database e un utente: ruolo Amministratore Cloud SQL (roles/cloudsql.admin).
  • Creare o eliminare un account di servizio IAM: ruolo Amministratore service account (roles/iam.serviceAccountAdmin).
  • Crea una connessione:
    • Service Networking Admin (roles/servicenetworking.networksAdmin))
    • Amministratore Service Usage (roles/serviceusage.serviceUsageAdmin).
  • Visualizza gli oggetti e i relativi metadati: Storage Object Viewer (roles/storage.objectViewer)
  • Fornisce le autorizzazioni per amministrare le policy sui progetti. Project IAM Admin (roles/resourcemanager.projectIamAdmin).
  • Accesso in lettura e scrittura a tutte le risorse Cloud Run: Sviluppatore Cloud Run (roles/run.developer).
  • Esegue il deployment e gestisce le risorse di cui è stato eseguito il deployment nell'origine Cloud Run: Cloud Run Source Developer (roles/run.sourceDeveloper).
  • Per consentire l'accesso pubblico: Cloud Run Admin (roles/run.admin).
  • Per eseguire operazioni come account di servizio: Service Account User (roles/iam.serviceAccountUser).

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Configura Cloud SQL

Crea un'istanza Cloud SQL

Crea un database

Per creare un database, segui questi passaggi:

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 dell'app di esempio in Cloud Run

Configura un account di servizio Cloud Run

Configura il service account predefinito di Compute Engine utilizzato da Cloud Run in modo che abbia i ruoli Cloud SQL Client e Visualizzatore oggetti Storage.

Console

  1. Nella console Google Cloud , vai alla pagina Service account IAM.

    Vai a Service account IAM

  2. Fai clic sul menu Azioni accanto al service account, quindi fai clic su Gestisci accesso.
  3. Fai clic su Aggiungi un altro ruolo, quindi trova e seleziona Client Cloud SQL (roles/cloudsql.client) nel menu a discesa Ruolo.
  4. Fai clic su Aggiungi un altro ruolo, quindi trova e seleziona Storage Object Viewer (roles/storage.objectViewer) nel menu a discesa Ruolo.
  5. Fai clic su Salva.

gcloud

  1. Esegui questo comando gcloud per ottenere un elenco dei service account del tuo progetto:
    gcloud iam service-accounts list
  2. Copia l'EMAIL del account di servizio predefinito di Compute Engine.
  3. Esegui questo comando per aggiungere il ruolo Cloud SQL Client al service account predefinito di Compute Engine:
    gcloud projects add-iam-policy-binding YOUR_PROJECT_ID \
      --member="serviceAccount:SERVICE_ACCOUNT_EMAIL" \
      --role="roles/cloudsql.client"
  4. Esegui questo comando per aggiungere il ruolo Storage Object Viewer al service account predefinito di Compute Engine:
    gcloud projects add-iam-policy-binding YOUR_PROJECT_ID \
      --member="serviceAccount:SERVICE_ACCOUNT_EMAIL" \
      --role="roles/storage.objectViewer"

Configura un'app di esempio Cloud SQL

Con un'istanza Cloud SQL, un database e un account di servizio con autorizzazioni client, ora puoi configurare un'applicazione di esempio per connetterti alla tua istanza Cloud SQL.

Esegui il deployment dell'app di esempio

I passaggi per eseguire il deployment dell'esempio in Cloud Run dipendono dal tipo di indirizzo IP assegnato all'istanza Cloud SQL.

Il metodo di connessione dell'immagine varia in base alle variabili di ambiente impostate.

  • Per connetterti utilizzando TCP, imposta il valore della variabile di ambiente INSTANCE_HOST. Questo metodo di connessione rispetta i certificati e le porte configurati come variabili di ambiente.
  • Per connetterti utilizzando i socket Unix, imposta il valore della variabile di ambiente INSTANCE_UNIX_SOCKET.

    Non impostare il valore della variabile di ambiente INSTANCE_HOST.

    I socket Unix non sono supportati in modo nativo in Java. Se la tua applicazione è scritta in Java, devi utilizzare il connettore Java di Cloud SQL.

  • Per connetterti utilizzando uno dei connettori dei linguaggi di Cloud SQL, imposta il valore della variabile di ambiente INSTANCE_CONNECTION_NAME .

    Non impostare i valori per le seguenti variabili di ambiente:

    • INSTANCE_HOST
    • INSTANCE_UNIX_SOCKET
    • DB_PORT
    • DB_ROOT_CERT
    • DB_CERT
    • DB_KEY
    Questi valori non vengono utilizzati perché il connettore dei linguaggi di Cloud SQL fornisce già una connessione sicura utilizzando il server proxy di autenticazione Cloud SQL, che stabilisce connessioni a Cloud SQL sulla porta 3307.

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.
  5. Nella console Google Cloud , vai alla pagina Cloud Run.

    Vai a Cloud Run

  6. Seleziona la casella di controllo accanto al nome del servizio quickstart-service.
  7. Fai clic su Elimina nella parte superiore della pagina di Cloud Run.

Passaggi di pulizia facoltativi

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

  1. Nella Google Cloud console, vai alla pagina Service account.

    Vai a IAM

  2. Fai clic sull'icona di modifica (che assomiglia a una matita) per l'account IAM denominato Service account predefinito Compute Engine.
  3. Elimina il ruolo Client Cloud SQL.
  4. Fai clic su Salva.

Se non utilizzi le API abilitate nell'ambito di 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 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 e database SQL Server per la tua istanza Cloud SQL.

Per ulteriori informazioni sui prezzi, consulta 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: