Skip to content

[Containers] Document scheduling policies and snapshots - #33531

Open
thomasgauvin wants to merge 11 commits into
productionfrom
codex/containers-scheduling-policy
Open

thomasgauvin wants to merge 11 commits into
productionfrom
codex/containers-scheduling-policy

Conversation

@thomasgauvin

Copy link
Copy Markdown
Contributor

Summary

  • Builds on Add docs and changelog for containers snapshots #31946 and preserves the original snapshot commit and authorship.
  • Documents the new durable_object scheduling policy alongside the existing default policy.
  • Covers named images, runtime instance sizing, scheduling-policy immutability, snapshot restore constraints, and rollout behavior.
  • Updates the Containers architecture and configuration pages, Durable Object Container API, and Wrangler configuration reference.
  • Adds a Containers changelog entry for the scheduling-policy public beta.

Validation

  • pnpm run check (Astro: 0 errors, warnings, or hints; Worker TypeScript passed)
  • git diff --check
  • Reviewed against the Cloudflare documentation style guide and adjacent Containers docs
  • Full local build reached the bundling stage, then stopped because the local disk filled; GitHub CI will run the full build.

Documentation checklist

  • Includes a changelog entry.
  • Adheres to the documentation style guide.

@github-actions github-actions Bot added product:workers Related to Workers product product:durable-objects Durable Objects: https://developers.cloudflare.com/workers/learning/using-durable-objects/ product:changelog product:containers size/l labels Sep 18, 2026
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Sep 18, 2026

Copy link
Copy Markdown

🚀 Deploying Preview to Cloudflare 🚀

Preview URL: https://codex-containers-scheduling-policy.previews.developers.cloudflare.com (commit c994c6a)

This URL reflects your latest Preview deployment

Preview Deployments by commit

Status Deployment URL Commit Updated (UTC) See this deployment's details
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://7365c204.previews.developers.cloudflare.com c994c6a 2026-09-21T15:56:24.283Z Visit the dashboard ↗
  • Build: Failed ❌

View logs ↗
a730273 2026-09-18T15:54:59.341Z View logs ↗

@cloudflare-docs-bot

cloudflare-docs-bot Bot commented Sep 21, 2026

Copy link
Copy Markdown
Contributor

Review

⚠️ Part of the review could not complete in commit c994c6a — it will retry on the next push.

Code Review

This code review is in beta and may not always be helpful — use your judgment.

No code review issues found.

Conventions

❌ This review could not complete this run; results may be incomplete. It will retry on the next push.

Style Guide Review

No style-guide issues found.

Commands

Only codeowners can run commands. Post a comment with the command to trigger it.

Command Description
/review Runs a review now. Incremental if a prior review exists, full if not.
/full-review Re-reviews the entire PR diff from scratch, ignoring incremental history. Useful after a rebase, when you want a fresh review, or if the bot gets out of sync and reports issues that no longer exist.
/ignore-review-limit Permanently lifts the 2-review automatic limit for this PR. Future pushes will trigger reviews as normal.
/disable-auto-review Stops automatic reviews from triggering on future pushes to this PR. Codeowners can still run /review or /full-review manually.
/rebase Rebases the PR branch against production. On conflict, attempts to resolve automatically using AI. Stops with an explanation if confidence is not high enough.

@cloudflare-docs-bot

Copy link
Copy Markdown
Contributor

Review coverage

🟡 4 ownership areas need approval.

Suggested reviewers: @dinasaur404 @irvinebroque @th0m @joshthoward @vy-ton

Needs approval Eligible approvers Suggested
workers @irvinebroque, @MattieTK, @vy-ton, @cloudflare/wrangler, @cloudflare/product-owners dinasaur404, irvinebroque
containers
/src/content/docs/containers/
@mikenomitch, @th0m, @cloudflare/cloudchamber, @cloudflare/product-owners irvinebroque, th0m
containers
/src/content/changelog/containers/
@mikenomitch, @th0m, @cloudflare/cloudchamber, @cloudflare/pm-changelogs, @cloudflare/product-owners th0m
durable-objects @danlapid, @iglesiasbrandon, @irvinebroque, @joshthoward, @lambrospetrou, @mikenomitch, @rita3ko, @vy-ton, @cloudflare/product-owners irvinebroque, joshthoward, vy-ton
CODEOWNERS mappings for displayed areas (4)
Pattern Owners
/src/content/docs/workers/wrangler/ @irvinebroque, @MattieTK, @vy-ton, @cloudflare/wrangler, @cloudflare/product-owners
/src/content/docs/containers/ @mikenomitch, @th0m, @cloudflare/cloudchamber, @cloudflare/product-owners
/src/content/changelog/containers/ @mikenomitch, @th0m, @cloudflare/cloudchamber, @cloudflare/pm-changelogs, @cloudflare/product-owners
/src/content/docs/durable-objects/ @danlapid, @iglesiasbrandon, @irvinebroque, @joshthoward, @lambrospetrou, @mikenomitch, @rita3ko, @vy-ton, @cloudflare/product-owners

sidebar:
order: 4
products:
- containers
---

import { WranglerConfig, PackageManagers, Steps } from "~/components";
import {

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think it could be great if we mentioned cloudflare/debian-trixie here and linked to the backing DockerHub link

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

And show some example witht he pattern of building your images with snapshots

publish_future_dated_entry: true
---

import { TypeScriptExample, WranglerConfig } from "~/components";

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

same feedback, should we mention here the new generic image that you can use to build your own images here?

@github-actions

Copy link
Copy Markdown
Contributor

Preview URL: https://c994c6aa.preview.developers.cloudflare.com
Preview Branch URL: https://codex-containers-scheduling-policy.preview.developers.cloudflare.com

Files with changes (up to 15)

Original Link Updated Link
https://developers.cloudflare.com/containers/configuration/scheduling-policy/ https://codex-containers-scheduling-policy.preview.developers.cloudflare.com/containers/configuration/scheduling-policy/
https://developers.cloudflare.com/containers/guides/image-management/ https://codex-containers-scheduling-policy.preview.developers.cloudflare.com/containers/guides/image-management/
https://developers.cloudflare.com/workers/wrangler/configuration/ https://codex-containers-scheduling-policy.preview.developers.cloudflare.com/workers/wrangler/configuration/
https://developers.cloudflare.com/durable-objects/api/container/ https://codex-containers-scheduling-policy.preview.developers.cloudflare.com/durable-objects/api/container/
https://developers.cloudflare.com/containers/guides/snapshots/ https://codex-containers-scheduling-policy.preview.developers.cloudflare.com/containers/guides/snapshots/
https://developers.cloudflare.com/changelog/post/2026-09-30-snapshots/ https://codex-containers-scheduling-policy.preview.developers.cloudflare.com/changelog/post/2026-09-30-snapshots/
https://developers.cloudflare.com/changelog/post/2026-09-30-durable-object-scheduling-policy/ https://codex-containers-scheduling-policy.preview.developers.cloudflare.com/changelog/post/2026-09-30-durable-object-scheduling-policy/
https://developers.cloudflare.com/containers/concepts/architecture/ https://codex-containers-scheduling-policy.preview.developers.cloudflare.com/containers/concepts/architecture/
https://developers.cloudflare.com/containers/ https://codex-containers-scheduling-policy.preview.developers.cloudflare.com/containers/
https://developers.cloudflare.com/containers/faq/ https://codex-containers-scheduling-policy.preview.developers.cloudflare.com/containers/faq/
https://developers.cloudflare.com/containers/configuration/rollouts/ https://codex-containers-scheduling-policy.preview.developers.cloudflare.com/containers/configuration/rollouts/
https://developers.cloudflare.com/containers/platform/limits/ https://codex-containers-scheduling-policy.preview.developers.cloudflare.com/containers/platform/limits/
https://developers.cloudflare.com/containers/configuration/environment-variables/ https://codex-containers-scheduling-policy.preview.developers.cloudflare.com/containers/configuration/environment-variables/
https://developers.cloudflare.com/containers/configuration/ https://codex-containers-scheduling-policy.preview.developers.cloudflare.com/containers/configuration/
https://developers.cloudflare.com/containers/configuration/scaling-and-routing/ https://codex-containers-scheduling-policy.preview.developers.cloudflare.com/containers/configuration/scaling-and-routing/

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

product:changelog product:containers product:durable-objects Durable Objects: https://developers.cloudflare.com/workers/learning/using-durable-objects/ product:workers Related to Workers product size/l

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants