{ "slug": "wrangler-top-level-containers-supports-durable-object-managed-applications-1003782ed581", "title": "wrangler top-level containers supports Durable Object-managed applications", "tools": [ "wrangler" ], "tags": [ "agent" ], "introduced_at": "2026-09-10T15:21:12.000Z", "announced_at": "2026-09-10T15:21:12.000Z", "effective_at": null, "date_basis": "source-publication", "status": "unknown", "how": { "incantation": "When a Worker uses Durable Object-managed Containers, configure `scheduling_policy: \"durable_object\"`, its class, and named image sources; deploy with Wrangler and select prepared images through `ctx.container.images`. Retry the same deploy command if Cloudflare reports partial completion after application creation fails.", "examples": [ "{\"containers\":[{\"class_name\":\"\",\"scheduling_policy\":\"durable_object\",\"images\":{\"\":{\"dockerfile\":\"\"}}}]}", "npx wrangler deploy --containers-rollout=none", "npx wrangler versions deploy @100%" ], "gotchas": [ "Version: 4.131.0", "containers[].scheduling_policy (required): Set to `\"durable_object\"` for Durable Object-managed scheduling.", "containers[].class_name (required): Names the corresponding Durable Object class for this release-note configuration.", "containers[].name: Optional Container application name in the release note.", "containers[].images: Map of named images accessible through `ctx.container.images`; each image must specify exactly one of `dockerfile` or `image`.", "containers[].images..dockerfile: Local Dockerfile path; Wrangler builds and pushes the image. Mutually exclusive with `image` for each named image.", "containers[].images..image: Digest-pinned image reference in the Cloudflare Registry. Mutually exclusive with `dockerfile` for each named image.", "containers[].images..build_context: Build context relative to the Wrangler config; only valid with `dockerfile`.", "containers[].images..build_vars: Build-time variables; only valid with `dockerfile`.", "--containers-rollout: For `wrangler deploy`, `none` skips Container image and instance updates.", "EXPERIMENTAL_CLOUDFLARE_CONTAINER_IMAGES: Temporary reserved Wrangler binding for Container image references; user configuration cannot declare it.", "ctx.container.images: Runtime object exposing configured named image references to Durable Object code.", "Prerequisite: The Durable Object linked to the Container must use SQLite storage.", "Prerequisite: A local Dockerfile build requires Docker or a Docker-compatible CLI to be running.", "Prerequisite: Wrangler deploy of an existing Worker requires Editor access; creating a new Worker requires product-level Admin.", "Prerequisite: The `durable_object` scheduling policy is in public beta.", "Durable Object-managed entries also accept an optional `name` and optional named `images` map; scheduler-only fields are rejected.", "Wrangler builds or resolves each image and waits while Cloudflare prepares it for the Containers runtime.", "Local development support for these entries is deferred to a follow-up.", "With `--containers-rollout=none`, existing Workers retain deployed Container metadata and image binding even when local `containers` is omitted or empty; local scheduler edits are ignored, and upload stops if deployed versions cannot be recovered.", "Existing Workers for Platforms dispatch scripts reject `--containers-rollout=none` before upload because their API does not expose enough metadata to preserve Container associations safely.", "Without `--containers-rollout=none`, removing managed Containers, including by omitting `containers`, clears the experimental image binding even with `keep_vars`.", "`versions deploy` validates selected versions before changing traffic and creates Durable Object-managed applications only after deployment succeeds.", "Both `deploy` and `versions deploy` report partial completion if application creation fails afterward, with instructions to retry the same command.", "`EXPERIMENTAL_CLOUDFLARE_CONTAINER_IMAGES` is a temporary, reserved Wrangler binding; user configuration cannot declare it, and existing versions that already use it are treated as Container configuration.", "The binding's class keys identify managed applications during `versions deploy`, including classes with empty image maps.", "Existing scheduler-backed entries and Durable Object migrations continue to work unchanged.", "Docs conflict: The current Wrangler configuration docs additionally allow omitting `class_name` when linking a Container by `name` from `exports..container`; the Wrangler 4.131.0 release note describes `class_name` entries and does not document that alternative. Current docs may describe later behavior." ] }, "why_it_matters": "Configure a Worker to use managed Containers backed by a Durable Object class and deploy its images.", "sources": [ "https://github.com/cloudflare/workers-sdk/releases/tag/wrangler%404.131.0", "https://developers.cloudflare.com/containers/configuration/scheduling-policy/", "https://developers.cloudflare.com/workers/wrangler/commands/workers/", "https://developers.cloudflare.com/workers/wrangler/configuration/", "https://developers.cloudflare.com/containers/guides/image-management/", "https://developers.cloudflare.com/workers/authorization/workers/" ], "rank": 0.92026, "judge": { "publish": true, "judge_model": "codex-cli/gpt-6-luna+typesafe/jev-1.13.0", "prompt_version": "extract-v7+enrich-v1+judge-v2x3+jev-publish-v1" }, "review_state": "approved", "provenance": { "run_id": "augsep-20261008", "verdict_id": "augsep-20261008:augsep-20261008-12a477641aa3fffb-0:gate", "evidence_hash": "4c7bb692974f408b42d0bc9ad78ebb07ea2ad945341cfe3e16a557b8b9e75905" }, "review": { "draft_hash": "6718ecccf528621de5640e0982786cf27e2cd3e9cd8f84676b5f8b718ab4e8ee", "reviewer": "publication-gate", "reviewed_at": "2026-10-07T00:00:00.000Z", "decision": "augsep-20261008:gate", "reason": "2 of 3 judge runs approved with p_yes >= 0.9 (mean 0.92 >= 0.9; 2 needed) and Jev gave 0.74 (>= 0.6 needed)." } }