Configura un servizio Cloud Run

Cloud Run è una piattaforma applicativa completamente gestita che ti consente di eseguire container direttamente sull'infrastruttura scalabile di Google. Per saperne di più, consulta la panoramica di Cloud Run.

Questo documento descrive le connessioni e i parametri che puoi configurare quando utilizzi App Design Center per creare un servizio Cloud Run. I parametri di configurazione si basano sul modulo Terraform terraform-google-cloud-run.

Connessioni dei componenti

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

Componente connesso

Aggiornamenti delle applicazioni

Informazioni introduttive
Secret Manager
  • Il servizio Cloud Run può fare riferimento ai dati secret.
  • Il campo Dati secret di Secret Manager viene fatto riferimento dal campo env_secret_vars di Cloud Run.
  • Il ruolo roles/secretmanager.secretAccessor viene aggiunto al account di servizio Cloud Run.
 Configurare 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 aggiunto al account di servizio.
  • L'email del account di servizio e le informazioni IAM vengono aggiunte alle variabili di ambiente Cloud Run.
 Autenticazione da servizio a servizio
AlloyDB per PostgreSQL
  • Il servizio Cloud Run può connettersi all'istanza AlloyDB per PostgreSQL.
  • I metadati delle risorse AlloyDB per PostgreSQL vengono aggiunti alle variabili di ambiente Cloud Run.
  • Il ruolo roles/alloydb.admin AlloyDB per PostgreSQL viene aggiunto al account di servizio Cloud Run.
 Connettersi da Cloud Run
BigQuery
  • Il servizio Cloud Run può interagire con il set di dati BigQuery.
  • I metadati delle risorse BigQuery vengono aggiunti alle variabili di ambiente Cloud Run.
  • Il ruolo BigQuery roles/bigquery.dataEditor viene aggiunto 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 delle risorse Bigtable vengono aggiunte alle variabili di ambiente Cloud Run.
  • Il ruolo roles/bigtable.admin viene aggiunto 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 di connessione Cloud SQL vengono aggiunti al servizio Cloud Run.
  • I ruoli roles/cloudsql.instanceUser e roles/cloudsql.client vengono aggiunti al account di servizio Cloud Run.
  • Il account di servizio Cloud Run viene aggiunto come utente IAM all'istanza Cloud SQL.
 Connettersi da Cloud Run

Cloud SQL (PostgreSQL)
  • Il servizio Cloud Run può leggere e scrivere dati nell'istanza Cloud SQL (PostgreSQL).
  • I metadati di connessione Cloud SQL vengono aggiunti al servizio Cloud Run.
  • I ruoli roles/cloudsql.instanceUser e roles/cloudsql.client vengono aggiunti al account di servizio Cloud Run.
  • Il account di servizio Cloud Run viene aggiunto come utente IAM all'istanza Cloud SQL.
 Connettersi 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 assegnato al account di servizio Cloud Run.
 Connettiti ai servizi Google Cloud

Backend di bilanciamento del carico globale di Cloud Load Balancing
  • 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 nella cache i dati 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 aggiunto 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 nella cache i dati in Memorystore for Redis Cluster.
  • Le informazioni di connessione di Memorystore for Redis Cluster vengono aggiunte alle variabili di ambiente Cloud Run.
  • App Design Center aggiunge 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 nella cache i dati nell'istanza Memorystore for Valkey.
  • App Design Center aggiunge le informazioni di connessione Memorystore for Valkey alle variabili di ambiente Cloud Run.
  • App Design Center aggiunge il ruolo roles/memorystore.dbConnectionUser al account di servizio Cloud Run.
 Connettersi 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 Cloud Run.
  • I ruoli roles/pubsub.publisher e roles/pubsub.subscriber vengono aggiunti al account di servizio Cloud Run.
  • Il servizio Cloud Run viene aggiunto ai campi della sottoscrizione push e pull Pub/Sub.
 Tutorial sull'utilizzo di Pub/Sub con Cloud Run

Backend di 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 di 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 Cloud Load Balancing vengono aggiunti alle variabili di ambiente 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 Cloud Run.
  • Il ruolo roles/spanner.databaseAdmin viene aggiunto 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 aggiunto al account di servizio Cloud Run.
 Ospitare app e agenti AI su Cloud Run

Parametri di configurazione obbligatori

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

Nome parametro

Descrizione e vincoli

Informazioni introduttive

ID progetto

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

 Configurare i componenti

Regione

La località di deployment del servizio Cloud Run.

 Località Cloud Run

Nome del servizio

 name Servizio Cloud Run

Parametri di configurazione facoltativi

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

Funzionalità

Funzionalità secondaria

Nome parametro

Descrizione e informazioni sui vincoli

Informazioni introduttive
Container

Nome contenitore

 name Creazione di container

Immagine container

 image Deployment di immagini container in Cloud Run

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

Dipende dal container

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

Argomenti container

 args[] Configurare i container per i servizi

Container Command

 command Configurare i container per i servizi
Variabili di ambiente

Key (Chiave)

 name Variabili di ambiente per i servizi

Valore

 valore Variabili di ambiente per i servizi
Variabili secret di ambiente

Key (Chiave)

 EnvVarSource Gestire i secret

Secret

 secret Gestire i secret

Versione

 versione Gestire i secret
Montaggi volumi

Nome

 name Connettersi da Cloud Run

Percorso di montaggio

 mountPath Connettersi da Cloud Run
Porte

Nome

 name Utilizzare HTTP/2 per i servizi

Porta container

 containerPort Utilizzare HTTP/2 per i servizi
Risorse

CPU

 limits Configurare i limiti della CPU per i servizi

Memoria

 limits Configurare i limiti di memoria per i servizi

CPU inattiva

Indica se la CPU viene allocata solo durante le richieste.

 cpuIdle

Boosting della CPU all'avvio

 startupCPUBoost Impostare il boost della CPU all'avvio
Probe di avvio

Soglia di errore

 failureThreshold Configura i controlli di integrità dei container per i servizi

Initial Delay Seconds

 initialDelaySeconds Configura probe

Timeout (secondi)

 timeoutSeconds Configura probe

Period Seconds

 periodSeconds Configura probe

Percorso HTTP Get

 path Configura probe

HTTP Get Port

 porta Configura probe

Nome intestazioni HTTP

 name Configura probe

Valore delle intestazioni HTTP

 valore Configura probe

Porta socket TCP

 porta Probe di avvio TCP predefinito

Porta GRPC

 porta Configura probe

Servizio gRPC

 service Configura probe

Probe di attività

 livenessProbe Casi d'uso

Descrizione

 description Impostare le descrizioni dei servizi

Crea service account

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

 Configurare l'identità del servizio per i job

Ruoli del progetto del service account

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

 Configurare l'identità del servizio per i job

In entrata

 IngressTraffic Limitare il traffico in entrata della rete per Cloud Run

Membri

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

 Configurare l'identità del servizio per i job

Accesso VPC

Connettore

 connettore VPC con connettori

Egress egress Controllare il traffico del servizio in uscita

Interfacce di rete

 Rete network Esegui il deployment di un servizio
Subnet subnetwork Esegui il deployment di un servizio
Tag tag Esegui il deployment di un servizio

Protezione da eliminazione di Cloud Run

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

 deletion_protection

Abilita il file collaterale Prometheus

Abilita il file collaterale Prometheus nell'istanza Cloud Run.

 Scrivere metriche Prometheus utilizzando il sidecar Prometheus

Volumi

Nome

 name Configurare un volume in memoria
Secret Secret secret Rendere accessibile un secret a Cloud Run
Modalità predefinita defaultMode
Percorso path Rendere disponibile un secret per Cloud Run
Versione versione Rendere disponibile un secret per Cloud Run
Modalità mode Rendere disponibile un secret per Cloud Run
Istanza Cloud SQL Istanze instances[] Connettersi da Cloud Run
Empty Dir Medio medium Configurare i montaggi dei volumi in memoria per i servizi
Limite di dimensioni sizeLimit Configurare i montaggi dei volumi in memoria per i servizi
GCS Bucket bucket Configurare i montaggi dei volumi Cloud Storage per i servizi
Sola lettura readOnly Configurare i montaggi dei volumi Cloud Storage per i servizi
NFS Server server Configurare i montaggi dei volumi NFS per i servizi
Percorso path Configurare i montaggi dei volumi NFS per i servizi
Sola lettura readOnly Configurare i montaggi dei volumi NFS per i servizi

Scalabilità del servizio

Numero minimo di istanze

 minInstanceCount Impostare il numero minimo di istanze per i servizi

Revisione

 revisione Revisioni del servizio Cloud Run

Scalabilità dei modelli

Numero minimo di istanze

 minInstanceCount Impostare il numero minimo di istanze per i servizi
Numero massimo di istanze maxInstanceCount Informazioni sul numero massimo di istanze

Chiave di crittografia

 encryptionKey Utilizzo delle chiavi di crittografia gestite dal cliente

Max Instance Request Concurrency

 maxInstanceRequestConcurrency Numero massimo di richieste simultanee per i servizi

Affinità sessione

 sessionAffinity Impostare l'affinità sessione per i servizi

Ambiente di esecuzione

 executionEnvironment Informazioni sugli ambienti di esecuzione dei servizi

Traffico

Tipo

 type Rollback, implementazioni graduali e migrazione del traffico
Percent percento Rollback, implementazioni graduali e migrazione del traffico
Revisione revisione Rollback, implementazioni graduali e migrazione del traffico
Tag tag Rollback, implementazioni graduali e migrazione del traffico

Etichette di servizio

Key (Chiave)

 labels Configurare le etichette per i servizi
Valore labels Configurare le etichette per i servizi

Annotazioni del servizio

Key (Chiave)

 annotations annotations
Valore annotations annotations

Client

Nome

Identificatore arbitrario per il client API.

 client
Versione

Identificatore arbitrario per l'identificatore della versione.

 clientVersion

Launch Stage

 LaunchStage Fasi di lancio del prodotto

Segmenti di pubblico personalizzati

 customAudience Impostare segmenti di pubblico personalizzati per i servizi

Autorizzazione binaria

Motivazione deployment di emergenza

 breakglassJustification Utilizzare il deployment di emergenza
Usa valore predefinito useDefault Utilizza l'autorizzazione binaria

Etichette dei modelli

Key (Chiave)

 labels Configurare le etichette per i servizi
Valore labels Configurare le etichette per i servizi

Annotazioni del modello

Key (Chiave)

 annotations annotations
Valore annotations annotations

Timeout

 timeout Impostare il timeout delle richieste per i servizi

Account di servizio

 serviceAccount Configurare l'identità del servizio per i servizi