Description

The prebuilds documentation currently does not explain how to recover when prebuild jobs saturate provisioner queues. This situation can occur for instance when a faulty template version is published and leaves admins needing to manually diagnose and clear jobs.

We should add a troubleshooting section to the prebuilds docs that gives admins clear recovery steps. This would include how to adjust reconciliation settings, pause the prebuild loop, and cancel provisioner jobs to restore normal operation.

Troubleshooting steps to document:

• Adjust theCODER__PREBUILDS_RECONCILIATION_INTERVAL configuration value to decrease the reconciliation loop interval.
• Run thecoder prebuilds pause CLI command to pause the prebuilds reconciliation loop.
• Use thecoder provisioner job list andcoder provisioner job cancel CLI commands to list and stop provisioner jobs by ID.

Related to:coder/internal#924