Movatterモバイル変換


[0]ホーム

URL:


Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

Commit7820786

Browse files
committed
docs: add documentation for preset invalidation
Adds a new section explaining how to invalidate presets when externaldependencies change without a template version update. When presetsare invalidated, the reconciliation loop automatically recycles theirprebuilt workspaces.Updates#17917
1 parent9ca5b44 commit7820786

File tree

1 file changed

+24
-0
lines changed

1 file changed

+24
-0
lines changed

‎docs/admin/templates/extending-templates/prebuilt-workspaces.md‎

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -229,6 +229,30 @@ When a template's active version is updated:
229229

230230
The system always maintains the desired number of prebuilt workspaces for the active template version.
231231

232+
###Invalidating prebuilds
233+
234+
When external dependencies change (such as AMI updates, base image changes, or configuration drift) without a template version update, you can invalidate presets to force their prebuilt workspaces to be recreated.
235+
236+
This is useful when:
237+
238+
- A base VM image or container image has been updated externally
239+
- Infrastructure configuration has drifted from the desired state
240+
- You want to ensure prebuilt workspaces use the latest dependencies without publishing a new template version
241+
242+
To invalidate presets:
243+
244+
1. Navigate to**Templates** and select your template.
245+
1. Go to the**Prebuilds** tab.
246+
1. Click**Invalidate Prebuilds**.
247+
1. Confirm the action in the dialog.
248+
249+
Once presets are invalidated, the next reconciliation loop run will delete the old prebuilt workspaces and create new ones to maintain the desired instance count.
250+
The process typically completes within a few reconciliation cycles (the interval is controlled by`CODER_WORKSPACE_PREBUILDS_RECONCILIATION_INTERVAL`, which defaults to 15 seconds).
251+
252+
>[!NOTE]
253+
>Preset invalidation only affects unclaimed prebuilt workspaces owned by the`prebuilds` system user.
254+
>Workspaces that have already been claimed by users are not affected.
255+
232256
##Administration and troubleshooting
233257

234258
###Managing resource quotas

0 commit comments

Comments
 (0)

[8]ページ先頭

©2009-2025 Movatter.jp