Skip to content

Document retry_dns failover behavior#69110

Open
tdashelby-cmyk wants to merge 1 commit into
saltstack:masterfrom
tdashelby-cmyk:codex/document-retry-dns-failover
Open

Document retry_dns failover behavior#69110
tdashelby-cmyk wants to merge 1 commit into
saltstack:masterfrom
tdashelby-cmyk:codex/document-retry-dns-failover

Conversation

@tdashelby-cmyk
Copy link
Copy Markdown

What does this PR do?

Documents the retry_dns behavior when the minion is configured with master_type: failover.

The current minion code forces retry_dns to 0 during startup in that mode so DNS errors move to the next configured master instead of retrying the same name resolution.

What issues does this PR fix or reference?

Fixes #69109

Previous Behavior

The retry_dns reference only described the default retry interval and the general 0 behavior, so the failover-specific override was not visible from the minion configuration docs.

New Behavior

The retry_dns reference now notes that master_type: failover causes Salt to set retry_dns to 0 during startup to allow failover on DNS errors.

Merge requirements satisfied?

[NOTICE] Bug fixes or features added to Salt require tests.

  • Docs
  • Changelog - documentation-only reference update
  • Tests written/updated - documentation-only reference update

Commits signed with GPG?

No

Verification

  • git diff --check
  • Select-String -Path doc\ref\configuration\minion.rst -Pattern 'master_type.*failover','retry_dns`` to ``0','conf_minion:: retry_dns'

@tdashelby-cmyk tdashelby-cmyk requested a review from a team as a code owner May 11, 2026 14:54
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.

[DOCS] Out of date reference minion configuration for retry_dns

1 participant