Connettiti a Cloud SQL per PostgreSQL dalle funzioni Cloud Run

Scopri come eseguire il deployment di un'app di esempio sulle funzioni Cloud Run collegate a un'istanza PostgreSQL utilizzando la console Google Cloud e un'applicazione client.

Se completi tutti i passaggi in modo tempestivo, le risorse create in questa guida rapida in genere costano meno di un dollaro.

Prima di iniziare

  1. 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.
  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Make sure 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.

    Go to project selector

  5. Make sure that billing is enabled for your Google Cloud project.

  6. Abilita le API Cloud necessarie per eseguire un'app di esempio Cloud SQL sulle funzioni Cloud Run.

    Console

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

    Abilita le API

    Vengono abilitate le seguenti API:

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

    gcloud

    Fai clic sul seguente pulsante per aprire Cloud Shell, che fornisce accesso da riga di comando alle 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 cloudfunctions.googleapis.com sqladmin.googleapis.com run.googleapis.com cloudbuild.googleapis.com artifactregistry.googleapis.com eventarc.googleapis.com compute.googleapis.com servicenetworking.googleapis.com pubsub.googleapis.com logging.googleapis.com

    Questo comando abilita le seguenti API:

    • API Cloud Run Functions
    • API Cloud SQL Admin
    • API Cloud Run
    • API Cloud Build
    • API Artifact Registry
    • API Eventarc
    • API Compute Engine
    • API Service Networking
    • API Cloud Logging
  7. Aggiungi al tuo utente il ruolo IAM Invoker delle funzioni Cloud Run.

    Aggiungi il ruolo

Configura Cloud SQL

Crea un'istanza Cloud SQL

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. Nel 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 Google 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. Nel menu di navigazione SQL, seleziona Utenti.
  4. Fai clic su Aggiungi account utente.
  5. Nella pagina Aggiungi un account utente per l'istanza quickstart-instance, 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. DB_PASS 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=DB_PASS

I limiti di lunghezza del nome utente sono gli stessi per Cloud SQL e per PostgreSQL on-premise.

Configura un account di servizio Cloud Run Functions

Configura l'account di servizio utilizzato dalle funzioni Cloud Run in modo che disponga del ruolo Client Cloud SQL con le autorizzazioni per connettersi 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 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 EMAIL dell'account di servizio Compute Engine.
  3. Esegui il seguente comando per aggiungere il ruolo Client Cloud SQL all'account di servizio Compute Engine:
    gcloud projects add-iam-policy-binding YOUR_PROJECT_ID \
      --member="serviceAccount:SERVICE_ACCOUNT_EMAIL" \
      --role="roles/cloudsql.client"

Crea una funzione

  1. Nella console Google Cloud, vai alla pagina Funzioni Cloud Run.

    Vai alle funzioni Cloud Run

  2. Fai clic su Crea funzione.
  3. Per Ambiente, seleziona 2ª gen..
  4. Nel campo Nome funzione, inserisci quickstart-function.
  5. Nella regione Autenticazione, seleziona Consenti chiamate non autenticate.
  6. Fai clic su Avanti.
  7. Dal menu Runtime, seleziona una delle seguenti lingue:
  8. Lingua Numero di versione
    Vai 1,20
    Java 17
    Node.js 18
    Python 3.10
  9. Nel menu Codice sorgente, verifica che sia selezionato Editor incorporato. In questo passaggio, utilizzerai la funzione predefinita fornita nell'editor.

esegui il deployment della funzione

  1. Nella parte inferiore della pagina Funzioni Cloud Run, fai clic su Esegui il deployment. La console Google Cloud ti reindirizza alla pagina dei dettagli della funzione.
  2. Al termine del deployment della funzione, fai clic sul link URL per visualizzare un browser web che mostra il messaggio Hello, World!.

Esegui il deployment dell'app di esempio Cloud SQL come funzione

Configura e esegui il deployment dell'app di esempio Cloud SQL come funzione nelle funzioni Cloud Run. Innanzitutto, utilizza Cloud Shell per configurare e compilare l'app di esempio. Poi, utilizza le funzioni Cloud Run per eseguire il deployment dell'app di esempio.

Esistono due modi per configurare, compilare ed eseguire il deployment dell'app, a seconda che tu abbia creato un'istanza Cloud SQL per PostgreSQL con un IP pubblico o privato.

Configura un'app di esempio Cloud SQL

Esegui il deployment dell'app di esempio

I passaggi per eseguire il deployment dell'esempio nelle funzioni Cloud Run dipendono dal tipo di indirizzo IP assegnato all'istanza 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 e fai clic su Elimina per eliminare l'istanza.
  5. Nella console Google Cloud, vai alla pagina Funzioni Cloud Run.

    Vai alle funzioni Cloud Run

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

Passaggi facoltativi per la pulizia

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 (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 Google Cloud, vai alla pagina API.

    Vai alle API

  2. Seleziona l'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 e database PostgreSQL per la tua istanza Cloud SQL.

Per ulteriori informazioni sui prezzi, consulta la pagina Prezzi di Cloud SQL per PostgreSQL.

Scopri di più su:

  • Configurare l'istanza Cloud SQL con un indirizzo IP pubblico.
  • Configurare l'istanza Cloud SQL con un indirizzo IP privato.

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