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

Commit104aa19

Browse files
authored
chore(docs): improve prebuild provsioners section (#20321)
## 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.
1 parent0faee8e commit104aa19

File tree

2 files changed

+9
-2
lines changed

2 files changed

+9
-2
lines changed

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

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -379,6 +379,7 @@ This keeps other provisioners available to handle user-initiated jobs.
379379

380380
1) Create a provisioner key with a prebuild tag (e.g.,`is_prebuild=true`).
381381
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.
382383
See[Scoped Key](../../provisioners/index.md#scoped-key-recommended) for instructions on how to create a provisioner key.
383384

384385
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:
412413

413414
1) Publish the new template version.
414415

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.
416420
The loop frequency is controlled by the configuration value[`CODER_WORKSPACE_PREBUILDS_RECONCILIATION_INTERVAL`](../../../reference/cli/server.md#--workspace-prebuilds-reconciliation-interval).
417421
When the loop runs, it will provision prebuilds for the new template version and deprovision prebuilds for the previous version.
418422
Both provisioning and deprovisioning jobs for prebuilds should display the tag`is_prebuild=true`.
419423

420-
3) Create a new workspace from a preset.
424+
4) Create a new workspace from a preset.
421425
Whether the preset uses a prebuild pool or not, the resulting job should not include the`is_prebuild=true` tag.
422426
This confirms that only prebuild-related jobs are routed to the dedicated prebuild provisioner pool.
423427

‎docs/admin/templates/extending-templates/workspace-tags.md‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -74,6 +74,9 @@ that every tag set is associated with at least one healthy provisioner.
7474
>[!NOTE]
7575
>It may be useful to run at least one provisioner with no additional
7676
>tag restrictions that is able to take on any job.
77+
>
78+
>`coder_workspace_tags` are cumulative.
79+
>Jobs will only match provisioners that have all tags defined in both your template configuration and`coder_workspace_tags`.
7780
7881
###Parameters types
7982

0 commit comments

Comments
 (0)

[8]ページ先頭

©2009-2025 Movatter.jp