Connettiti a Cloud SQL per PostgreSQL da Cloud Run

Scopri come eseguire il deployment di un'app di esempio su Cloud Run connessa a un'istanza PostgreSQL utilizzando la console Trusted 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. In the Trusted Cloud console, on the project selector page, select or create a Trusted Cloud project.

    Go to project selector

  2. Verify that billing is enabled for your Trusted Cloud project.

  3. 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 da riga di comando alle tue risorse Trusted Cloud direttamente dal browser. Cloud Shell può essere utilizzato per eseguire i comandi gcloud presentati in questa guida rapida.

    Apri Cloud Shell

    Esegui questo comando gcloud utilizzando Cloud Shell:

    gcloud services enable compute.googleapis.com sqladmin.googleapis.com run.googleapis.com \
containerregistry.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 Container Registry
    • API Cloud Build
    • API Service Networking

Configura Cloud SQL

Crea un'istanza Cloud SQL

Crea un database

Console

  1. Nella console Trusted 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

Crea un utente

Console

  1. Nella console Trusted Cloud , vai alla pagina Istanze Cloud SQL.

    Vai a Istanze Cloud SQL

  2. Per aprire la pagina Panoramica di un'istanza, fai clic sul nome dell'istanza.
  3. Seleziona Utenti dal menu di navigazione SQL.
  4. Fai clic su Aggiungi account utente.
  5. Nella pagina Aggiungi un account utente all'istanza instance_name, aggiungi le seguenti informazioni:
    • Nel campo Nome utente, inserisci quickstart-user.
    • Nel campo Password, specifica una password per l'utente del database. Prendi nota di questo valore per utilizzarlo in un passaggio successivo di questa guida rapida.
  6. Fai clic su Aggiungi.

gcloud

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

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

Configura un account di servizio Cloud Run

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

Console

  1. Nella console Trusted Cloud , vai alla pagina IAM.

    Vai a IAM

  2. Per il account di servizio denominato Service account predefinito di Compute Engine, fai clic sull'icona a forma di matita.
  3. Fai clic su AGGIUNGI UN ALTRO RUOLO.
  4. Aggiungi il ruolo denominato Client Cloud SQL.
  5. Fai clic su Salva.

gcloud

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

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 all'istanza Cloud SQL.

Esegui il deployment dell'app di esempio

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

Il metodo di connessione delle immagini varia in base alle variabili di ambiente impostate.

  • Per connetterti tramite 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 Cloud SQL.

  • Per connetterti utilizzando uno dei connettori dei linguaggi 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 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 Trusted Cloud vengano addebitati costi relativi alle risorse utilizzate in questa pagina, segui questi passaggi.

  1. Nella console Trusted 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 e poi fai clic su Elimina per eliminare l'istanza.

  5. Nella console Trusted 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 Cloud Run.

Passaggi facoltativi di pulizia

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

  1. Nella console Trusted Cloud , vai alla pagina IAM.

    Vai a IAM

  2. Fai clic sull'icona di modifica (a forma di matita) per l'account IAM denominato Account di servizio predefinito Compute Engine.
  3. Elimina il ruolo Client Cloud SQL.
  4. 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

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

    Vai alle API

  2. Seleziona le API che vuoi disattivare e fai clic sul pulsante Disattiva 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: