在 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"该配置使用三个部分:
containers定义容器镜像,并通过class_name将其与 Durable Object 类关联。durable_objects.bindings使 Durable Object 命名空间对 Worker 代码可用。在此示例中,通过env.MY_CONTAINER访问。exports声明 Durable Object 类,并为其配置 SQLite 存储。
containers 和 durable_objects.bindings 中的 class_name,以及 exports 中的键,必须与 Worker 中导出的 Durable Object 类匹配。
containers 条目还可以配置实例类型、最大运行实例数、镜像构建、放置约束、滚动发布和 SSH 访问。
所有可用字段和值请参阅 Containers Wrangler 配置参考。
- 部署 Containers — 构建镜像并部署 Worker。
- 扩缩容与路由 — 路由请求并扩展容器实例。
- 滚动发布 — 控制配置变更如何到达正在运行的实例。
- 镜像管理 — 使用本地和远程容器镜像。