Skip to content

Document that idle_duration requires a nodes range - #4173

Merged
r4victor merged 1 commit into
masterfrom
pr_document_idle_duration_node_range
Aug 20, 2026
Merged

Document that idle_duration requires a nodes range#4173
r4victor merged 1 commit into
masterfrom
pr_document_idle_duration_node_range

Conversation

@r4victor

Copy link
Copy Markdown
Collaborator

The docs promised that idle_duration terminates idle instances of a fixed-size fleet, which can never happen: termination only removes instances above nodes.min, and nodes: N sets min to N.

  • Rewrite the "Idle duration" section in concepts/fleets.md to scope termination to instances above nodes.min and switch its example from nodes: 2 to a min: 0 / target: 2 range, so the example actually terminates something.
  • Add an admonition explaining that a fleet already at nodes.min keeps its instances, since dstack would immediately provision new ones to maintain the minimum.
  • Qualify the same claim in the manage-fleets snippet, which the dev environments, tasks, and services pages include, and in its duplicate in guides/protips.md.
  • Extend the idle_duration field description with the fixed-nodes: N consequence, which renders into the fleet reference.

AI assistance: written with Claude Code.

@r4victor
r4victor merged commit 0acd80b into master Aug 20, 2026
23 of 24 checks passed
@r4victor
r4victor deleted the pr_document_idle_duration_node_range branch August 20, 2026 08:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant