Configura un servizio Cloud Run

In Application Design Center, puoi configurare un servizio Cloud Run per eseguire container stateless direttamente sull'infrastruttura scalabile e completamente gestita di Google. Puoi personalizzare il servizio per le connessioni dei componenti e i parametri di configurazione specifici. I parametri di configurazione sono elencati nel modulo Terraform terraform-google-cloud-run su GitHub.

Connessioni dei componenti

La tabella seguente include i componenti che puoi connettere a un servizio Cloud Run e i relativi aggiornamenti alla tua applicazione e al codice Terraform generato.

Componente collegato Aggiornamenti delle applicazioni Informazioni introduttive
Secret Manager
  • Il servizio Cloud Run può fare riferimento ai dati del secret.
  • Il campo Dati secret di Secret Manager è referenziato dal campo env_secret_vars di Cloud Run.
  • Il ruolo roles/secretmanager.secretAccessor viene concesso al account di servizio Cloud Run.
Configura i secret per i servizi

Service account

  • Il servizio Cloud Run utilizza il account di servizio come identità di servizio.
  • Il ruolo roles/run.invoker viene concesso al account di servizio.
  • L'indirizzo email del account di servizio e le informazioni di Identity and Access Management (IAM) vengono aggiunti alle variabili di ambiente di Cloud Run.
Autenticazione service-to-service
AlloyDB per PostgreSQL
  • Il servizio Cloud Run può connettersi all'istanza AlloyDB.
  • I metadati della risorsa AlloyDB vengono aggiunti alle variabili di ambiente di Cloud Run.
  • Il ruolo roles/alloydb.admin viene concesso al account di servizio Cloud Run.
Connettiti da Cloud Run
BigQuery
  • Il servizio Cloud Run può interagire con il set di dati BigQuery.
  • I metadati della risorsa BigQuery vengono aggiunti alle variabili di ambiente di Cloud Run.
  • Il ruolo roles/bigquery.dataEditor viene concesso al account di servizio Cloud Run.
Panoramica di BigQuery

Bigtable

  • Il servizio Cloud Run può eseguire funzioni amministrative sull'istanza Bigtable.
  • Le informazioni sui metadati della risorsa Bigtable vengono aggiunte alle variabili di ambiente di Cloud Run.
  • Il ruolo roles/bigtable.admin viene concesso al account di servizio Cloud Run.
Panoramica di Bigtable

Un altro servizio Cloud Run

  • Il servizio Cloud Run di origine può inviare traffico al servizio Cloud Run di destinazione.
  • Il servizio Cloud Run di origine contiene l'URI del servizio Cloud Run di destinazione nelle sue variabili di ambiente.
Che cos'è Cloud Run

Cloud SQL (MySQL)

  • Il servizio Cloud Run può leggere e scrivere dati nell'istanza Cloud SQL (MySQL).
  • I metadati della connessione Cloud SQL vengono aggiunti al servizio Cloud Run.
  • I ruoli roles/cloudsql.instanceUser e roles/cloudsql.client vengono concessi al account di servizio Cloud Run.
  • Il account di servizio Cloud Run viene aggiunto come utente IAM all'istanza Cloud SQL.
Connettiti da Cloud Run

Cloud SQL (PostgreSQL)

  • Il servizio Cloud Run può leggere e scrivere dati nell'istanza Cloud SQL (PostgreSQL).
  • I metadati della connessione Cloud SQL vengono aggiunti al servizio Cloud Run.
  • I ruoli roles/cloudsql.instanceUser e roles/cloudsql.client vengono concessi al account di servizio Cloud Run.
  • Il account di servizio Cloud Run viene aggiunto come utente IAM all'istanza Cloud SQL.
Connettiti da Cloud Run

Cloud Storage

  • Il servizio Cloud Run può gestire gli oggetti nel bucket Cloud Storage.
  • Le informazioni IAM del account di servizio Cloud Run vengono aggiunte al bucket Cloud Storage.
  • Il ruolo roles/storage.objectAdmin viene concesso al account di servizio Cloud Run.
Connettiti ai servizi Google Cloud

Backend di Cloud Load Balancing globale

  • Il bilanciatore del carico può distribuire il traffico in entrata al servizio Cloud Run.
  • Il servizio Cloud Run viene aggiunto come endpoint di backend nella configurazione dei backend NEG serverless di Cloud Load Balancing.
Configura un bilanciatore del carico delle applicazioni esterno globale con Cloud Run

Memorystore for Redis

  • Il servizio Cloud Run può memorizzare i dati nella cache nell'istanza Memorystore for Redis.
  • Le informazioni di connessione di Memorystore for Redis vengono aggiunte alle variabili di ambiente di Cloud Run.
  • Il ruolo roles/redis.editor viene concesso al account di servizio Cloud Run.
Connessione a un'istanza Redis da un servizio Cloud Run

Memorystore for Redis Cluster

  • Il servizio Cloud Run può memorizzare i dati nella cache nell'istanza Memorystore for Redis Cluster.
  • Le informazioni di connessione di Memorystore for Redis Cluster vengono aggiunte alle variabili di ambiente di Cloud Run.
  • App Design Center concede il ruolo roles/redis.dbConnectionUser al account di servizio Cloud Run.
Connettiti a un'istanza Memorystore for Redis Cluster

Memorystore for Valkey

  • Il servizio Cloud Run può memorizzare i dati nella cache nell'istanza Memorystore for Valkey.
  • App Design Center aggiunge le informazioni di connessione di Memorystore for Valkey alle variabili di ambiente di Cloud Run.
  • App Design Center concede il ruolo roles/memorystore.dbConnectionUser al account di servizio Cloud Run.
Connettiti a un'istanza Memorystore for Valkey

Pub/Sub

  • Il servizio Cloud Run può ricevere messaggi o pubblicare nell'argomento Pub/Sub.
  • L'ID argomento Pub/Sub viene aggiunto alle variabili di ambiente di Cloud Run.
  • I ruoli roles/pubsub.publisher e roles/pubsub.subscriber vengono concessi al account di servizio Cloud Run.
  • Il servizio Cloud Run viene aggiunto ai campi della sottoscrizione push e pull di Pub/Sub.
Tutorial sull'utilizzo di Pub/Sub con Cloud Run

Backend Cloud Load Balancing regionale

  • Il bilanciatore del carico può distribuire il traffico in entrata al servizio Cloud Run.
  • Il servizio Cloud Run viene aggiunto come endpoint di backend nella configurazione dei backend NEG serverless di Cloud Load Balancing.
Configura un bilanciatore del carico delle applicazioni esterno regionale con Cloud Run

Frontend Cloud Load Balancing regionale

  • Gli indirizzi IP HTTP e HTTPS del bilanciatore del carico sono disponibili per l'applicazione in esecuzione nel container Cloud Run.
  • I metadati dell'indirizzo di Cloud Load Balancing vengono aggiunti alle variabili di ambiente di Cloud Run.
Panoramica delle regole di forwarding

Spanner

  • Il servizio Cloud Run può gestire l'istanza Spanner.
  • I dettagli della connessione Spanner vengono aggiunti alle variabili di ambiente di Cloud Run.
  • Il ruolo roles/spanner.databaseAdmin viene concesso al account di servizio Cloud Run.
  • Le informazioni IAM del account di servizio Cloud Run vengono aggiunte all'istanza Spanner.
Connettiti ai servizi Google Cloud

Vertex AI

  • Il servizio Cloud Run può interagire con i servizi Vertex AI.
  • Il ruolo roles/aiplatform.user viene concesso al account di servizio Cloud Run.
Ospita app di AI e agenti su Cloud Run

Parametri di configurazione obbligatori

Se il modello include un componente Cloud Run, devi configurare i seguenti parametri prima di eseguire il deployment.

Nome parametro Descrizione e vincoli Informazioni introduttive

ID progetto

Il progetto in cui vuoi eseguire il deployment della risorsa Cloud Run.

Configura i componenti

Regione

La località di deployment del servizio Cloud Run.

Località di Cloud Run

Nome servizio

name Servizio Cloud Run

Parametri di configurazione facoltativi

I seguenti parametri sono facoltativi. Per visualizzare i parametri avanzati, nell'area Configurazione, seleziona Mostra campi avanzati.

Funzionalità Nome parametro Descrizione e informazioni sui vincoli Informazioni introduttive
Container

Nome contenitore

name Creazione di container
Container

Immagine container

image Deployment di immagini container in Cloud Run
Container

Working Dir

La directory di lavoro del container. Se non specificato, viene utilizzato il valore predefinito del runtime del container, che potrebbe essere configurato nell'immagine container.

workingDir
Container

Dipende dal container

dependsOn[] Configura l'ordine di avvio dei container per i deployment sidecar
Container

Argomenti container

args[] Configura i container per i servizi
Container

Comando container

command Configura i container per i servizi
Container: variabili di ambiente

Key (Chiave)

name Variabili di ambiente per i servizi
Container: variabili di ambiente

Valore

valore Variabili di ambiente per i servizi
Container: variabili di ambiente secret

Key (Chiave)

EnvVarSource Rendi un secret accessibile a Cloud Run
Container: variabili di ambiente secret

Secret

secret Rendi un secret accessibile a Cloud Run
Container: variabili di ambiente secret

Versione

version Rendi un secret accessibile a Cloud Run
Container: montaggi volumi

Nome

name Connettiti da Cloud Run
Container: montaggi volumi

Percorso di montaggio

mountPath Connettiti da Cloud Run
Container: porte

Nome

name Utilizza HTTP/2 per i servizi
Container: porte

Porta container

containerPort Utilizza HTTP/2 per i servizi
Container: risorse

CPU

limits Configura i limiti di CPU per i servizi
Container: risorse

Memoria

limits Configura i limiti di memoria per i servizi
Container: risorse

CPU inattiva

Indica se la CPU viene allocata solo durante le richieste.

cpuIdle
Container: risorse

Boost della CPU all'avvio

startupCPUBoost Imposta il boost della CPU all'avvio
Container: probe di avvio

Soglia di errore

failureThreshold Configura i controlli di integrità dei container per i servizi
Container: probe di avvio

Initial Delay Seconds

initialDelaySeconds Configura i probe di avvio
Container: probe di avvio

Timeout (secondi)

timeoutSeconds Configura i probe di avvio
Container: probe di avvio

Period Seconds

periodSeconds Configura i probe di avvio
Container: probe di avvio

Percorso HTTP Get

path Configura i probe di avvio
Container: probe di avvio

Porta HTTP Get

port Configura i probe di avvio
Container: probe di avvio

Nome intestazioni HTTP

name Configura i probe di avvio
Container: probe di avvio

Valore delle intestazioni HTTP

valore Configura i probe di avvio
Container: probe di avvio

Porta socket TCP

port Probe di avvio TCP predefinito
Container: probe di avvio

Porta GRPC

port Configura i probe di avvio
Container: probe di avvio

Servizio gRPC

service Configura i probe di avvio
Container

Probe di attività

livenessProbe Casi d'uso

Descrizione

description Imposta le descrizioni dei servizi

Crea service account

Crea un nuovo account di servizio per il servizio Cloud Run.

Configura l'identità di servizio per i servizi

Ruoli dei progetti dei service account

Ruoli da concedere al account di servizio appena creato. Attiva Crea service account e non fornire input per Service account.

Configura l'identità di servizio per i servizi

In entrata

IngressTraffic Limita il traffico di rete in entrata per Cloud Run

Membri

Utenti e service account che possono richiamare il servizio. Per l'accesso pubblico, inserisci allUsers. Per l'accesso da parte di utenti Google che hanno eseguito l'accesso, inserisci allAuthenticatedUsers o un elenco di utenti e service account specifici. Per saperne di più, consulta la sezione Membri.

Gestisci l'accesso ai servizi
Accesso VPC

Connettore

connector VPC con connettori
Accesso VPC Egress egress Controlla il traffico dei servizi in uscita
Accesso VPC: interfacce di rete Rete network Esegui il deployment di un servizio
Accesso VPC: interfacce di rete Subnet subnetwork Esegui il deployment di un servizio
Accesso VPC: interfacce di rete Tag tag Esegui il deployment di un servizio

Protezione da eliminazione di Cloud Run

Impedisce a Terraform di eliminare o ricreare job e servizi Cloud Run.

deletion_protection

Abilita il sidecar Prometheus

Abilita il sidecar Prometheus nel servizio Cloud Run.

Scrivi le metriche di Prometheus utilizzando il sidecar di Prometheus
Volumi

Nome

name Configura un volume in memoria
Volumi: Secret Secret secret Rendi un secret accessibile a Cloud Run
Volumi: Secret Modalità predefinita defaultMode Rendi un secret accessibile a Cloud Run
Volumi: Secret Percorso path Rendi un secret accessibile a Cloud Run
Volumi: Secret Versione version Rendi un secret accessibile a Cloud Run
Volumi: Secret Modalità mode Rendi un secret accessibile a Cloud Run
Volumi: istanza Cloud SQL Istanze instances[] Connettiti da Cloud Run
Volumi: EmptyDir Medio medium Configura i montaggi dei volumi in memoria per i servizi
Volumi: EmptyDir Limite di dimensioni sizeLimit Configura i montaggi dei volumi in memoria per i servizi
Volumi: GCS Bucket bucket Configura i montaggi dei volumi Cloud Storage per i servizi
Volumi: GCS Sola lettura readOnly Configura i montaggi dei volumi Cloud Storage per i servizi
Volumi: NFS Server server Configura i montaggi dei volumi NFS per i servizi
Volumi: NFS Percorso path Configura i montaggi dei volumi NFS per i servizi
Volumi: NFS Sola lettura readOnly Configura i montaggi dei volumi NFS per i servizi
Scalabilità del servizio

Numero minimo di istanze

minInstanceCount Imposta il numero minimo di istanze per i servizi

Revisione

revision Revisioni dei servizi Cloud Run
Scalabilità dei modelli

Numero minimo di istanze

minInstanceCount Imposta il numero minimo di istanze per i servizi
Scalabilità dei modelli Numero massimo di istanze maxInstanceCount Informazioni sul numero massimo di istanze

Chiave di crittografia

encryptionKey Utilizzo delle chiavi di crittografia gestite dal cliente

Contemporaneità massima delle richieste per istanza

maxInstanceRequestConcurrency Numero massimo di richieste in parallelo per i servizi

Affinità di sessione

sessionAffinity Imposta l'affinità sessione per i servizi

Ambiente di esecuzione

executionEnvironment Informazioni sugli ambienti di esecuzione dei servizi
Traffico

Tipo

type Rollback, rilasci graduali e migrazione del traffico
Traffico Percent percent Rollback, rilasci graduali e migrazione del traffico
Traffico Revisione revision Rollback, rilasci graduali e migrazione del traffico
Traffico Tag tag Rollback, rilasci graduali e migrazione del traffico
Etichette di servizio

Key (Chiave)

labels Configura le etichette per i servizi
Etichette di servizio Valore labels Configura le etichette per i servizi
Annotazioni di servizio

Key (Chiave)

annotations annotations
Annotazioni di servizio Valore annotations annotations
Client

Nome

Identificatore arbitrario per il client API.

client
Client Versione

Identificatore arbitrario per la versione del client API.

clientVersion

Fase di lancio

LaunchStage Fasi di lancio dei prodotti

Segmenti di pubblico personalizzati

customAudience Imposta segmenti di pubblico personalizzati per i servizi
Autorizzazione binaria

Motivazione deployment di emergenza

breakglassJustification Utilizza il deployment di emergenza
Autorizzazione binaria Usa valore predefinito useDefault Utilizza Autorizzazione binaria
Etichette dei modelli

Key (Chiave)

labels Configurazione delle etichette per i servizi
Etichette dei modelli Valore labels Configurazione delle etichette per i servizi
Annotazioni del modello

Key (Chiave)

annotations annotations
Annotazioni del modello Valore annotations annotations

Timeout

timeout Imposta il timeout della richiesta per i servizi

Account di servizio

serviceAccount Configura l'identità di servizio per i servizi