You signed in with another tab or window.Reload to refresh your session.You signed out in another tab or window.Reload to refresh your session.You switched accounts on another tab or window.Reload to refresh your session.Dismiss alert
## DescriptionFollow-up from:#20305 to include anote about `coder_workspace_tags` being cumulative and a new step tovalidate the status of the prebuild provisioners.Fix steps formatting.
Copy file name to clipboardExpand all lines: docs/admin/templates/extending-templates/prebuilt-workspaces.md
+6-2Lines changed: 6 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -379,6 +379,7 @@ This keeps other provisioners available to handle user-initiated jobs.
379
379
380
380
1) Create a provisioner key with a prebuild tag (e.g.,`is_prebuild=true`).
381
381
Provisioner keys are org-scoped and their tags are inferred automatically by provisioner daemons that use the key.
382
+
**Note:**`coder_workspace_tags` are cumulative, so if your template already defines provisioner tags, you will need to create the provisioner key with the same tags plus the`is_prebuild=true` tag so that prebuild jobs correctly match the dedicated prebuild pool.
382
383
See[Scoped Key](../../provisioners/index.md#scoped-key-recommended) for instructions on how to create a provisioner key.
383
384
384
385
2) Deploy a separate provisioner pool using that key (for example, via the[Helm coder-provisioner chart](https://github.com/coder/coder/pkgs/container/chart%2Fcoder-provisioner)).
@@ -412,12 +413,15 @@ Follow these steps:
412
413
413
414
1) Publish the new template version.
414
415
415
-
2) Wait for the prebuilds reconciliation loop to run.
416
+
2) Validate the status of the prebuild provisioners.
417
+
Check the Provisioners page in the Coder dashboard or run the[`coder provisioner list`](../../../reference/cli/provisioner_list.md) CLI command to ensure all prebuild provisioners are up to date and the tags are properly set.
418
+
419
+
3) Wait for the prebuilds reconciliation loop to run.
416
420
The loop frequency is controlled by the configuration value[`CODER_WORKSPACE_PREBUILDS_RECONCILIATION_INTERVAL`](../../../reference/cli/server.md#--workspace-prebuilds-reconciliation-interval).
417
421
When the loop runs, it will provision prebuilds for the new template version and deprovision prebuilds for the previous version.
418
422
Both provisioning and deprovisioning jobs for prebuilds should display the tag`is_prebuild=true`.
419
423
420
-
3) Create a new workspace from a preset.
424
+
4) Create a new workspace from a preset.
421
425
Whether the preset uses a prebuild pool or not, the resulting job should not include the`is_prebuild=true` tag.
422
426
This confirms that only prebuild-related jobs are routed to the dedicated prebuild provisioner pool.