跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

Wrangler 配置

最后更新 查看 MarkdownAgent 设置

在 Worker 的 Wrangler 配置文件中定义 Containers。每个 Container 都与一个 Durable Object 类关联,该类在运行时提供对 Container 的访问。

最小配置

新的 Container 应用需要 Container 定义、Durable Object 绑定(binding)以及 Durable Object 类导出:

{
	"$schema": "./node_modules/wrangler/config-schema.json",
	"name": "my-container-worker",
	"main": "src/index.ts",
	"upload_source_maps": true,
	// Set this to today's date
	"compatibility_date": "2026-11-14",
	"containers": [
		{
			"class_name": "MyContainer",
			"image": "./Dockerfile",
			"max_instances": 10,
		},
	],
	"durable_objects": {
		"bindings": [
			{
				"name": "MY_CONTAINER",
				"class_name": "MyContainer",
			},
		],
	},
	"exports": {
		"MyContainer": {
			"type": "durable-object",
			"storage": "sqlite",
		},
	},
}
"$schema" = "./node_modules/wrangler/config-schema.json"
name = "my-container-worker"
main = "src/index.ts"
upload_source_maps = true
# Set this to today's date
compatibility_date = "2026-11-14"

[[containers]]
class_name = "MyContainer"
image = "./Dockerfile"
max_instances = 10

[[durable_objects.bindings]]
name = "MY_CONTAINER"
class_name = "MyContainer"

[exports.MyContainer]
type = "durable-object"
storage = "sqlite"

该配置使用三个部分:

  1. containers 定义容器镜像,并通过 class_name 将其与 Durable Object 类关联。
  2. durable_objects.bindings 使 Durable Object 命名空间对 Worker 代码可用。在此示例中,通过 env.MY_CONTAINER 访问。
  3. exports 声明 Durable Object 类,并为其配置 SQLite 存储。

containers 和 durable_objects.bindings 中的 class_name,以及 exports 中的键,必须与 Worker 中导出的 Durable Object 类匹配。

Container 设置

containers 条目还可以配置实例类型、最大运行实例数、镜像构建、放置约束、滚动发布和 SSH 访问。

所有可用字段和值请参阅 Containers Wrangler 配置参考。

后续步骤

这篇文档对您有帮助吗?