search

saltstack / salt

Software to automate the management and configuration of any infrastructure or application at scale. Get access to the Salt software package repository here:
https://repo.saltproject.io/
Apache License 2.0
13.98k stars 5.47k forks source link

[DOCS] Multi-Master DNS Retry Timeout #66533

Open Jepson2k opened 1 month ago

Jepson2k commented 1 month ago

Description Its not clear from the documentation that when a minion is configured in multi-master mode (therefore retry_dns must be 0) that the acceptance_wait_time parameter is used as the waiting value between DNS resolution attempts.

Suggested Fix Add a note to both retry_dns and acceptance_wait_time parameter that the acceptance_wait_time parameter is used as the waiting value between DNS resolution attempts in multi-master mode.

Type of documentation Salt documentation

Location or format of documentation https://docs.saltproject.io/en/latest/ref/configuration/minion.html

Additional context I help to manage 50 laptops we use for various events. The setup has to be flexible and work on different networks so we use multicast DNS names for resolution. When we don't use SaltStack, the minion still attempt to resolve the name. I couldn't figure out from the documentation which parameter could be used to reduce the amount of DNS requests. After looking through the code I found it was the acceptance_wait_time parameter.

welcome[bot] commented 1 month ago

Hi there! Welcome to the Salt Community! Thank you for making your first contribution. We have a lengthy process for issues and PRs. Someone from the Core Team will follow up as soon as possible. In the meantime, here’s some information that may help as you continue your Salt journey. Please be sure to review our Code of Conduct. Also, check out some of our community resources including:

There are lots of ways to get involved in our community. Every month, there are around a dozen opportunities to meet with other contributors and the Salt Core team and collaborate in real time. The best way to keep track is by subscribing to the Salt Community Events Calendar. If you have additional questions, email us at saltproject@vmware.com. We’re glad you’ve joined our community and look forward to doing awesome things with you!