Skip to content

Commit 52d5d5c

Browse files
committed
Adds docs for container rollout none option
1 parent 7194342 commit 52d5d5c

3 files changed

Lines changed: 29 additions & 6 deletions

File tree

src/content/docs/containers/get-started.mdx

Lines changed: 11 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -21,8 +21,17 @@ In this guide, we will build and push a container image alongside your Worker co
2121

2222
<Render product="containers" file="docker-setup" />
2323

24-
{/* FUTURE CHANGE: Add some image you can use if you don't have Docker running. */}
25-
{/* FUTURE CHANGE: Link to docs on alternative build/push options */}
24+
### Deploy without Docker
25+
26+
If you do not have Docker running locally but want to deploy Worker code changes without rebuilding the container image, pass `--containers-rollout=none` to the deploy command:
27+
28+
<PackageManagers
29+
type="exec"
30+
pkg="wrangler"
31+
args="deploy --containers-rollout=none"
32+
/>
33+
34+
This skips the container image build and push steps, deploying your Worker code while reusing the existing container image from a previous deployment. You must have deployed the container at least once with Docker before using this option.
2635

2736
## Deploy your first Container
2837

src/content/docs/sandbox/configuration/wrangler.mdx

Lines changed: 13 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ sidebar:
55
order: 1
66
---
77

8-
import { WranglerConfig } from "~/components";
8+
import { WranglerConfig, PackageManagers } from "~/components";
99

1010
## Minimal configuration
1111

@@ -52,6 +52,18 @@ The Sandbox SDK is built on Cloudflare Containers. Your configuration requires t
5252

5353
The minimal configuration shown above includes all required settings. For detailed configuration options, refer to the [Containers configuration documentation](/workers/wrangler/configuration/#containers).
5454

55+
## Deploy without Docker
56+
57+
If you do not have Docker running locally but want to deploy Worker code changes without rebuilding the container image, pass `--containers-rollout=none` to the deploy command:
58+
59+
<PackageManagers
60+
type="exec"
61+
pkg="wrangler"
62+
args="deploy --containers-rollout=none"
63+
/>
64+
65+
This skips the container image build and push steps, deploying your Worker code while reusing the existing container image from a previous deployment. You must have deployed the container at least once with Docker before using this option.
66+
5567
## Troubleshooting
5668

5769
### Binding not found

src/content/docs/workers/wrangler/commands.mdx

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -336,9 +336,11 @@ None of the options for this command are required. Also, many can be set in your
336336
- Specify the [Workers for Platforms dispatch namespace](/cloudflare-for-platforms/workers-for-platforms/how-workers-for-platforms-works/#dispatch-namespace) to upload this Worker to.
337337
- `--metafile` <Type text="string" /> <MetaInfo text="optional" />
338338
- Specify a file to write the build metadata from esbuild to. If flag is used without a path string, this defaults to `bundle-meta.json` inside the directory specified by `--outdir`. This can be useful for understanding the bundle size.
339-
- `--containers-rollout` <Type text="immediate | gradual" /> <MetaInfo text="optional" />
340-
- Specify the [rollout strategy](/containers/faq#how-do-container-updates-and-rollouts-work) for [Containers](/containers) associated with the Worker. If set to `immediate`, 100% of container instances will be updated in one rollout step, overriding any configuration in `rollout_step_percentage`. Note that `rollout_active_grace_period`, if configured, still applies.
341-
- Defaults to `gradual`, where the default rollout is 10% then 100% of instances.
339+
- `--containers-rollout` <Type text="immediate | gradual | none" /> <MetaInfo text="optional" />
340+
- Specify the [rollout strategy](/containers/faq#how-do-container-updates-and-rollouts-work) for [Containers](/containers) associated with the Worker.
341+
- `gradual` (default) — Rolls out to 10% then 100% of instances.
342+
- `immediate` — Rolls out to 100% of container instances in one step, overriding any configuration in `rollout_step_percentage`. Note that `rollout_active_grace_period`, if configured, still applies.
343+
- `none` — Skips building and pushing a new container image. Use this when you do not have Docker running locally but still want to deploy Worker code changes. The deployment uses the existing container image from a previous deploy.
342344
- `--strict` <Type text="boolean" /> <MetaInfo text="(default: false) optional" />
343345
- Turns on strict mode for the deployment command, meaning that the command will be more defensive and prevent deployments which could introduce potential issues. In particular, this mode prevents deployments if the deployment would potentially override remote settings in non-interactive environments.
344346
- `--tag` <Type text="string" /> <MetaInfo text="optional" />

0 commit comments

Comments
 (0)