Configurer un service Cloud Run

Dans Application Design Center, vous pouvez configurer un service Cloud Run pour exécuter des conteneurs sans état directement sur l'infrastructure évolutive et entièrement gérée de Google. Vous pouvez personnaliser le service pour vos connexions de composants et paramètres de configuration spécifiques. Les paramètres de configuration sont listés dans le module Terraform terraform-google-cloud-run sur GitHub.

Connexions des composants

Le tableau suivant inclut les composants que vous pouvez connecter à un service Cloud Run, ainsi que les mises à jour de votre application et de son code Terraform généré qui en résultent.

Composant connecté Mises à jour de l'application Informations générales
Secret Manager
  • Le service Cloud Run peut référencer les données du secret.
  • Le champ Données du secret de Secret Manager est référencé par le champ env_secret_vars de Cloud Run.
  • Le rôle roles/secretmanager.secretAccessor est attribué au compte de service Cloud Run.
Configurer des secrets pour les services

Compte de service

  • Le service Cloud Run utilise le compte de service comme identité de service.
  • Le rôle roles/run.invoker est attribué au compte de service.
  • L'adresse e-mail du compte de service et les informations IAM (Identity and Access Management) sont ajoutées aux variables d'environnement Cloud Run.
Authentification de service à service
AlloyDB pour PostgreSQL
  • Le service Cloud Run peut se connecter à l'instance AlloyDB.
  • Les métadonnées de la ressource AlloyDB sont ajoutées aux variables d'environnement Cloud Run.
  • Le rôle roles/alloydb.admin est attribué au compte de service Cloud Run.
Connexion depuis Cloud Run
BigQuery
  • Le service Cloud Run peut interagir avec l'ensemble de données BigQuery.
  • Les métadonnées de la ressource BigQuery sont ajoutées aux variables d'environnement Cloud Run.
  • Le rôle roles/bigquery.dataEditor est attribué au compte de service Cloud Run.
Présentation de BigQuery

Bigtable

  • Le service Cloud Run peut effectuer des fonctions d'administration sur l'instance Bigtable.
  • Les métadonnées de la ressource Bigtable sont ajoutées aux variables d'environnement Cloud Run.
  • Le rôle roles/bigtable.admin est attribué au compte de service Cloud Run.
Présentation de Bigtable

Un autre service Cloud Run

  • Le service Cloud Run source peut envoyer du trafic au service Cloud Run de destination.
  • Le service Cloud Run source contient l'URI du service Cloud Run de destination dans ses variables d'environnement.
Qu'est-ce que Cloud Run ?

Cloud SQL (MySQL)

  • Le service Cloud Run peut lire et écrire des données dans l'instance Cloud SQL (MySQL).
  • Les métadonnées de connexion Cloud SQL sont ajoutées au service Cloud Run.
  • Les rôles roles/cloudsql.instanceUser et roles/cloudsql.client sont attribués au compte de service Cloud Run.
  • Le compte de service Cloud Run est ajouté en tant qu'utilisateur IAM à l'instance Cloud SQL.
Connexion depuis Cloud Run

Cloud SQL (PostgreSQL)

  • Le service Cloud Run peut lire et écrire des données dans l'instance Cloud SQL (PostgreSQL).
  • Les métadonnées de connexion Cloud SQL sont ajoutées au service Cloud Run.
  • Les rôles roles/cloudsql.instanceUser et roles/cloudsql.client sont attribués au compte de service Cloud Run.
  • Le compte de service Cloud Run est ajouté en tant qu'utilisateur IAM à l'instance Cloud SQL.
Connexion depuis Cloud Run

Cloud Storage

  • Le service Cloud Run peut gérer les objets du bucket Cloud Storage.
  • Les informations IAM du compte de service Cloud Run sont ajoutées au bucket Cloud Storage.
  • Le rôle roles/storage.objectAdmin est attribué au compte de service Cloud Run.
Se connecter aux services Google Cloud

Backend Cloud Load Balancing global

  • L'équilibreur de charge peut distribuer le trafic entrant vers le service Cloud Run.
  • Le service Cloud Run est ajouté en tant que point de terminaison de backend dans la configuration des backends de NEG sans serveur Cloud Load Balancing.
Configurer un équilibreur de charge d'application externe global avec Cloud Run

Memorystore pour Redis

  • Le service Cloud Run peut mettre en cache les données dans l'instance Memorystore pour Redis.
  • Les informations de connexion Memorystore pour Redis sont ajoutées aux variables d'environnement Cloud Run.
  • Le rôle roles/redis.editor est attribué au compte de service Cloud Run.
Se connecter à une instance Redis à partir d'un service Cloud Run

Memorystore for Redis Cluster

  • Le service Cloud Run peut mettre en cache les données dans l'instance Memorystore for Redis Cluster.
  • Les informations de connexion à Memorystore for Redis Cluster sont ajoutées aux variables d'environnement Cloud Run.
  • App Design Center attribue le rôle roles/redis.dbConnectionUser au compte de service Cloud Run.
Se connecter à une instance Memorystore for Redis Cluster

Memorystore for Valkey

  • Le service Cloud Run peut mettre en cache les données dans l'instance Memorystore pour Valkey.
  • App Design Center ajoute les informations de connexion Memorystore pour Valkey aux variables d'environnement Cloud Run.
  • App Design Center attribue le rôle roles/memorystore.dbConnectionUser au compte de service Cloud Run.
Se connecter à une instance Memorystore pour Valkey

Pub/Sub

  • Le service Cloud Run peut recevoir des messages ou publier dans le sujet Pub/Sub.
  • L'ID du sujet Pub/Sub est ajouté aux variables d'environnement Cloud Run.
  • Les rôles roles/pubsub.publisher et roles/pubsub.subscriber sont attribués au compte de service Cloud Run.
  • Le service Cloud Run est ajouté aux champs d'abonnement push et pull Pub/Sub.
Tutoriel : Utiliser Pub/Sub avec Cloud Run

Backend Cloud Load Balancing régional

  • L'équilibreur de charge peut distribuer le trafic entrant vers le service Cloud Run.
  • Le service Cloud Run est ajouté en tant que point de terminaison de backend dans la configuration des backends de NEG sans serveur Cloud Load Balancing.
Configurer un équilibreur de charge d'application externe régional avec Cloud Run

Interface Cloud Load Balancing régionale

  • Les adresses IP HTTP et HTTPS de l'équilibreur de charge sont disponibles pour l'application exécutée dans le conteneur Cloud Run.
  • Les métadonnées d'adresse Cloud Load Balancing sont ajoutées aux variables d'environnement Cloud Run.
Présentation des règles de transfert

Spanner

  • Le service Cloud Run peut gérer l'instance Spanner.
  • Les détails de la connexion Spanner sont ajoutés aux variables d'environnement Cloud Run.
  • Le rôle roles/spanner.databaseAdmin est attribué au compte de service Cloud Run.
  • Les informations IAM du compte de service Cloud Run sont ajoutées à l'instance Spanner.
Se connecter aux services Google Cloud

Vertex AI

  • Le service Cloud Run peut interagir avec les services Vertex AI.
  • Le rôle roles/aiplatform.user est attribué au compte de service Cloud Run.
Héberger des applications et des agents d'IA sur Cloud Run

Paramètres de configuration requis

Si votre modèle inclut un composant Cloud Run, vous devez configurer les paramètres suivants avant de procéder au déploiement.

Nom du paramètre Description et contraintes Informations générales

ID du projet

Projet dans lequel vous souhaitez déployer la ressource Cloud Run.

Configurer les composants

Région

Emplacement de déploiement du service Cloud Run.

Emplacements Cloud Run

Nom du service

name Service Cloud Run

Paramètres de configuration facultatifs

Les paramètres suivants sont facultatifs. Pour afficher les paramètres avancés, dans la zone Configuration, sélectionnez Afficher les champs avancés.

Fonctionnalité Nom du paramètre Description et informations sur les contraintes Informations générales
Conteneurs

Nom du conteneur

name Créer des conteneurs
Conteneurs

Image de conteneur

image Déployer des images de conteneurs dans Cloud Run
Conteneurs

Répertoire de travail

Répertoire de travail du conteneur. Si aucune valeur n'est spécifiée, la valeur par défaut de l'environnement d'exécution du conteneur est utilisée, qui peut être configurée dans l'image de conteneur.

workingDir
Conteneurs

Dépend du conteneur

dependsOn[] Configurer l'ordre de démarrage des conteneurs pour les déploiements side-car
Conteneurs

Arguments du conteneur

args[] Configurer des conteneurs pour les services
Conteneurs

Commande du conteneur

command Configurer des conteneurs pour les services
Conteneurs : variables d'environnement

Clé

name Variables d'environnement pour les services
Conteneurs : variables d'environnement

Valeur

value Variables d'environnement pour les services
Conteneurs : variables d'environnement de secret

Clé

EnvVarSource Rendre un secret accessible à Cloud Run
Conteneurs : variables d'environnement de secret

Secret

secret Rendre un secret accessible à Cloud Run
Conteneurs : variables d'environnement de secret

Version

version Rendre un secret accessible à Cloud Run
Conteneurs : installations de volumes

Nom

name Connexion depuis Cloud Run
Conteneurs : installations de volumes

Chemin d'installation

mountPath Connexion depuis Cloud Run
Conteneurs : ports

Nom

name Utiliser HTTP/2 pour les services
Conteneurs : ports

Port du conteneur

containerPort Utiliser HTTP/2 pour les services
Conteneurs : ressources

Processeur

limits Configurer les limites de processeur pour les services
Conteneurs : ressources

Mémoire

limits Configurer les limites de mémoire pour les services
Conteneurs : ressources

Processeur inactif

Indique si le processeur n'est alloué que pendant les requêtes.

cpuIdle
Conteneurs : ressources

Optimisation du CPU au démarrage

startupCPUBoost Configurer l'optimisation du processeur au démarrage
Conteneurs : vérification de démarrage

Seuil d'échec

failureThreshold Configurer des vérifications d'état de conteneur pour les services
Conteneurs : vérification de démarrage

Secondes de délai initial

initialDelaySeconds Configurer des vérifications de démarrage
Conteneurs : vérification de démarrage

Délai avant expiration (en secondes)

timeoutSeconds Configurer des vérifications de démarrage
Conteneurs : vérification de démarrage

Secondes de la période

periodSeconds Configurer des vérifications de démarrage
Conteneurs : vérification de démarrage

Chemin d'accès HTTP Get

path Configurer des vérifications de démarrage
Conteneurs : vérification de démarrage

Port HTTP Get

port Configurer des vérifications de démarrage
Conteneurs : vérification de démarrage

Nom des en-têtes HTTP

name Configurer des vérifications de démarrage
Conteneurs : vérification de démarrage

Valeur des en-têtes HTTP

value Configurer des vérifications de démarrage
Conteneurs : vérification de démarrage

Port de socket TCP

port Vérification de démarrage TCP par défaut
Conteneurs : vérification de démarrage

Port GRPC

port Configurer des vérifications de démarrage
Conteneurs : vérification de démarrage

Service gRPC

service Configurer des vérifications de démarrage
Conteneurs

Vérification d'activité

livenessProbe Cas d'utilisation

Description

description Définir des descriptions de services

Créer un compte de service

Créez un compte de service pour le service Cloud Run.

Configurer l'identité du service pour les services

Rôles de projet du compte de service

Rôles à attribuer au compte de service nouvellement créé. Activez l'option Créer un compte de service et ne fournissez pas d'entrée pour Compte de service.

Configurer l'identité du service pour les services

Entrée

IngressTraffic Restreindre l'entrée réseau pour Cloud Run

Membres

Utilisateurs et comptes de service pouvant appeler le service. Pour un accès public, saisissez allUsers. Pour autoriser l'accès aux utilisateurs Google connectés, saisissez allAuthenticatedUsers ou une liste d'utilisateurs et de comptes de service spécifiques. Pour en savoir plus, consultez Membres.

Gérer l'accès aux services
Accès VPC

Connecteur

connector VPC avec connecteurs
Accès VPC Sortie egress Contrôler le trafic du service de sortie
Accès au VPC : interfaces réseau Réseau réseau Déployer un service
Accès au VPC : interfaces réseau Sous-réseau subnetwork Déployer un service
Accès au VPC : interfaces réseau Tags tags Déployer un service

Protection contre la suppression Cloud Run

Empêche Terraform de détruire ou de recréer des jobs et des services Cloud Run.

deletion_protection

Activer le side-car Prometheus

Activez le side-car Prometheus dans le service Cloud Run.

Écrire des métriques Prometheus à l'aide du side-car Prometheus
Volumes

Nom

name Configurer un volume en mémoire
Volumes : Secret Secret secret Rendre un secret accessible à Cloud Run
Volumes : Secret Mode par défaut defaultMode Rendre un secret accessible à Cloud Run
Volumes : Secret Chemin d'accès path Rendre un secret accessible à Cloud Run
Volumes : Secret Version version Rendre un secret accessible à Cloud Run
Volumes : Secret Mode mode Rendre un secret accessible à Cloud Run
Volumes : instance Cloud SQL Instances instances[] Connexion depuis Cloud Run
Volumes : EmptyDir Moyenne medium Configurer les installations de volume en mémoire pour les services
Volumes : EmptyDir Limite de taille sizeLimit Configurer les installations de volume en mémoire pour les services
Volumes : GCS Bucket bucket Configurer des installations de volume Cloud Storage pour les services
Volumes : GCS Lecture seule readOnly Configurer des installations de volume Cloud Storage pour les services
Volumes : NFS Serveur server Configurer des montages de volume NFS pour les services
Volumes : NFS Chemin d'accès path Configurer des montages de volume NFS pour les services
Volumes : NFS Lecture seule readOnly Configurer des montages de volume NFS pour les services
Scaling de service

Nombre minimal d'instances

minInstanceCount Définir un nombre minimal d'instances pour les services

Révision

révision Révisions de service Cloud Run
Scaling de modèles

Nombre minimal d'instances

minInstanceCount Définir un nombre minimal d'instances pour les services
Scaling de modèles Nombre maximal d'instances maxInstanceCount À propos du nombre maximal d'instances

Clé de chiffrement

encryptionKey Utiliser les clés de chiffrement gérées par le client

Simultanéité maximale des requêtes d'instance

maxInstanceRequestConcurrency Nombre maximal de requêtes simultanées pour les services

Affinité de session

sessionAffinity Définir l'affinité de session pour les services

Environnement d'exécution

executionEnvironment À propos des environnements d'exécution des services
Trafic

Type

type Rollbacks, déploiements progressifs et migration du trafic
Trafic Pourcentage percent Rollbacks, déploiements progressifs et migration du trafic
Trafic Révision révision Rollbacks, déploiements progressifs et migration du trafic
Trafic Tag tag Rollbacks, déploiements progressifs et migration du trafic
Libellés de service

Clé

labels Configurer des étiquettes pour les services
Libellés de service Valeur labels Configurer des étiquettes pour les services
Annotations de service

Clé

annotations annotations
Annotations de service Valeur annotations annotations
Client

Nom

Identifiant arbitraire du client API.

client
Client Version

Identifiant arbitraire de la version du client API.

clientVersion

Étape de lancement

LaunchStage Étapes de lancement des produits

Audiences personnalisées

customAudience Définir des audiences personnalisées pour les services
Autorisation binaire

Justification de l'accès d'urgence

breakglassJustification Utiliser le mode d'urgence
Autorisation binaire Utiliser les valeurs par défaut useDefault Utiliser l'autorisation binaire
Libellés de modèle

Clé

labels Configurer des étiquettes pour les services
Libellés de modèle Valeur labels Configurer des étiquettes pour les services
Annotations de modèle

Clé

annotations annotations
Annotations de modèle Valeur annotations annotations

Délai avant expiration

timeout Définir le délai avant expiration des requêtes pour les services

Compte de service

serviceAccount Configurer l'identité du service pour les services