配置 Cloud Run 服务

在 Application Design Center 中，您可以配置 Cloud Run 服务，以直接在 Google 的可伸缩全代管式式基础设施上运行无状态容器。您可以根据特定的组件连接和配置参数自定义服务。terraform-google-cloud-run Terraform 模块中列出了配置参数。

组件连接

下表列出了您可以连接到 Cloud Run 服务的组件，以及对应用及其生成的 Terraform 代码进行的相应更新。

关联的组成部分	应用更新	背景信息
Secret Manager	Cloud Run 服务可以引用 Secret 数据。 Cloud Run env_secret_vars 字段会引用 Secret Manager Secret Data 字段。 roles/secretmanager.secretAccessor 角色已添加到 Cloud Run 服务账号。	为服务配置 Secret
服务账号	Cloud Run 服务会将该服务账号用作服务身份。 roles/run.invoker 角色已添加到服务账号。 服务账号电子邮件地址和 IAM 信息会添加到 Cloud Run 环境变量中。	对服务到服务进行身份验证
AlloyDB for PostgreSQL	Cloud Run 服务可以连接到 AlloyDB for PostgreSQL 实例。 AlloyDB for PostgreSQL 资源元数据已添加到 Cloud Run 环境变量中。 AlloyDB for PostgreSQL roles/alloydb.admin 角色已添加到 Cloud Run 服务账号。	从 Cloud Run 连接
BigQuery	Cloud Run 服务可以与 BigQuery 数据集进行交互。 BigQuery 资源元数据会添加到 Cloud Run 环境变量中。 BigQuery roles/bigquery.dataEditor 角色已添加到 Cloud Run 服务账号。	BigQuery 概览
Bigtable	Cloud Run 服务可以对 Bigtable 实例执行管理功能。 Bigtable 资源元数据信息会添加到 Cloud Run 环境变量中。 roles/bigtable.admin 角色已添加到 Cloud Run 服务账号。	Bigtable 概览
其他 Cloud Run 服务	来源 Cloud Run 服务可以向目标 Cloud Run 服务发送流量。 来源 Cloud Run 服务在其环境变量中包含目标 Cloud Run 服务 URI。	Cloud Run 是什么
Cloud SQL (MySQL)	Cloud Run 服务可以向 Cloud SQL (MySQL) 实例读取和写入数据。 Cloud SQL 连接元数据会添加到 Cloud Run 服务中。 roles/cloudsql.instanceUser 和 roles/cloudsql.client 角色已添加到 Cloud Run 服务账号。 Cloud Run 服务账号已作为 IAM 用户添加到 Cloud SQL 实例。	从 Cloud Run 连接
Cloud SQL (PostgreSQL)	Cloud Run 服务可以向 Cloud SQL (PostgreSQL) 实例读取和写入数据。 Cloud SQL 连接元数据会添加到 Cloud Run 服务中。 roles/cloudsql.instanceUser 和 roles/cloudsql.client 角色已添加到 Cloud Run 服务账号。 Cloud Run 服务账号已作为 IAM 用户添加到 Cloud SQL 实例。	从 Cloud Run 连接
Cloud Storage	Cloud Run 服务可以管理 Cloud Storage 存储桶中的对象。 Cloud Run 服务账号 IAM 信息已添加到 Cloud Storage 存储桶。 roles/storage.objectAdmin 角色已分配给 Cloud Run 服务账号。	连接到 Google Cloud 服务
全球 Cloud Load Balancing 后端	负载均衡器可以将传入流量分配到 Cloud Run 服务。 Cloud Run 服务在 Cloud Load Balancing 无服务器 NEG 后端配置中添加为后端端点。	使用 Cloud Run 设置全球外部应用负载均衡器
Memorystore for Redis	Cloud Run 服务可以在 Memorystore for Redis 实例中缓存数据。 Memorystore for Redis 连接信息已添加到 Cloud Run 环境变量中。 roles/redis.editor 角色已添加到 Cloud Run 服务账号。	从 Cloud Run 服务连接到 Redis 实例
Memorystore for Redis Cluster	Cloud Run 服务可以将数据缓存在 Memorystore for Redis Cluster 中。 Memorystore for Redis Cluster 连接信息会添加到 Cloud Run 环境变量中。 应用设计中心会将 roles/redis.dbConnectionUser 角色添加到 Cloud Run 服务账号。	连接到 Memorystore for Redis Cluster 实例
Memorystore for Valkey	Cloud Run 服务可以将数据缓存在 Memorystore for Valkey 实例中。 App Design Center 会将 Memorystore for Valkey 连接信息添加到 Cloud Run 环境变量中。 应用设计中心会将 roles/memorystore.dbConnectionUser 角色添加到 Cloud Run 服务账号。	连接到 Memorystore for Valkey 实例
Pub/Sub	Cloud Run 服务可以接收消息或发布到 Pub/Sub 主题。 Pub/Sub 主题 ID 会添加到 Cloud Run 环境变量中。 roles/pubsub.publisher 和 roles/pubsub.subscriber 角色已添加到 Cloud Run 服务账号。 Cloud Run 服务会添加到 Pub/Sub 推送和拉取订阅字段中。	教程：将 Pub/Sub 与 Cloud Run 搭配使用
区域级 Cloud Load Balancing 后端	负载均衡器可以将传入流量分配到 Cloud Run 服务。 Cloud Run 服务在 Cloud Load Balancing 无服务器 NEG 后端配置中添加为后端端点。	使用 Cloud Run 设置区域级外部应用负载均衡器
区域级 Cloud Load Balancing 前端	负载均衡器的 HTTP 和 HTTPS IP 地址可供在 Cloud Run 容器中运行的应用使用。 Cloud Load Balancing 地址元数据会添加到 Cloud Run 环境变量中。	转发规则概览
Spanner	Cloud Run 服务可以管理 Spanner 实例。 Spanner 连接详细信息会添加到 Cloud Run 环境变量中。 roles/spanner.databaseAdmin 角色已添加到 Cloud Run 服务账号。 Cloud Run 服务账号 IAM 信息已添加到 Spanner 实例。	连接到 Google Cloud 服务
Vertex AI	Cloud Run 服务可以与 Vertex AI 服务进行交互。 roles/aiplatform.user 角色已添加到 Cloud Run 服务账号。	在 Cloud Run 上托管 AI 应用和代理

必需的配置参数

如果您的模板包含 Cloud Run 组件，则必须在部署之前配置以下参数。

参数名称	说明和限制	背景信息
项目 ID	您要在其中部署 Cloud Run 资源的项目。	配置组件
区域	Cloud Run 服务部署位置。	Cloud Run 位置
服务名称	name	Cloud Run 服务

可选配置参数

以下参数是可选的。如需显示高级参数，请在配置区域中选择显示高级字段。

功能	子功能	参数名称	说明和限制条件信息	背景信息
容器		容器名称	name	构建容器
		容器映像	图片	将容器映像部署到 Cloud Run
		工作目录	容器的工作目录。如果未指定，则系统会使用容器运行时的默认值，该值可能会在容器映像中进行配置。	workingDir
		取决于容器	dependsOn[]	为 sidecar 部署配置容器启动顺序
		容器参数	args[]	为服务配置容器
		容器命令	命令	为服务配置容器
	环境变量	键	name	服务的环境变量
		值	value	服务的环境变量
	环境 Secret 变量	键	EnvVarSource	管理密文
		Secret	secret	管理密文
		版本	version	管理密文
	卷装载	名称	name	从 Cloud Run 连接
		装载路径	mountPath	从 Cloud Run 连接
	端口	名称	name	为服务使用 HTTP/2
		容器端口	containerPort	为服务使用 HTTP/2
	资源	CPU	限制	为服务配置 CPU 限制
		内存	限制	为服务配置内存限制
		CPU 空闲	是否仅在请求期间分配 CPU。	cpuIdle
		启动 CPU 加速功能	startupCPUBoost	设置启动 CPU 加速功能
	启动探测	失败阈值	failureThreshold	为服务配置容器健康检查
		初始延迟秒数	initialDelaySeconds	配置探测
		超时秒数	timeoutSeconds	配置探测
		周期秒数	periodSeconds	配置探测
		HTTP Get 路径	path	配置探测
		HTTP Get 端口	端口	配置探测
		HTTP 标头名称	name	配置探测
		HTTP 标头值	value	配置探测
		TCP 套接字端口	端口	默认 TCP 启动探测
		GRPC 端口	端口	配置探测
		GRPC 服务	服务	配置探测
		活跃性探测	livenessProbe	使用场景
		说明	description	设置服务说明
		创建服务账号	为 Cloud Run 服务创建新的服务账号。	为作业配置服务身份
		服务账号项目角色	要授予新创建的服务账号的角色。启用创建服务账号，并且不为服务账号提供输入。	为作业配置服务身份
		入站流量	IngressTraffic	限制 Cloud Run 的网络入站流量
		成员	可以调用服务的用户和服务账号。如需公开访问权限，请输入 allUsers。如需允许已登录的 Google 用户访问，请输入 allAuthenticatedUsers，或输入特定用户和服务账号的列表。如需了解详情，请参阅成员。	为作业配置服务身份
虚拟私有云 (VPC) 访问权限		连接器	connector	具有连接器的 VPC
		出站	egress	控制出站流量服务流量
	网络接口	网络	网络	部署服务
		子网	子网	部署服务
		标记	tags	部署服务
		Cloud Run 防删除保护	防止 Terraform 销毁或重新创建 Cloud Run 作业和服务。	deletion_protection
		启用 Prometheus Sidecar	在 Cloud Run 实例中启用 Prometheus 边车。	使用 Prometheus 边车写入 Prometheus 指标
卷		名称	name	配置内存中卷
	Secret	Secret	secret	将 Secret 设为可供 Cloud Run 访问
		默认模式	defaultMode
		路径	path	将 Secret 设为可供 Cloud Run 访问
		版本	version	将 Secret 设为可供 Cloud Run 访问
		Mode	mode	将 Secret 设为可供 Cloud Run 访问
	Cloud SQL 实例	实例	instances[]	从 Cloud Run 连接
	空目录	中	medium	为服务配置内存中卷装载
		大小限制	sizeLimit	为服务配置内存中卷装载
	GCS	存储桶	存储桶	为服务配置 Cloud Storage 卷装载
		只读	readOnly	为服务配置 Cloud Storage 卷装载
	NFS	服务器	服务器	为服务配置 NFS 卷装载
		路径	path	为服务配置 NFS 卷装载
		只读	readOnly	为服务配置 NFS 卷装载
服务扩缩		实例数量下限	minInstanceCount	为服务设置实例数下限
		修订版本	revision	Cloud Run 服务修订版本
模板扩缩		实例数量下限	minInstanceCount	为服务设置实例数下限
		实例数上限	maxInstanceCount	关于实例数上限
		加密密钥	encryptionKey	使用客户管理的加密密钥
		实例请求并发数上限	maxInstanceRequestConcurrency	服务的并发请求数上限
		会话亲和性	sessionAffinity	为服务设置会话亲和性
		执行环境	executionEnvironment	服务执行环境简介
流量		类型	type	回滚、逐步发布和流量迁移
		Percent	percent	回滚、逐步发布和流量迁移
		修订版本	revision	回滚、逐步发布和流量迁移
		标记	tag	回滚、逐步发布和流量迁移
服务标签		键	labels	为服务配置标签
		值	labels	为服务配置标签
服务注解		键	annotations	annotations
		值	annotations	annotations
客户		名称	API 客户端的任意标识符。	client
		版本	版本标识符的任意标识符。	clientVersion
		发布阶段	LaunchStage	产品发布阶段
		自定义受众群体	customAudience	为服务设置自定义目标对象
Binary Authorization		Breakglass 理由	breakglassJustification	使用 breakglass
		使用默认值	useDefault	使用 Binary Authorization
模板标签		键	labels	为服务配置标签
		值	labels	为服务配置标签
模板注释		键	annotations	annotations
		值	annotations	annotations
		超时	timeout	为服务设置请求超时
		服务账号	serviceAccount	为服务配置服务身份