Skip to content

Commit a6a5baf

Browse files
authored
add --containers-rollout docs to main rollouts page (#26761)
1 parent 7563c53 commit a6a5baf

File tree

1 file changed

+17
-2
lines changed

1 file changed

+17
-2
lines changed

src/content/docs/containers/platform-details/rollouts.mdx

Lines changed: 17 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,9 +5,10 @@ sidebar:
55
order: 2
66
---
77

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

1010
## How rollouts work
11+
1112
When you run `wrangler deploy`, the Worker code is updated immediately and Container
1213
instances are updated using a rolling deploy strategy. The default rollout configuration is two steps,
1314
where the first step updates 10% of the instances, and the second step updates the remaining 90%.
@@ -22,6 +23,7 @@ If you have cleanup that must occur before a Container instance is stopped, you
2223
Once stopped, the instance is replaced with a new instance running the updated code. Requests may hang while the container is starting up again.
2324

2425
Here is an example configuration that sets a 5 minute grace period and a two step rollout where the first step updates 10% of instances and the second step updates 100% of instances:
26+
2527
<WranglerConfig>
2628

2729
```toml
@@ -40,4 +42,17 @@ class_name = "MyContainer"
4042
tag = "v1"
4143
new_sqlite_classes = ["MyContainer"]
4244
```
43-
</WranglerConfig>
45+
46+
</WranglerConfig>
47+
48+
## Immediate rollouts
49+
50+
If you need to do a one-off deployment that rolls out to 100% of container instances in one step, you can deploy with:
51+
52+
<PackageManagers
53+
pkg="wrangler"
54+
type="exec"
55+
args="deploy --containers-rollout=immediate"
56+
/>
57+
58+
Note that `rollout_active_grace_period`, if configured, will still apply.

0 commit comments

Comments
 (0)